Il est possible de réaliser des imports de fiches liées entre elles dans des relations en utilisant un fichier Excel.
Les points suivants vont être abordés dans cet article :
Structure du fichier
Onglet "Worksheet"
Il s'agit de l'onglet principal qui permet d'enregistrer les premières fiches. Cet onglet fonctionne sur le même principe qu'un import classique.
En mode "Différentiel", il faut bien renseigner la colonne "submissionNumber" afin que l'on puisse retrouver les fiches à mettre à jour.
En mode "Ajout", il faut tout de même mettre un identifiant dans "submissionNumber". Ce dernier sera remplacé lors de la création mais permet de reconnaître la fiche au sein du document, notamment dans l'onglet "Relation".
Onglets "Relations"
Dans cet onglet, on répertorie toutes les relations entre les différentes fiches. Il doit posséder au moins 4 colonnes plus une cinquième optionnelle :
"parent" : permet de choisir une fiche dans l'onglet Worksheet. Il faut l'identifier pour son numéro de fiche "submissionNumber".
"relation" : il s'agit du nom système de la relation permettant de lier deux fiches
"child" : permet de choisir une fiche dans un autre onglet. Il faut l'identifier par son numéro de fiche "submissionNumber".
"structure id" : Il s'agit de l'identifiant Daxium du formulaire permettant de construire l'autre fiche.
"count" : ce paramètre optionnel permet de définir la quantité dans une relation quantifiable.
Onglets des fiches en relation
On peut ensuite créer autant d'onglets que nécessaire pour créer d'autres fiches.
Chaque onglet doit être appelé par le nom système de la relation, suivi d'un espace, suivi par l'identifiant du formulaire de la fiche.
Par exemple : "NomSystème 2951".
Bien renseigner les "submissionNumber" de la même manière que dans "Worksheet".
Lancer un import
Dans la vue tableau des fiches, il faut cliquer sur "Import" puis selectionner le fichier Excel que vous avez préparé.
Les options séparateur de colonne et encodage n'ont pas d'effet car nous n'utilisons pas de fichier CSV mais un fichier XLS.
Le mode "Ajout" va créer une nouvelle fiche pour chaque ligne du fichier. Le mode "Différentiel" va mettre à jour des fiches existantes sans en créer.
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.
Cas particulier
Il n'est pas possible actuellement de retirer des fiches en relation via un import différentiel.
Les formules d'une fiche parent (principale) ne seront pas mises à jour lors d'un import de fiches si ces formules se basent sur un champs relation qui comprend plus de 5 élements.