Dieses Kommando ändert die Werte eines Kommandos. Mit dem Block Kommando "Brick Kommandowerte ändern" wird ein Brick ausgewählt. Mit dem Kommando "Brick Zeile ändern" wird eine Parameter Änderung vorgenommen. Am Ende des Block Kommandos werden die Änderung zu der Datenbank geschrieben.
Parameter für das Block Kommando
- Brick ID: Der Brick der geändert werden soll.
- Neueste Brick Version: Ja(Default)=Ändere die neueste Version von dieser Brick ID. Nein=Ändere diesen Brick auch wenn es neuere Versionen gibt.
- Folder: wenn keine Brick ID übergeben, dann mit Folder und Brickname suchen
- Brickname: wenn keine Brick ID übergeben, dann mit Folder und Brickname suchen
- Bei Fehler anhalten?: Ja(Default)=Bei Fehler den Durchlauf anhalten. Nein=Fehler ignorieren und alle mögliche Änderungen vornehmen.
- Neue Brick Version?: Ja(Default)=neue DLEVERSION wird angelegt mit gültig von/bis Daten. Nein=nur neue Revision.
- Gültig Von: wenn neue Version angelegt werden soll -> leer = letze Version gültig bis
- Gültig Bis: wenn neue Version angelegt werden soll -> leer = 2999-12-31
- Fehlermeldung Zielvariable: Wenn bei Fehler nicht angehalten wird, dann werden Fehler in diese Variable geschrieben.
- Neue Brick ID Zielvariable: Wenn eine neue Version erstellt werden soll, wird die neue Brick ID in diese Variable geschrieben.
- Änderungskommentar: Jede Änderung im Brick wird protokolliert. Das Protokoll kann am Ende des Bricks in einem Kommentar Block ausgegeben werden. Dieser Parameter wird über die Property Files übersetzt und mit Platzhalter für diese Werte versehen: {date} {user} {lineNr} {commandName} {paramName} {oldVal} {newVal} . Z.B. "Preiseänderung am {date} von {user} auf Zeile {lineNr}. Für Übersetzungen, wie üblich muss die Zeichenkette mit @@ versehen werden. Alte Änderungskommentare werden behalten. Bleibt der Parameter leer, werden keine Änderungen geschrieben und alte Kommentare bleiben wie gehabt.
Parameter für das Brick Zeilen Ändern Kommando
- Zeile: Das Kommando soll auf dieser Zeilennummer im Brick vorkommen.
- Kommando: Genau dieses Kommando muss auf der Zeile stehen.
- Parameter: Dieser Parameter wird geändert z.B. calcValue, op1, text
- Original Wert: Dieser Wert ist im aktuellen Brick erwartet. Wenn dieser Parameter leer ist, wird immer der neuer Wert geschrieben.
- Neuer Wert: Dieser Wert wird gespeichert.
- Fehlerreferenz: Dieser Wert wird in die Fehlermeldung geschrieben.
Fehlerbehandlung
Bei Fehler anhalten
Es wird eine DLE Java Exception mit der Brick Id, Kommando, Parameter und Werte geworfen.
Bei Fehler nicht anhalten
Es werden alle Fehler in eine Variable geschrieben. Nur ein Fehler pro Zeile wird protokolliert. Beispiel:
BRICK_ID=12345;ROW=12;COMMAND=BASE:comment;PARAM=text;OLD_VAL=Hello World!;NEW_VAL=Hello again, World!;ERROR=PARAM_NOT_FOUND;REFERENCE=myUniqueReference
BRICK_ID=12345;ROW=13;COMMAND=DCE:CalculationElement;PARAM=calcValue;OLD_VAL=40.5;NEW_VAL=41.5;ERROR=OLD_VALUES_DO_NOT_MATCH;REFERENCE=myUniqueReference
Mögliche "ERROR" Werte
- COMMAND_NOT_FOUND
- Kommando auf der Zeile nicht gefunden
- PARAM_NOT_FOUND
- Kommando und Zeile richtig, aber Parameter nicht gefunden
- OLD_VALUES_DO_NOT_MATCH
- Kommando, Zeile und Parameter richtig, aber Wert im Brick stimmt nicht mit "Original Wert" überein.
*WICHTIGER HINWEIS* Es werden nur Fehler vom Kommando "Brick Zeile ändern" gefangen. Andere Java-Fehler können auftauchen und müssen selber abgedeckt werden.
