Cital Insights API - Entity-Relationship und UML-Diagramme

Haupt-Entitätstypen für die REST API

Wenn die REST API verwendet wird, gibt es verschiedene Entitätstypen, auf die der Benutzer stoßen kann.


Kunden - Der Kunde ist eine separate Geschäftseinheit: eine Person oder Organisation, die Geräte und/oder Vermögenswerte des Mieters verwendet. Der Kunde kann mehrere Benutzer und Millionen von Geräten und/oder Vermögenswerten haben.

Unterkunden - Analog zu Kunden, aber unter dem übergeordneten Kunden angeordnet. Kann auch Unterkunden und Benutzer haben (unendliche Multi-Tenancy).

Benutzer - Benutzer können Dashboards durchsuchen und Entitäten verwalten.

Vermögenswerte - Abstrakte IoT-Entitäten, die mit anderen Geräten und Vermögenswerten in Beziehung stehen können. Im Cital-Eco-System verwenden wir den Vermögenswert als Entitätstyp für Aktivierungs- und Metadatenobjekte.

Vermögenswertprofil - Jeder Vermögenswert hat ein Vermögenswertprofil. Dies definiert den Typ des Vermögenswerts. Zum Beispiel gehört jedes Metadatenobjekt (Vermögenswert) zu einer Metadatenkategorie (Vermögenswertprofil).

Entitätsansichten - Dies sind die Geräte, die den Kunden zur Verfügung gestellt werden. Sie bieten unterschiedliche Schlüssel je nach Sensortyp und Zeitfenster abhängig von der Abonnementperiode.


Jede Entität unterstützt:

Attribute - Dies sind Schlüssel-Wert-Paare, die mit Entitäten verknüpft sind. Zum Beispiel hat jedes Metadaten-Vermögensobjekt eine Seriennummer, ein Modell und eine Firmware-Version.

Zeitreihendaten - Zeitreihen-Datenpunkte, die für Speicherung, Abfrage und Visualisierung verfügbar sind. Zum Beispiel Temperatur, Luftfeuchtigkeit und Batteriestand.

Beziehungen - gerichtete Verbindungen zu anderen Entitäten. Zum Beispiel enthält, verwaltet, besitzt und produziert.


ER-Diagramm

Dieses Diagramm zeigt die relevantesten Entitätstypen, ihre Attribute und Identifikationsmerkmale im Cital-Eco-System.

 


Bitte beachte, dass wir Attribute und Objekte weggelassen haben, die für Kunden nicht relevant sind, um das Risiko von Verwirrung zu verringern und den Einstieg in dieses Entitätsmodell zu erleichtern.


UML-Flussdiagramm

Dieses Diagramm zeigt den Fluss der Entitätstypen und wie jeder Entitätstyp im Cital-Eco-System mit einem anderen verbunden ist.

Bitte beachte, dass wir Attribute und Objekte weggelassen haben, die für Kunden nicht relevant sind, um das Risiko von Verwirrung zu verringern und den Einstieg in dieses Entitätsmodell zu erleichtern.

 



Das Diagramm zeigt die Beziehungen zwischen den Customer, Child_customer, User, Asset, Entity_view, Entity_relation, and Timeseries_data and attributes -Entitäten.


Jede Customer entity steht mit vielen User entities in Beziehung, und jede User entity steht mit vielen Asset und Entity_view entities in Beziehung. Darüber hinaus kann jede Customer entity viele Child_customer entities haben, die ebenfalls mit vielen User entities in Beziehung stehen.


Die Asset und Entity_view entities stehen über die Entity_relation entity miteinander in Beziehung, die die Beziehung zwischen einem Asset und einer Entity_view entity darstellt. Eine Entity_relation entity kann mit vielen Asset entities in Beziehung stehen, aber jeder Asset kann nur mit einer Entity_relation entity in Beziehung stehen.


Schließlich stehen die Entity_view und die Timeseries_data und Attributes in Beziehung, die die Zeitreihendaten und Attribute darstellen, die mit einer Entity_view verbunden sind. Die Entity_view kann mit vielen Timeseries_data und Attributes verknüpft sein.


Basierend auf diesem Diagramm können wir Beziehungen sehen, die wir in solchen Szenarien verwenden können:


Arbeiten mit Aktivierungsvermögenswerten: Benutzer können ihre Aktivierungsvermögenswerte finden und mithilfe der Entitätsbeziehung Entitätsansichten erhalten, die mit diesen Aktivierungen zusammenhängen.


Abrufen von Zeitreihendaten und Attributen: Der Benutzer kann eine Entitätsansicht finden und die Entitätsansichts-ID verwenden, um Zeitreihendaten abzurufen.

Have a question?