ContextHub - Exigences en matière d'importation de la structure des actifs

L'arbre d'assets

Votre arbre d'assets se trouve dans l'Asset Browser sur TrendHub. 

  1. Sélectionnez l'icône Tags, et cliquez sur le bouton "Search tags & attributes" situé à côté du commutateur de Hub dans la barre supérieure unifiée. 
  2. Regardez le menu déroulant qui s'ouvre, et cliquez sur l'option "Assets". 

Les nœuds racine des assets qui ont été publiés ou activés s'affichent dans la liste déroulante.

Le nœud racine est le nœud de départ d'un chemin d'Assets. Le chemin peut être composé de plusieurs branches et nœuds qui mènent finalement aux assets ou aux attributs de la structure, par exemple la température ou la concentration. 

Cet Asset Browser se trouve également dans ContextHub et est mis à disposition lors de l'ajout d'un composant à un Context Item nouvellement créé ou à un filtre de vue contextuelle nouvellement créé. 

Structure des assets

Voici un exemple typique d'un arbre d'actifs dans TrendMiner :

  • Houston (asset du nœud racine)
    • Réacteur 1 (noeud standard sous-asset)
      • Concentration (attribut - nœud de feuille)
      • Température
      • Niveau

Importation en csv d'Asset Structure (option admin)

Si vous ne disposez pas d'un outil spécialisé comme OSIsoft PI AF, et que vous souhaitez mettre en place une structure d'Asset, vous pouvez utiliser l'importation CSV de la structure d'Asset intégrée dans ContextHub. Vous pouvez définir votre structure dans un fichier CSV prêt à l'emploi, disponible en téléchargement. 

  1. Sélectionnez ContextHub à l'aide du hubswitch
  2. Sélectionnez "Config".
  3. Sélectionnez "Asset Structure".
  4. Cliquez sur l'option "Add asset structure

blobid0.png

Un panneau latéral "Ajouter une Asset Structure" s'ouvre à droite de l'écran. Téléchargez le fichier d'exemple mis à disposition dans le panneau latéral.

blobid1.png

Voici un exemple de fichier, ouvert à l'aide d'un tableur :

blobid2.png

Règles générales pour la présentation de la structure en CSV

  • Le parent d'un nœud (ligne unique) doit être défini au-dessus de ses enfants
  • Le balisage du fichier exige que vous utilisiez le balisage CSV avec une virgule (,) comme séparateur et que toutes les valeurs soient facultativement citées par "
  • L'encodage doit être UTF-8

  • Le chemin est le chemin complet de l'Installation. Il doit inclure le nom. Et le nom doit être cohérent dans son utilisation. Cela signifie une orthographe et une casse cohérentes.

Mise à jour de l'Asset Structure du CSV

IMPORTANT !!! Depuis l'écran de configuration de la structure des Asset (ContextHub → Config → Asset structure), téléchargez votre structure d'Asset actuelle. De cette façon, votre liste d'assets et d'attributs aura une colonne appelée "id". Cet identifiant est l'identifiant unique de l'asset ou des attributs dans le système TrendMiner. Ainsi, nous saurons, lorsque vous mettrez à jour l'une des lignes de votre fichier csv, à quel Asset du système TrendMiner vous faites référence. La colonne source est également complétée maintenant.

Pour mettre à jour une ligne, assurez-vous que la colonne "id" de votre ligne est bien remplie. Vous pouvez modifier ici le chemin d'accès, le nom, la description, le type, le modèle et le Tags. La colonne source ne peut pas être mise à jour.

Remarque : Lorsque vous mettez à jour le nom d'un élément, vous devez également mettre à jour le chemin d'accès.

Pour les nouvelles entrées dans la structure, laissez le champ "id" vide. Dans le champ source, vous devez copier-coller l'identifiant de la source à partir des autres lignes. Cet identifiant est le même dans toutes les lignes et est unique pour chaque arbre d'actifs.

Pour supprimer des entrées, supprimez les lignes du fichier CSV afin de supprimer l'asset ou l'attribut de la structure d'asset de TrendMiner.

