Cockpit

Überblick

Die Cockpit-Anwendung bietet Ihnen Optionen, um Internet der Dinge (IoT) Assets und Geschäftsdaten zu verwalten. In diesem Handbuch zeigen wir Ihnen, wie Sie:

Weitere Informationen zur Cockpit-Anwendung finden Sie in der folgenden Einführung.

Einführung

Das Cumulocity Cockpit kann in vielen Industriebereichen eingesetzt werden, einschließlich:

  • Zustandsüberwachung

  • Alarmüberwachung und Eskalation

  • Gebäude-Asset-Monitoring

  • Energieverbrauch von Fabriken und Geräten

  • Überwachung von Sensordaten

Im folgenden Abschnitt wird die Cockpit-Anwendung beschrieben. Sie bietet viel Funktionalität:

  • Daten-Explorer: IoT-Daten interaktiv erforschen, vergleichen und visualisieren.

  • Dashboards: Erstellen Sie eigene Analysen und Monitor-Seiten, indem Sie Widgets auswählen und anordnen. Wählen Sie aus verschiedenen Widgets, einschließlich Karten, Tabellen, Grafiken, Diagramme, Steuerelemente und mehr.

  • Smart Rule Baukasten: Erstellen Sie Verarbeitungs-Regeln für generierte Daten.

  • Geschäfts-Regel Paket: Verwenden Sie vordefinierte Geschäftsregeln für Geofencing, Schwellenwerte oder Alarm-Eskalationen und Benachrichtigungen als (SMS / E-Mail / Sprache).

  • Berichte: Erstellen Sie Berichte mit integrierten Dashboard und verschicken Sie sie per Email.

  • Asset Management: Organisieren Sie Assets in Hierarchien.

  • Alarme verwalten: Überwachen Sie die Probleme Ihres Assets anhand von Schweregraden und Arbeitsabläufen.

  • Datenpunktbibliothek: Verwalten Sie die Standardeinstellungen ("Profile") Ihrer Geräte und übernehmen Sie diese automatisch mit Hilfe der "Datenpunktbibliothek".

Konzepte

Die wichtigsten Konzepte der Cockpit-Anwendung sind:

Asset: Ein Asset repräsentiert ein Objekt wie Gebäude, Maschinen oder Autos.

Asset Hierarchie: Die Assets sind hierarchisch (wie Bäume) organisiert. Die Verzweigungen des Baums repräsentieren Gruppen und die Blätter des Baums repräsentieren die einzelnden Geräte.

Gruppe: Eine Gruppe ist eine Möglichkeit, Geräte und Assets in einer Asset-Hierarchie zu organisieren. Eine Gruppe kann ein oder mehrere Geräte, untergeordnete (Kind)Geräte oder andere Gruppen enthalten.

Gerät: Ein IoT-Gerät kann entweder ein Gateway-Gerät oder ein über ein Gateway (wie Modbus oder KNX-Gerät) indirekt verbundenes Gerät oder ein Sensor sein.

Datenpunkt: Sie repräsentieren Sensordaten, wie Temperatur-Zeitreihen. In anderen Teilen von Cumulocity werden sie Messungen genannt. Andere Begriffe sind Zeitreihen oder Variablen. Sie sind immer Sensor erzeugte Daten.

Datenpunkt Eigenschaften: Metadaten für einen Datenpunkt, die zusätzliche Eigenschaften darstellen, die vom Benutzer wie ein Label, Min / Max-Werte, Schwellenwerte oder andere hinzugefügt werden.

Dashboard: Eine benutzerdefinierte Seite mit einzelnen Inhalten aus verschiedenen Widgets.

Bericht: Ähnlich wie Dashboards, aber mit analytischem Inhalt, der auf einem begrenzten Zeitrahmen oder Umfang der Arbeit basiert.

Smart Rules: Cumulocity-Geschäftsregeln sind Instanzen aus einer intelligenten Regelvorlage, die den Smart Rule Builder verwendet.

Cumulocity Anwendungen

Die Cockpit Anwendung basiert auf dem Cumulocity Anwendungs- framwork. Mehr zu den folgenden Dingen finden Sie auch hier:"Einführung":

  • Welche Webbrowser werden unterstützt?
  • Wie melde ich mich bei Cumulocity an?
  • Wie navigiere ich? Wie in die Anwendung verlinken? Wie benutzt man Cumulocity auf Touchgeräten?
  • Benutzeroberflächenkonventionen

Der Anfang mit Cumulocity Cockpit

Willkommen Seite

Die Willkommensseite wird geöffnet, sobald Sie sich bei Cumulocity Cockpit anmelden.

image alt text

Die Willkommensseite zeigt die folgenden Abschnitte:

  • Eine Begrüßung mit der Anzahl der angeschlossenen Geräte (oder Assets).

  • Eine Linkliste.

  • Eine Liste der verfügbaren Anwendungen

  • Eine Liste von Nachrichten basierend auf dem Cumulocity-Twitter. Hinweis: Dies ist nur für Mandanten, die von www.cumulocity.com gehostet werden, verfügbar.

  • Ein Link zu verschiedenen Teilen der Dokumentation.

Ausblenden der Willkommensseite

Klicken Sie hierzu oben rechts auf "Beim Starten nicht anzeigen".

Willkommensseite als Standard wiederherstellen

Um die Willkommensseite wiederherzustellen, wählen Sie im Navigator links oben "Willkommen". Deaktivieren Sie dann "Beim Start nicht anzeigen".

Home Dashboard

Die Cockpit-Startseite ist eine Dashboard-Seite:

image alt text

Das Dashboard zeigt Daten für den Mandanten an. Das Home-Dashboard ist eine Seite, die von allen Benutzern des Mandanten gemeinsam genutzt wird. Sie besteht aus Widgets, die IoT-Daten visualisieren. Standardmäßig enthält das Home-Dashboard fünf Widgets, die einen Begrüßungstext, eine Zusammenfassung der verfügbaren Objekte, Assets mit Alarmen, neue Alarme und eine Karte aller Objekte anzeigen.

Das Home-Dashboard kann ähnlich wie andere Cockpit-Dashboards bearbeitet werden: Sie können die angezeigten Widgets hinzufügen, entfernen oder ändern. Verwenden Sie das Einstellungssymbol (drei Punkte untereinander)oben rechts oder bewegen Sie den Cursor innerhalb eines Widgets und verwenden Sie das Einstellungssymbol des individuellen Widgets.

Weitere Informationen hierzu finden Sie unter "Bearbeiten eines Dashboards" weiter unten.

Um das Dashboard auf den ursprünglichen Inhalt zurückzusetzen, verwenden Sie den Menüpunkt "Standard-Dashboard zurücksetzen" aus dem Zahnrad-Symbol.

Geräte verbinden

Um die Cockpit-Anwendung zu verwenden, müssen Sie IoT-Geräte anschließen. Geräte werden im Device Management angeschlossen. Wechseln Sie mit dem Application Switcher rechts oben in das "Device Management" und wählen Sie dann "Registrierung".

Hier nochmal die Details: Device Management User Guide. Logout menu

Asset Management

Ein Asset repräsentiert das Business-Objekt im Allgemeinen wie Gebäude, Maschinen, Produktionseinheiten oder Autos.

Assets sind in Hierarchien organisiert. Beispielsweise könnte eine Energieüberwachungsanwendung die folgende Assethierarchie aufweisen:

image alt text

Die Assethierarchie besteht aus zwei Typen von Objekten:

  • Gruppenobjekte: Diese Gruppen werden in der Cockpit-Anwendung erstellt und können einzelne Geräte oder andere Gruppen gruppieren.

  • Geräteobjekte: Hierbei handelt es sich um Geräte, die mit der Anlagenhierarchie verknüpft sind.

In diesem Beispiel repräsentieren Gruppenobjekte einen Gebäudebestand. Geräteobjekte repräsentieren den Raumbestand. Die Gruppennamen und die Hierarchie können vom Benutzer individuell definiert werden. Die Hierarchie kann mehrere Ebenen haben, eine Regionsebene, Stadtebene, Straßenniveau, Gebäudeebene, Stockwerk und Raumebene. Ein Gerät kann Teil von mehreren und unterschiedlichen Hierarchien sein, wie Teil der regionalen Hierarchie und Teil der Kundenhierarchie.

Einzelne Geräte werden nicht in der Cockpit-Anwendung verwaltet. Sie werden in der Device Management Anwendung verwaltet. Um ein Gerät in der Anlagenhierarchie zu positionieren, müssen Sie das Gerät der jeweiligen Gruppe zuordnen. Siehe Beschreibung unten für Details.

Asset Hierarchie im Vergleich zur Geräte Hierarchie

Cumulocity unterstützt zwei Arten von Hierarchien: eine Gerätehierarchie und eine Assethierarchie. Die Gerätehierarchie verfolgt, wie Geräte mit Cumulocity kommunikativ verbunden sind. Die Assethierarchie strukturiert die Assets, die über die M2M-Geräte fernüberwacht und gesteuert werden. Weitere Informationen hierzu finden Sie unter "Cumulocity's Domain Model"

In der Cockpit-Anwendung konstruieren Sie Ihre Assethierarchie, indem Sie Gruppenobjekte erstellen und Geräte in die Hierarchie einbinden. Die Anlagenhierarchie hängt von den verwendeten IoT-Geräten ab. Es gibt viele IoT-Geräte, aber diese beiden Typen sind sehr häufig:

  • Smart-Geräte sind in sich geschlossene Geräte mit Sensoren, Aktoren und einem Kommunikationsmodul. Sie sind typischerweise mit einem einzigen Asset verbunden. Intelligente Geräte sind Trackers, eine Wetterstation oder allgemeine "smart" Sensoren mit integriertem Kommunikationsmodul.

  • Gateway Geräte stellen die Kommunikation von anderen Geräten zu Cumulocity her, umfassen jedoch keine Sensoren oder Aktoren. Typische Gateway-Geräte umfassen Zigbee-, Modbus-, M-Bus- oder KNX-Gateways.

Im folgenden Abschnitt wird die Verwendung von Cockpit mit Smart Devices und Gateway-Geräten erläutert und wie intelligente Geräte in die Assethierarchie eingebunden sind:

image alt text

Smart Devices werden im Device Management (rechte Seite) als Top-Level-Geräte dargestellt. In der Cockpit-Anwendung können Sie intelligente Geräte in Gruppen organisieren, wie die Pfeile im obigen Diagramm angeben.

Gateway-Geräte können die Cockpit-Anwendung so anwenden:

