Konfigurationsdatei für Bediener-Tasks-Vorlagen (JSON-Datei)
Die in Desigo CC importierte Task-Vorlagen-Konfiguration ist eine JSON-Datei, in der wichtige Daten angegeben werden können, die für die Erstellung von Bediener-Tasks erforderlich sind.
Änderungen an vorhandenen Vorlagen
Wenn eine vorhandene Vorlage geändert wird, sind die vor den Änderungen erstellten zugehörigen Tasks von den Änderungen nicht betroffen, da die Vorlagendaten in diese Tasks kopiert werden. Löschen Sie bei Problemen oder wenn Sie eine Vorlage ändern möchten, die aus dieser Vorlage erstellten Tasks vor den Änderungen.
Ziele mit anderen Masseinheiten als die Originalvorlage verwalten
Wenn eine Task Zielobjekte verarbeiten muss, deren Masseinheit von der in der Originalvorlage abweicht, muss die Originalvorlage geändert und entsprechend der gewünschten Masseinheit angepasst werden.
Einzelheiten zu den Attributen finden Sie im Folgenden.
Vorlagenattribute | |||
Parameter | Beschreibung | Verwendung | Beispiel |
Duration | Standardtaskdauer, ausgedrückt in dd:hh:mm. | Optional | „Duration“: „01:06:30“ |
NotesRequired | Gibt an, ob die Bedienernotizen erforderlich sind. Gültige Werte sind "Ja" (Standard) oder "Nein". | Optional |
|
RevertActionMode | Der Modus Zurücksetzen. Gültige Werte sind "Manuell" (Standard) oder "Automatisch". | Optional | "RevertActionMode": "Automatisch" |
TimeoutForConditions | Der maximale Timeout (in Sekunden), bevor die Bedingungen nach der Ausführung der Zurücksetzungsbefehls überprüft werden. Der Standardwert ist 30 Sekunden. | Optional | "TimeoutForConditions" : 60 |
TaskActions | Eine Reihe von Task-Aktionen. Einzelheiten finden Sie in der folgenden Tabelle. | Notwendig | Beispiele finden Sie in der folgenden Tabelle. |
Attribute für Taskaktionen | |||
Parameter | Beschreibung | Verwendung | Beispiele |
ObjectModels | Name oder Array der Namen der Objektmodelle des zu kommandierenden Systemobjekts. Wenn "*" oder nicht angegeben (Standard), wird die Task-Aktion auf alle Zielobjekte angewendet. | Optional | "ObjectModels":
"ObjectModels": |
ObjectModelsExcluded | Name oder Array von Namen der Objektmodelle, die von der Task-Aktion ausgeschlossen werden sollen. Dieses Attribut kann nur angegeben werden, wenn ObjectModels gleich "*" ist:
| Optional | Task-Aktion nicht für alle Objektmodelle ausführen, die in allen anderen Task-Aktionen explizit definiert sind: "ObjectModelsExcluded": "*"
Task-Aktion nicht für alle Objektmodelle ausführen, die in allen anderen Task-Aktionen und in den angegebenen Bereichs- und Zonenobjekten explizit definiert sind: "ObjectModelsExcluded": ["*","GMS_FS20EN_EOT_FI_Area", "GMS_FS20EN_EOT_FI_ManualZone"]
Task-Aktion nicht für die angegebenen Bereichs- und Zonenobjekte ausführen: "ObjectModelsExcluded": ["GMS_FS20EN_EOT_FI_Area", "GMS_FS20EN_EOT_FI_ManualZone"
|
Eigenschaft CommandName | Name der zu befehlenden Eigenschaft und Name des auszuführenden Befehls. | The pair Property/CommandName ist alternativ zu dem Alias-ID des Befehls. | Bereich/Zone ausschliessen "ObjectModels": ["GMS_FS20EN_EOT_FI_Area", "GMS_FS20EN_EOT_FI_ManualZone"],
Alarme in einer Teilstruktur unterdrücken "Eigenschaft": "SuppressAlarms",
Unterdrückt Alarme auf einem bestimmten Ordner "Property“: "SuppressAlarms", |
CommandAlias | Die ID des Alias, der den auszuführenden Befehl darstellt. | Dieses Attribut ist eine Alternative zum Paar Property/CommandName. | FS20EN-Brandmelder ausschliessen (15 ist der Alias für „Exclude“) "ObjectModels": ["GMS_FS20EN_EOT_FI_FireDetector"], “CommandAlias" : 15 Alarme auf einem bestimmten Ordner unterdrücken (unter Angabe des Alias 76, dem Alias für „SuppressAlarm“) "CommandAlias" : 76 |
Parameter | Array von Befehlsparametern mit Werten. | Dieses Attribut muss nur angegeben werden, wenn für den Befehl Parameter erforderlich sind. Hinweis: Der Wert dieses Attributs muss in der entsprechenden Masseinheit angegeben werden, wenn diese für den Wert relevant ist. | "ObjectModels" : ["GmsOrganizationMode"], |
OverridableParameter | Name des Parameters, dessen Wert für jedes Ziel vom Bediener während der Task-Konfiguration geändert werden kann. | Optional. Dieses Attribut muss angegeben werden, damit der Parameterwert während der Task-Konfiguration bearbeitet werden kann. Pro Befehl bzw. Zurücksetzungsbefehl ist nur ein übersteuerbarer Parameter zulässig. | "OverridableParameter": “Value” |
RevertAction | Die Definition der Zurücksetzungsaktion, d. h. das Zurücksetzen auf einen früheren Zustand. Einzelheiten finden Sie in der folgenden Tabelle. | Optional | Beispiele finden Sie in der folgenden Tabelle. |
Bedingung | Die Bedingung muss einen Wert enthalten, der es ermöglicht, dass die Task auf den Status Die zu überprüfende Bedingung, wenn die Task abläuft oder nachdem die Zurücksetzaktion ausgeführt wurde. Einzelheiten finden Sie in der folgenden Tabelle. | Notwendig | Beispiele finden Sie in der folgenden Tabelle. |
ExecutionOrder | Ausführungsreihenfolge der Aktion. Dieses Attribut sollte nur angegeben werden, wenn die Task-Aktionen in einer bestimmten Reihenfolge ausgeführt werden müssen. | Optional | "ExecutionOrder": 1 |
Attribute für Zurücksetzungsaktionen | |||
Parameter | Beschreibung | Verwendung | Beispiele |
Eigenschaft CommandName | Name der zu befehlenden Eigenschaft und Name des auszuführenden Zurücksetz-Befehls. | Das Paar Property/CommandName ist alternativ zu dem Alias-ID des Befehls. | Zone einschliessen "Property": "Mode", "CommandName": "Enable"
Unterdrückung von Alarmen in einer Teilstruktur aufheben "Property": "SuppressAlarms", "CommandName": "DisableAll"
Alarmunterdrückung für einen bestimmten Ordner deaktivieren "Property": "SuppressAlarms", |
CommandAlias | Die ID des Alias, der den auszuführenden Zurücksetz-Befehl darstellt. | Dieses Attribut ist eine Alternative zum Paar | FS20EN-Zone einschliessen (16 ist der Alias für „Einschliessen“) "CommandAlias“: 16
Unterdrückung der Alarme auf einem bestimmten Ordner aufheben (unter Angabe des Alias 77, dem Alias für “UnsuppressAlarm”) "CommandAlias": 77 |
Parameter | Array von Befehlsparametern mit Werten. | Dieses Attribut muss nur angegeben werden, wenn für den Befehl Parameter erforderlich sind. Hinweis: Der Wert dieses Attributs muss in der entsprechenden Masseinheit angegeben werden, wenn diese für den Wert relevant ist. | "Parameter": {"Value": 1, "Priority": 8} |
OverridableParameter | Name des Parameters, dessen Wert für jedes Ziel vom Bediener während der Task-Konfiguration geändert werden kann. | Optional. Dieses Attribut muss angegeben werden, um den Wert des Parameters während der Task-Konfiguration bearbeiten zu können. Pro Befehl bzw. Zurücksetzungsbefehl ist nur ein übersteuerbarer Parameter zulässig. | "OverridableParameter": “Value” |
Attribute für Bedingungen | |||
Parameter | Beschreibung | Verwendung | Beispiele |
Eigenschaft | Name der Eigenschaft, die von der Bedingung überprüft wird. Wenn nicht angegeben, wird stattdessen der Name der Eigenschaft verwendet, die von der Task-Aktion befohlen wird. | Optional | Sicherstellen, dass eine Zone nicht deaktiviert ist "Bedingung": { "Property" : "Mode", "Operator": "<>", „Value": 0 } |
Operator | Vergleichsoperator der Bedingung. Zulässige Werte:
| Notwendig | Sicherstellen, dass die Alarmunterdrückung deaktiviert ist (für die Eigenschaft "SuppressAlarms" 0 = Deaktiviert, 1 = Aktiviert) "Bedingung": { "Property" : "SuppressAlarms", "Operator": "=", „Value": 0 } |
Wert | Der Wert, der für den Vergleich einer Bedingung verwendet werden soll. | Notwendig Hinweis: Der Wertetyp muss mit dem Eigenschaftstyp übereinstimmen. Zudem muss der Wert dieses Attributs in der entsprechenden Masseinheit angegeben werden, wenn diese für den Wert relevant ist. | |
ValuePerObjectModel | Objektmodell/Wert-Paare, die spezifische Werte für spezifische Objektmodelle angeben. | Optional Hinweis: Die Objektmodelle in dieser Liste müssen ebenfalls zur Liste ObjectModels von TaskAction gehören. Wenn ein Objektmodell in der Liste ValuePerObjectModel nicht angegeben ist, wird der Bedingungswert aus dem Attribut Value gelesen. | Stellen Sie sicher, dass der Wert für Objekte vom Typ "ObjectModels": "*", "Condition": { "Operator": ">", "Value": 1, “ValuePerObjectModel”: {"GMS_BACNET_EO_BA_AO_1": "1.2"} } |
Index | Der Index des einzelnen, auszuwertenden Elements, wenn der Typ der Bedingungseigenschaft ein Array ist. | Optional | Stellen Sie sicher, dass das Element mit dem Index 7 der Eigenschaft Priority_Array Max oder NaN lautet. "Condition": { "Property": "Priority_Array", "Operator": "=", "Index": 7, "Value": "Max", "ValuePerObjectModel": {"GMS_BACNET_EO_BA_AO_1": "NaN"} }, |
MaxAge | Bedingung für das Abrufen von Daten aus dem Feld. Wenn der Wert aus dem Feld in Millisekunden älter als diese Angabe ist, wird er erneut abgerufen und der aktuellste Wert bereitgestellt. Wenn dieser Parameter -1 ist (Standardeinstellung), wird der Wert immer aus dem Prozessabbild abgerufen. | Optional | |
Beispiele für Vorlagen für Bediener-Tasks
Vorlage, mit der Alarme in einer Teilstruktur für einen Tag, sechs Stunden und dreissig Minuten unterdrückt werden können
Wenn eine aus dieser Vorlage erstellte Task abläuft, wird überprüft, ob die Eigenschaft "SuppressAlarms" der dieser Task zugeordneten Zielobjekte "0" ist. Das bedeutet, dass die Alarmunterdrückung deaktiviert ist.
{
"Template":
{
"Duration": "01:06:30",
"TaskActions":
[
{
"Property": "SuppressAlarms",
"CommandName": "EnableAll",
"Condition":
{
"Operator": "=",
"Value": 0
}
}
]
}
}
Vorlage, mit der Alarme für ein bestimmtes Systemobjekt für zwei Stunden unterdrückt werden können
Wenn eine aus dieser Vorlage erstellte Task abläuft, wird überprüft, ob die Eigenschaft "SuppressAlarms" der dieser Task zugeordneten Zielobjekte "0" ist. Das bedeutet, dass die Alarmunterdrückung deaktiviert ist.
{
"Template":
{
"Duration": "00:02:00",
"TaskActions":
[
{
"Property": "SuppressAlarms",
"CommandName": "Enable",
"Condition":
{
"Operator": "=",
"Value": 0
}
}
]
}
}
Vorlage, mit der Alarme in einer Teilstruktur unterdrückt werden können und die Zurücksetz-Aktion nach zwei Tagen automatisch ausgeführt wird
Mit dieser Vorlage können Tasks erstellt werden, die Alarme der mit der Task verknüpften Zielobjekte unterdrücken, in zwei Tagen ablaufen, keine Bedienernotizen erfordern und die Zurücksetz-Aktion automatisch ausführen.
Nach Ausführung der Zurücksetz-Aktion wird überprüft, ob die Alarmunterdrückung für die der Task zugeordneten Zielobjekte deaktiviert ist (Eigenschaft SuppressAlarms gleich 0).
{
"Template":
{
"Duration" : „02:00:00",
"NotesRequired": "No",
"RevertActionMode": "Automatic",
"TaskActions": [
{
"Property": "SuppressAlarms",
"CommandName": "EnableAll",
"RevertAction":
{
"CommandName" : "DisableAll"
},
"Condition":
{
"__comment": "0 = Disabled; 1 = Enabled",
"Operator": "=",
"Value": 0
},
},
]
}
}
Vorlage, mit der ein Bereich vom Typ "GMS_FS20EN_EOT_FI_Area" und eine Zone vom Typ "GMS_FS20EN_EOT_FI_ManualZone" für 45 Minuten ausgeschlossen werden können
Wenn eine aus dieser Vorlage erstellte Task abläuft, wird überprüft, ob die Eigenschaft "Mode" der dieser Task zugeordneten Zielobjekte 1 ist.
{
"Template":
{
"Duration": „00:00:45",
"TaskActions" :
[
{
"ObjectModels": ["GMS_FS20EN_EOT_FI_Area", "GMS_FS20EN_EOT_FI_ManualZone"],
"Property": "Mode",
"CommandName": "Disable",
"Condition":
{
"Operator": "=",
"Value": 1
}
}
]
}
}
Vorlage, die einen Ausschluss von Brandalarmen ermöglicht und die Zurücksetz-Aktion nach fünf Stunden automatisch ausführt
Mit dieser Vorlage können Tasks erstellt werden, die die Zielobjekte ausschliessen, nach fünf Stunden ablaufen und die Zurücksetz-Aktion automatisch ausführen.
Nach der Zurücksetz-Aktion wird mit einem maximalen Timeout von 60 Sekunden überprüft, ob die der Task zugeordneten Zielobjekte aktiviert sind (Eigenschaft "Mode" gleich 0).
Diese Vorlage unterbindet den Ausschluss von Zielobjekten des Typs „GMS_FS20EN_EOT_FI_Area“.
{
"Template":
{
"Duration" : „00:05:00",
"RevertActionMode": "Automatic",
"TimeoutForConditions" : 60,
"TaskActions" :
[
{
"ObjectModelsExcluded": "GMS_FS20EN_EOT_FI_Area",
"CommandAlias" : 15,
"RevertAction" :
{
"CommandAlias" : 16,
},
"Condition":
{
"Property" : "Mode",
"Operator" : "<>",
"__comment" : "0 = Disabled",
"Value" : 0
}
},
]
}
}
Vorlage, mit der mehrere Befehle für dieselben Objekte ausgeführt werden können
Mit dieser Vorlage können beim Starten einer Task sowohl die Befehle DisableInput (ExcludeIn) als auch DisableOutput (ExcludeOut) ausgeführt werden. Wenn die Task abläuft, wird sowohl der Befehl EnableInput (IncludeIn) als auch EnableOutput (IncludeOut) wie Zurücksetz-Aktionen ausgeführt.
Nach der Zurücksetz-Aktion wird mit einem maximalen Timeout von 60 Sekunden überprüft, ob die der Task zugeordneten Zielobjekte aktiviert sind (Eigenschaft “Status.Modus” gleich 0).
{
"Template":
{
"Duration": "00:05:00",
"RevertActionMode": "Automatic",
"TimeoutForConditions" : 60,
"TaskActions":
[
{
"ObjectModels": ["GMS_7_FI_MXL_Detector_Device", "GMS_7_FI_MXL_Fire_Detector_Device"],
"__comment": "47 = ExcludeIn",
"CommandAlias": 47,
"RevertAction":
{
"__comment": "49 = IncludeIn",
"CommandAlias": 49,
},
"Condition":
{
"Property": "Status.Mode",
"Operator": "<>",
"__comment": "0 = Disabled",
"Value": 0
}
},
{
"ObjectModels": ["GMS_7_FI_MXL_Detector_Device", "GMS_7_FI_MXL_Fire_Detector_Device"],
"__comment": "48 = ExcludeOut",
"CommandAlias": 48,
"RevertAction":
{
"__comment": "50 = IncludeOut",
"CommandAlias": 50,
},
"Condition":
{
"Property": "Status.Mode",
"Operator": "<>",
"__comment": "0 = Disabled",
"Value": 0
}
},
]
}
}
Vorlage, die das Schreiben eines Werts erlaubt, den der Bediener beim Konfigurieren der Task angeben kann
Diese Vorlage wird auf BACNet Analogeingänge und Binäreingänge angewendet und führt die folgenden Befehle in der angegebenen Reihenfolge aus:
- Ausser Betrieb (Befehl OutOfSvc für die Eigenschaft Out_Of_Service)
- Wert schreiben (Befehl Write für die Eigenschaft Present_Value)
Die Zurücksetzungsaktion ist nur für die erste Aktion erforderlich und führt den Befehl InService für die Eigenschaft Out_Of_Service aus.
Nach Ausführung der Zurücksetzungsaktion wird geprüft, ob die Zielobjekte in Betrieb sind (Eigenschaft Out_Of_Service hat den Wert 0).
{
"Template": {
"TaskActions": [
{
"ExecutionOrder": 0,
"ObjectModels":
[
"GMS_BACNET_EO_BA_AI_1",
"GMS_BACNET_EO_BA_BI_1"
],
"Property": "Out_Of_Service",
"CommandName": "OutOfSvc",
"RevertAction": {
"CommandName": "InService"
},
"Condition": {
"Operator": "=",
"Value": 0
},
},
{
"ExecutionOrder": 1,
"ObjectModels":
[
"GMS_BACNET_EO_BA_AI_1",
"GMS_BACNET_EO_BA_BI_1"
],
"Property": "Present_Value",
"CommandName": "Write",
"OverridableParameter": "Value",
"Condition": {
"Property": "Out_Of_Service",
"Operator": "=",
"Value": 0
},
},
]
}
}
