Importations

Les importations vous permettent d'intégrer dans votre back office vos données déjà existantes à l'aide de trames au format CSV. Elles vous permettent également d'assurer l'intégrité des données importées en vérifiant l'ensemble des règles métiers définies dans vos spécifications.

Composition

Une importation est composée d'un fichier, de ressources, d'une donnée, d'un état, d'une progression, d'un auteur et d'un ensemble d'erreurs.

Le fichier est un fichier au format CSV comprenant les données et les en-têtes des données à importer. Vous devez obligatoirement respecter la structure du fichier pour importer vos données. Pour ce faire, vous pouvez télécharger des trames. Par exemple, si vous souhaitez importer des utilisateurs, rendez-vous sur la liste des utilisateurs, cliquez sur Importer des utilisateurs, puis sur Télécharger une trame.

Les resources sont l'ensemble des ressources au format JSON que vous souhaitez importer. Si aucun fichier n'est fourni avec l'importation, ce sont ces données qui seront utilisées.

L'auteur est comme son nom l'indique l'auteur de l'importation.

La donnée est la ressource que vous souhaitez importer. Par exemple, les tâches, les utilisateurs, les réunions, etc.

Chaque importation s'effectue en tant que tâche de fond. Vous pouvez suivre leur avancement grâce à la progression.

L'état est le statut actuel de votre importation. Les états possibles sont :

• En cours
• Terminé
• Erreur

Les erreurs sont l'ensemble des erreurs métiers de votre fichier d'importation. Par exemple, il peut s'agir d'une contrainte d'unicité non valide (deux lignes identiques). Chaque erreur est accompagnée d'un numéro de ligne pour vous aider à la corriger. Si votre importation est en erreur, vous devez en créer une nouvelle avec un fichier corrigé.

ℹ️

Il convient également de noter qu'aucune donnée n'est importée si votre fichier contient des erreurs.

Cas pratique

Imaginez que vous souhaitiez importer des utilisateurs dans votre application. Pour ce faire, vous téléchargez la trame associée. Vous récupérez donc un fichier CSV sous la forme :

E-mail,Mot de passe,Prénom,Nom,Avatar,Langue,Fuseau horaire,Rôle,Equipes
,,,,,,,,
,,,,,,,,

Afin d'importer vos utilisateurs, vous remplissez la trame avec au minimum les champs obligatoires.

E-mail,Mot de passe,Prénom,Nom,Avatar,Langue,Fuseau horaire,Rôle,Equipes
[email protected],,John,Doe,,Anglais,UTC,Administrateur,Paris;Londres
[email protected],,Jane,Doe,,Français,Paris,Administrateur,Paris;Londres

ℹ️

Les champs de type association tels que Rôle ou Equipes doivent être renseignés par leur désignation (ici Administrateur ou Paris).

ℹ️

Les champs à valeurs multiples tels que les associations plusieurs-à-plusieurs, les tableaux ou les énumérations multiples doivent avoir des données séparées par un ;.

Ensuite il ne vous reste plus qu'à envoyer le fichier depuis l'interface et à suivre l'avancement de votre importation.