image alt text

Gateway-Geräte werden in der Geräteverwaltung als Geräte der obersten Ebene dargestellt. Die angeschlossenen Geräte (wie Zigbee, Modbus oder KNX Geräte) werden als "Kindgeräte" (rechte Seite) angezeigt. Diese untergeordneten Geräte können in der Asset-Hierarchie wie oben dargestellt organisiert werden.

Die Assethierarchie und die Gerätehierarchie sind autark: Während sich innerhalb der Device Management-Anwendungen alle Kindgeräte unterhalb des Gateway-Geräts befinden, sind dieselben Kindgeräte in zwei verschiedenen Gebäuden in der Cockpit-Anwendung organisiert.

Zusammenfassung: Geräte können in der Device Management Applikation oder in der Cockpit Applikation völlig unterschiedliche Hierarchien haben.

Cockpit Assets im Vergleich zu Business Assets

Die Abbildung von Objekten in der Cockpit-Assethierarchie ist eine virtuelle Hierarchie. Wenn Sie Lkw innerhalb der Cumulocity-Plattform verwalten, wird jeder LKW über sein individuelles Tracking-Gerät mit Cumulocity kommuniziert.

Für Gebäudemanagement ist es am häufigsten, dass eine Gruppe von Sensoren innerhalb eines Gebäudes das Gebäude als eine Gruppe darstellt, die mit der Cumulocity-Plattform kommuniziert.

Der Navigator zeigt eine Hierarchie von Assets unter "Guppen" (siehe Screenshot unten):

  • Oben werden die "Top-Level" Gruppen angezeigt.

  • Beim Erweitern einer Gruppe werden alle ihre Kindobjekte angezeigt. Kindobjekte können weitere Gruppen oder Geräte der Gruppe zuordnen.Kindobjekte werden auch auf der Registerkarte "Sub-Assets" angezeigt.

image alt text

Wenn Sie ein Objekt in der Asset-Hierarchie auswählen, zeigt der rechte Teil der Anwendung weitere Details zum ausgewählten Objekt an:

image alt text

Die sichtbaren Register auf der rechten Seite des Navigators unterscheiden sich je nach Auswahl im Navigator. Die folgende Tabelle zeigt, welche Registerkarten auf der Basis der Auswahl im Navigator sichtbar sind:

Name des tab Name Dashboard Info Alarms Sub-assets Standort Data explorer
Gruppe ausgewählt: Ja, wenn konfiguriert Ja Nein Ja Nein Ja, zeigt alle Datenpunkte der Kindgeräte
Gerät ausgewählt: Ja, wenn konfiguriert Ja Ja Nein Ja Ja, zeigt alle Datenpunkte der Kindgeräte

Es können zusätzliche Registerkarten angezeigt werden, falls die Anwendung mit Plugins erweitert wurde. Siehe auch "Introduction to plugin development" .

Wenn Sie ein Gateway-Gerät hinzufügen, werden die Kindgeräte nicht angezeigt. Um Kindgeräte anzuzeigen, müssen Sie sie dem zugehörigen Asset hinzufügen. Details, die sich auf die untergeordnete Hierarchie beziehen, sind in der Geräteverwaltungsanwendung sichtbar und bearbeitbar.

Um in der Asset-Hierarchie weiter zu navigieren, verwenden Sie den Navigator oder wählen Sie ein Objekt auf der Registerkarte "Sub-Asset" aus. Um in der Asset-Hierarchie nach oben zu navigieren, verwenden Sie den Eintrag in der Pfadnavigation unter dem Namen des Assets.

Assets Durchsuchen

Um nach Gruppen oder Geräten zu suchen, geben Sie den Namen der Gruppe oder des Geräts in das Suchfeld ein und klicken Sie auf "Enter". Sie können auf die Ergebnisse klicken. Die ausgewählte Gruppe bzw. das ausgewählte Gerät wird dann im Navigator links ausgewählt und auf der rechten Seite angezeigt.

Gruppen Hinzufügen

Um eine neue Top-Level-Gruppe hinzuzufügen, klicken Sie auf "+" im oberen Bereich der Anwendung und wählen Sie "Gruppe hinzufügen ...". Daraufhin erscheint der folgende Dialog:

image alt text

Dadurch wird eine neue Gruppe mit den ausgewählten zugewiesenen Geräten erstellt. Nach dem Klicken auf "Gruppe mit Geräten erstellen" wird die Gruppe im Navigator als oberstes Objekt angezeigt.

Um eine neue Gruppe als Kinder eines vorhandenen Assets hinzuzufügen, klicken Sie auf die Schaltfläche "+ Gruppe hinzufügen" auf der Registerkarte "Sub-Assets".

image alt text

Weisen Sie Geräte Gruppen zu

Vor dem Hinzufügen eines Geräts zur Assethierarchie muss es mit Cumulocity verbunden sein. Verbinden Sie Geräte über das Device Management mit der Plattform. Genaues dazu finden Sie hier "Connecting Devices".

Um neu verbundene Geräte der Assethierarchie zuzuordnen, markieren Sie die Gruppe, in der das Gerät erscheinen soll, klicken Sie auf "Sub-Assets" und klicken Sie auf die Schaltfläche "+ Gerät zuordnen".

Suchen Sie im folgenden Dialog nach Geräten und wählen Sie die zuzuordnenden Geräte (oder Kindgeräte) aus.

image alt text

Gruppen Löschen

Sie können eine Gruppe per Hover über die Gruppe auf der Registerkarte "Sub-Assets" löschen. Sie sehen ein rotes [X], das Sie klicken können, um die Gruppe zu löschen.

Gerät Trennen

Um ein Gerät von einer Gruppe zu trennen, wählen Sie die Gruppe im Navigator aus. In der Registerkarte "Sub-Assets" werden die untergeordneten Geräte angezeigt und dort können Sie einzelnde Geräte auswählen und trennen. Klicken Sie auf die rote Schaltfläche [X].

Das Trennen eines Geräts bedeutet nicht, dass die Kindgeräte oder die zugehörigen Daten entfernt werden. Das Gerät wird nur aus seiner Position in der Asset-Hierarchie entfernt. Er kann danach anderen Gruppen zugeordnet werden.

Editieren von Gruppen

Um den Namen der Gruppe zu bearbeiten, klicken Sie auf die Registerkarte "Info" und bearbeiten den Namen.

Verwenden des Daten-Explorers, um Daten zu visualisieren

Datenpunkte (Messungen oder Sensordaten) können im Cockpit an drei Stellen visualisiert werden:

  • Klicken Sie im Navigator auf den "Data Explorer". Von dort haben Sie Zugriff auf alle Datenpunkte aller Assets.

  • Navigieren Sie zu einem bestimmten Asset und klicken Sie auf den Reiter "Daten Explorer". Sie haben Zugriff auf alle Datenpunkte der Assets und Sub-Assets.

  • Hinzufügen von datenpunktbezogenen Widgets zu einem Dashboard, um vordefinierte Berichte anzuzeigen.

Um Datenpunkte zu visualisieren, folgen Sie diesen Schritten:

  • Gehen Sie zu der Gruppe oder dem Gerät, und klicken Sie auf "Daten Explorer".

  • Die ersten fünf Datenpunkte des ausgewählten Geräts oder der ausgewählten Gruppe werden angezeigt.

  • Fügen Sie zusätzlichen Datenpunkt hinzu, indem Sie "Datenpunkte hinzufügen ..."

  • Passen Sie Farben, Bereiche und andere Visualisierungseigenschaften an.

  • Durchsuchen Sie weitere Daten, indem Sie den Zeitraum oder die Wertebereiche ändern.

  • Wenn Sie Ihre aktuelle Konfiguration für später speichern möchten, speichern Sie sie als Widget mit "Als Widget zum Dashboard senden ..."

Der Data Explorer und das Dashboard sind eng miteinander verbunden:

  • Wenn Sie eine Data Explorer-Konfiguration als Widget an ein Dashboard senden, können Sie das Dashboard auswählen, in dem das neue Widget gespeichert wird.

  • Wenn Sie auf das Konfigurationssymbol eines "Datenpunktgraphen" -Widgets klicken, gelangen Sie zu einem Dialog, der dem Daten-Explorer ähnelt, und hier können Sie das Widget konfigurieren.

Öffnen des Daten-Explorers

Wenn Sie auf den Reiter "Data Explorer" klicken, wird er geöffnet.

Er wird mit vorhandenen Datenpunkten des Objekts (Gruppe oder Gerät) voreingestellt. Die ersten 5 Datenpunkte werden standardmäßig angezeigt.

image alt text

Die Visualisierung wird basierend auf Datenpunkt-Eigenschaften erzeugt.

Die Datenpunkteigenschaften (min, max, color, ..) werden wie folgt voreingestellt:

  • Wenn diese Eigenschaften zuvor bearbeitet wurden, werden die ursprünglichen Werte verwendet.

  • Wenn die Datenpunkte eine übereinstimmende Definition in der Datenpunktbibliothek haben, werden die Werte aus der Datenpunktbibliothek verwendet.

In der "Datenpunkt Bibliothek" können mehrere übereinstimmende Datenpunkteingaben vorhanden sein. In diesem Fall wird die erste automatisch vom System ausgewählt. Sie können diese Auswahl mit dem Zahnradsymbol überschreiben und " X aus Bibliothek laden" auswählen. X bezieht sich auf den Eintrag in der Datenpunktbibliothek.

image alt text

Datenpunkte hinzufügen

Zusätzliche Datenpunkte können dem Daten-Explorer hinzugefügt werden, indem Sie auf "+ Datenpunkt hinzufügen" klicken. Daraufhin erscheint der folgende Dialog:

image alt text

Wählen Sie im oberen Bereich des Dialogs ein Gerät aus der Anlagenhierarchie aus. Nur die Assethierarchie unterhalb der im Navigator markierten Objekte ist sichtbar. Wurde im Navigator "Data Explorer" markiert, ist die komplette Anlagenhierarchie sichtbar.

Im unteren Teil des Dialogs werden alle Datenpunkte des ausgewählten Objekts angezeigt. Markieren Sie die Datenpunkte, die Sie im Daten-Explorer anzeigen möchten. Klicken Sie auf "Hinzufügen", um alle ausgewählten Datenpunkte zur Liste der Datenpunkte hinzuzufügen.

Ändern der Datenpunktvisualisierung

Ändern Sie die Eigenschaften unter dem Diagramm, um die Datenpunktvisualisierung zu ändern.

