# Importer des fiches 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](#import-differentiel). Pour les imports incluant des relations entre formulaires, consultez [Importer des fiches avec des relations](#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. ![](/files/C4bImliqmtw17cX0Q0Of) 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. ![](/files/TJjCvrVw5F96vMI3kt7V) Définissez le mode d'insertion sur **Ajouter** pour créer de nouvelles fiches. {% hint style="info" %} 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**. {% endhint %} ![](/files/XeYDMIsZoxU66qh7qsmT) ![](/files/Wk2lH6mafd3H0Af4PAIf) ## 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. ![](/files/SWMIzT2StJDXgZnoRC4e) 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. ![](/files/WQxxyOF1hFy2cNPykRcQ) ### 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. ![](/files/mTosfaUKpOtydrcFVm70) 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 : ![](/files/lSTcIkKM8qmaRx8Aan20) * `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é. ![](/files/5iFV8G4gazjkUxYm7A75) 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. ![](/files/TJjCvrVw5F96vMI3kt7V) 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. --- # 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://www.center.daxium-air.com/user-documentation/documentation-utilisateur/use/views/actions-from-views/import-submissions.md?ask= ``` 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.