DoAction

Dieses Paket wird von dem Dienst im Produktivbetrieb an die Komponente versendet um eine Aktion auszulösen. Dabei hat der Dienst bereits im Vorfeld eine eingehende Prüfung vorgenommen und es ist sichergestellt, dass es sich um eine der Komponente bekannte Aktion handelt und zudem alle Parameter den Vorgaben entsprechen.

{
    "command": "DoAction",
    "id": "run",
    "parameters": [
        {
            "id": "p1",
            "value": "test"
        },
        {
            "id": "p2",
            "value": 12
        }
    ]
}

Codierung String: DoAction<TAB>run<TAB>p1<TAB>"test"<TAB>p2<TAB>12

Hinweis: Die Reihenfolge der Parameter ist egal, optionale Parameter können auch ganz entfallen. Elementare Datentypen werden immer in ihrer JSON Notation übermittelt, i.e. 42, 3.14159, true, "Text", ... Insbesondere werden Zeichenkette immer mit den doppelten Hochkommas gekapselt. Wird ein optionaler Parameter nicht weggelassen, so kann er leer (undefined) werden - eine leere Zeichenkette hingegen wäre "". Experimentell wird die JSON Notation auch für Feldparameter beibehalten, i.e. [1,2,3,4] als Wert wäre das Feld mit den Zahlen 1, 2, 3 und 4.

Man beachte auch, dass zur Vereinfachung des Protokolls hier im Gegensatz zu allen anderen Paketcodierungen auf die Angabe von Feldnamen verzichtet wurde.

Die eindeutige Kennung id der Aktion muss immer angegeben werden, parameters ist optional.