Die Eingabefelder sind so konzipiert, dass eine genaue Zeitdauer für die Visualisierung festgelegt wird:

  • Linkes Feld: Startzeit der x-Achse

  • Rechts: Endzeit der x-Achse

  • Zeitaggregationsebene: Keine Aggregation, täglich, stündlich

Für Datenpunkte stehen folgende Eigenschaften zur Verfügung:

  • V: Wählen Sie aus, ob der Datenpunkt visualisiert werden soll oder nicht.

  • Farbe: Farbe des Graphen.

  • Label: Text, der auf der y-Achse verwendet wird.

  • Einheit: Einheit auf der y-Achse verwendet. Unit ist der benutzerdefinierte String, der auf der y-Achse gezeigt wird.

  • Min / Max: Bereich der y-Achse.

  • Zielwert: Der Sollwert wird derzeit nicht im Diagramm angezeigt. Der Wert wird im Widget "Datenpunktliste" verwendet.

  • Yellow Range Min / Max: Definiert den Bereich, in dem kleinere Alarme durch die Schwellenregel erhöht werden sollen. Diese Werte werden derzeit nicht visualisiert. Detaillierte Informationen finden Sie unter Smart Rules.

  • Red Range Min / Max: Definiert den Bereich, in dem Kritische Alarme durch Schwellenregeln erhöht werden sollen. Diese Werte werden derzeit nicht visualisiert. Detaillierte Informationen finden Sie unter Smart Rules.

  • Diagrammtyp: Wählen Sie für aggregierte Daten aus, welcher aggregierte Wert visualisiert werden soll. Die Optionen sind: min, max, Fläche

  • Y Achse: Wählen Sie aus, auf welcher y-Achse der Datenpunkt angezeigt werden soll. Optionen sind: Auto, links, rechts.

  • Asset: Der Name des Assets des Datenpunkts. Dieses Feld ist nicht editierbar. Der interne Name des Datenpunktes (Messfragment und Serie) wird angezeigt.

Browsen im Daten-Explorer

So navigieren Sie im Daten-Explorer:

  • Bewegen der Zeit: Bewegen Sie auf die X-Achse und ziehen Sie sie nach links oder rechts.

  • Wählen Sie einen Zeitbereich im Diagramm aus

  • Doppelklicken, um den Bearbeitungszeitbereich zu beenden

Variieren der Y-Achse

Im Daten-Explorer können Sie eine Spalte mit der Bezeichnung "y-Achse" mit folgenden Werten konfigurieren:

  • Auto (Standard)

  • Links

  • Rechts

Die Werte definieren, wo die y-Achse für den jeweiligen Datenpunkt angezeigt wird. "Auto" positioniert den ersten Datenpunkt auf die linke y-Achse und die restlichen auf die rechten y-Achsen.

Jeder Datenpunkt wird auf seiner eigenen y-Achse angezeigt, sofern die folgende Bedingung nicht erfüllt ist:

  • Zwei Datenpunkte mit demselben Minimum und dem gleichen Maximalwert teilen sich eine gemeinsame y-Achse.

In diesem Fall sind beide Datenpunkte mit einer einzigen y-Achse dargestellt. Zusätzlich zeigt die y-Achse nur die Einheit (oder mehrere Einheiten, falls sie unterschiedlich sind). Das Etikett wird nicht angezeigt.

Erstellen von Widgets aus dem Daten-Explorer

Verwenden Sie das Menü und wählen Sie "Als Widget zu einem Dashboard senden".

Dadurch wird ein modaler Dialog mit allen Dashboards des aktuellen Objekts angezeigt. Navigieren Sie zum entsprechenden Dashboard und drücken Sie "Select", um ein neues Widget im ausgewählten Dashboard zu erstellen.

image alt text

Exportieren von Messdaten in csv- oder xlsx-Dateien

Benutzer haben die Möglichkeit, Messdaten als csv- oder xlsx-Dateien herunterzuladen. Die exportierten Daten werden in sechs Spalten unterteilt:

  • Uhrzeit - Datum und Uhrzeit der Messung
  • Quelle der Messung
  • Gerätename - Name des verwendeten Geräts
  • Fragment-Serien - (z. B. c8y_SpeedMeasurement)
  • Wert - einfach der Wert der Messung
  • Einheit - Die für die jeweilige Messung verwendete Einheit (wie "C", "km / h", "sec" ...)

Um die Messdaten entweder in csv oder xlsx herunterzuladen, navigieren Sie zunächst zum "Data Explorer", wählen den gewünschten Zeitbereich aus und klicken dann auf den kleinen Zahnradknopf rechts oben.

Export measurement data

Wählen Sie, ob ein CSV oder Excel (XLSX) Download erfolgen soll.

Das Fenster "Bericht erstellen" erscheint. Die Dateien werden abhängig davon geladen, wie viele Datenpunkte Sie dem "Data Explorer" hinzugefügt haben. Sobald der Ladevorgang abgeschlossen ist, klicken Sie auf die Schaltfläche "Download".

Arbeiten mit Dashboards

Dashboards bieten Ihnen eine individuelle Visualisierung Ihrer Daten mit einer Reihe von Widgets. Widgets können Karten, Bilder, Graphen, Tabellen und andere grafische Darstellungen von Daten anzeigen. Cumulocity kommt mit einer Reihe von voreingestellten Widgets, siehe Abschnitt "Widget Package". Sie können auch eigene Widgets entwickeln und diese zu Ihrem Cumulocity-Konto hinzufügen. Siehe Web developer's guide.

Ein neues Dashboard erstellen

Um ein Dashboard zu erstellen, navigieren Sie zu einem Objekt in der Asset-Hierarchie. Anschließend klicken Sie rechts oben auf das Zahnrad-Symbol. Wählen Sie "Dashboard erstellen". Dies öffnet einen Dialog und Sie können:

Dashboard cogwheel

  • Benennen Sie das von Ihnen erstellte Dashboard, das auch als Menüreiter angezeigt wird.

  • Geben Sie den Standort des Dashboards in der Navigation an.

  • Wählen Sie das Symbol, das neben dem Namen im Menü angezeigt wird.

  • Wählen Sie die Sichtbarkeit: "Dashboard für alle Benutzer sichtbar", ob das Dashboard für alle sichtbar ist ("global") oder nur begrenzte Anzahl von Benutzern.

  • "Dashboard-Layout": Konfigurieren Sie das Layout Ihres Dashboards. Wähle ein "Dashboard Theme", "Default Widget Header Style" und "Default Widget Margin". Danach können Sie Ihr aktuell ausgewähltes Layout im Vorschaufenster sehen.

Create Dashboard

Klicken Sie auf "Speichern", um das Dashboard zu erstellen und zu öffnen. Solange es keine Widgets auf dem Armaturenbrett gibt, sehen Sie eine "Widget" -Schaltfläche. Verwenden Sie diese Schaltfläche, um Ihr erstes Widget dem Dashboard hinzuzufügen.

Erstellen eines Dashboards für identische Geräte

Sie können ein Dashboard erstellen, das für alle identischen Geräte angezeigt wird. Um dies zu tun, erstellen Sie ein neues Dashboard wie oben beschrieben. Bevor Sie auf "Speichern" klicken, wählen Sie die Option "Dashboard anwenden an alle Geräte des Typs type". Der Text "type" wird durch den Typ des aktuell ausgewählten Gerätes ersetzt.

Dann sollte dieses Dashboard für alle identischen Geräte erscheinen. Änderungen an diesem Dashboard werden automatisch auf alle Dashboards angewendet.

Sie können nur Widgets und Daten zum Dashboard für das Gerät selbst hinzufügen. Es ist nicht möglich, Daten von untergeordneten Geräten hinzuzufügen, da die Struktur dieser Geräte von Gerät zu Gerät unterschiedlich sein könnte.

Hinzufügen von Berechtigungen zu einem Dashboard

Berechtigungen können nur einer bestimmten Benutzerrolle gewährt werden. Um dies zu tun, erstellen Sie ein neues Dashboard wie oben beschrieben oder editieren Sie ein Dashboard.

Um ein Dashboard zu editieren clicken Se auf das Zahnrad Symbol und wählen Dashboard editieren aus.

Um Berechtigungen für bestimmte Benutzer zu erteilen, deaktivieren Sie das "Dashboard für alle Benutzer sichtbar" und deaktivieren Sie "Dashboard an alle Geräte des Typs" type "anwenden.

Add permissions

Dann klicken Sie auf "Berechtigungen hinzufügen" und wählen Sie eine Gruppe aus dem Dropdown-Menü.

Select group

Danach wählen Sie die gewünschte Berechtigung für die ausgewählte Gruppe aus.

Select permission

Berechtigungen können mehreren Gruppen gewährt werden.

Hinzufügen eines Widget zu einem Dashboard

Um ein Widget zu einem Dashboard hinzuzufügen, stellen Sie sicher, dass das Dashboard sichtbar ist. Danach klicken Sie rechts oben auf das Zahnrad-Symbol. Wählen Sie "Hinzufügen eines Widgets zu einem Dashboard". Dies öffnet einen Dialog mit einer Auswahl von Widgets, die Sie dem Dashboard hinzufügen können.

Add Widget

Bei der Auswahl eines Widget-Typs werden zusätzliche Eingabefelder für diesen Widget-Typ angezeigt. Weitere Informationen zum "Widget Package] (# widget-package)" finden Sie mit diesem Link. Ähnlich wie bei den Dashboards können Sie den Widget Stil anpassen. Der aktuell ausgewählte Stil ist in der Vorschau auf der rechten Seite zu sehen.

Dashboard editieren

Sie können die Dashboard-Eigenschaften bearbeiten, indem Sie auf das Zahnrad-Symbol klicken und "Dashboard editieren" auswählen. Dies wird Sie zu einen ähnlichen Dialog wie "Erstellen eines Dashboards" bringen. In diesem Dialog können den Dashboard Namen, Symbol, Position, Stil und Berechtigungen bearbeitet werden.

Edit Dashboard

Sie können die Widgets des Dashboards neu anordnen. Durch drag und drop der Kopfzeile des Widgets können Sie das Widget auf eine andere Position auf der Seite verschieben. Durch drag und drop der Pfeile in der unteren rechten Ecke eines Widgets können Sie ein Widget ändern. Durch Anklicken des Symbols in der rechten oberen Ecke des Widgets können Sie die Widget-Eigenschaften löschen oder editieren.

