Das Steuerelement des Typs „Liste“ ermöglicht die Auswahl eines Elements aus der Dropdown-Liste der Werte des Steuerelements.
Hinweis: Ab Version 2023.1.0 besteht die Möglichkeit, das Tabellarische-Daten-Steuerelement durch das Listen-Steuerelement zu beobachten (siehe Beispiel: Beobachtung eines Tabellarische Daten-Steuerelements durch eine Listen-Steuerelement).
In der Definition des Steuerelements sind folgende Felder verfügbar:
- Anzeigename – das ist ein Feld, dessen Inhalt auf der Workflow-Karte sichtbar sein wird, der Feldwert muss nicht eindeutig sein, wodurch es möglich ist, mehrere Steuerelemente hinzuzufügen, für die derselbe Name angezeigt wird.
- Name (ID) – das ist ein Feld, dessen Wert nur in den Eigenschaften des Steuerelements sichtbar ist. Der Wert dieses Feldes muss innerhalb der Workflow-Karte einzigartig sein.
- Anzeige auf der gesamten Breite – durch Markierung dieser Eigenschaft wird das Steuerelement in voller Breite des Fensters „Workflow-Datenblatt“ angezeigt.
- Steuerelement in einer neuen Zeile anzeigen – der Parameter ist dafür verantwortlich, das Steuerelement an den Anfang einer neuen Zeile der Workflow-Karte zu setzen, ohne dass die Separatoren zwischen dem aktuellen und dem vorherigen Steuerelement hinzugefügt werden müssen. Die Möglichkeit der Nutzung des Parameters „Steuerelement in einer neuen Zeile anzeigen“ ist abhängig vom Wert des Parameters „Anzeige auf der gesamten Breite“. Wenn der Parameter „ Anzeige auf der gesamten Breite“ ausgewählt wurde, ist es nicht möglich das Parameter „Steuerelement in einer neuen Zeile anzeigen“ zu benutzen. Wenn der Parameter „Steuerelement in einer neuen Zeile anzeigen“ aktiviert ist, ist der Parameter „Anzeige auf der gesamten Breite“ verfügbar. Seine Auswahl schaltet aus und deaktiviert den Parameter „Steuerelement in einer neuen Zeile anzeigen“.
- In Dokumentenliste anzeigen – Parameter, der dafür verantwortlich ist, ob eine Spalte mit den Steuerelementwerten in der Liste der Dokumente angezeigt wird, die auf den Workflow-Typ eingegrenzt wird, zu dem das Steuerelement hinzugefügt wurde.
Initialisierung von Werten und Wertänderung (Beobachter)
- Initialisierung – das Feld kann folgenden Wert annehmen: Datenwörterbuch, SQL OD, SQL ERP oder C# Script.
Wenn der Wert „Datenwörterbuch“ ausgewählt wird, kann der Betreiber eine feste Liste von Positionen für das Steuerelement definieren und den in der Steuerung präsentierten Eintrag als Standardwert auswählen.
Bei dem Wert „SQL OD“ oder „SQL ERP“ wird die Liste von Positionen auf Basis einer SQL-Abfrage initialisiert, die auf Basis von Comarch DMS bzw. Comarch ERP XL arbeitet.
Im Fall des Werts „C# Script“ ist es möglich, den Code in C#-Programmiersprache zu definieren, der die Werte im Steuerelement initialisieren wird.
- Bei jedem Öffnen einleiten – Parameter sichtbar, wenn „SQLOD“ oder „C# Script“ im Feld „Initialisierung“ ausgewählt ist; durch die Auswahl eines Parameters werden die im Steuerelement angezeigten Werte jedes Mal initialisiert, wenn das Dokument in einer Stufe geöffnet wird, in der die SQL/C#-Initialisierung in seinen Eigenschaften aktiviert ist. Das Deaktivieren eines Parameters bedeutet, dass der Wert einmal initialisiert wird.
Wenn der Parameter ‘Präsentation einer Standardwerts‘ abgewählt bleibt, wird standardmäßig ein leerer Wert (1) in der Workflow-Karte im Steuerelement angezeigt, die definierten Werte werden nach dem Maximieren der Liste angezeigt. Wenn Sie einen Parameter auswählen, zeigt das Steuerelement standardmäßig den ausgewählten Wert (2) an.
Hinweis:
Beispiel für SQL-Abfrage für das Steuerelement des Typs „Liste“
select 1, 'abcd’
union
select 2, ‘xyz’
Identifikationsart – das Feld ermöglicht es dem Betreiber, den Typ der Identifikatoren nachfolgender Positionen auf der Liste zu definieren. Übernimmt Werte:
- Int – wenn die IDs nachfolgender Positionen in der Liste mit einer Zahl bestimmt sind. Bei der Initialisierungsmethode mit dem Wörterbuch ist der ID-Typ immer int.
- Text – wenn die IDs nachfolgender Positionen in der Liste mit einem Textwert definiert sind (z. B. GUID).
Wenn im Steuerelement Liste der ID-Typ als int angegeben ist, werden im SQL-Abfrageeditor in den Initialisierungs- und Beobachtungsmechanismen die folgenden Parameter angezeigt:
- <ID_des_Steuerelements_des_Typs_Liste>_Id
- <ID_des_Steuerelements_des_Typs_Liste>_Text
Wenn im Steuerelement Liste der ID-Typ als text angegeben ist, werden im SQL-Abfrageeditor in den Initialisierungs- und Beobachtungsmechanismen die folgenden Parameter angezeigt:
- <ID_des_Steuerelements_des_Typs_Liste>_IdText
- <ID_des_Steuerelements_des_Typs_Liste>_Text
Verknüpfte Steuerelemente – Steuerelement, das eine Liste von verwandten Steuerelementen darstellt, auf deren Grundlage der Wert des Ergebnissteuerelements berechnet wird. Das Ergebnissteuerelement ist ein Steuerelement, auf dem ein z. B. arithmetischer Ausdruck mit gebundenen Steuerelementen definiert wurde.
Arbeitsmodus – das Feld nimmt folgende Werte an: „Liste“ oder „Suchen“. Der Wert „Liste“ füllt das Steuerelement mit einer vollständigen Liste von Positionen, die auf der Grundlage der SQL-Abfrage definiert wurden. Der Wert „Suchen“ initialisiert das Steuerelement mit einer Liste von Positionen, die die vom Betreiber eingegebenen Suchkriterien erfüllen. Im Arbeitsmodus „Suchen“ kann mit einer beliebigen Zeichenfolge nach einem Wert gesucht werden. Dieser Arbeitsmodus hängt vom Wert des Parameters „Nach einer beliebigen Zeichenfolge suchen“ ab. Wenn der Arbeitsmodus des Steuerelements auf „Liste“ eingestellt ist, ist der Parameter nicht verfügbar.
Das Steuerelement des Typs „Liste“ kann als Steuerelement verwendet werden, aus dem der Benutzer definierte Werte auf der Workflow-Karte aus der Konfiguration des Steuerelements auswählt, z. B. Zahlungsmethoden. Wenn in der Konfiguration dieses Steuerelements eine SQL-Abfrage eingegeben ist, können Sie damit eine bestimmte Liste der Werte aus der Datenbank abrufen, den die Anwendung automatisch in das Feld des Steuerelements einträgt.
Beispiel:
Auf Basis von Comarch DMS wurde eine zusätzliche Tabelle erstellt (do.wdrKontrahenci), in der die Daten von Geschäftspartnern gespeichert werden:
In der Definition des Workflow-Typs wurde ein Steuerelement des Typs Liste hinzugefügt:
Die Werte im Steuerelement des Typs Liste werden mit einer SQL-Abfrage initialisiert:
Basierend auf der Abfrage im Steuerelement „Auftragnehmer“ steht auf der Workflow-Karte eine Liste aller Geschäftspartner aus der Tabelle zur Verfügung:
Das Steuerelement des Typs „Liste“ in der Workflow-Karte wird mit einem Standardwert ausgefüllt, wenn für dieses Steuerelement in einer bestimmten Stufe kein Wert gespeichert wurde. Der Betreiber kann den Standardwert auf dem Dokument bearbeiten und ändern. Der eingegebene Wert wird gespeichert und gemerkt. Für Steuerelement des Typs Liste wurde die Möglichkeit programmiert, die Werte in den nächsten Stufen neu zu initialisieren. Wenn für das Steuerelement die Eigenschaft „SQL-Initialisierung“ ausgewählt wurde (in mehreren Stufen), wird die Steuerung in jeder Stufe mit dem Standardwert neu initialisiert.
Es ist möglich, in einem Steuerelement des Typs „Liste“ auf den Namen und die Position des ausgewählten Elements zu verweisen.