Colonnes obligatoires dans le fichier csv:

  • Chemin
  • Nom
  • Type (peut être ASSET (sans référence à des données de tag), ATTRIBUTE (avec référence à des données de tag).
  • Tag avec préfixe de l' historien (si type = ATTRIBUTE) (par exemple: [PI18]BA:LEVEL.1)
  • Source

Remarque : l'ID est obligatoire pour les mises à jour, sinon le programme tentera de créer l'installation et une erreur sera renvoyée : L'Installation avec le chemin {0} existe déjà avec l'ID {1}. Vous devez utiliser cet ID si vous voulez réactiver le noeud.

Remarque : Le préfixe n'est nécessaire que lorsque nous avons plusieurs historiens. S'il n'y en a qu'un, le préfixe n'est pas nécessaire.

Remarque : La source est obligatoire lors de la mise à jour. Lors de l'ajout d'une nouvelle Asset Structure, il est obligatoire d'être vide.

Une fois que votre fichier CSV a été rempli : 

  1. Indiquez un nom pour votre Asset Structure.
  2. Ajoutez le fichier en cliquant sur le bouton "Add attachment" dans le panneau latéral "Add asset structure". Sélectionnez le fichier. 
  3. Cliquez sur le bouton "Ajouter" à la base du panneau. Votre nouvelle Asset Structure est maintenant ajoutée au menu de votre Asset Structure dans le ContextHub. Vous recevrez une notification lorsque cela sera fait. S'il y a eu un problème avec le fichier, un fichier d'erreur sera généré avec des messages d'erreur pour des lignes spécifiques.
  4. Pour activer la nouvelle structure d'asset, cliquez sur le bouton "Publier la structure d'asset pour tous ceux qui ont des autorisations". 
  5. Cliquez sur le bouton d'enregistrement.

Maintenant publiée, votre nouvelle Asset Structure est disponible dans l'Asset Browser de la plate-forme lorsqu'elle est ouverte. Les Asset Structures non publiées ne sont disponibles que pour les administrateurs.

Remarque : plusieurs structures d'actifs téléchargées peuvent être publiées et rendues disponibles dans l'Asset Browser à tout moment. 

Pour reconfigurer votre Asset Structure : 

  1. Cliquez sur les trois points verticaux situés à droite de chaque ligne de la structure des assets dans le ContextHub. Un petit menu déroulant apparaît. 
  2. Sélectionnez "Configure asset structure". Un panneau latéral s'ouvre et fournit les détails en format CSV de votre Asset Structure.
  3. Cliquez sur la petite horloge située à droite du bouton "Télécharger". 

Un panel "Histoire" sera ouvert. Ce panneau affichera la liste des téléchargements pour cette Asset Structure, les heures associées aux téléchargements et si le téléchargement a été effectué avec succès. Les fichiers d'erreur peuvent être consultés ici. Vous pouvez fermer ce panneau en utilisant le bouton "Fermer l'historique" situé à la base du panneau.

Pour mettre à jour l'Asset Structure, il suffit de ;

  1. Modifiez le fichier CSV si nécessaire (voir ci-dessus).
  2. Ajoutez le fichier dans le panneau latéral via l'option "Ajouter une pièce jointe". 
  3. Cliquez sur le bouton "Enregistrer".

Modèles et recherche croisée basée sur la valeur des assets

Pour indiquer que les différents assets sont similaires et contiennent le même ensemble d'attributs, TrendMiner utilise des modèles dans l'Asset Structure.

Dans le fichier CSV, vous pouvez ajouter des modèles en les ajoutant dans la colonne "modèle". Cela les affiche à côté de vos assets dans l'Asset Browser et permet à nos recherches et algorithmes de donner de meilleurs résultats à l'avenir.

La recherche croisée basée sur la valeur des assets est une option de recherche de TrendMiner qui vous permet d'explorer des actifs et des attributs similaires prédéfinis dans le cadre d'un modèle. 

Après avoir défini vos modèles et regroupé vos assets et attributs dans la colonne du modèle, vous pourrez effectuer une recherche sur vos assets et attributs sous forme de groupes, par opposition à des ensembles de données individuels. 

L'image ci-dessous est un exemple de structure de fichier Asset qui contient le nom de modèle "BA Reactor". Ce modèle particulier regroupe les réacteurs 1, 2 et 3. Traditionnellement, la recherche basée sur la valeur vous permet d'enregistrer chaque recherche de réacteur pour une valeur particulière d'intérêt, pour ensuite comparer et contraster. Avec la recherche croisée basée sur la valeur des Asset, vous pouvez facilement rechercher toutes les données relatives aux réacteurs en vous assurant qu'au niveau de la description, vous regroupez chaque réacteur sous le modèle, dans ce cas, le réacteur BA.

Remarque : Le nom du modèle créé doit être cohérent dans son utilisation. Cela signifie une orthographe et une utilisation de la casse cohérentes.

blobid3.png