Wenn das Dashboard gesperrt ist, können Widgets nicht neu geordnet werden. Um ein Armaturenbrett zu sperren / zu entsperren, klicken Sie rechts oben auf das Zahnrad und dann auf "Dashboard sperren" / "Dashboard entsperren".

dashboard lock

Auf einem Laptop erscheinen diese Symbole nur, wenn man mit der Maus über den Widget-Header fährt.

Die Bearbeitung auf Touch-Geräten wie Smartphones oder Tablets unterstützt nicht alle Funktionen. Um die Widget-Icons auf Touch-Geräten anzuzeigen, fahren Sie mit der Maus über den Widget-Header.

Dashboard kopieren

Um ein Dashboard von einem Objekt in ein anderes zu kopieren, verwenden Sie das Zahnrad oben rechts und wählen Sie "Dashboard kopieren". Danach wählen Sie das Objekt aus, auf das das Dashboard angewendet werden soll, und klicken Sie auf "Dashboard einfügen", um das Dashboard einzufügen.

Eine alternative Möglichkeit, ein Dashboard zu kopieren, besteht darin, das "[Dashboard per type] (# create-a-dashboard-for-all-devices-of-the-same-type)" -Ansatz zu verwenden. Mit dem "Dashboard per type" -Ansatz kopieren Sie das Dashboard von einem Objekt auf alle identischen Objekte.

Dashboard löschen

Um ein Widget zu einem Dashboard hinzuzufügen, stellen Sie sicher, dass das Dashboard sichtbar ist. Das gleiche gilt beim Löschvorgang. Klicken Sie oben rechts auf das Zahnrad-Symbol. Wählen Sie "Dashboard löschen", um ein Dashboard zu löschen.

Widget Paket

Das Cockpit enthält Preset-Widget-Typen. Jeder Widget-Typ kann verschiedene Parameter konfigurieren und verschiedene Daten angezeigen. Im folgenden Abschnitt werden alle verfügbaren Widget-Typen und die Konfigurationseigenschaften beschrieben.

Widget "Asset Eigenschaften"

Eine benutzerdefinierte Liste der Attribute des aktuellen Objekts wird angezeigt. Das aktuelle Objekt kann ein Gerät oder das Gruppenobjekt sein.

Zu konfigurierende Parameter:

Widget "Datenpunktgraph"

Zeigen Sie einen Datenpunkt (Messungen) in einem Diagramm. Die Visualisierung ist die gleiche wie der Daten-Explorer.

Der einfachste Weg, um ein Datenpunktgrafik-Widget zu erstellen, besteht darin, zum Daten-Explorer zu navigieren und dann "An Dashboard schicken" zu wählen.

Die zu konfigurierenden Parameter sind die gleichen wie im Daten-Explorer. Bitte beziehen Sie sich auf "Data Explorer" .

Widget "Datenpunkttabelle"

Diese Widget-Konfiguration ist identisch mit dem Datenpunkt-Graphen, anstatt die Daten als Liniendiagramm zu visualisieren, werden die Daten als Tabelle visualisiert.

  • Das Datenpunkttabellen-Widget zeigt Daten basierend auf ausgewählten Datenpunkten, Zeitintervall und Aggregation an.

  • Werte außerhalb des Bereichs, die auf den konfigurierten gelben und roten Bereichen basieren, werden in der Tabelle hervorgehoben.

Data point table

Widget "Karte"

Standort eines Geräts oder aller Geräte in der Gruppe anzeigen. Die Karte bietet folgende Funktionen:

  • Die Karte hat Funktionalität wie Ziehen und Vergrößern / Verkleinern.

  • Die Symbole für die Geräte sind farbcodiert. Die verwendete Farbe hängt von der folgenden Regel ab:

    • Mindestens ein kritischer Alarm: rot

    • Mindestens ein Hauptalarm: orange

    • Mindestens ein wenig-wichtiger Alarm: gelb

    • Mindestens eine Warnung: blau

    • Kein Alarm: grün

  • Wenn Sie auf ein Gerätesymbol klicken, wird ein Popup mit den folgenden Informationen angezeigt:

    • Der Gerätename: Wenn sie angeklickt wird, navigiert die Anwendung zum Gerät.

    • Datum, an dem das Gerät zuletzt seinen Standort gemeldet hat, falls verfügbar.

    • Die Option zum Anzeigen / Ausblenden der Gerätespuren für den vorherigen und den aktuellen Tag.

Zu konfigurierende Parameter:

  • Zielgerät oder Gruppe: Wählen Sie aus, welche Geräte auf der Karte angezeigt werden sollen. Wenn eine Gruppe ausgewählt ist, sind alle in der Gruppe enthaltenen Geräte sichtbar.

Hinweis: Wenn keines der Zielgeräte über einen bekannten Standort verfügt, zeigt das Widget eine Weltkarte ohne Symbole an.

Widget "HTML"

Benutzerdefinierten Inhalt anzeigen. Der Inhalt kann mit HTML formatiert werden.

Der zu konfigurierende Parameter:

  • Zielgerät oder Gruppe: Wählen Sie das Objekt aus, für das optionale HTML-Ausdrücke ausgewertet werden sollen.

  • HTML Inhalt:

Variablen, die im HTML-Inhalt verwendet werden können:

  • {{DevicesCount}}: Gesamtzahl der Geräte.

  • {{UsersCount}}: Gesamtzahl der Benutzer.

  • {{DeviceGroupsCount}}: Gesamtzahl der Gruppen.

  • {{Device.name}}: Der Name des Geräts.

  • {{Device. Property }}: Allgemeinere Form der oben genannten. Sie können jede Eigenschaft des Geräts ansprechen.

  • {{Device.c8y_Hardware.model}}: Das Modell des Geräts.

  • {{Device. Fragment . Property }}: Allgemeinere Form der oben genannten. Sie können jede Eigenschaft eines beliebigen Fragments des Geräts ansprechen.

Zusätzliche Information:

  • "Gerät" bezieht sich auf das Zielgerät, wie im Widget-Konfigurationsparameter ausgewählt.*
  • Fragment.property * bezieht sich auf die Eigenschaften des jeweiligen Gerätes. Um die verfügbaren Eigenschaftsnamen zu sehen, können Sie das Widget "Asset-Eigenschaft" oder "Asset-Tabelle" verwenden und auf den Link "+ Hinzufügen" in der Widget-Konfiguration klicken. Daraufhin wird eine Tabelle mit unterstützten Eigenschaften angezeigt. Sie können die Werte aus der Spalte "Eigenschaft" kopieren und einfügen. Generierte Eigenschaften dieser Widgets sind in den HTML-Widgets nicht verfügbar.

Widget "Asset Alarme"

Zeigt alle Objekte mit einem kritischem Alarm . Es gibt keine zusätzlichen Parameter zu konfigurieren.

Widget "Asset Anzahl"

Zeigt die Anzahl der Geräte online und mit Alarmen an. Es gibt keine zusätzlichen Parameter zu konfigurieren.

Widget "Alarm Liste"

Zeigt eine Liste von Alarmen, Filter für Objekte, Alarmschwere und Alarmstatus an.

Zu konfigurierende Parameter:

  • Zielgerät oder Gruppe: Wählen Sie Gruppen oder Geräte, optionale HTML-Ausdrücke, die ausgewertet werden sollen.

  • Status: Nur Geräte mit Alarmen eines bestimmten Alarmstatus anzeigen.

  • Typ: Nur Alarme des angegebenen Typs anzeigen. Details können angezeigt werden, wenn Sie einmal auf einen Alarm klicken.

  • Schweregrad: Nur Alarme der ausgewählten Schweregrad anzeigen.

Widget "Neueste Alarme"

Zeigt alle Alarme aller Schwere nach Zeit sortiert an. Es gibt keine zusätzlichen Parameter zu konfigurieren.

Widget "Datenpunktliste"

Zeigen Sie Datenpunkte (Messungen), eine in jeder Zeile, mit aktuellen Werten und Datenpunkt-Eigenschaften.

Zu konfigurierende Parameter:

  • Liste der Datenpunkte: Wählen Sie einen oder mehrere Datenpunkte aus.

  • Wählen Sie sichtbare Spalten:

    • Label: Bezeichnung des Datenpunktes. Weitere Informationen finden Sie unter Data Explorer.

    • Ziel: Zielwert. Kann in der Datenexplorer- oder Datenpunktbibliothek konfiguriert werden.

    • Aktuell: Aktueller Wert.

    • Diff: Absolute Differenz zwischen aktuellem Wert und Zielwert.

    • Diff%: Prozentsatz der Differenz zwischen aktuellem Wert und Zielwert.

    • Asset: Name des Geräts oder der Gruppe des Datenpunkts.

Widget "Asset Tabelle"

Zeigt die Details aller Kindgeräte in einer Tabelle an. Dies ist ein sehr starkes Widget, das es ermöglicht, ausgewählte Eigenschaften von Objekten in einer Tabelle anzuordnen.

Zu konfigurierende Parameter:

  • Zielgerät oder Gruppe: Wählen Sie für welches Objekt alle Kindgeräte angezeigt werden sollen. Dies ist typischerweise ein Gruppenobjekt.

  • Eigenschaften: Wählen Sie Eigenschaften oder Aktionen eines Objekts aus, um sie als Spalten in der Tabelle zu visualisieren. Im Konfigurationsdialog sehen Sie eine Liste der konfigurierten Spalten, jede der Spalten kann eine Eigenschaft oder eine Aktion sein.

Beispiel:

  • Im folgenden Screenshot sind fünf Spalten konfiguriert. Drei Eigenschaftenspalten "Meter", "Vendor" und "Owner", die sich auf die Eigenschaften "name", type "und" owner "beziehen. Zusätzlich gibt es zwei Aktionen, eine zum Umschalten des Wartungsmodus und eine zum Neustarten des Geräts.

image alt text

  • Die resultierende Tabelle wird wie folgt visualisiert:

image alt text

