Das Element <command> konfiguriert einen Command um eine oder mehrere Aktionen auszuführen. Mit den Attributen parent, relatedObjects, src und target werden Angaben zu den Komponenten gemacht.
Das auszuführende Command wird mit dem Attribut xsi:type referenziert).
Attributname | Verwendung | Attributwerte | Defaultwert | Beschreibung |
---|---|---|---|---|
id | benötigt | Eindeutiger Name auf den referenziert werden kann. | ||
relatedObjects | optional | this | Formel zum Engineering Objekt, das aktuell eingefügt wird | |
src | benötigt | Typ des Engineering Objekts, das gezogen wurde | ||
xsi:type | benötigt | changeInstanceParent changeClassParent createNodeForClass createNodeForInstance deleteNodeCommand instantiateAndCreateNode |
Definiert die Funktion des Commands changeInstanceParent: Der Knoten einer Instanz kann von einer Übergeordneten Komponente zu einer anderen gezogen werden. changeClassParent = Der Knoten einer Baukastenkomponente kann von einer übergeordneten Baukastenkomponente zu einer anderen gezogen werden. createNodeForClass = Erzeugt einen Knoten für eine Komponente, die aus der Baukasten-Bibliothek in das Diagramm gezogen wird. createNodeForInstance = Erzeugt einen Knoten für eine Komponente, die vom Projektbaum in das Diagramm gezogen wird. deleteNodeCommand = löst zusätzlich zum Löschen weitere Aktionen aus. instantiateAndCreateNode = Erzeugt eine Instanz der angegebenen Komponente und einen Knoten aus der Palette. |
Erlaubte Unterelemente | Anzahl |
---|---|
ecAction | beliebig |
Das folgende Codebeispiel definiert einen Command, der einen neuen Knoten für eine Komponente erzeugt, die per Drag & Drop aus dem Projektbaum in das Diagramm gezogen wird:
<command xsi:type="createNodeForInstance"
src="=isInstanceOf('WaterSupply_ModularSystem.Items.Cictern')"
id="command1"/>
Folgendes Codebeispiel definiert einen Command, er einen neuen Knoten für eine neue Instanz einer Komponente erzeugt, die aus der Palette heraus erzeugt wird:
<command xsi:type="instantiateAndCreateNode"
src="=isClassEO() and
(absoluteName='WaterSupply_ModularSystem.Items.Cictern')"
eoClassPath="WaterSupply_ModularSystem.Items.Cictern"
id="command8"/>
Das folgende Codebeispiel definiert einen Command mit dem Typ deleteNodeCommand, der mit der Aktion ClearParameterReferenceAction (2) zusätzlich zum Löschen des Knotens vom Typ Execution (1) noch in der Vorgängerkomponente (3) den Wert des Parameters mit der Referenz zum Nachfolger (4) löscht.
Ergebnis:
Nach dem Löschen des Knotens vom Typ Ausführung (1) ist in der Vorgängerkomponente (3) der Wert des Parameters Nachfolger (4) gelöscht.
Sollen weitere Parameterwerte gelöscht werden, sind unter dem gleichen Command weitere Actions zu konfigurieren.