L'arbre d'assets
Votre arbre d'assets se trouve dans l'Asset Browser sur TrendHub.
- 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.
- 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
-
Réacteur 1 (noeud standard sous-asset)
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.
- Sélectionnez ContextHub à l'aide du hubswitch
- Sélectionnez "Config".
- Sélectionnez "Asset Structure".
- Cliquez sur l'option "Add asset structure
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.
Voici un exemple de fichier, ouvert à l'aide d'un tableur :
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.
- Lors du téléchargement d'une structure AF entièrement nouvelle, le champ source doit être vide. Vous constaterez qu'après le téléchargement initial et lorsque l'arbre AF est créé, le champ source sera automatiquement rempli lors du téléchargement de la structure AF. Vous trouverez plus de détails dans la section "Mise à jour de la structure AF CSV".
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: Il s'agit de l'identifiant de l'arbre csv de l'actif. Il doit être présent sur chaque ligne
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 :
- Indiquez un nom pour votre Asset Structure.
- Ajoutez le fichier en cliquant sur le bouton "Add attachment" dans le panneau latéral "Add asset structure". Sélectionnez le fichier.
- 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.
- Pour activer la nouvelle structure d'asset, cliquez sur le bouton "Publier la structure d'asset pour tous ceux qui ont des autorisations".
- 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 :
- 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.
- Sélectionnez "Configure asset structure". Un panneau latéral s'ouvre et fournit les détails en format CSV de votre Asset Structure.
- 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 ;
- Modifiez le fichier CSV si nécessaire (voir ci-dessus).
- Ajoutez le fichier dans le panneau latéral via l'option "Ajouter une pièce jointe".
- 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.
Constructeur de l'Arbre des installations - À partir de 2023.R1.0
Le constructeur d'arbre des installations, qui fait partie du Digital Twin Manager, offre une fonctionnalité permettant de construire des nouvelles hiérarchies des installations ou de modifier celles qui existent déjà (importées par un CSV) dans TrendMiner. Vous pouvez le trouver dans la Configuration de la plate-forme -> Structure des installations -> Ajouter une structure des installations et ensuite sous "Configurer via" en sélectionnant l'option "Créateur d'arbre des installations".
Sélectionnez ensuite un nom pour la structure des installations que vous voulez construire et appuyez sur "Continuer".
Dans le "Créateur d'Arbre des Installations", vous pouvez configurer vos propres structures des installations, à l'intérieur de TrendMiner. Vous pouvez commencer par ajouter un nœud, ce qui se fait en entrant un nom de nœud et en cliquant sur le bouton plus.
Une fois fait, un nouveau nœud devrait apparaître comme indiqué ci-dessous.
Les données de séries temporelles peuvent être attachées à un nœud. Pour ce faire, utilisez la barre de recherche sur le côté droit pour trouver l'entité de série temporelle souhaitée, puis faites-la glisser sur un nœud spécifié. Une seule entité de série temporelle peut être attachée à un nœud.
Un noeud peut avoir une "Description", qui peut être ajoutée en cliquant sur l'espace réservé à la description, situé juste en dessous du nom du noeud.
Opérations avec un nœud :
DÉPLACER
Lorsque vous cliquez sur le bouton de déplacement, vous déplacez le nœud vers un nœud sélectionné dans la structure des installations.
Après avoir cliqué sur le bouton "Déplacer", un panneau de navigation latéral, dans lequel vous pouvez visualiser la structure des installations et sélectionner un nœud vers lequel vous souhaitez vous déplacer, apparaîtra.
Remarque : toute structure enfant associée au nœud initialement sélectionné sera conservée.
Comme dans l'exemple ci-dessous, le nœud portant le nom "Nœud enfant du nœud enfant" a été déplacé du statut de nœud enfant du nœud portant le nom "Nœud enfant" au nœud portant le nom "Nœud enfant du nœud enfant 2".
Remarque : vous ne pouvez pas déplacer un nœud sur lui-même.
SUPPRIMER
Supprimez un noeud sélectionné et tous ses descendants ou choisissez de supprimer le noeud spécifié et de déplacer tous ses descendants sur le niveau actuel. La structure des descendants sera préservée.
Si vous choisissez de "Supprimer le nœud et déplacer les descendants ici", vous obtiendrez une structure des installations comme celle présentée ci-dessous :
Si vous choisissez de supprimer le nœud et tous ses descendants, vous verrez ce qui suit:
Remarque : Le nœud racine ne peut pas être supprimé.
ALLER UN NIVEAU PLUS PROFOND
Naviguez un niveau plus profond dans la hiérarchie des Installations, en cliquant sur le bouton du curseur droit sur un nœud d'intérêt :
Remarque : le Créateur d'arbres des installations peut être utilisé pour modifier des structures des installations CSV déjà importées. Vous pouvez utiliser cette fonction en sélectionnant "Modifier la structure des installations" sur une installation existante.
Remarque : Les modifications apportées à la hiérarchie des installations sont enregistrées automatiquement.