Die Liste der Eigenschaften kann wie folgt editiert werden:

  • Neue Eigenschaften hinzufügen: Klicken Sie auf "+ Eigenschaften hinzufügen" und wählen Sie eine oder mehrere Eigenschaften aus. Die ausgewählten Eigenschaften werden dann am Ende der Spalten hinzugefügt.
    Hinweis: Die Eigenschaft "Aktiver Alarmstatus" zeigt aktive Alarme als Symbole in der Tabelle an. Wenn Sie diese Eigenschaft auswählen, konfigurieren Sie auch den Renderer "Active Alarm Status" in der Spaltenliste.

  • Fügen Sie eine neue Aktion hinzu: Klicken Sie auf "+ Aktion hinzufügen". Sie können dann die vordefinierte Aktion hinzufügen, um den Wartungsmodus umzuschalten. Oder Sie wählen "Create Operation", um eine Schaltfläche zu erstellen, die einen Shell-Befehl ausführt. Im folgenden Dialog können Sie dann die Bezeichnung für die Schaltfläche und den auszuführenden Shell-Befehl eingeben. image alt text Im Dialog werden die voreingestellten Shell-Befehle der ersten Shell-Befehle angezeigt. Die Liste ist leer, wenn es kein solches Gerät gibt. Weitere Informationen finden Sie unter shell commands.
    Sie können auch das JSON-Format für den Vorgang eingeben, der an das Gerät gesendet wird. Für Einzelheiten wenden Sie sich an den Gerätehersteller für unterstützte Vorgänge.

  • Spaltenüberschrift bearbeiten: Um den Kopf der Spalte zu bearbeiten, klicken Sie auf die Spalte "Label" und bearbeiten das Label.

  • Anordnen von Spalten: Sie können die Spalten durch Ziehen und Ablegen mit dem Handle vor der Spalte "Label" neu anordnen.

  • Entfernen von Eigenschaften: Klicken Sie auf das rote Symbol am Ende einer Zeile, um die Spalte zu entfernen.

Widget "Relais Steuerung"

Ermöglicht das Ein- und Ausschalten eines Geräterelais. Nur für Geräte verfügbar, die diesen Vorgang unterstützen.

Widget "Relais Array"

Bei einem Relais-Array können Sie Relais ein- oder ausschalten. Nur für Geräte verfügbar, die diesen Vorgang unterstützen.

Widget "Nachricht Senden"

Sendet eine Nachricht an ein Gerät. Das Verhalten des Gerätes selbst ist geräteabhängig. Nur für Geräte verfügbar, die diesen Vorgang unterstützen.

Arbeiten mit Alarmen

Das Arbeiten mit Alarmen ist identisch mit der Arbeit mit Alarmen in der Geräteverwaltung. Siehe "Working with alarms" im Device Management Handbuch.

Arbeiten mit Dashboard Berichten

Es gibt zwei Arten von Berichten in der Cockpit-Anwendung. Dashboard-Berichte ermöglichen es Ihnen, Anwendungen, Alarme, Assets, Ereignisse und viele andere Widgets zu verfolgen. Die andere Art des Berichtes "Exporting data with Reports" ist der Datenexport nach csv oder xlsx Files.

Durchsehen von Berichten

Dashboard-Berichte sind globale Dashboard Seiten unabhängig von der Asset-Hierarchie. Der Navigator zeigt eine Schaltfläche "Berichte" an. Um alle vorhandenen Berichte anzuzeigen, erweitern Sie das Menü "Berichte" und sehen dann alle abgespeicherten Berichte.

Erstellen Neuer Berichte

Um einen neuen Bericht hinzuzufügen, wählen Sie in der Kopfzeile die Schaltfläche "+" und klicken Sie auf "Neuen Bericht erstellen".

Füllen Sie die Felder "Name" und "Icon" im Dialog aus und clicken Sie "Speichern".

image alt text

Dann können dem erstellten Bericht Widgets hinzugefügt werden.

Löschen von Berichten

Um einen Bericht zu löschen, clicken Sie das Zahnrad-Symbol und wählen Sie "Löschen".

Berichten Widgets hinzufügen

Sie können dem Bericht Widgets hinzufügen, ähnlich den Dashboard-Widgets.

Berichte anzeigen

Um einen Bericht anzuzeigen, öffnen Sie im Navigator die "Berichte" und klicken Sie auf den entsprechenden Bericht. Der Bericht wird angezeigt.

Daten Exportieren mit Berichten

Mit der Funktion "Bericht Erstellen" können Sie csv- oder xlsx-Reports für den gesamten Mandanten anfordern. Zusätzlich können Sie Filter nach bestimmten Geräten, Zeitbereichen oder Felder auswählen. Die Berichte enthalten Informationen zu allen angegebenen "Filtern" und aktivierten "Feldern". Die maximale Anzahl von Dokumenten, die in eine einzelne xlsx-Datei exportiert werden können, beträgt 1 Million. Wenn die Anzahl der Dokumente für definierte "Filter" den Grenzwert überschreitet, erhält das Ergebnis nur 1 Million Dokumente.

Informationen zum Verwenden von Dashboard-Berichten finden Sie unter Working with Dashboard Reports.

Um alle Berichte anzuzeigen, wählen Sie "Berichte" und klicken Sie auf "Bericht Erstellen".

Wenn ein Bericht erstellt wurde, können Sie ihn duplizieren. Dazu gehen Sie in der Berichtkonfiguration zum gewuenschten Bericht und klicken auf Duplizieren am Ende der Reihe. Es geht ein neues Fenster auf in dem alle Daten des aktuellen Berichts dupliziert werden. Sie können Änderungen anwenden, wenn Sie es wünschen. Zum Beenden drücken Sie die Schaltfläche "Speichern".

Hinzufügen von Berichten

