Importer des fiches

Importer des fiches en masse dans Daxium-Air à l'aide de fichiers CSV.

Vous pouvez ajouter ou mettre à jour des fiches en masse dans le back office Daxium-Air à l'aide de fichiers CSV.

Démarrage rapide — import CSV simple

Le cas le plus courant : ajouter de nouvelles fiches à partir d'un fichier CSV.

1. Obtenir un modèle : dans la vue tableau, cliquez sur Actions > Export et choisissez Export complet pour import. Le fichier CSV téléchargé contient déjà tous les en-têtes de colonnes corrects pour votre formulaire.
2. Préparer vos données : ajoutez vos nouvelles lignes. Supprimez la colonne submissionNumber afin que Daxium-Air crée de nouvelles fiches plutôt que de mettre à jour des fiches existantes.
3. Définir le créateur : renseignez la colonne userEmail avec l'adresse e-mail de l'utilisateur qui doit apparaître comme créateur de la fiche.
4. Importer : dans la vue tableau, cliquez sur Import, sélectionnez votre fichier CSV, définissez le mode d'insertion sur Ajouter et cliquez sur Import.

Un traitement en arrière-plan lance l'import. Une notification apparaît à la fin. En cas d'erreur, téléchargez le fichier CSV d'erreur pour comprendre ce qui s'est mal passé.

Pour mettre à jour des fiches existantes en masse, consultez Import différentiel. Pour les imports incluant des relations entre formulaires, consultez Importer des fiches avec des relations.

Structure de tableur attendue

Exportez les données existantes via Export complet pour import pour obtenir un modèle correctement structuré, puis modifiez les valeurs selon vos besoins.

Pour importer de nouvelles fiches, supprimez la colonne submissionNumber — sinon vous mettrez à jour des fiches existantes au lieu d'en créer de nouvelles.

Colonnes requises par défaut

Tout import doit inclure la colonne userEmail, renseignée avec l'adresse e-mail de l'utilisateur Daxium-Air désigné comme créateur de la fiche.

Colonnes de champs

Ajoutez une colonne par champ du formulaire à renseigner. L'en-tête de la colonne doit être le nom système du champ.

Il n'est pas obligatoire d'inclure tous les champs. Cependant, si un champ obligatoire est absent, la fiche ne sera pas enregistrée — vous recevrez un fichier d'erreur expliquant le problème.

Champ liste : renseignez à l'aide de la valeur d'affichage de l'option ou de son identifiant externe. Ajoutez un suffixe au nom système :

• nomsysteme#name — utilise la valeur d'affichage de l'option
• nomsysteme#external — utilise l'identifiant externe de l'option

N'utilisez qu'une seule des deux options par colonne.

Champ date : les dates doivent être au format ISO 8601. Exemple : 2018-04-30T17:00:00+02:00

Champ fichier et image : fournissez une URL publique depuis laquelle le fichier peut être téléchargé.

Champ booléen : la valeur doit être true ou false. Toute autre valeur génère une erreur.

Champ localisation : ajoutez 3 colonnes. Si le nom système est address :

• address#address — adresse complète (ex. : 21A bd Gabriel Guist'hau 44 000 Nantes)
• address#lat — latitude (ex. : 55.9967)
• address#lng — longitude (ex. : 54.774)

Paramétrer l'import

Dans la vue tableau, cliquez sur Import. Sélectionnez votre fichier CSV, choisissez l'encodage et le séparateur de colonnes. Utilisez la virgule , par défaut lors d'un import depuis Microsoft Excel.

Définissez le mode d'insertion sur Ajouter pour créer de nouvelles fiches.

Lors de l'enregistrement depuis Excel, choisissez le type de fichier CSV UTF-8 (séparateur : virgule). Dans la boîte de dialogue d'import Daxium-Air, vérifiez que l'encodage est défini sur UTF-8.

Gestion des erreurs

Lorsque l'import est terminé, si des fiches n'ont pas pu être enregistrées, un fichier CSV d'erreur est disponible en téléchargement. Il explique ce qui s'est mal passé pour chaque ligne en échec.

---

Avancé

Import différentiel

Le mode différentiel met à jour des fiches existantes plutôt que d'en créer de nouvelles. Incluez la colonne submissionNumber pour identifier les fiches à mettre à jour. Les numéros de fiche apparaissent dans la première colonne de la vue tableau — ne les confondez pas avec l'UUID, qui contient des lettres.

Deux options différentielles sont disponibles :

• Différentiel sans recalcul des formules — import plus rapide. Les formules parent-enfant sur les fiches liées ne sont pas recalculées.
• Différentiel avec recalcul des formules — import plus lent. Les formules parent-enfant sur les fiches liées sont recalculées.

Cellules vides : lorsqu'une colonne est présente dans le fichier mais qu'une cellule est vide, choisissez le comportement :

• Conserver l'ancienne valeur — la cellule vide est ignorée ; la valeur existante est conservée.
• Supprimer l'ancienne valeur — la cellule vide remplace la valeur existante.

Importer des fiches avec des relations

Il est possible d'importer des fiches liées entre elles par des relations à l'aide d'un fichier Excel.

Structure du fichier

Onglet « Worksheet »

L'onglet principal pour les fiches primaires. Il suit la même structure qu'un import CSV standard.

En mode Différentiel, incluez submissionNumber pour identifier les fiches à mettre à jour.

En mode Ajouter, incluez tout de même un identifiant dans submissionNumber — il est remplacé à la création mais sert à identifier la fiche au sein du fichier, notamment dans l'onglet Relationships.

Onglet « Relationships »

Liste toutes les relations entre les fiches. Doit comporter au moins 4 colonnes, plus une cinquième facultative :

• parent — numéro de fiche de l'onglet Worksheet
• relationship — nom système du champ relation liant les deux fiches
• child — numéro de fiche d'un onglet lié
• id structure — identifiant Daxium du formulaire utilisé pour construire le formulaire enfant
• count (facultatif) — quantité dans une relation comptable

Onglets des fiches liées

Créez un onglet par formulaire lié.

Chaque onglet doit être nommé : NomSystème IdFormulaire (ex. : SystemName 2951). Renseignez les valeurs submissionNumber de la même façon que dans l'onglet Worksheet.

Lancer l'import

Dans la vue tableau, cliquez sur Import et sélectionnez votre fichier Excel. Les options de séparateur et d'encodage n'ont pas d'effet pour les fichiers Excel.

Le mode Ajouter crée une nouvelle fiche pour chaque ligne. Le mode Différentiel met à jour les fiches existantes sans en créer.

Limitations

• Il n'est actuellement pas possible de supprimer des fiches liées via un import différentiel.
• Les formules d'une fiche parente ne sont pas recalculées lors de l'import si elles se basent sur un champ relation contenant plus de 5 éléments.