6.3 ModalDialog - Methoden
6.3.1 Einleitung
Modale Dialoge können die enaio® Clients ansteuern und Aktionen auslösen. Wie in "6.1.2 Kommunikation Clients ↔ modaler Dialog" dargestellt erfolgt dieses über Callback-Mechanismen, wird jedoch in asynchronen Methoden gekapselt.
6.3.2 Standard-Methoden
Methodenname | Verfügbar ab | Beschreibung |
|---|---|---|
11.10.7 | ||
11.10.7 | ||
11.10.7 | ||
11.10.7 | ||
11.10.7 | ||
11.10.7 | ||
11.10.7 | ||
11.10.16 |
XXX
6.3.3 Zwischenspeicherung von Feldwerten
Alle validen Werte, die mit der Methode setFieldValueByInternal in ein Maskenfeld gesetzt werden sollen, werden zunächst in einem internen Zwischenspeicher gehalten. In diesem Zwischenspeicher wird die Reihenfolge der Aufrufe beibehalten. Mehrfache Aufrufe von setFieldValueByInternal auf das gleiche Feld ersetzen jeweils den davor gespeicherten Wert im Zwischenspeicher.
Die Werte aus dem Zwischenspeicher werden erst dann in die Maske zurückgeschrieben, wenn der modale Dialog mit der Methode closeModalDialog und einem Rückgabewert 1 geschlossen wurde. Wird der modale Dialog mit einem anderen Rückgabewert geschlossen, werden die zwischengespeicherten Werte verworfen und die Werte der Maske werden nicht verändert.
Die Methode getFieldValueByInternal gibt immer zuerst den Wert aus dem Zwischenspeicher zurück. Ist dort keine Wert vorhanden, gibt sie den Wert aus der Indexdatenmaske selbst zurück.
6.3.4 Zwischenspeicherung von Workflow-Variablenwerten
Alle validen Werte, die mit der Methode setWorkflowVariableByName gesetzt werden sollen, werden zunächst in einem internen Zwischenspeicher gehalten. In diesem Zwischenspeicher wird die Reihenfolge der Aufrufe beibehalten. Mehrfache Aufrufe von setWorkflowVariableByName auf die gleiche Workflow-Variable ersetzen jeweils den davor gespeicherten Wert im Zwischenspeicher.
Die Werte aus dem Zwischenspeicher werden erst dann in die Workflow-Variablen zurückgeschrieben, wenn der modale Dialog mit der Methode closeModalDialog und einem Rückgabewert 1 geschlossen wurde. Wird der modale Dialog mit einem anderen Rückgabewert geschlossen, werden die zwischengespeicherten Werte verworfen und die Werte der Workflow-Variablen werden nicht verändert.
Die Methode getWorkflowVariableByName gibt immer zuerst den Wert aus dem Zwischenspeicher zurück. Ist dort keine Wert vorhanden, gibt sie den davor gespeicherten Wert der Workflow-Variable zurück.
Da die Werte ggf. auch in die jeweils mit Workflow-Variablen verbundenen Felder auf der Workflow-Maske geschrieben werden, erfolgt auch die Zwischenspeicherung von Feldwerten. Wenn der modale Dialog mit der Methode closeModalDialog und einem Rückgabewert 1 geschlossen wurde, werden zunächst die Werte aus dem internen Zwischenspeicher für Workflow-Variablen in die verbundenen Felder zurückgeschrieben. Danach erfolgt die Abarbeitung des internen Zwischenspeicher für Feldwerte, d.h. wenn der Feldwert zunächst mit der Methode setWorkflowVariableByName und danach mit der Methode setFieldValueByInternal geändert wird, gewinnt die letztere.