Um weitere Berichte zu erstellen, klicken Sie auf "Bericht hinzufügen"

  • Geben Sie den Namen des Berichts ein.
  • Wählen Sie aus, ob der Dateityp entweder "csv" oder "Excel" sein soll.
  • [Filter hinzufügen] (# filter), um Objekt- oder zeitspezifische Berichte anzufordern.
  • [Felder auswählen] (# Felder) des Berichts.
  • Klicken Sie auf "Speichern", um den Vorgang abzuschließen.

Add Reports

Filter

Berichte können auf bestimmte Objekte oder einen Zeitbereich gefiltert werden. Um ein zu exportierendes Objekt auszuwählen, navigieren Sie zuerst zur Suchleiste "Objekt zum Exportieren" unter dem Bereich "Filter". Bestimmte Geräte oder Gruppen können durch Schreiben ihres Namens oder Eigenschaftswerts in die Suchleiste ausgewählt werden. Wenn Sie auf die Schaltfläche "Suchen" klicken, sucht das Cockpit nach einem passenden Eintrag in Ihrer Gerätebibliothek. Nachdem alle passenden Geräte gefunden wurden, werden sie unter der Suchleiste angezeigt. Um ein Gerät auszuwählen, klicken Sie einfach auf seinen Namen und es wird grün hervorgehoben.

Object filter

Zusätzliche Filter wie "Zeitbereich" können aktiviert werden. Sie haben die Möglichkeit, Objektberichte zu "Letztes Jahr", "letzter Monat", "letzte Woche" zu filtern oder einfach einen benutzerdefinierten Zeitraum einzugeben. Um den Zeitbereich zu wählen, klicken Sie auf das Scroll-Menü und wählen Sie den gewünschten Zeitraum. Wenn Sie den Zeitbereich anpassen möchten, erscheinen zwei kleine Datumsfelder, um einen Zeitbereich auszuwählen. Time range

Um Filter zu aktivieren, müssen Sie auf das Kontrollkästchen unter "Aktiviert" klicken.

Felder

Um Berichte zu bearbeiten, können verschiedene Felder ausgewählt werden. Wenn Sie z. B. "Alarme" und "Ereignisse" auswählen, filtern Sie die Berichte nur auf diese beiden Felder. Insgesamt gibt es vier Felder, die Sie wählen können.

  • Alarme
  • Veranstaltungen
  • Verwaltetes Objekt
  • Messungen

Um ein Feld zu aktivieren, klicken Sie einfach auf den Namen des Feldes.

Fields

Wenn ein bestimmtes Feld aktiviert ist, können vordefinierte oder neue Eigenschaften hinzugefügt werden. Wenn Sie leere Eigenschaften hinzufügen möchten, klicken Sie auf "Hinzufügen". Um Label oder Pfad einzugeben, klicken Sie auf "Spalte" oder "Pfad" in der roten Zeile. Wenn Sie beispielsweise das Feld "Alarme" aktivieren, können Sie in Spalte und Pfad den Wert "Schweregrad" eingeben, um einen Bericht nur für Alarmschwere zu erhalten.

Wenn Sie ein Feld im Feld "Felder" haben, das nicht aus der Liste "Vordefinierte Liste hinzufügen", sondern als benutzerdefinierte Eigenschaft definiert ist, ist es erforderlich, dass mindestens eine Eigenschaft für den Export für benutzerdefinierte Werte eingerichtet werden muss um auf dem Excelblatt zu erscheinen. Wenn ein Bericht beispielsweise 4 Felder definiert hat: Zeit, Gerätename, Typ und c8y_SpeedMeasurement.speed.value, dann sind die ersten 3 vordefinierte Eigenschaften und die letzte eine benutzerdefinierte Eigenschaft. Wenn keine Messung für den Export keine benutzerdefinierte Eigenschaft c8y_SpeedMeasurement.speed.value hat, wird sie nicht auf dem Excel-Blatt angezeigt.

Wenn Ihr Feld ein gültiges.key.with.dot ist, dann verweisen Sie es als ['Fragment.key.with.dot'] in dem Pfad, z.B. ['Fragment.key.with.dot'] serie.value

Um vordefinierte Eigenschaften hinzuzufügen, klicken Sie auf "Vordefinierte hinzufügen".

Um vordefinierte Eigenschaften auszuwählen, klicken Sie auf das entsprechende Kontrollkästchen unter "SHOW". Nachdem die gewünschten Eigenschaften ausgewählt wurden, klicken Sie auf "Auswählen".

Select

Um eine bestimmte Eigenschaft effizient zu suchen, können Sie das Suchfeld verwenden.

Wenn das Feld "Messungen" aktiviert wurde, können Sie auch "Von Datenpunkt hinzufügen" wählen.

Add from datapoint

Um einen Datenpunkt zu wählen, klicken Sie auf das Kontrollkästchen. Wenn die Auswahl abgeschlossen ist, klicken Sie auf "Hinzufügen".

Das "Suchfeld" kann auch für eine einfachere Handhabung genutzt werden. Geben Sie im Feld "Suchfeld" den Namen oder Wert der gewünschten Geräte ein und klicken Sie auf "Senden". Alle übereinstimmenden Einträge werden angezeigt.

Add datapoint

Stammdaten exportieren in csv or xlsx files

Um "Stammdaten" in csv- oder xlsx-Dateien zu exportieren, navigieren Sie zu "Bericht Erstellen" auf der Registerkarte "Bericht".

  • Wählen Sie die gewünschten Dateien aus, die Sie exportieren möchten, indem Sie auf das entsprechende Kontrollkästchen klicken.
  • Klicken Sie auf "Exportieren".

Exporting

Sie erhalten eine E-Mail mit den Links zu jeder Datei.

Die Standardzeit-Eigenschaften von Dokumenten (zB Zeit oder Erstellungszeit in Alarmen) werden exportiert

  • als xlsx file im format: 03/13/2016 00:00:24
  • als csv file im format: 2016-03-13T00:01:24.000Z

Nur csv Zeit enthält Millisekunden und Zeitzone.

Berichte Editieren

Um Berichte zu editieren genügt es sie anzuklicken und die Veränderungen zu speichern.

Berichte Löschen

Um Berichte über den Namen des Berichts zu entfernen, klicken Sie auf die Schaltfläche "X".

Verwenden der Datenpunktbibliothek

Die Data Point-Bibliothek enthält Standardwerte für Datenpunkt-Eigenschaften. Datenpunkteigenschaften ähneln den "Absatzformaten" in Textverarbeitungsanwendungen: Sie möchten nicht jeden Absatz einzeln formatieren. Stattdessen möchten Sie einen Satz von Standardformaten definieren und diese auf Ihre Absätze in Ihrem Dokument anwenden. Die Datenpunktbibliothek bietet die gleiche Funktionalität für Datenpunkte: Sie bietet eine Reihe von Standarddatenpunktformaten, die von verschiedenen Geräten problemlos auf Ihre Datenpunkte angewendet werden können.

Wie verwendet die Cockpit-Anwendung die Datenpunktbibliothek? Um die Standard-Visualisierung für einen Datenpunkt wie Farbe oder Label zu finden, durchsucht Cockpit die Datenpunktbibliothek und versucht, einen passenden Eintrag zu finden. Ein Eintrag gilt als "Passend", wenn der Wert für Fragment und Serie in der Datenpunktbibliothek mit denen der Messung übereinstimmt. Wenn ein passender Eintrag gefunden wird, werden die entsprechenden Datenpunkteigenschaften für eine Standardvisualisierung verwendet.

Darüber hinaus werden die Eigenschaften der Datenpunktbibliothek von Schwellenwert-Geschäftsregeln verwendet: Die in der Datenpunktbibliothek konfigurierten roten und gelben Werte werden von den Schwellwertregeln verwendet, um Alarme auszulösen.

Bei Auswahl von "Data Point Library" im Navigator öffnet sich eine Liste mit vordefinierten Datenpunkten inklusive deren Eigenschaften.

image alt text

Beim Anklicken eines Eintrags kann ein einzelner Eintrag in der Datenpunktbibliothek editiert werden:

image alt text

Arbeiten mit Smart Rules

Cumulocity enthält eine Regel-Engine, um Daten in Echtzeit zu analysieren und Aktionen basierend auf Daten auszuführen. Diese Regeln werden in einer Skriptsprache angegeben und in der Administrations-Anwendung verwaltet.

Zum Erstellen von Regeln enthält die Cockpit-Anwendung einen "Smart Rule Builder". Mit dem Smart Rule Builder können Regeln aus Vorlagen erstellt werden. Diese Regeln werden als intelligente Regeln "Smart Rules" bezeichnet. Die Vorlagen werden als intelligente Regelvorlagen "Smart Rules Template" bezeichnet.

Smart Rules werden parametriert. Es gibt zwei Quellen für Parameter:

Regelparameter werden vom Benutzer beim Erstellen einer Smart Rule aus einer Vorlage bereitgestellt. Beispiele sind E-Mail-Adressen und Alarmtexte.

Objektparameter werden in der Gruppe oder dem Gerät gespeichert. Diese Parameter können auch nach der Erstellung der Smart-Rule editiert werden. Ein Beispiel enthält Min- und Max-Werte für Schwellenwerte.

Eine "Smart Rule" Erstellen

Smart Rules können entweder unter "Konfiguration -> Smart Rules" oder unter dem Reiter "Info" einer Gruppe oder eines Geräts erstellt werden.

  • Klicken auf "+ Smart Rule hinzufügen"

  • Auf eine Smart Rule Templates klicken.

  • Geben Sie in der nächsten Form die Regelparameter ein. Die Regelparameter unterscheiden sich von Regel zu Regel, Details siehe Einzelregelbeschreibungen unterhalb.

  • Über das Suchfeld können Sie auch die aktuelle Smart Rule für Zielgeräte oder Assets aktivieren. Dieser Schritt ist aber optional.

  • Wählen Sie aus, ob die Regel aktiviert oder deaktiviert werden soll.

  • Auf "Erstellen" clicken.

Eine Liste der intelligenten Regeln wird unten gezeigt. Beachten Sie, dass die Anzahl der angezeigten Smart-Regeln je nach Ihrer Installation unterschiedlich sein kann.

image alt text

Danach ist die Regel für alle Geräte und Gruppen aktiv, wenn die Regel auf freigegeben steht und nicht nur für bestimmte Objekte aktiviert wurde. Im nächsten Abschnitt erfahren Sie, wie Sie eine intelligente Regel für bestimmte Objekte deaktivieren.

Deaktivierte Smart Rules werden nicht in Gruppenmenüs oder Gerätemenüs angezeigt, um Verwirrung zu vermeiden. Smart Rules können mehrere Male instanziiert werden.

Aktivieren und Deaktivieren von Smart Rules

Smart Rules können Sie unter dem Info-Tab eines Geräts oder einer Gruppe sehen. Sie müssen innerhalb dieser Gruppe aktiv sein und auch auf untergeordneter Ebene aktiv sein.

Für ein einzelnes Objekt (Gruppe oder Gerät) kann eine einzelne Smart Rule aktiviert (eingeschaltet) und deaktiviert (ausgeschaltet) werden. Wenn zum Beispiel ein Gerät zu viele Grenzwertalarme erzeugt, können Sie die Regel für dieses einzelne Objekt deaktivieren. Die Regel ist für alle anderen Objekte noch aktiv.

Um eine Smart Rule für eine Gruppe oder ein Gerät zu deaktivieren oder zu aktivieren, wechseln Sie einfach auf die Registerkarte Info und klicken Sie auf die Schaltfläche, um die Regel zu aktivieren oder zu deaktivieren.

Info tab

Bearbeiten, Klonen oder Entfernen von Smart Rules

Um eine bestimmte Smart Rule zu bearbeiten, zu klonen oder zu entfernen, klicken Sie einfach auf das rechts neben der Smart Rule befindliche Zahnrad und klicken Sie auf die gewünschte Option.

Für ein einfacheres Debugging gibt es einen direkten Link von einer intelligenten Regel zu einem entsprechenden Ereignisverarbeitungsmodul. Klicken Sie auf das Zahnrad und wählen Sie dann "Bearbeiten".

Beispiel: Definieren von genauen Schwellenwerten

Gehen Sie folgendermaßen vor, um eine Schwellenregel zu definieren:

  • Navigieren Sie im Asset-Navigator zu der gewünschten Gruppe oder dem gewünschten Gerät, um einen Schwellenwert auf anzuwenden.
  • Klicken Sie auf "Data Explorer".
  • Wenn der Datenpunkt standardmäßig nicht sichtbar ist, wählen Sie "Datenpunkt hinzufügen" und fügen Sie einen Datenpunkt hinzu.
  • Für den Datenpunkt, der den Schwellenwert erhöhen soll, klicken Sie am Ende der Zeile auf das Symbol "Zahnrad" und wählen Sie "Smart Rule erstellen".

image alt text

  • Auswählen "Bei Messungen, die den Schwellenwert überschreiten, Alarm erstellen"

  • Füllen Sie die Regelparameter im Formular aus:

image alt text

  • Sie können den minimalen und den maximalen Wert für den roten Bereich eingeben. Wenn die Werte außerhalb dieser Werte liegen, wird ein Grenzwertalarm ausgelöst.

  • Unter "Alarm erstellen" können Sie optional den Alarmtyp und den Alarmtext bearbeiten.

  • Unter "Für Zielgruppe oder Geräte aktivieren" können Sie das Objekt auswählen, auf das diese Regel angewendet wird.

  • Klicken Sie auf "Erstellen"

Nachdem die Regel erstellt wurde, wird sie automatisch aktiviert und Alarme erscheinen, wenn sie auftreten.

Ausführen einer Kettenregel

Smart Rules können ein neues Datenelement auf der Plattform erstellen. Beispielsweise erzeugt die Schwellenregel neue Alarme. Diese neuen Daten können durch ausgewählte intelligente Regeln weiterverarbeitet werden. Zum Beispiel durch eine "Bei Alarm E-Mail verschicken" Regel. Mit diesem Mechanismus ist es möglich, eine Kette von intelligenten Regeln zu erstellen. Wenn Sie eine Regelkette erstellen, müssen Sie eine klare Vorstellung haben, wie viele Daten erstellt werden, um Überlastungen oder übermäßige Datenmengen zu vermeiden.

Regeln für den Geschäftsablauf

Die folgenden Smart Rules sind in unserem System verfügbar.

Messschwellenalarme

Beim Überschreiten der definierten gelben und roten Bereiche werden Alarme generiert und gelöscht.

Die Regel verwendet den folgenden Parameter aus dem Geräteobjekt oder der Datenpunktbibliothek:

  • Objektwert roter Bereich: Bereich, wenn das System kritische Alarme erstellen soll. Diese Werte können im Data Explorer für jeden Datenpunkt editiert werden.

  • Objektwert gelber Bereich: Bereich, wenn das System kleinere Alarme erstellen sollte. Diese Werte können im Data Explorer für jeden Datenpunkt editiert werden.

  • Datenpunktbibliothek roter Bereich: Wenn kein roter Bereich im jeweiligen Objekt gespeichert ist, wird die Datenpunktbibliothek nach dem konfigurierten Datenpunkteintrag durchsucht und der dazugehörige rote Bereich verwendet.

  • Datenpunkt Bibliothek gelber Bereich: Ähnlich wie der rote Bereich.

Mit diesem Mechanismus können Sie globale Schwellenbereiche in der Datenpunktbibliothek konfigurieren. Diese globalen Werte können dann von Fall zu Fall für bestimmte Objekte überschrieben werden.

Die Regel verwendet die folgenden Parameter:

image alt text

  • Fragment: Name des Messfragments. Die eingehende Messung muss genau den gleichen Fragmentnamen wie konfiguriert haben. Beim Erstellen einer Regel aus dem Datenexplorer sind die Fragmentdaten bereits ausgefüllt.

  • Serie: Ähnlich wie Fragment, nur für die Serie.

  • Eintrag der Datenpunktbibliothek: Name des Eintrags in der Datenpunktbibliothek. Hier finden Sie die Standardwerte für rote und gelbe Bereiche, falls sie nicht für ein einzelnes Objekt konfiguriert sind.

  • Typ: Typ von Alarm, der betätigt wird.

  • Text: Text des Alarms der betätigt wird.

Eine detaillierte Beschreibung der Schritte, die diese Smart Rule für jeden eingehenden Messwert durchführt:

  • Prüfen Sie, ob die Messung Daten für das Fragment und die Serie enthält (Regelparameter).

  • Prüfen Sie, ob die Regel für das Quellobjekt aktiviert ist.

  • Die Daten des roten und gelben Bereiches sammeln von entweder:

    • dem Quellobjekt (der Messung)

    • der Datenpunktbibliothek (Regelparameter).

Sind keine rot / gelb Bereiche definiert, werden folgerichtig keine Alarme generiert.

Im Quellobjekt definierte Bereichswerte haben eine höhere Priorität als die in der Datenpunktbibliothek definierten Werte. Sie können auch einfach einen einzelnen Wert (z. B. gelber Bereich max) überschreiben, indem Sie ihn im Quellobjekt setzen. Die anderen Werte werden dann von der Datenpunktbibliothek übernommen.

  • Liegt der eingehende Wert im gelben Bereich...

  • Gibt es einen aktiven Alarm für das Objekt...

  • ..wird der Schweregrad "weniger wichtig" vergeben.

Sonst

  • Einen neuen Alarm erstellen mit den geforderten Parametern.

    • Liegt der eingehende Wert im roten Bereich...

    • Gibt es einen aktiven Alarm für das Objekt...

  • ..wird der Schweregrad "kritisch" vergeben.

Sonst

  • Einen neuen Alarm erstellen mit den geforderten Parametern.

  • Wenn die Messung außerhalb des gelben und roten Bereichs liegt.

  • Wenn ein aktiver Alarm des gegebenen Typs für das Objekt vorhanden ist.

  • ..wird der Alarm gestoppt.

Troubleshooting

  • Stellen Sie sicher, dass der Alarm erstellt wurde und nicht irgendwo dupliziert wurde.

  • Das Gerät ist nicht in Wartung Wartung : In diesem Fall gibt es keinen neuen Alarm, weil diese unterdrückt werden.

  • Wenn Sie keine Alarmzuordnungsregel haben (siehe: Repriorisieren der Alarme) die die Alarmschwelle ändert: In diesem Fall kann der Alarm anders ausfallen als erwartet.

  • Prüfen Sie, ob ein Alarm bereits durch die nächsten geplanten Messungen mit dem resultierenden Wert in einem grünen Bereich gelöscht wurde.

  • Bitte beachten Sie, dass, wenn Sie einen Alarm löschen, dass der Alarm behoben ist. Ein neuer Alarm wird nur dann ausgelöst, wenn das Gerät seinen Zustand ändert und die Schwellen wieder überschreitet.

Bei Schwellwertüberschreitung Alarm erzeugen

Wenn der Messwert den ROT-Bereich betritt oder verlässt, wird ein kritischer Alarm erzeugt oder gelöscht. Die Schwere des Alarms wird bestimmt durch:

  • Wenn der Messwert in den ROTEN Bereich wechselt, ist der Schweregrad kritisch.
  • Wenn der Messwert auf im grünen Bereich war, wird der Alarm gelöscht.

Diese Regel ist ähnlich der obigen Schwellenregel. In dieser Regel wird jedoch der ROT-Schwellenwert explizit angegeben. Die andere Schwellenregel oben extrahiert die Schwellenwerte aus der Geräte- oder Datenpunktbibliothek.

Die Parameter dieser Regel:image alt text

  • Fragment: Name des Messfragments. Die eingehende Messung muss genau den gleichen Fragmentnamen wie konfiguriert haben. Beim Erstellen einer Regel aus dem Data Explorer ist der Fragmentname bereits ausgefüllt.

  • Serie: Ähnlich wie Fragment, nur für Serie.

  • Minimum, Maximum: Wenn ein Wert im Bereich [minimum; Maximum] wird der konfigurierte Alarm ausgelöst.
  • Typ: Typ des Alarms, der ausgelöst wird.
  • Text: Text des Alarms, der ausgelöst wird.

Troubleshooting

  • Bitte überprüfen Sie die gleichen Schritte wie für die Schwellenregel oben.

Bei Alarm E-mail senden

Wenn ein Alarm erzeugt wird, wird eine E-Mail gesendet.

Die Regel verwendet die folgenden Parameter:

image alt text

  • Alarmarten: Die Arten der Alarme, die die Regel auslösen. Für jeden neu erzeugten Alarm mit einem dieser Typen in der Liste wird die Regel ausgelöst.

  • Senden an: E-Mail-Adressen für das Versenden der E-Mail an. Mehrere Adressen können durch ein Komma getrennt werden (",", kein Leerzeichen!).

  • CC senden an: Wie bisher nur für E-Mail "CC" Feld.

  • Senden BCC an: Wie bisher nur für E-Mail "BCC" -Feld.

  • Antwort auf: Adresse, die verwendet werden soll, um auf die Nachricht zu antworten.

  • Betreff: Betreff der E-Mail. Sie können eine Variable des Formulars # {name} verwenden. Unterstützte Variablen werden unter "Smart Rule Variables" weiter unten aufgelistet.

  • Text: Text der E-Mail. Sie können eine Variable des Formulars # {name} verwenden. Unterstützte Variablen werden unter "Smart Rule Variables" weiter unten aufgelistet.

  • Antwort auf: Adresse, die verwendet werden soll, um auf die Nachricht zu antworten.

Troubleshooting

  • Bitte überprüfen Sie die gleichen Schritte wie für die Schwellenregel oben.

  • Bitte überprüfen Sie Ihren Spam-Ordner.

Bei Alarm SMS senden

Wenn ein Alarm erzeugt wird, wird eine SMS gesendet.

Diese Regel ist nur verfügbar, wenn Ihr Mieter über einen konfigurierten SMS-Anbieter verfügt.

Die Regel verwendet die folgenden Parameter:

image alt text

  • Alarmtypen: Die Alarmtypen, die die Regel auslösen. Für jeden neu erzeugten Alarm wird eine Regel ausgelöst.

  • Telefonnummer: Zielrufnummer. Es wird empfohlen, mobilen Ländercode für alle Nummern, z.B. "+49" oder "0049" für Deutschland. Mehrere Nummern können durch ein Komma getrennt werden (",", kein Leerzeichen!).

  • Nachricht: SMS-Text mit max. 160 Zeichen. Sie können die Variable # {name} verwenden. Unterstützte Variablen werden unter "Smart Rule Variables" weiter unten aufgelistet.

Troubleshooting

  • Bitte überprüfen Sie die gleichen Schritte wie für die Schwellenregel oben.

  • Wenn Sie eine Variable verwenden, wird ein Limit von 160 als Gesamtzahl angewendet. Wenn nach dem Anwenden der Variablen der Text mehr als 160 Zeichen enthält, wird die SMS nicht gesendet.

##Bei Alarmdauer Schweregrad erhöhen

Wenn ein Alarm für eine bestimmte Zeit aktiv ist, wird der Schweregrad erhöht.

Die Parameter der Regel:image alt text

  • Alarmtypen: Die Alarmtypen, die die Regel auslösen.

  • Dauer: Wie lange muss es einen aktiven Alarm geben, um die Regel auszulösen?

Beschreibung:

  • Wenn ein konfigurierter Alarm ausgelöst wird, beginnt die Überwachung, wie lange der Alarm aktiv bleibt.
  • Wenn der Alarm nach einer bestimmten Zeit noch aktiv ist, erhöht er die Schwere einer Stufe, wie von "WENIGER WICHTIG" auf "WICHTIG".
  • Wenn der Alarm "KRITISCH" ist, wird die Überwachung gestoppt, da keine weiteren Maßnahmen zur Verfügung stehen.

Die Regel überprüft, ob die konfigurierte Dauer einmal pro Minute überschritten wurde. Daher kann es vorkommen, dass sich die Alarmschwelle nicht in der Sekunde ändert, während sie die Dauer überschreitet, sondern nur während der folgenden Überprüfung.

Bei Geofence Alarm erzeugen

Die Geofence-Smart-Regel kann so konfiguriert werden, dass ein Alarm beim Überfahren der Geofence (oder beides) erzeugt wird. Bestehende Alarme werden gelöscht, wenn die entgegengesetzte Bedingung wahr ist, wie wenn ein verfolgtes Fahrzeug, das den Geofence-Bereich verlassen hat, wieder in den Geofence-Bereich eintritt.

Die Regel verwendet die folgenden Parameter:

image alt text

  • Geofence: Definieren Sie ein Polygon, das den Rand eines Bereichs definiert. Klicken Sie auf "Geofence bearbeiten", navigieren Sie zu Ihrem Bereich (z. B. mit dem Feld "Suchadresse") und definieren Sie ein Polygon, indem Sie einmal an jedem Punkt des Rahmens klicken. image alt text

  • Typ: Typ des Alarms, der ausgelöst wird.

  • Text: Text des Alarms, der aausgelöst wird.

  • Schweregrad: Schweregrad des Alarms, der ausgelöst wird.

  • TriggerAlarmOn: Definition, welche Geofence Interaktion den Alarm erzeugt. Werte: "verlassen", "hineinfahren" oder "beide". "Verlassen" wird automatisch als Voreinstellung gesetzt.

Es wird kein Alarm ausgelöst, bis das Gerät zum ersten Mal die Geofence-Grenze überquert.

Troubleshooting

  • Bitte stellen Sie sicher, dass das Gerät innerhalb der Geofence war, einmal mindestens nach dem Erstellen / Aktivieren der Regel

  • Wenn sich das Gerät nicht im Modus Wartung befindet: Es wird kein neuer Alarm aufgrund der Unterdrückungsrichtlinie erzeugt.

  • Wenn Sie keine Alarmzuordnungsregel haben (siehe: Repriorisieren der Alarme), die den Alarmschweregrad ändern: In diesem Fall kann der Alarm eine andere Schwere haben als erwartet .

Berechne Energieverbrauch

Erstellen Sie den Verbrauchsdatenpunkt anhand von Daten aus einem Elektro-, Gas- und Wasserzähler.

Die Regel verwendet die folgenden Parameter:

image alt text

  • Fragment: Name des Messfragments. Die eingehende Messung muss genau den gleichen Fragmentnamen wie konfiguriert haben. Beim Erstellen einer Regel aus dem Datenexplorer ist das Fragment bereits ausgefüllt.

  • Serie: Ähnlich wie Fragment, nur für die Serie.

  • Dauer: Zeitraum, in dem Verbrauchswerte berechnet werden sollen.Dies wird nur definiert, wie oft der Verbrauch nicht die Einheit der Verbrauchsmessung berechnet wird.

  • Consumption Fragment: Name des Messfragments, das generiert werden soll.

  • Consumption Series: Name der Messreihe, die generiert werden soll.

Die Einheit der Verbrauchsmessung ist immer pro Stunde (zB wenn die Messungen in "kg" liegen, wird der Verbrauch in "kg / h" liegen). Die Regel nimmt die letzten zwei Messungen für eine definierte Zeit. Sie berechnet dann die Differenz von Wert und Zeit und berechnet den Verbrauch pro Stunde.

Beispiel:

Die Regel sei so konfiguriert, dass sie alle 20 Minuten berechnet wird. Es folgen folgende Messungen:100 kg bei 11:59 und 200 kg bei 12:14.Um 12:20 wird die Regel das nächste Mal ausgelöst und es dauert die letzten beiden Messungen. Es berechnet Wert und Zeitdifferenz. Die um 12:20 erstellte Verbrauchsmessung beträgt somit 400 kg /h. Falls im letzten Zeitraum keine neue Messung angelegt wurde, wird eine Messung mit Verbrauch 0 angelegt.

Bei fehlenden Messdaten Alarm erzeugen

Erstellen Sie einen Alarm, wenn keine neuen Messdaten für eine bestimmte Zeit empfangen wurden.

Die Regel verwendet die folgenden Parameter:

image alt text

  • Typ: Art der Messung. Die eingehende Messung muss den gleichen Typ haben wie konfiguriert. Beim Erstellen einer Regel aus dem Datenexplorer ist der Typ bereits ausgefüllt.
  • Zeitintervall: Zeitintervall für die Berechnung von Verbrauchswerten.
  • Typ: Typ des ausgelösten Alarms.
  • Schweregrad: Schweregrad des Alarms.
  • Text: Text des ausgelösten Alarms.

Die Regel prüft, ob das konfigurierte Zeitintervall einmal pro Minute überschritten wurde. Daher kann es bis zu einer Minute dauern, bis der Alarm nach Überschreiten des Zeitintervalls erzeugt wurde. Um zu prüfen, ob das Zeitintervall überschritten wurde, muss nach der Aktivierung der Regel mindestens eine eingehende Messung erfolgen.

Bei Alarm Kommando ausführen

Wenn ein bestimmter Alarm aufgetreten ist, senden Sie die angegebene Operation an das Gerät.

Die Regel verwendet die folgenden Parameter:

image alt text

  • Alarmarten: Die Alarmtypen lösen die Regel aus. Für jeden neu festgelegten Alarm wird diese Regel ausgelöst.

  • Operation: Der Vorgang, der gesendet wird. Die Operation wird als JSON-Beschreibung bereitgestellt. Einige Standardoperationen können unter dem Operationsfeld ausgewählt werden. Um einen Standardbetrieb zu verwenden, wählen Sie einen aus und drücken Sie die Pfeiltaste rechts. Dadurch wird die JSON der ausgewählten Operation eingefügt.

Bei Geofence Email senden

Eine E-Mail wird verschickt, wenn ein Gerät das definierte Geofence verlässt oder betritt.

Die Regel verwendet die folgenden Parameter: image alt text

  • Geofence: Definieren Sie ein Polygon in der Weise ähnlich der Regel "Bei Geofence Überschreiten einen Alarm auslösen".

  • Senden an: E-Mail-Adressen für das Versenden der E-Mail an. Mehrere Adressen können durch ein Komma getrennt werden (",", kein Leerzeichen!).

  • CC senden an: Wie bisher nur für E-Mail "CC" Feld.

  • Senden BCC an: Wie bisher nur für E-Mail "BCC" -Feld.

  • Antwort auf: Adresse, die verwendet werden muss, um auf die Nachricht zu antworten.

  • Betreff: Betreff der E-Mail. Sie können eine Variable des Formulars # {name} verwenden. Unterstützte Variablen werden unter "Smart Rule Variables" weiter unten aufgelistet.

  • Text: E-Mail-Text. Sie können eine Variable des Formulars # {name} verwenden. Unterstützte Variablen werden unter "Smart Rule Variables" weiter unten aufgelistet.

Troubleshooting

  • Es wird kein Alarm ausgelöst, bis das Gerät zum ersten Mal die Geofence-Grenze überquert.
  • Den Spam Ordner überprüfen.

Bei Alarm Anruf starten

Wenn ein Alarm erzeugt wird, leitet er einen Text-zu-Sprache-Anruf ein. Die Regel verwendet die folgenden Parameter:

image alt text

  • Alarmtypen: Diese Alarmtypen lösen die Regel aus. Er wird auf alle neuen Alarme angewendet.

  • Telefonnummer: Zielrufnummer. Es wird empfohlen, den mobilen Ländercode für alle Nummern, wie "+49" oder "0049" für Deutschland, einzuschließen.

  • Nachricht: Der von der Regel ausgelesene Text.

  • Wiederholungen: Die Anzahl der Wiederholungen, die Zieltelefonnummer zu erreichen, wenn der Anruf nicht erfolgreich (Telefon besetzt oder Anruf abgelehnt).

  • Intervall: Zeitintervall zwischen den Wiederholungen (in Minuten).

  • Acknowledgement: Flag, der angibt, dass der Empfänger des Anrufs den Anruf quittieren muss (wenn ein nicht quittierter Anruf nicht als erfolgreicher Anruf gezählt wird)

  • Quittierungstext: Die Quittierungsmeldung (wird nach der Hauptmeldung gelesen), zB: "Bitte bestätigen Sie diesen Aufruf mit einem Klick auf 5"

  • Acknowledgement Number: Die Nummer der Taste, die der Empfänger zur Bestätigung drücken muss. Wenn die Taste gedrückt wird, ist der Anruf erfolgreich und der Alarmstatus wird quittiert.

Troubleshooting

  • Überprüfen Sie, dass der Alarm erstellt und nicht dupliziert wurde.

  • Wenn sich das Gerät nicht im Modus Wartung befindet: Es wird kein neuer Alarm aufgrund der Unterdrückungsrichtlinie erzeugt.

  • Wenn Sie keine Alarmzuordnungsregel haben (siehe: Repriorisieren der Alarme), die den Alarmschweregrad ändern: In diesem Fall kann der Alarm eine andere Schwere haben als erwartet .

Bei Alarm eskalieren

Wenn ein Alarm erzeugt wird, wird E-Mail, SMS oder / und ein Text-to_Speach Anruf initiiert.

Die Regel verwendet die folgenden Parameter: image alt text

  • Alarmtypen: Die Alarmtypen lösen diese Regel aus. Er wird auf alle neuen Alarme angewendet.

Die Regel definiert eine Kette von Aktionen in Schritten. Um Schritte hinzuzufügen, klicken Sie auf die Schaltfläche "Schritt hinzufügen". Es erscheint ein Formular mit folgenden Parametern:

image alt text

  • Aktionstyp: Art der Aktion, die im Schritt ausgeführt wird. Mögliche Werte sind:

  • E-Mail senden (siehe unter Alarm E-Mail-Regel für Parameterbeschreibungen senden)

  • Sms senden (siehe Alarm-SMS-Regel für Parameterbeschreibungen senden)

  • Telefon anrufen (siehe Auf Alarm initiieren Text-to-Speech-Aufrufregel für Parameterbeschreibungen)

  • Bedingung: Die Bedingung, die angewendet wird, wenn die Regel ausgeführt wird. Mögliche Werte sind:

  • Immer: Aktion wird immer ausgeführt.

  • Immer: Wenn Schritt N fehlgeschlagen ist: Nur Telefonschritte können fehlschlagen. Der Schritt wird als fehlgeschlagen markiert, sobald alle Wiederholungen ohne erfolgreichen Aufruf durchgeführt wurden. Diese Option wird angezeigt, wenn bereits ein Telefonschritt konfiguriert ist, auf den verwiesen werden kann.

Troubleshooting

  • Überprüfen Sie, dass der Alarm erstellt und nicht dupliziert wurde.

  • Wenn sich das Gerät nicht im Modus Wartung befindet: Es wird kein neuer Alarm aufgrund der Unterdrückungsrichtlinie erzeugt.

  • Wenn Sie keine Alarmzuordnungsregel haben (siehe: Repriorisieren der Alarme), die den Alarmschweregrad ändern: In diesem Fall kann der Alarm eine andere Schwere haben als erwartet .

Smart Rule Variablen

Sie können Variablen in bestimmten Regelparametern verwenden. Wenn eine Regel ausgelöst wird, werden die Variablen durch ihre Istwerte ersetzt. Mit diesem Mechanismus können Sie Gerätenamen oder Alarmtexte in verschiedene Ausgaben (E-Mail, SMS, Text-to-Voice) einfügen. Sie können alle Informationen über das auslösende Ereignis (wie den Alarm) und das Quellgerät davon enthalten.

Beispiel Variablen:

Variable Content
#{creationTime} Zeitpunkt wann der Alarm erstellt wurde
#{type} Typ des Alarms.
#{time} Zeitpunkt des Auslösens.
#{text} Beschreibung des Alarms.
#{source.name} Gerätename.
#{source.c8y_Hardware.serialNumber} Seriennummer des Geräts.
#{source.c8y_Notes} Zusatzinformation.
#{status} Status des Alarms: AKTIV, zur Kenntnis genommen oder GELÖSCHT.
#{severity} Schweregrad des Alarms: KRITISCH, WICHTIG, WENIGER WICHTIG oder WARNUNG.
#{count} Anzahl der Alarm Nachrichten für ein Gerät: Nachrichtenwiederholungen für ein Gerät werden nur fuer das Gerät gewertet.
#{source.c8y_Address.street} Strasse, wo sich das Gerät befindet.
#{source.c8y_Address.cityCode} Postleitzahl, wo sich das Gerät befindet.
#{source.c8y_Address.city} Ortsname, wo sich das Gerät befindet.

Note:Falls die Variable nicht existiert oder falsch geschrieben ist, wird der generierte Inhalt angezeigt.