Analytics Builder 10.14.0 | Bedienungsanleitung für Analytics Builder for Cumulocity IoT | Blockreferenz | Eingabe | Positionseingabe
 
Positionseingabe
apama.analyticsbuilder.blocks.PositionInput
Empfängt Event-Objekte aus Cumulocity IoT und extrahiert das c8y_Position-Fragment in ein Value-Objekt.
Wenn kein c8y_Position-Fragment vorhanden ist, wird das Ereignis ignoriert. Wenn das Fragment nicht mindestens einen gültigen Breitengrad und einen gültigen Längengrad enthält, wird das Ereignis ignoriert. Wenn der Parameter "Primärwert" auf "Höhe" gesetzt ist und das Fragment keine Höhe enthält, wird das Ereignis ignoriert. Breitengrade müssen zwischen -90 und 90 Grad einschließlich liegen. Längengrade müssen zwischen -180 und 180 Grad einschließlich liegen.
Der Primärwert der Ausgabe des Value-Objekts kann als Breitengrad, Längengrad oder Höhe festgelegt werden. Alle Bestandteile des c8y_Position-Fragments werden zum Eigenschaften-Dictionary des Value-Objekts hinzugefügt.
Wenn der Parameter "Zeitstempel ignorieren" festgelegt ist, ignoriert der Block den Zeitstempel des Ereignisses und verarbeitet die Messwerte in der Reihenfolge ihres Empfangs. Falls nicht, ordnet er die Ereignisse neu und verwirft alte Messwerte.
Der Parameter, der den Eingangs-Stream des Blocks definiert, ist "Gerät oder Gerätegruppe" und "Ereignistyp", wenn festgelegt.
Hinweis: Bei der Ausführung im Simulationsmodus werden die Zeitstempel aufgrund der Verwendung historischer Eingabedaten nicht ignoriert.
Hinweis: Für Event-Objekte wird keine Änderungshistorie gepflegt, sodass es nicht möglich ist, die Originalobjekte aus dem Inventar abzurufen. Deshalb kann sich ein Modell, das diesen Eingabeblocktyp enthält, im Simulationsmodus anders verhalten als im Produktionsmodus.
Parameter
Name
Beschreibung
Typ
Hinweise
Gerät oder Gerätegruppe
Das Gerät oder die Gerätegruppe, von der die Position empfangen wird.
Der Modelleditor verwendet den aktuellen Geräte- oder Gerätegruppennamen. Dieser ist intern der Inventar-ID zugeordnet.
string
Ereignistyp
Der Ereignistyp, auf den der Block hört. Wenn nicht gesetzt, erfolgt keine Filterung nach Typ.
Um Ereignisse aus einem anderen Modell zu verwenden, muss diese Eigenschaft festgelegt sein.
string
Optional
Benachrichtigungs­­modus
Filtert Event-Ereignisse so, dass nur neue Ereignisse, aktualisierte Ereignisse oder alle Ereignisse verarbeitet werden.
In der Standardeinstellung werden alle Ereignisse verarbeitet.
Option - eine von:
*Alle
*Nur aktualisierte Alarme
*Nur neue Ereignisse
Standard: Nur neue Ereignisse
Zeitstempel ignorieren
Wenn gewählt, wird der Zeitstempel des eingehenden Messwerts ignoriert.Hinweis: Bei der Ausführung im Simulationsmodus werden die Zeitstempel aufgrund der Verwendung historischer Eingabedaten nicht ignoriert.
boolean
Standard: false
Primärwert
Der Primärwert, der vom Block ausgegeben wird: Breitengrad, Längengrad oder Höhe, oder leer, wenn nicht festgelegt.
Option - eine von:
*Breitengrad
*Längengrad
*Höhe
Optional
Details zum Ausgangsport
Name
Beschreibung
Typ
Position
Ein Objekt, das mindestens Breitengrad und Längengrad enthält.
any