Importation des activités à partir d’un fichier CSV
Vous pouvez importer plusieurs activités à partir d’une source externe dans Maintain en chargeant un fichier texte au format CSV contenant des données d’activité, puis intégrer le fichier dans les activités. Les activités peuvent être visualisées et modifiées de la même manière que les activités créées dans Maintain.
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 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.
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.
Bien que la ligne d’en-tête ne doive pas être supprimée, vous pouvez supprimer des valeurs spécifiques de l’en-tête ou changer l’ordre des valeurs. Par exemple, si un certain champ n’est pas pertinent pour l’importation dans un scénario spécifique, vous pouvez le supprimer de l’en-tête et des lignes suivantes. Cela aura pour effet de laisser le champ vide sur toutes les activités importées.
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 : title,status,department, créez un fichier CSV avec une ligne supplémentaire :
title,status,department
Erect scaffolding,Done,Rigging
Vous allez créer une activité intitulée « Installer l’échafaudage » avec l’état « Terminé(es) » et le service « Montage » lors de l’importation.
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 forme StartTime (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 l’heure de début (startTime) fixée au 10 décembre 2023.
title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023
Format des champs de valeurs booléennes
Certains champs d’activité dans Maintain représentent des valeurs booléennes, telles que true ou false. Les champs de date 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.
title,isActive (true/false)
Erect scaffolding,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é avec la ville (city) définie sur Boston, MA.
title,city
Erect scaffolding,"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é avec l’état (state) défini sur New York, mais elle n’aura pas de valeur dans le champ correspondant à la ville (city).
title,city,state
Erect scaffolding,New York
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écial assetExternalId 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.
title,assetExternalId
Erect scaffolding,NY_BUILDING_23
Si l’ID externe fourni ne s’exporte pas, l’utilisateur verra une erreur pendant l’importation.
Les utilisateurs finaux peuvent ne pas connaître l’ID externe de l’actif auquel l’activité est liée. S’il est nécessaire de fournir aux utilisateurs finaux une liste des actifs possibles et de leurs ID externes, nous recommandons de récupérer ces données à l’aide de l’API d’actif de CDF ou d’autres extracteurs de données.
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 cochant 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.