====== Listenmapping ======
Hier in **Listenmapping** wird beschrieben wie und wo [[Lists|Listen]] und ihre Einträge genutzt werden können.

===== Formularen =====
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]] dazu verwendet werden.

==== Beispiel ====
Im Beispiel wird statt des Benutzernamens (''USER''), das zum Namen zugehörige [[Glossar#Attribut]] ''initialen'' aus der Liste  ''List_User'' verwendet.
<code xml>
<Sample ctrltype="textbox" data="Sample" preassign="CALL(GetListTextByParam List_User:initialen|%USER%)" />
</code>

===== Listenansichten =====
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.

==== Beispiel ====
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.
<code xml>
<CheckedName data="CheckedName" label="$Primus.COL_APPROVED_NAME" type="List" list="List_User:initialen" position="16" width="104" visible="1" />
</code>

===== AppAttributes =====
Bei der Wertzuweisung in den INI-Dateien von [[AppAttributes]] können Listeneinträge mit [[GetListText]] oder [[GetListTextFromDict]] zugewiesen werden. Die Definition welche Liste zu verwenden ist, wird dabei aus der [[GUI_Document_List]] der [[CFG.XML]] genommen. <del>Abweichende Attribute, der Default ist ''text'', für die Ersetzung müssen hier jedoch mit einem Pipe (''|'') und nicht mit einem Doppelpunkt abgetrennt werden</del>((Dies ist eine Fehlinterpretation aus der Anfangszeit)).

==== Beispiel ====
Die Zuweisung ''CheckedName=CALL(GetListText CheckedName)'' verwendet die Definition aus folgender Definition:
<code xml>
<CheckedName data="CheckedName" type="List" list="List_User:initialen" position="16" width="104" visible="1" label="$Primus.COL_APPROVED_NAME" />
</code>


{{tag>Liste}}