ContextHub - Rahmenwerk für mehrere Anlagen

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.
• Wenn Sie eine völlig neue AF-Struktur hochladen, muss das Quellfeld leer sein. Sie werden sehen, dass nach dem ersten Hochladen und bei der Erstellung des AF-Baums das Quellfeld automatisch ausgefüllt wird, wenn Sie die AF-Struktur herunterladen. Weitere Details finden Sie im Abschnitt "Aktualisieren der CSV-Assetstruktur".

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: Dies ist der Bezeichner der Asset-CSV-Struktur. Er muss in jeder Zeile vorhanden sein

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.

Asset-Baum Ersteller - Ab 2023.R1.0

Der Asset-Baum Ersteller, Teil des Digital Twin Managers, bietet die Möglichkeit, neue Asset-Hierarchien in TrendMiner zu erstellen oder bestehende (per CSV importierte) zu bearbeiten. Sie finden ihn unter Plattformkonfiguration -> Asset-Struktur -> Asset-Struktur hinzufügen und wählen dann unter "Konfigurieren über" die Option "Asset-Baum Ersteller".   

Wählen Sie dann einen Namen für die Asset-Struktur, die Sie erstellen möchten, und klicken Sie auf "Weiter". 

Mit dem "Asset-Baum Ersteller" können Sie Ihre eigenen Asset-Strukturen in TrendMiner konfigurieren. Beginnen Sie mit dem Hinzufügen eines Knotens, indem Sie einen Knotennamen eingeben und auf die Plus-Schaltfläche klicken.

Sobald Sie dies getan haben, sollte ein neuer Knoten erscheinen, wie unten gezeigt. 

Zeitreihendaten können an einen Knoten angehängt werden. Verwenden Sie dazu die Suchleiste auf der rechten Seite, um die gewünschte Zeitreiheneinheit zu finden, und ziehen Sie sie dann per Drag & Drop auf einen bestimmten Knoten. Einem Knoten kann nur eine Zeitreiheneinheit zugeordnet werden.

Ein Knoten kann eine "Beschreibung" haben, die Sie hinzufügen können, indem Sie auf den Platzhalter für die Beschreibung klicken, der sich direkt unter dem Namen des Knotens befindet. 

Operationen mit einem Knoten:

VERSCHIEBEN
Wenn Sie auf die Schaltfläche “Verschieben” klicken, verschieben Sie den Knoten auf einen ausgewählten Knoten in der Asset Struktur. 

Nachdem Sie auf die Schaltfläche "Verschieben" geklickt haben, wird ein seitlicher Navigationsbereich angezeigt, in dem Sie die Asset Struktur einsehen und einen Knoten auswählen können, den Sie verschieben möchten. 

Hinweis: Alle untergeordneten Strukturen, die mit dem ursprünglich ausgewählten Knoten verbunden sind, werden beibehalten. 

Wie im Beispiel unten wurde der Knoten mit dem Namen "Untergeordneter Knoten des untergeordneten Knotens" von einem untergeordneter Knoten des Knotens mit dem Namen "Untergeordneter Knoten" zu einem Knoten mit dem Namen "Untergeordneter Knoten des untergeordneten Knoten 2" verschoben. 

Hinweis: Sie können einen Knoten nicht auf sich selbst verschieben.

LÖSCHEN
Löschen Sie einen ausgewählten Knoten und alle seine Nachfolger oder wählen Sie, den angegebenen Knoten zu löschen und alle seine Nachfolger auf die aktuelle Ebene zu verschieben. Die Struktur der Nachfolger bleibt dabei erhalten. 

Wenn Sie die Option "Knoten löschen und Nachfolger hierher verschieben" wählen, erhalten Sie eine Asset-Struktur wie unten dargestellt: 

Wenn Sie den Knoten und alle seine Nachfolger löschen möchten, sehen Sie Folgendes: 

Hinweis: Der Stammknoten kann nicht gelöscht werden. 

EINE EBENE TIEFER NAVIGIEREN 
Navigieren Sie eine Ebene tiefer in der Asset-Hierarchie, indem Sie mit der rechten Maustaste auf einen Knoten von Interesse klicken: 

Hinweis: Mit dem Asset-Baum-Ersteller können Sie bereits importierte CSV-Asset-Strukturen bearbeiten. Sie können diese Funktion nutzen, indem Sie "Asset-Struktur bearbeiten" auf einer bestehenden Asset-Struktur wählen. 

Hinweis: Die an der Asset-Hierarchie vorgenommenen Änderungen werden automatisch gespeichert.