1
Téléchargement du modèle de fichier CSV
Le fichier CSV importé doit être conforme au modèle spécifique à votre projet. Pour télécharger le fichier maintain-import-template.csv :
- Naviguez jusqu’à Activités et choisissez Ajouter une activité.
- Choisissez Importer des activités.
- Choisissez Télécharger le modèle.
2
Remplissage du modèle de fichier CSV
Le modèle CSV ne contiendra qu’une seule ligne de valeurs représentant les valeurs possibles que vous pouvez fournir pour une activité importée. Cette ligne est appelée ligne d’en-tête et ne doit pas être supprimée lors du remplissage du modèle.Pour importer une seule activité, ajoutez une nouvelle ligne au modèle et saisissez les valeurs appropriées séparées par des virgules. Chaque valeur de la nouvelle ligne doit contenir la valeur que vous souhaitez renseigner sur la ligne d’en-tête respective fournie dans le modèle.Par exemple, si votre modèle contient la ligne d’en-tête suivante : Vous allez créer une activité intitulée « Installer l’échafaudage » avec l’état « Terminé(es) » et le service « Montage » lors de l’importation.Si l’ID externe fourni ne s’exporte pas, l’utilisateur verra une erreur pendant l’importation.
title,status,department, créez un fichier CSV avec une ligne supplémentaire :Format des champs de date
Certains champs d’activité dans Maintain représentent des dates et doivent avoir un format spécifique pour être importés correctement. Les champs de date peuvent être identifiés dans le modèle CSV par une valeur d’en-tête spéciale sous la formestartTime (DD/MM/YYYY). Dans cet exemple, startTime est le nom du champ, tandis que DD/MM/YYYY est le format de date qui doit être utilisé dans les lignes suivantes du fichier CSV.Par exemple, l’importation du fichier suivant aura pour effet de créer l’activité avec startTime défini sur le 10 décembre 2023.Format des champs de valeurs booléennes
Certains champs d’activité dans Maintain représentent des valeurs booléennes, telles quetrue ou false. Les champs de valeurs booléennes peuvent être identifiés dans le modèle CSV par une valeur d’en-tête spéciale sous la forme isActive (true/false). Ces champs n’ont que deux valeurs valides : true ou false.Par exemple, l’importation du fichier suivant aura pour effet de créer l’activité avec isActive défini sur false.Format des valeurs contenant des virgules
En raison de la séparation des valeurs par des virgules au format CSV, soyez prudent lorsqu’un champ d’activité doit également contenir une virgule. Maintain traite les fichiers CSV selon la norme RFC 4180, laquelle exige que les valeurs contenant des virgules soient entourées de guillemets doubles.Par exemple, l’importation du fichier suivant aura pour effet de créer l’activité aveccity défini sur Boston, MA.Représentation des valeurs manquantes
Vous pouvez laisser le champ vide pour les champs d’activité non requis pour représenter des valeurs manquantes ou non pertinentes pour l’activité spécifique.Par exemple, l’importation du fichier suivant aura pour effet de créer l’activité avecstate défini sur New York, mais elle n’aura pas de valeur dans le champ city.Connexion d’une activité à un actif
Maintain permet de connecter une activité à un actif CDF de façon à contextualiser l’activité dans des modèles 3D, des documents, des PSN, etc. Pour que Maintain crée le lien approprié vers un actif dans CDF, vous devez fournir l’ID externe de l’actif CDF dans le modèle d’importation.Si vous avez une contextualisation d’actif dans votre projet, le modèle comportera un champ spécialassetExternalId que vous devrez compléter avec l’ID externe de l’actif de l’activité.Par exemple, en cas d’importation du fichier suivant et en supposant qu’un actif CDF existe avec l’ID externe NY_BUILDING_23, l’activité sera contextualisée sur cet actif au moment d’être intégrée dans Maintain.3
Importation d’un fichier CSV rempli
Une fois que vous avez renseigné un modèle CSV, vous pouvez l’importer dans Maintain :
- Accédez à Activités > Ajouter une activité.
- Choisissez Importer des activités.
- Sélectionnez le champ Cliquer pour sélectionner le fichier CSV à importer.
- Sélectionnez et chargez le fichier CSV renseigné depuis votre ordinateur.
- Assurez-vous d’avoir importé le fichier en vérifiant la section Inspecteur de fichiers. Un message vert doit indiquer le nombre de lignes à importer et si vous avez des avertissements ou des erreurs.
- S’il n’y a pas d’erreurs, sélectionnez Importer pour lancer le processus d’importation.
- Une fois l’importation réussie, vous verrez un message vert confirmant le succès de l’opération avec le bouton Afficher les activités.
- Facultatif. Choisissez Afficher les activités pour accéder aux activités importées et assurez-vous qu’elles sont correctes conformément au fichier CSV.