# Champs personnalisés

{% embed url="<https://www.youtube-nocookie.com/embed/mDyJD-mnnL0>" %}
Comment utiliser les champs personnalisés dans Dastra
{% endembed %}

## Dans quel cas utiliser les champs personnalisés ?

Il se peut que certaines informations propres à votre secteur ne soient pas présentes dans les champs natifs du registre des traitements, les exercices de droits, les tâches...etc...

Dastra vous permettra de créer des champs de formulaire personnalisés que vous pouvez très facilement ajouter pour enrichir les données saisies.

Voici un exemple de configuration de champs pour l'acteur :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FoY1ImpvH7Yv9zuB2CEos%2Fimage.png?alt=media&#x26;token=2ba110af-c25a-4b87-afb9-5e5b90731002" alt=""><figcaption><p>Configuration des champs</p></figcaption></figure>

Et voici le résultat dans le formulaire :

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fn6oOTtCX9BfVGUJdCPoz%2Fimage.png?alt=media&#x26;token=a116e97d-db63-4d53-adfb-6c9c700425d5" alt=""><figcaption></figcaption></figure>

## Fonctionnalités concernées

{% hint style="success" %}
Attention ! Toutes les fonctionnalités ne sont pas concernées par les champs personnalisés
{% endhint %}

Vous pouvez personnaliser les formulaires suivants :&#x20;

