# Importer vos données (Excel, Csv)

{% embed url="<https://www.youtube-nocookie.com/embed/XNcy3eudgZk?si=LadsT5mhFv-hubDT>" %}

## L'import de données dans Dastra

Dastra vous permet très facilement d'importer vos propres données sous format tableur directement dans l'application.

Les imports sont possibles dans les modules suivants :&#x20;

* import du registre
* import des acteurs
* import des actifs
* import des jeux de données
* import des champs
* import des mesures de sécurité
* import des catégories de personnes concernées
* import des réponses d'audit
* import des modèles d'audit (à venir)
* import des types de risques
* import des demandes d'exercice de droits
* import des violations de données
* import des tâches

Dans chaque import, le processus est le même.&#x20;

Il s'effectue en 4 étapes :&#x20;

1. [Préparation du fichier de données](#1.-preparation-du-fichier-de-donnees)
2. [Téléchargement du fichier](#2.-charger-le-fichier)
3. [Vérification des données avant import](#3.-verifiez-vos-donnees)
4. [Import des données](#4.-importez-les-donnees)

### 1. Préparation du fichier de données

Dastra supporte que les formats de données suivants :

* **Excel** (.xlsx)
* **Fichiers plats** (.csv,.txt) avec séparateur ; et encodage UTF-8 (l'encodage est important pour avoir les accents)
* **JSON** (Uniquement pour l'import du registre complet et les modèles de traitements)

Pour accéder au menu d'import de données, cliquez sur le bouton "importer" sous chaque flèche du bouton de création.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FfxzoUATtdwnlY9gSJnTf%2FCapture%20d&#x27;%C3%A9cran%202024-12-18%20102227.png?alt=media&#x26;token=d806a540-c655-436a-9f74-000f00fe83bd" alt=""><figcaption></figcaption></figure>

Sélectionnez Excel si cela vous est demandé :&#x20;

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FEbfp0w0RAiDblq0jxdol%2Fimage.png?alt=media&#x26;token=10d3b40f-e062-4d39-9c81-3c077f588eb6" alt=""><figcaption></figcaption></figure>

#### Téléchargement du modèle de fichier

Ensuite, téléchargez un modèle de fichier en cliquant sur le bouton "Télécharger le modèle de fichier"

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FCBaJPPGVrLyt4dxIc8iZ%2FCapture%20d&#x27;%C3%A9cran%202024-12-18%20102637.png?alt=media&#x26;token=617c6972-c3d8-49ec-afe3-159f6a0ead05" alt=""><figcaption></figcaption></figure>

Le modèle de fichier est **un fichier au format CSV** que vous pouvez facilement éditer avec un tableau Libre Office, Wordpad, Excel ou Google Sheet.

Celui-ci contiendra toutes les colonnes nécessaires avec des exemples de données.

Exemple de fichier (pour le registre) : &#x20;

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FebptFr4XCdpx1P1xsqcB%2Fimage.png?alt=media&#x26;token=29f24e51-4c8f-46dc-b508-8d4fe35def1c" alt=""><figcaption><p>La ligne 2 contient des données d'exemple qu'il faut remplacer</p></figcaption></figure>

#### Renseignement du modèle de fichier

Remplissez le fichier téléchargé avec vos données.

Pour chaque fichier de données, vous pourrez afficher les valeurs attendues sur les colonnes :&#x20;

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2Fd34qwxxciHy9Yt3UTRWC%2Fimage.png?alt=media&#x26;token=72376724-e15c-4da6-b8bc-74fc8727491a" alt=""><figcaption><p>Valeurs attendues pour le fichier d'import du registre</p></figcaption></figure>

Les imports contiennent des valeurs attendues en anglais. C'est tout à fait normal. En effet, il s'agit d'un import technique en base de données.&#x20;

Les valeurs en anglais correspondent aux listes déroulantes des boutons de sélection.&#x20;

Par exemple, dans l'import du registre, le champ "processing state" correspond au champ "état du traitement" dans Dastra. Il s'agit du champ indiqué dans la première étape "Généralités".

Le champ "State" correspond au statut du traitement ("brouillon" pour "Draft" ou "publié" pour "Active").&#x20;

### 2. Charger le fichier

Une fois votre fichier de données prêt, vous devrez dans certains cas indiquer une unité organisationnelle. Tous les fichiers importés seront placés dans cette unité organisationnelle.&#x20;

{% hint style="info" %}
Seuls les imports d'objets qui peuvent être attachés à des unités organisationnelles sont concernés. Par exemple, le registre des traitements ou les violations de données. Les acteurs, mesures ou jeux de données ne sont pas concernés.
{% endhint %}

#### Mettre à jour les données via l'import

Il est proposé de cocher une case permettant de mettre à jour les données existantes.&#x20;

Cette fonctionnalité permet de mettre à jour les données dans Dastra à partir des données du fichier Excel.&#x20;

Par défaut, l'import va créer des nouveaux objets. Si l'objet existe déjà (un acteur par exemple), l'import ne créera pas de nouvel objet.&#x20;

Il est possible de mettre à jour un objet existant (par exemple un acteur).&#x20;

Dans ce cas, il faut sélectionner la case "Mettre à jour à les données existantes" et choisir le champ de correspondance. Ce champ sera la clé permettant d'identifier les champs à mettre à jour.&#x20;

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FlhbCrUVJ0QEtuZzB14rp%2Fimage.png?alt=media&#x26;token=de0db4b2-4de9-4862-ae16-c7475fd510d3" alt=""><figcaption><p>Mise à jour des données</p></figcaption></figure>

En cliquant sur le bouton "Ecraser les données des lignes qui matchent", les données correspondantes seront remplacées par les données de l'import.

#### Envoi du fichier

Envoyez le fichier en cliquant dans la zone

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2F3iKzQWiPOm6I1ooUpgav%2Fimage.png?alt=media&#x26;token=abebd3f3-b9c1-419c-8a75-e134f0bea653" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Vous pouvez également envoyer vos fichiers en effectuant un glisser-déposer dans la zone d'envoi des fichiers
{% endhint %}

### 3. Vérifiez vos données

L'utilitaire suivant vous permet de valider et d'éventuellement choisir les colonnes de votre fichier Excel sur les colonnes attendues en format d'import.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FVLY0D1cYeIscNKwCDt5X%2Fimage.png?alt=media&#x26;token=2d549c80-0e0d-4a49-874e-c6267c8f808d" alt=""><figcaption></figcaption></figure>

Si tout vous semble conforme, vous pouvez lancer l'import des données.

### 4. Importez les données

Lancez l'import des données en cliquant sur le bouton continuer. Le processus d'import va alors se déclencher.

<figure><img src="https://1301193153-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LvBxs22wUMicv9uWp6C-2584506019%2Fuploads%2FeJ0RHPrGeOcrFrxiJG4z%2Fimage.png?alt=media&#x26;token=a97e884d-b835-464f-bc23-207e94a93b72" alt=""><figcaption></figcaption></figure>

### 5. C'est fini !

Bravo ! vous êtes arrivé au bout de ce guide ! Nous vous recommandons de vérifier que les données ont bien été importés dans l'outil.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.dastra.eu/features/generalites/importer-vos-donnees-excel-csv.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
