Importation de fiches depuis un fichier CSV
L’importateur CSV transforme une feuille de calcul en fiches — une fiche par ligne. Il se trouve sous Fiches → Importer des fiches et vous guide dans le choix d’un modèle, le mappage des colonnes aux champs, la sélection d’un dossier de destination et l’exécution de l’importation avec suivi de la progression en direct.
Format CSV
Section intitulée « Format CSV »Préparez une ligne d’en-tête, une fiche par ligne, et conservez une colonne pour le nom de la fiche. Le panneau Format CSV de la barre latérale propose des exemples de colonnes (Nom, Description, Statut, Propriétaire), et Télécharger un exemple de CSV vous fournit un fichier de départ. Seuls les fichiers .csv sont acceptés (« Fichiers CSV uniquement »), et « cet importateur s’attend à ce que chaque ligne du fichier CSV représente une seule fiche ».
Deux autres conseils de formatage :
- Une colonne fournit le nom de la fiche et doit contenir une valeur dans chaque ligne que vous souhaitez importer. DICE suggère une colonne Nom/Titre lorsqu’il en trouve une ; sinon, il sélectionne la première colonne.
- Les types de colonnes (texte, date, nombre) sont détectés automatiquement à partir des données lors de la génération d’un modèle. Veillez donc à ce que les valeurs de chaque colonne soient cohérentes.
Choisir un mode d’importation
Section intitulée « Choisir un mode d’importation »La section Mode d’importation propose deux options :
- Créer un nouveau modèle et importer — « Importez un fichier CSV, générez automatiquement un modèle, vérifiez-le, puis lancez l’importation. » Cette option convient particulièrement à une première importation : DICE déduit un modèle à partir de vos colonnes.
- Importer dans un modèle existant — « Choisissez d’abord un modèle, puis mappez les champs et importez les fiches. » Cette option est disponible dès que vous disposez d’au moins un modèle ; Télécharger un exemple produit un fichier CSV correspondant aux champs du modèle sélectionné.
Importer avec un nouveau modèle
Section intitulée « Importer avec un nouveau modèle »- Importer un fichier CSV — cliquez pour importer le fichier ou faites-le glisser et déposez-le. Le fichier est analysé sur place et le nombre de lignes s’affiche (« N lignes prêtes à être mappées »).
- Vérifier le générateur de modèles — le modèle déduit s’affiche avec un Nom du modèle et une Description du modèle préremplis à partir du nom du fichier, ainsi que les Champs de données détectés.
- Sous Nom et description de la fiche, confirmez la Colonne du nom et, facultativement, la Colonne de la description. Ces colonnes figurent dans les Champs de données comme Nom de la fiche / Description de la fiche et portent la mention Non créé en tant que champ, car chaque fiche les contient déjà.
- Cliquez sur Créer le modèle. Le modèle est enregistré dans votre équipe et vous passez à la destination et à l’importation (« Modèle créé. Passez à la destination et à l’importation. »).
Comme le modèle a été généré à partir de votre fichier CSV, le mappage des colonnes est appliqué automatiquement (« Ce modèle a été généré à partir du fichier CSV importé ; le mappage des champs est donc appliqué automatiquement. »). Le panneau Mappage automatique des colonnes rappelle les sources du nom et de la description ; utilisez Retour au modèle pour les modifier.
Importer dans un modèle existant
Section intitulée « Importer dans un modèle existant »- Sous Sélectionner un modèle, choisissez le modèle qui doit recevoir les lignes importées.
- Importer un fichier CSV — « Importez un fichier CSV pour commencer le mappage et l’importation. » Le panneau affiche vos Lignes CSV à côté des Champs du modèle sélectionné.
- Cliquez sur Continuer vers le mappage des champs.
Destination et mappage des champs
Section intitulée « Destination et mappage des champs »L’étape Destination et mappage des champs vous permet de contrôler ce qui sera créé :
- Dossier — le dossier de destination de chaque fiche importée. Le sélecteur est prérempli avec le dernier dossier que vous avez utilisé ; vous devez en sélectionner un avant l’importation.
- Mappage des champs — « Mappez chaque champ du modèle à la colonne CSV qui doit le renseigner. » Des mappages suggérés sont appliqués lorsque les noms des colonnes correspondent ; les champs laissés sur Aucune colonne ne sont tout simplement pas renseignés. (Cette étape est ignorée lorsque le modèle a été généré automatiquement à partir du fichier CSV.)
- Nom et description de la fiche — la colonne CSV dont chaque fiche tire son nom (obligatoire) et, facultativement, sa description. Il s’agit de propriétés de la fiche ; les colonnes ne sont donc pas stockées comme données de champ.
- Stocker également ces colonnes comme champs — cette option est désactivée par défaut. Activez-la pour conserver aussi les valeurs du nom et de la description dans les données de champ de chaque fiche. Lorsqu’un champ mappé est ignoré, cela est indiqué sous son nom, y compris pour un champ Obligatoire — le nom et la description propres à la fiche portent la valeur à sa place.
Sous le mappage, l’Aperçu des fiches importées affiche les premières lignes telles qu’elles seront importées, le nombre de lignes prêtes (« N lignes prêtes à être importées ») et signale celles qui échoueraient (« N lignes échouent actuellement »), généralement parce qu’une valeur obligatoire est absente. Corrigez le fichier CSV ou le mappage jusqu’à ce que les lignes qui vous intéressent affichent Prêt.
Chaque ligne de l’aperçu se lit comme la page de la fiche qu’elle deviendra : le nom, son modèle, sa description, puis l’organisation, l’équipe et le dossier auxquels elle appartiendra. Cette dernière ligne mérite d’être vérifiée avant l’importation : un dossier partagé avec vous appartient à une autre équipe, et les fiches qui y sont créées appartiennent à cette équipe, pas à la vôtre.
Exécuter l’importation
Section intitulée « Exécuter l’importation »Cliquez sur Importer N fiches. L’importation s’exécute par lots avec un État de l’importation actualisé en direct (« Traitement de X lignes sur Y. Lot A sur B. »), puis affiche un récapitulatif : « N fiches importées. » et, le cas échéant, « Échec de N lignes. »
Une importation réussie consigne également, pour chaque fiche, un groupe d’activités Fiche importée dans le flux d’activité, et le modèle créé reste disponible pour de futures importations.
Importer un package d’assemblage
Section intitulée « Importer un package d’assemblage »Indépendamment de l’importation CSV, DICE peut importer un Package d’importation d’assemblage — un fichier JSON décrivant, dans une même structure, des fiches, des assemblages, des pièces jointes associées aux pièces et des liens de relation. Cette fonction se trouve sous Assemblages → Importer un package d’assemblage.
- Collez le JSON du package ou cliquez sur Charger un fichier.
- Cliquez sur Valider le package. Une simulation du package produit un Plan d’importation indiquant le nombre de Fiches, d’Assemblages, de Fiches hors assemblage, de Pièces jointes aux fiches et de Liens entre fiches à créer, ainsi que les éventuels Problèmes bloquants et Avertissements. Les dossiers, catégories et relations référencés sont comparés aux éléments existants et marqués réutiliser l’existant, créer, ou signalés comme ambigus.
- Lorsque le plan indique « Ce package est prêt à être importé. », cliquez sur Valider l’importation.
Contrairement à l’importation CSV, l’importation d’un package d’assemblage est transactionnelle : « rien n’est écrit avant la validation, et l’importation suit le principe du tout ou rien ». Résolvez tous les problèmes bloquants avant de valider. Consultez la page Assemblages pour en savoir plus sur les assemblages et les pièces.