* [Fiches de traitement](https://doc.dastra.eu/features/editer-le-registre)
* [Exercice de droits](https://doc.dastra.eu/features/gerer-les-exercices-des-droits)
* [Tâches](https://doc.dastra.eu/features/planifier/gerer-vos-taches)
* [Actifs](https://doc.dastra.eu/features/editer-le-registre/remplir-le-questionnaire/applications)
* [Acteurs](https://doc.dastra.eu/features/cartography/referentials)
* [Mesures](https://doc.dastra.eu/features/editer-le-registre/remplir-le-questionnaire/mesures-de-securite)
* [Jeux de données](https://doc.dastra.eu/features/editer-le-registre/remplir-le-questionnaire/categorie-de-donnees)
* Champs de données
* [Violations](https://doc.dastra.eu/rappels-utiles/rgpd-en-bref/violations-de-donnees)
* [Evaluations de risques](https://doc.dastra.eu/features/la-gestion-des-risques/risques)
* [Systèmes d'IA](https://doc.dastra.eu/features/systemes-dia)
* [Contrats](https://doc.dastra.eu/features/contrats)
* [Points de contrôles](https://doc.dastra.eu/compliance/library/risks#association-des-controles)

{% hint style="danger" %}

### Limitations du nombre de champs

La quantité de champs personnalisés est limitée selon de plan que vous utilisez. Nous vous invitons à consulter l[a page des tarifs de l'application](https://www.dastra.eu/fr/pricing) pour plus d'informations à ce sujet
{% endhint %}

## Types de champs disponibles

Dastra vous propose plusieurs types de champs personnalisés possibles

* Texte simple
* Texte long
* Texte enrichi
* Nombre entier
* Nombre décimal
* Date
* Date et heure
* Case à cocher (réponse multiple) (**non filtrable**)
* Case à cocher (réponse unique)
* Sélecteur simple
* Sélecteur multiple (**non filtrable**)
* Case à cocher (Oui/Non)

## Utilisation des champs personnalisés

Vous pouvez :

* Afficher et modifier les données des champs personnalisés dans les formulaires de chaque module
* Les champs personnalisés peuvent s'afficher dans tous les tableaux de visualisation de l'application. Pour les afficher, cliquer sur le bouton de paramétrage des colonnes du tableau.
* Les champs personnalisés sont **présents dans tous les exports Excel** de données. Pour plus d'informations sur les exports, [consultez la page sur les exports](https://doc.dastra.eu/features/editer-le-registre/exporter-importer-le-registre)
* Les champs personnalisés peuvent être présents dans les exports HTML, Word et PDF sur option (en cochant la case "Exportable dans les rapports" sur le champ en question)
* **A l'exception des champs à réponses multiples**, les champs personnalisés sont tous filtrables via le système de [filtres avancés](https://doc.dastra.eu/features/generalites/advanced-filters).&#x20;
* Les champs personnalisés peuvent être mis à jour en masse dans les tableaux de données
* Les champs personnalisés peuvent être importés via fichiers plats [en utilisant le système d'import](https://doc.dastra.eu/features/generalites/importer-vos-donnees-excel-csv)
* Les champs personnalisés sont **accessibles et modifiables via toutes les API**. Pour cela, il faudra utiliser le nom de variable attribué à chaque colonne. [Consultez la rubrique concernant les modifications via API des champs personnalisés](#manipuler-les-champs-personnalises-dans-les-api).

## Mise en place des champs personnalisés

* Allez dans votre **Espace de travail**
* Cliquez sur le menu à gauche **Réglages de l'espace de travail**
* Cliquez sur le menu **Champs personnalisés**
* Choisissez le module dans lequel vous voulez ajouter un champ personnalisé
* Les champs doivent être créés dans des groupes. Ces groupes peuvent être positionnés d'une certaine façon dans le formulaire Cliquez sur "**Ajouter un groupe de champs**"

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FUvwZW86WO2RaWXPaIce4%2Fimage.png?alt=media&#x26;token=393d674f-3e0f-4dc2-b195-9f6f3e2569a4" alt=""><figcaption></figcaption></figure>

* **Renseignez le nom et l'emplacement** dans le formulaire que vous souhaitez

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fr9YxNrelh2ALFpmAZK0B%2Fimage.png?alt=media&#x26;token=170ae491-9233-4b39-91d6-f999c05ec825" alt=""><figcaption></figcaption></figure>

Pour certains éléments, il est possible de définir l'emplacement que vous souhaitez dans le formulaire !

* Une fois le groupe créé, vous pouvez désormais **effectuer un glisser-déposer des types de champs** que vous souhaitez mettre en place !

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FzLwBi0Wpxu9zeWJbBATR%2Fimage.png?alt=media&#x26;token=be654935-6707-4ebe-a0d3-6c1026a6aad1" alt=""><figcaption></figcaption></figure>

Renseignez toutes les informations !

* Cliquez sur enregistrer et ça y est ! Votre premier champ de donnée personnelle est en place !
* Vous pouvez effectuer des glisser déposer pour réordonner les champs comme bon vous semble.

## Manipuler les champs personnalisés dans les API

Dastra vous permet de récupérer, modifier et créer via l'[API Rest](https://doc.dastra.eu/api-references/configuration-api) toutes les valeurs des entités comprenant des champs personnalisés.

Une propriété "**customFields**" sera disponible dans toutes les entités que vous récupérez en get dans Dastra.c

```json
 {
   "id": 1234,
   "label": "Test asset",
   etc...
   "customFields": {
     "dpo_name":"jean-marc le dpo",
     "dpo_email":"dpo@github.com",
     "dpo_habilitations": ["Expert","Consulting","Data Mapping"],
     "has_large_dataset":false,
     etc...
   }
 }
```

Pour modifier cette propriété, il suffit de poster (POST) ou modifier (PUT) l'élément en mettant à jour les éléments de la collection

Pour collecter le nom des variables personnalisés, vous devez vous rendre dans la page de configuration des champs personnalisés.

{% hint style="info" %}
Attention, tous **les champs personnalisés seront validés par le serveur**. Si une colonen n'est pas présente dans la configuration, elle sera automatiquement supprimée.

Si un champ n'est pas valide (par exemple, si il n'est pas renseigné alors qu'il est marqué comme étant obligatoire), cela lèvera une exception avec le code 400
{% endhint %}

## Limitations

Vous ne pouvez **pas filtrer les champs personnalisés du type multiple (case à cocher (Multiple) et sélecteur (Multiple))**. C'est une limitation connue sur laquelle nous travaillons.&#x20;