Befehlsdaten

Für jeden Befehl müssen die folgenden Daten angegeben werden:

Daten

Verwendung

Beschreibung

CommandType

Notwendig

Name des Befehlstyps für die ausgewählte Eigenschaft (z. B. BACnetAnalogWithPriority).

Hinweis: Der Befehl muss in dem Projekt vorhanden sein.

Name

Notwendig

Name des Befehls.

Hinweis: Dieser Name muss für die aktuelle Eigenschaft eindeutig sein (z. B. WritePrio08, ReleasePrio08).

Beschriftung

Optional

Liste von Werten, die als Beschreibung des Befehls verwendet werden (z. B. beschreibender Text für die Schaltfläche im Status- und Befehlsfenster). Jeder Wert muss folgende Daten beinhalten:

  • Kultur: Kultur des Textes (z.B. “en-US”).
  • Text: Label

Wenn die Liste leer ist („Label“: [ ]), wird der Name des Befehls als Standardlabel angenommen.

Guid

Optional

Eine Zeichenfolge, die den Befehl kennzeichnet.

Hinweise:

  • Der Wert dieser Zeichenfolge wird vom System automatisch zugewiesen, wenn der Befehl zum ersten Mal erstellt wird. Der Wert darf nicht manuell eingestellt werden.
  • Wenn ein Objektmodell zum ersten Mal importiert wird, haben die Befehle, die für dessen Eigenschaften angegeben sind, keine GUID oder die GUID wurde zwar deklariert, ist aber leer ("Guid": “”). In diesem Fall erstellt der Importer einen neuen Befehl.
  • Wenn ein Objektmodell exportiert wird, enthält die GUID den automatisch vom System zugewiesenen Wert. Dieser Wert darf nicht geändert werden, andernfalls kann der Befehl bei einem Re-Import nicht mehr erkannt werden.
  • Im Falle eines Re-Imports:
    • Wenn die Guid nicht angegeben oder leer ist („Guid“: “”), wird der Befehl erstellt bzw. neu erstellt.
    • Wenn die GUID angegeben ist und mit der eines vorhandenen Befehls übereinstimmt, wird der vorhandene Befehl aktualisiert.
    • Wenn die GUID angegeben ist und nicht mit der eines vorhandenen Befehls übereinstimmt, wird der Befehl ignoriert.
    • Alle bereits vorhandenen, aber noch nicht aktualisierten Befehle, die den übereinstimmenden GUID-Mechanismus verwenden, werden entfernt.
    • Wenn ein zuvor erstellter Befehl gelöscht werden muss, müssen Sie ihn aus der Befehlsliste entfernen.

Abhängigkeiten

Optional

Liste der Abhängigkeiten.

Ausführliche Informationen zum Definieren einer Abhängigkeit (d. h. einer Bedingung, die auf einer in den Dependency<X>-Feldern angegebenen im Eigenschaft basiert) finden Sie in der Tabelle Abhängigkeitsdaten:.

Alias

Optional

Alias-ID. Der Standardwert ist 0 (entspricht "k.A.").

Hinweise:

  • Der Alias muss für alle Eigenschaften eines Objektmodells eindeutig sein.
  • Die anzugebende ID entspricht dem Wert des zugehörigen Alias in der Befehlsmakro-Textgruppe (TxG_CommandMacro). Die ID muss in der Textgruppe vorhanden sein, bevor der Import ausgeführt wird.
  • Die Befehlsmakro-Textgruppe wird von diesem Importer nicht verwaltet. Wenn diese Textgruppe in der JSON-Datei hinzugefügt wurde, wird sie ignoriert.

Gruppe

Optional

Diese Zeichenfolge definiert die Konfiguration der Befehlsgruppen im Expander Scope-Rechte der Sicherheitsdefinition, die zum Ausführen des Befehls verwendet wird. Mögliche Einstellungen:

  • Standard (Sta.)
  • Event (Eve.)
  • Advanced (Adv.)
  • Ownership (Own.)

Wenn nichts angegeben ist, wird üblicherweise die Standardeinstellung (Sta.) verwendet.

Steuerung

Optional

Die Art der Steuerung, die in der Benutzeroberfläche verwendet werden muss. Mögliche Einstellungen:

  • Standard
  • Expander

Wenn nichts angegeben ist, wird standardmässig die Einstellung "Default" verwendet.

Kombiniert

Optional

True, wenn bei mehreren Befehlen ein Befehl aus einer Dropdown-Liste ausgewählt werden kann.

Der Standardwert lautet False.

Anzeige

Optional

Diese Zeichenfolge definiert, wo der Befehl verwendet wird. Mögliche Einstellungen:

  • SOFTWARE
  • GENERIC_DISPLAY
  • GENERIC_DISPLAY_SOFTWARE
  • RESERVED

Wenn nichts angegeben ist, wird standardmässig die Einstellung GENERIC_DISPLAY_SOFTWARE verwendet.

TargetedProperty

Optional

Name der Zieleigenschaft, die von diesem Befehl betroffen ist.

Wenn nichts angegeben ist, wird standardmässig die aktuelle Eigenschaft verwendet.

Wenn die Zeichenfolge leer ist ("TargetedProperty": “”), wird die aktuelle Eigenschaft übernommen.

Wenn die Zieleigenschaft Teil einer Struktur oder einer Referenz ist, muss der vollständige Name angegeben werden (<Name der Struktur>.<Name der Eigenschaft>), z.B.: “Struct_Value.Int_Value”).

Wenn die Zieleigenschaft ein Element aus einem Satz ist, muss der Name aus dem Namen des Satzes und dem Index der Eigenschaft bestehen (<Name des Satzes>[<Index>]), z.B.: “SetChar_Value[1]”). Beachten Sie, dass der Index mit "1" beginnt.

Logging

Optional

Diese Zeichenfolge definiert, wann Werte in die History-Datenbank geschrieben werden. Mögliche Einstellungen:

  • ALWAYS
  • NEVER
  • ON_FAILURE

Wenn nichts angegeben ist, wird standardmässig der Wert "ALWAYS" verwendet.

Parameter

Optional

Liste der Parameter. Ausführliche Informationen zur Definition eines Parameters finden Sie in der Tabelle Parameterdaten.

Im Falle eines Re-Imports müssen alle erforderlichen Parameter angegeben werden. Tatsächlich wird die Liste der Parameter bei jedem Import neu erstellt.