ContextHub - Anforderungen an den Import von Asset-Strukturen

Der Asset-Baum

Ihren Asset-Baum finden Sie im Asset-Browser auf TrendHub.  

1. Wählen Sie das Tags-Symbol und klicken Sie auf die Schaltfläche "Tags & Attribute suchen", die sich neben dem Hub-Schalter in der vereinheitlichten oberen Leiste befindet.  
2. Schauen Sie auf das Dropdown-Menü, das sich öffnet, und klicken Sie auf die Option "Assets".  

Die Asset-Root-Nodes, die veröffentlicht oder aktiviert wurden, werden in der Dropdown-Liste angezeigt.

Der Root Node ist der Startknoten eines Asset-Pfads. Der Pfad kann aus vielen Zweigen und Knoten bestehen, der schließlich zu den Assets oder Attributen der Struktur führt, z. B. Temperatur oder Konzentration.  

Dieser Asset-Browser befindet sich ebenfalls in ContextHub und wird verfügbar gemacht, wenn eine Komponente zu einem neu erstellten Context Item oder einem neu erstellten Context View Filter hinzugefügt wird.  

Asset Structure

Im Folgenden finden Sie ein typisches Beispiel für einen Asset-Baum in TrendMiner:

• Houston (Root-Node-Asset)
  • Reaktor 1 (Standard Node Sub-Asset)
    • Konzentration (Attribut - Leaf Node)
    • Temperatur
    • Ebene

Asset Structure csv-Import (Admin-Option)

Wenn Sie über kein spezialisiertes Tool wie OSIsoft PI AF verfügen und eine Anlagenstruktur einrichten möchten, können Sie den eingebauten CSV-Import der Anlagenstruktur innerhalb von ContextHub verwenden. Sie können Ihre Struktur in einer fertigen CSV-Datei definieren, die Sie herunterladen können.  

1. Wählen Sie ContextHub mit dem Hub-Schalter
2. Wählen Sie "Konfig".
3. Wählen Sie "Asset Structure".
4. Klicken Sie auf die Option Anlagenstruktur hinzufügen

Ein Seitenpanel "Asset Structure hinzufügen" öffnet sich auf der rechten Seite des Bildschirms. Laden Sie die im Seitenfenster zur Verfügung gestellte Beispieldatei herunter.

Im Folgenden finden Sie die Beispieldatei, die mit einem Tabellenkalkulationsprogramm geöffnet wurde:

Allgemeine Regeln beim Aufbau der Struktur in CSV

• Der Vorläufer eines Knotens (einzelne Zeile) sollte über seinen Nachfolgern definiert werden
• Das Markup der Datei erfordert, dass Sie das CSV-Markup mit einem Komma (,) als Trennzeichen verwenden und alle Werte optional mit "
• Die Kodierung muss UTF-8 sein.
• Der Pfad ist der vollständige Pfad des Assets. Er muss den Namen enthalten. Und der Name muss konsistent verwendet werden. Das bedeutet eine konsistente Schreibweise und Groß-/Kleinschreibung.

Aktualisieren der CSV-Asset Structure

WICHTIG!!! Laden Sie von der Konfigurationsseite der Anlagenstruktur (ContextHub → Konfig → Asset Structure) Ihre aktuelle Anlagenstruktur herunter. Auf diese Weise wird Ihre Liste der Assets und Attribute eine Spalte namens "id" haben. Diese ID ist die eindeutige Kennung des Assets oder der Attribute im TrendMiner-System. Auf diese Weise wissen wir, wenn Sie eine der Zeilen in Ihrer csv-Datei aktualisieren, auf welches Asset im TrendMiner-System Sie sich beziehen. Auch die Ausgangsspalte ist jetzt ausgefüllt.

Um eine Zeile zu aktualisieren, stellen Sie sicher, dass die 'ID'-Spalte Ihrer Zeile ausgefüllt ist. Hier können Sie Pfad, Name, Beschreibung, Typ, Vorlage und Tag bearbeiten. Die Ausgangsspalte kann nicht aktualisiert werden.

Hinweis: Wenn Sie den Namen eines Elements aktualisieren, müssen Sie auch den Pfad aktualisieren.

Bei neuen Einträgen in der Struktur lassen Sie das Feld 'ID' leer. Im Feld "Quelle" müssen Sie die Quell-ID aus den anderen Zeilen kopieren und einfügen. Diese ID ist in allen Zeilen gleich und pro Anlagenbaum eindeutig.

Um Einträge zu löschen, entfernen Sie die Zeilen aus der CSV-Datei, um das Asset oder Attribut aus der TrendMiner-Asset-Struktur zu löschen.

Obligatorische Spalten in der csv-Datei:

