Il est possible d'ajouter des données en masse dans le Back Office de Daxium-Air. L'import de fiche peut être réalisé à partir d'un tableur. Actuellement, Daxium-Air accepte les fichiers CSV.

Il est également possible de faire des modifications de fiches existantes en masse via cet outil.

Structure du tableur attendue

Pour facilement créer un fichier d'import avec la bonne structure, il est possible de faire un export de données existantes en choisissant l'option "Exporter complètement dans le format d'import". Il vous suffira alors de modifier les valeurs souhaitées.

Pour importer de nouvelles fiches il faut supprimer la colonne submissionNumber, sinon vous aller modifier les fiches existantes.

Colonnes requises par défaut

Pour tout import, il faut toujours préciser l'utilisateur qui sera désigné en tant que créateur de la fiche. Pour cela, il faut inclure la colonne userEmail. Cette dernière devra donc être remplie avec les emails des utilisateurs Daxium-Air.

Colonnes champs

On pourra ensuite ajouter des colonnes correspondant aux champs du formulaire. L'intitulé de la colonne doit être le nom système du champ. Il n'est pas obligatoire de mettre tous les champs du formulaire. Toutefois, si un champ obligatoire n'est pas renseigné, la fiche ne sera pas sauvegardée. Vous aurez un fichier de retour vous expliquant le problème.

Champ liste

Le cas des listes est légèrement différent des autres champs. Il est possible de renseigner une liste soit en utilisant sa valeur (ou nom) soit en utilisant son identifiant externe. Pour cela il faut ajouter un suffixe après le nom système du champ liste. Pour modifier une liste en utilisant sa valeur la colonne doit s'appeler nomSyteme#name, pour modifier une liste en utilisant l'identifiant externe : nomSysteme#external

Il est préférable de n'utiliser qu'une seule des deux options pour modifier une liste.

Champ fichier et image

Il n'est pas possible d'importer des fichiers ou des images via cet outil.

Champ booléen

Il n'est pas possible d'importer une fiche avec un booléen qui n'est pas sur "true" ou "false", vous recevrez un ficher de retour vous l'indiquant.

 

Mise en place de l'import

Dans la vue tableau des fiches dans le Back Office, il y a une option d'import de données.

• Vous pouvez choisir le fichier tableur contenant les fiches à importer, ainsi que l'encodage de ce dernier et, dans le cas ou le fichier est un CSV, le séparateur de colonne. Préférez le séparateur de colonne virgule "," par défaut si vous faites l'import depuis Microsoft Excel.

 

 

• Le mode d'insertion permet de choisir si vous souhaitez créer de nouvelles fiches ("Ajout") ou mettre à jour les fiches existantes ("Différentiel").

Concernant le choix "Différentiel", deux options sont disponibles

Différentiel sans calcul des formules dans les relations : permet de réaliser un import plus optimiser. Lors de cet import, les formules parents enfants ne seront pas calculées sur les fiches en relations.

Différentiel avec calcul des formules dans les relations : permet de réaliser un import qui sera beaucoup plus long mais qui prendra en compte le calcule des formules. Lors de cet import, les formules parents enfants seront calculées sur les fiches en relations.

Dans le cas où, vous choisissez le mode différentiel, il faut bien veiller à inclure une colonne "submissionNumber". Vous trouverez les numéro de fiches dans la première colonne de la vue tableau. Attention à ne pas confondre numéro de fiche avec l'uuid. Ce dernier est composé de lettres alors que le numéro de fiche qui nous intéresse ici est composé de chiffres.

 

 

• Il faut privilégier le format d'encodage UTF-8, dans Microsoft Excel, quand vous enregistrez votre .csv cela se présente de cette manière là quand vous faites "Fichier" -> "Enregistrer-Sous" -> "Parcourir" :

         Dans Excel, séléctionnez le type de fichier "CSV UTF-8 (délimité par des virgules)" comme la             capture d'écran ci-dessous le montre.

 

 

          Puis dans Daxium-air, vérifiez bien que le format d'import est réglé sur "UTF-8" : 

 

 

Lorsque vous cliquez sur le bouton Importer, l'import se lance en arrière plan. Une notification vous préviendra lorsque ce dernier sera terminé. Si jamais il y a eu des erreurs, vous pourrez télécharger un ficher CSV permettant de comprendre ce qui n'a pas fonctionné.

 

Gestion des erreurs

Lorsque votre import est terminé, si jamais une erreur a empêché une fiche ou plus de s'enregistrer, vous aurez un retour dans un fichier CSV. Ce dernier vous permettra de comprendre ce qui n'a pas fonctionné et comment corriger le problème.