Dieses Kapitel enthält eine Sammlung von Konzepten, die in den Building X-Apps verwendet werden.

Firma

Eine Firma bildet die oberste Einheit, z.B. Siemens. Sie beinhaltet mehrere Abos, die wiederum in Partitionen unterteilt sind. Eine Firma kann mehrere Orte haben, die als Campus mit mehreren Gebäuden oder als autonome Gebäuden modelliert werden. Die Mitgliedschaft eines Benutzenden in einer oder mehreren Benutzergruppen einer Firma mit Zugriff auf eine oder mehrere Partitionen ist erforderlich, um die Building X-Apps nutzen zu können.

Abo

Ein Abo ist eine vertragliche Vereinbarung zur Nutzung von 1...n erwerbbaren Building X-Apps. Das Abo ermöglicht den Zugriff auf eine Reihe von Apps, die auf einen bestimmten Anwendungsfall zugeschnitten sind. Alle Abos ermöglichen den Zugriff auf die drei Plattform-Apps: Accounts, Devices und Data Setup.

Partitionen

Partitionen sind logische Gruppierungen von Daten innerhalb eines Abos einer Firma. Partitionen ermöglichen differenzierte Zugriffsrechte auf verschiedene Datencluster für denselben Benutzer in derselben Firma.

Beispiel:

  • Die Firma ABC besteht aus Abo A und Abo B.
  • Abo A wurde in Partition A1 und Partition A2 aufgeteilt.
  • Abo B wurde in Partition B1, Partition B2 und Partition B3 aufgeteilt.

Ein Benutzer U1 erhält die Mitgliedschaft in Benutzergruppen mit erweitertem Rollenzugriff (Lesen und Schreiben) auf die Partitionen A1 und B1 und einfachem Rollenzugriff (nur Lesen) auf die Partitionen A2 und B2. Benutzer U1 erhält keinen Zugriff auf Partition B3.

Folglich kann der Benutzer U1 die Daten von Partition A1 und B1 vollständig einsehen und bearbeiten, während er die Daten von Partition A2 und B2 nur einsehen und auf die Daten von Partition B3 nicht zugreifen kann.

Standardpartition übergeben

Auf der Standardpartition werden alle Regeln und die Instanz der Rule-Engine ausgeführt. Falls Sie eine Standardpartition übergeben, gehen die Regeln verloren. Sie haben jedoch weiterhin Zugriff auf die App Rules und können neue Regeln erstellen.

Die Übergabe einer Standardpartition führt dazu, dass die in der Standardpartition erstellten Regeln verloren gehen.

Rollen

Benutzerrollen bestehen aus vordefinierten Berechtigungen für eine bestimmte App. In Building X gibt es drei Arten von Rollen: Systemrollen, Plattformrollen und App-spezifische Rollen. Die Systemrollen gewähren Zugriff auf die komplexen Funktionen der App Accounts; die beiden Plattformrollen gewähren Zugriff auf die Funktionen der Plattform-Apps Devices und Data Setup und sind auf einen bestimmten Anwendungsfall ausgerichtet, beispielsweise einen Application Engineer. Um Zugriff auf die Funktionen der anderen Apps eines Abos zu gewähren, ist eine App-spezifische Benutzerrolle erforderlich. Die meisten Apps verfügen über drei Berechtigungsstufen: Basic, Standard und Advanced. Benutzerrollen können Benutzenden nicht direkt zugewiesen werden, sondern werden durch die Erstellung von Benutzergruppen für jede der verfügbaren Benutzerrollen verwaltet.

Benutzergruppen

Benutzergruppen gewähren Zugriff auf einen Bereich einer Firma und weisen den Benutzern in der Benutzergruppe gleichzeitig eine bestimmte Berechtigungsstufe zu. Eine Benutzergruppe kann Zugriff auf mehrere Partitionen gewähren, kann aber nur eine Benutzerrolle enthalten. Um Benutzenden mehrere Benutzerrollen zuzuweisen, müssen die Benutzenden den entsprechenden Benutzergruppen hinzugefügt werden. Benutzende benötigen beispielsweise sowohl die Plattformrolle Application Engineer als auch die Benutzerrolle Operations Manager – Advanced für eine Partition der Firma. Diese Benutzenden müssen Mitglieder zweier Benutzergruppen sein, die über diese Rollen verfügen und Zugriff auf dieselbe Partition gewähren.