• Pfad
• Name 
• Type (kann ASSET sein (kein Tag-Datenbezug), ATTRIBUTE (mit Tag-Datenbezug)
• Tag mit historian-Präfix (wenn type = ATTRIBUTE) (eg: [PI18]BA:LEVEL.1)
• Quelle

Hinweis: Die ID ist für Aktualisierungen obligatorisch, andernfalls wird versucht, das Asset zu erstellen, und es wird ein Fehler zurückgegeben: Asset mit Pfad {0} existiert bereits mit ID {1}. Sie müssen diese ID verwenden, wenn Sie den Knoten wieder aktivieren wollen. 

Hinweis: Das Präfix wird nur benötigt, wenn wir mehrere Historians haben. Wenn es nur einen gibt, wird das Präfix nicht benötigt.

Hinweis: Die Quelle ist bei der Aktualisierung obligatorisch. Wenn eine neue Asset Structure hinzugefügt wird, muss sie unbedingt leer sein.

Sobald Ihre CSV-Datei ausgefüllt wurde:

1. Geben Sie einen Namen für Ihre Asset Structure ein.
2. Fügen Sie die Datei hinzu, indem Sie auf die Schaltfläche "Anhang hinzufügen" im Seitenfeld "Asset Structure hinzufügen" klicken. Wählen Sie die Datei aus.  
3. Klicken Sie auf die Schaltfläche "Hinzufügen" am unteren Rand des Panels. Ihre neue Asset Structure wird nun zu Ihrem Asset Structure-Menü im ContextHub hinzugefügt. Sie erhalten eine Benachrichtigung, wenn es fertig ist. Wenn mit der Datei etwas nicht in Ordnung war, wird eine Fehlerdatei mit Fehlermeldungen für bestimmte Zeilen erzeugt.
4. Um die neu hochgeladene Asset Structure zu aktivieren, klicken Sie auf den Schalter "Asset Structure für alle Berechtigten veröffentlichen".  
5. Klicken Sie auf die Schaltfläche "Speichern".

Jetzt veröffentlicht, ist Ihre neue Asset Structure beim Öffnen im Asset-Browser der Plattform verfügbar. Unveröffentlichte Asset Structures sind nur für Admins verfügbar.

Hinweis: Mehrere hochgeladene Asset Structures können jederzeit veröffentlicht und im Asset-Browser verfügbar gemacht werden.  

So re-konfigurieren Sie Ihre Asset Structure:

1. Klicken Sie im ContextHub auf die drei vertikalen Punkte, die sich rechts von jeder Asset Structure-Zeile befinden. Ein kleines Dropdown-Menü erscheint.  
2. Wählen Sie "Asset Structure konfigurieren". Es öffnet sich ein Seitenfenster mit den CSV-Details Ihrer Asset Structure.
3. Klicken Sie auf die kleine Uhr rechts neben der Schaltfläche "Download".  

Ein Panel "Geschichte" wird geöffnet. Dieses Panel listet die Uploads für diese Asset Structure auf, die zugehörigen Upload-Zeiten und ob sie erfolgreich hochgeladen wurde. Fehlerdateien können hier eingesehen werden. Sie können dieses Panel mit der Schaltfläche "Historie schließen" am unteren Rand des Panels schließen.

Um die Asset Structure zu aktualisieren:

1. Ändern Sie die CSV-Datei nach Bedarf (siehe oben).
2. Fügen Sie die Datei über die Option "Anhang hinzufügen" zum Seitenbereich hinzu.  
3. Klicken Sie auf die Schaltfläche "Speichern".

Vorlagen und die Suche Anlagenübergreifend nach Wertebereichen

Um anzuzeigen, dass verschiedene Assets ähnlich sind und denselben Satz von Attributen enthalten, verwendet TrendMiner Vorlagen in der Asset Structure.

In der CSV-Datei können Sie Vorlagen hinzufügen, indem Sie sie in der Spalte 'Vorlage' hinzufügen. Dadurch werden sie im Asset-Browser neben Ihren Assets angezeigt und helfen unseren Suchvorgängen und Algorithmen, in Zukunft bessere Ergebnisse zu erzielen.

Die Suche Anlagenübergreifend nach Wertebereichen ist eine TrendMiner-Suchoption, mit der Sie ähnliche Assets und Attribute durchsuchen können, die als Teil einer Vorlage vordefiniert sind.  

Nachdem Sie Ihre Vorlagen definiert und Ihre Assets und Attribute in der Vorlagenspalte gruppiert haben, können Sie Ihre Assets und Attribute in Form von Gruppen zu durchsuchen, im Gegensatz zu einzelnen Datensätzen.  

Das Bild unten ist ein Beispiel für eine Asset Structure-Datei, die den Vorlagennamen "BA Reaktor" enthält. Diese spezielle Vorlage gruppiert die Reaktoren 1, 2 und 3. Traditionell müssten Sie bei der wertbasierten Suche jede einzelne Suche der reaktoren nach einem bestimmten Wert speichern, um sie dann zu vergleichen und gegenüberzustellen. Mit der anlagenwertübergreifenden Suche können Sie leicht alle Reaktordaten durchsuchen, indem Sie auf der Beschreibungsebene sicherstellen, dass Sie jeden Reaktor unter der Vorlage gruppieren, in diesem Fall den BA-Reaktor.

Hinweis: Der erstellte Vorlagenname muss in seiner Verwendung konsistent sein. Dies bedeutet konsistente Schreibweise und Groß-/Kleinschreibung.