Importer des activités dans Maintain

Maintain prend en charge trois méthodes pour importer des activités :

Téléchargement CSV : Importer des activités en utilisant l’interface utilisateur (mode APM uniquement).
Cognite Toolkit : Ingérez des activités en utilisant la modélisation de données Cognite Toolkit (modes APM et IDM/CDM).
Transformations : Convertissez les données à partir de tables BRUTES ou d’autres sources en utilisant les CDF Transformations (modes APM et IDM/CDM).

Importer via téléchargement CSV (mode APM)

Disponibilité du mode : Mode APM uniquement. Le mode IDM/CDM ne prend pas en charge l’importation CSV dans l’interface utilisateur.

Les activités importées via CSV peuvent être visualisées et modifiées comme des activités créées dans Maintain.

Téléchargez le modèle de fichier CSV

Le fichier CSV importé doit être conforme à votre modèle spécifique au projet. Pour télécharger maintain-import-template.csv :

Accédez à Activités et sélectionnez Ajouter une activité.
Sélectionnez Importer des activités.
Sélectionnez Télécharger le modèle.

Remplissez le 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 la 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 modifier l’ordre des valeurs. Par exemple, si un certain champ n’est pas pertinent à importer dans un scénario spécifique, vous pouvez le retirer de l’en-tête et des lignes suivantes. Cela entraînera le fait que le champ sera laissé vide sur toutes les activités importées.

Pour importer une seule activité, ajoutez une nouvelle ligne au modèle et entrez les valeurs appropriées séparées par des virgules. Chaque valeur dans la nouvelle ligne doit contenir la valeur que vous souhaitez remplir dans 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 créerez une activité avec le titre “Élever des échafaudages”, le statut “Fait” et le département “Rigging” lors de l’importation.

Formater les champs de date

Certains champs d’activité dans Maintain représentent des dates et doivent avoir un format spécifique pour être correctement importés. 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 entraînera la création de l’activité avec startTime défini sur le 10 décembre 2023.

title,startTime (DD/MM/YYYY)
Erect scaffolding,10/12/2023

Formater les champs booléens

Certains champs d’activité dans Maintain représentent des valeurs booléennes, telles que true ou false. Les champs booléens 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 entraînera la création de l’activité avec isActive défini sur false.

title,isActive (true/false)
Erect scaffolding,false

Formater les valeurs contenant des virgules

En raison du format CSV qui sépare les valeurs par des virgules, soyez prudent lorsqu’un champ d’activité doit également contenir une virgule. Maintain traite les fichiers CSV selon la norme RFC 4180, qui exige que les valeurs contenant des virgules soient entourées de guillemets doubles. Par exemple, l’importation du fichier suivant entraînera la création de l’activité avec city défini sur Boston, MA.

title,city
Erect scaffolding,"Boston, MA"

Valeurs non définies

Vous pouvez laisser le champ vide pour les champs d’activité non obligatoires afin de représenter des valeurs manquantes ou non pertinentes pour l’activité spécifique. Par exemple, l’importation du fichier suivant entraînera la création de l’activité avec state défini sur New York, mais elle n’aura aucune valeur dans le champ city.

title,city,state
Erect scaffolding,New York

Connecter une activité à un actif

Maintain prend en charge la liaison d’activités à des actifs CDF, ce qui est utilisé pour contextualiser l’activité dans des modèles 3D, des documents, PSN, et plus encore. 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’actifs dans votre projet, il y aura un champ assetExternalId spécial dans le modèle que vous devrez remplir avec l’ID externe de l’actif de l’activité. Par exemple, lors de l’importation du fichier suivant et en supposant qu’un actif CDF existe avec l’ID externe NY_BUILDING_23, l’activité sera contextualisée à cet actif lors de son ingestion dans Maintain.

title,assetExternalId
Erect scaffolding,NY_BUILDING_23

Si l’ID externe fourni n’est pas exporté, l’utilisateur verra une erreur lors de 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 en utilisant l’API d’actifs de CDF (asset API) ou d’autres extracteurs de données.

Importez un fichier CSV rempli

Une fois votre modèle CSV rempli, vous pouvez l’importer dans Maintain :

Accédez à Activités > Ajouter une activité.
Sélectionnez Importer des activités.
Sélectionnez le champ Cliquez pour sélectionner le fichier CSV à importer.
Sélectionnez et téléchargez le fichier CSV rempli depuis votre ordinateur.
Vérifiez que vous avez importé le fichier en consultant 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 aucune erreur, sélectionnez Importer pour lancer le processus d’importation.
Lorsque l’importation réussit, vous verrez un message de succès vert avec le bouton Afficher les activités.
Facultatif. Sélectionnez Afficher les activités pour accéder aux activités importées et vérifier qu’elles sont correctes conformément au fichier CSV.

Importer via Cognite Toolkit

Disponibilité du mode : Modes APM et IDM/CDM. C’est l’approche recommandée pour l’ingestion d’activités par programme.

Utilisez Cognite Toolkit pour ingérer des activités via les capacités de modélisation de données de CDF. Cette méthode fonctionne pour les deux modes de déploiement et fournit un contrôle de version et des déploiements reproductibles.