Benutzer

Ein Benutzer ist eine Person, die Mitglied mindestens einer Firma ist und Zugriff auf mindestens eine Partition hat. Ein Benutzer benötigt ein Konto, um Building X-Apps aufrufen zu können. Der Zugriff kann entweder durch den Customer Administrator einer Firma oder durch Siemens oder einen Dritten auf Anfrage und Genehmigung der Kundschaft gewährt werden.

Machine User

Machine User sind virtuelle Benutzende, die eine bestimmte Reihe von Aktionen im Hintergrund ausführen können. Für Machine User steht eine Reihe von Machine User-Rollen zur Verfügung. Um Machine User Zugriff auf eine Partition zu gewähren, müssen Machine User Mitglieder einer Benutzergruppe mit der erforderlichen Machine User-Rolle und Zugriff auf die erforderliche Partition sein.

Standorte

Ein Standort ist eine Darstellung der Firma mit einer realen Adresse. Ein Standort kann entweder ein einzelnes Gebäude oder ein Campus mit mehreren Gebäuden sein. Eine Firma und eine Partition können mehrere Standorte haben. Wenn ein Campus einer Partition hinzugefügt wird, sind alle Gebäude innerhalb dieses Campus Teil der gewählten Partition.

Siemens-ID-Konto

Für den Zugriff auf Building X-Apps ist ein Siemens-ID-Benutzerkonto erforderlich. Benutzende können ein neues Siemens ID-Konto erstellen, nachdem sie zu einer Firma eingeladen wurden. Bei der ersten Anmeldung muss der neue Benutzer ein Konto im Siemens ID Self Service Portal erstellen. Nach der Registrierung kann der Benutzende auf Mein Konto in der App Accounts zugreifen, um die verfügbaren Mitgliedschaften zu sehen und die Benachrichtigungseinstellungen einzurichten.

Flow Editor

Der Flow Editor basiert auf der Bedienoberfläche Node-RED. Weitere Informationen zu grundlegenden Konzepten wie Nodes, Flows und Wires finden Sie im Benutzerhandbuch von Node-RED: https://nodered.org/docs/user-guide/concepts

Im Flow Editor ist ein Satz spezifischer Nodes (Knoten) verfügbar, die mit dem Abo verknüpft sind, zum Beispiel benutzerdefinierte Nodes für Building X. Weitere Informationen zu Nodes finden Sie unter: Building X-Nodes.

Flow

Ein Flow wird im Flow Editor definiert. Für jeden Flow können Nodes ausgewählt und in der erforderlichen Reihenfolge verbunden werden. Der Flow definiert, welche Daten verwendet werden und wie sie verarbeitet werden. Für jede Regel kann nur ein Flow erstellt werden.

Regeln

Eine Regel ist eine definierte Geschäftslogik darüber, wie Daten aus Building X erfasst und verarbeitet werden, um neue Informationen und weitere Einblicke zu gewinnen, die dann von anderen Building X-Diensten oder -Applikationen genutzt werden können. Regeln werden für einen oder mehrere Einrichtungstypen erstellt. Eine Regel verarbeitet Daten aus verschiedenen Quellen und kombiniert sie, um neue Informationen und Einblicke für andere Applikationen zu liefern.

In der App Rules (Regeln) gibt es verschiedene Stufen von Regeln:

  • Die Firmen-Bibliothek ist ein Katalog mit allgemeinen Regeln, die Partitionen zugewiesen und mit Assets verknüpft werden können.
  • Die Partitions-Bibliothek ist ein Katalog mit allen Regeln, die einer bestimmten Partition zugewiesen sind. In der Partitions-Bibliothek können Regeln mit Assets verknüpft und für alle verknüpften Assets geplant werden.
  • Asset-Regeln zeigt alle Paare aus Regel und Asset an, die nach dem Verknüpfen von Partitionsregeln mit Assets erstellt wurden. Hier können Benutzer die Eingangsparameter der Regeln an bestimmte Asset-Charakteristiken anpassen, die Ausführung der Regel-Asset-Paare manuell auslösen oder planen und die Resultate der Regelausführung anzeigen.

Abhängig von Ihrem Abo und Ihrer Benutzerrolle können Sie auf die Firmen-Bibliothek zugreifen und Ihren eigenen Partitionen oder Partitionen von anderen Firmen, die mit Ihnen geteilt wurden, eine Regel zuweisen.