Importer des activités dans Maintenir

Maintenir 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 : Ingest des activités en utilisant Cognite Toolkit pour la modélisation des données (modes APM et IDM/CDM).
Transformations : Convertir des données à partir de tables RAW ou d’autres sources en utilisant Transformations CDF (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 Maintenir.

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 row ne doive pas être supprimée, vous pouvez retirer 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 à 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 (JJ/MM/AAAA). Dans cet exemple, startTime est le nom du champ, tandis que JJ/MM/AAAA 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 (vrai/faux). 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 lorsque le champ d’activité doit également contenir une virgule. Maintenir 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 ville définie 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 état définie sur New York, mais elle n’aura aucune valeur dans le champ ville.

title,city,state
Erect scaffolding,New York

Connecter une activité à un actif

Maintenir prend en charge le lien des activités aux actifs CDF, qui est utilisé pour contextualiser l’activité dans des modèles 3D, des documents, PSN, et plus encore. Pour que Maintenir crée le lien approprié avec 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, il y aura un champ spécial assetExternalId dans le modèle que vous devez 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 Maintenir.

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 des actifs CDF ou d’autres extracteurs de données.

Importez un fichier CSV rempli

Une fois que vous avez un modèle CSV rempli, vous pouvez l’importer dans Maintenir:

Naviguez vers 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 pas d’erreurs, sélectionnez Importer pour commencer 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 naviguer vers les activités importées et vérifier qu’elles correspondent correctement 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 le Cognite Toolkit pour ingérer des activités grâce aux 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 le Cognite Toolkit, assurez-vous d’avoir :

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

Configurer le mappage de la vue d’activité

Dans votre configuration de Maintien, 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.

Ingestion des activités avec le Cognite Toolkit

Utilisez le Cognite Toolkit comme approche recommandée pour l’ingestion 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 du Cognite Toolkit pour des exemples et des modèles détaillés.

Configurez les correspondances de champs

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

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”, “Fait”)	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 à l’actif	Optionnel

Incluez des champs supplémentaires en fonction de vos paramètres de Configuration des champs dans Maintenir.

Déployez les activités

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

cdf deploy --env dev

Utilisez le --drop-data drapeau si vous devez remplacer les activités existantes :

cdf deploy --env dev --drop-data

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

Vérifiez dans Maintain

Connectez-vous à Maintenir. 2. Naviguez vers Activités. 3. 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 Transformations CDF pour convertir des données à partir de 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	Assurez-vous que votre configuration de champ inclut tous les champs que vous ingérez
Liens d’actifs cassés	Assurez-vous que les relations `assetExternalId` ou `mainAsset` pointent vers des actifs existants
Mauvaise localisation racine	Vérifiez que `rootLocation` correspond à votre configuration de localisation

​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é

​Ingestion 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é

Ingestion des activités avec le Cognite Toolkit

Ingestion des activités avec des Transformations

Dépannage