Prérequis

Avant d’importer des activités via Cognite Toolkit, assurez-vous de disposer de :

Une vue d’activité personnalisée configurée dans votre espace de modèle de données (ou utilisez la vue CogniteMaintenanceOrder standard de cdf_idm)
La vue d’activité mappée dans votre configuration Maintain sous viewMappings
Accès au Cognite Toolkit

Configurer le mappage de la vue d’activité

Dans votre configuration Maintain, vérifiez que la section viewMappings pointe vers votre vue d’activité :

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "cdf_idm",
    "version": "v1",
    "externalId": "CogniteMaintenanceOrder"
  }
}

Si vous avez créé une vue d’activité personnalisée (par exemple, APM_Activity ou ExtendedActivity), mettez à jour le mappage pour pointer vers votre vue personnalisée :

"viewMappings": {
  "activity": {
    "type": "view",
    "space": "maintain_schema_extention",
    "version": "v1",
    "externalId": "APM_Activity"
  }
}

En savoir plus sur l’extension des modèles de données et la configuration des mappages de vue.

Ingérer des activités avec le Cognite Toolkit

Utilisez le Cognite Toolkit comme approche recommandée pour ingérer des activités en mode IDM.

Créez la structure de données d'activité

Si vous ne l’avez pas encore fait, créez des fichiers YAML pour Container, View et Node pour vos activités. Suivez la structure standard de modélisation des données :

APM_Activity.Container.yaml - Définit le schéma du conteneur
APM_Activity.View.yaml - Définit les propriétés et les relations de la vue
apmActivities.Node.yaml - Contient vos instances d’activité Consultez la documentation Cognite Toolkit pour des exemples détaillés et des modèles.

Configurez les correspondances de champs

Assurez-vous que vos nœuds d’activité incluent les champs requis pour Maintain :

Champ	Description	Requis
`externalId`	Identifiant unique pour l’activité	Oui
`title`	Titre de l’activité	Oui
`status`	Statut de l’activité (par exemple, « Ouvert », « En cours », « Terminé »)	Recommandé
`startTime`	Date/heure de début	Recommandé
`endTime`	Date/heure de fin	Recommandé
`rootLocation`	Identifiant de l’emplacement racine	Recommandé
`assetExternalId`	ID externe de l’actif lié	Optionnel
`mainAsset`	Relation directe avec l’actif	Optionnel

Incluez des champs supplémentaires basés sur vos paramètres de Configuration de champ dans Maintain.

Déployez les activités

Déployez vos données d’activité en utilisant Cognite Toolkit :

cdf deploy --env dev

Utilisez l’indicateur --drop-data si vous devez remplacer des activités existantes :

cdf deploy --env dev --drop-data

En savoir plus sur les indicateurs de déploiement de Cognite Toolkit.

Vérifiez dans Maintain

Connectez-vous à Maintain.
Accédez à Activités.
Vérifiez que vos activités importées apparaissent avec les bonnes données.

Ingestion des activités avec des Transformations

Disponibilité du mode : Modes APM et IDM/CDM. C’est l’approche recommandée pour les données en masse.

Alternativement, vous pouvez utiliser CDF Transformations pour convertir les données des tables RAW ou d’autres sources en nœuds d’activité.

Dépannage

Si vous rencontrez des problèmes avec les activités après ingestion, consultez le tableau pour les causes et les solutions.

Problème	Solution
Activités non visibles	Vérifiez que la configuration `viewMappings` pointe vers l’espace, la vue et la version corrects
Champs manquants	Vérifiez que votre configuration de champ inclut tous les champs que vous ingérez
Liens d’actifs rompus	Assurez-vous que les relations `assetExternalId` ou `mainAsset` pointent vers des actifs existants
Emplacement racine incorrect	Vérifiez que `rootLocation` correspond à votre configuration d’emplacement

Flows

InField

Maintain

Ressources externes

Importer des activités dans Maintain

Importer via téléchargement CSV (mode APM)

Formater les champs de date

Formater les champs booléens

Formater les valeurs contenant des virgules

Valeurs non définies

Connecter une activité à un actif

Importer via Cognite Toolkit

Prérequis

Configurer le mappage de la vue d’activité

Ingérer des activités avec le Cognite Toolkit

Ingestion des activités avec des Transformations

Dépannage

​Importer via téléchargement CSV (mode APM)

​Formater les champs de date

​Formater les champs booléens

​Formater les valeurs contenant des virgules

​Valeurs non définies

​Connecter une activité à un actif

​Importer via Cognite Toolkit

​Prérequis

​Configurer le mappage de la vue d’activité

​Ingérer des activités avec le Cognite Toolkit

​Ingestion des activités avec des Transformations

​Dépannage

Importer via téléchargement CSV (mode APM)

Formater les champs de date

Formater les champs booléens

Formater les valeurs contenant des virgules

Valeurs non définies

Connecter une activité à un actif

Importer via Cognite Toolkit

Prérequis

Configurer le mappage de la vue d’activité

Ingérer des activités avec le Cognite Toolkit

Ingestion des activités avec des Transformations

Dépannage