Hier in Listenmapping wird beschrieben wie und wo Listen und ihre Einträge genutzt werden können.

In Formularen können Listen genutzt werden in dem Felder mit dem ctrltype listbox oder combobox verwendet werden. Dazu muß das Attribut type=„list“ sein und list muß auf die Liste verweisen. Die Verwendung von listchildren ist optional. Hinter dem Namen der Liste kann mit : (Doppelpunkt) ein bestimmtes Attribut des Listeneintrags gewählt werden, ist nichts angegeben dann wird text verwendet. Soll in einer Wertzuweisung in Preassign mit einem Listeneintrag erfolgen, dann kann GetListTextByParam oder GetListTextFromDict dazu verwendet werden.

Im Beispiel wird statt des Benutzernamens (USER), das zum Namen zugehörige Attribut initialen aus der Liste List_User verwendet.

<Sample ctrltype="textbox" data="Sample" preassign="CALL(GetListTextByParam List_User:initialen|%USER%)" />

In Listenansichten muß das Attribut type=„list“ sein und list muß auf die Liste verweisen. Die Verwendung von listchildren ist optional. Hinter dem Namen der Liste kann mit : (Doppelpunkt) ein bestimmtes Attribut des Listeneintrags gewählt werden, ist nichts angegeben dann wird text verwendet.

Im Beispiel werden in der GUI_Document_List statt des Loginnamens des Benutzers, der im Feld CheckedName gespeichert ist, die in List_User zugeordneten Initialen angezeigt.

<CheckedName data="CheckedName" label="$Primus.COL_APPROVED_NAME" type="List" list="List_User:initialen" position="16" width="104" visible="1" />

Bei der Wertzuweisung in den INI-Dateien von AppAttributes können Listeneinträge mit GetListText zugewiesen werden. Die Definition welche Liste zu verwenden ist, wird dabei aus der GUI_Document_List der CFG.XML genommen. Abweichende Attribute, der Default ist text, für die Ersetzung müssen hier jedoch mit einem Pipe (|) und nicht mit einem Doppelpunkt abgetrennt werden¹⁾

.

Die Zuweisung CheckedName=CALL(GetListText CheckedName) verwendet die Definition aus folgender Definition:

<CheckedName data="CheckedName" type="List" list="List_User:initialen" position="16" width="104" visible="1" label="$Primus.COL_APPROVED_NAME" />