====== Lists ======
Im [[Abschnitte|Abschnitt]] **Lists** werden Listen definiert, die in Primus für verschiedene Zwecke genutzt werden können. Da wäre die Möglichkeit mit [[combobox]] oder [[listbox]] in einem Formular Auswahllisten anzuzeigen, oder in Listenansichten um statt der Dateiendung das zugehörige [[Icon]] darzustellen.

===== Namenskonvention für Listen =====
Der Name der Liste ist, von Hardcoded Listen abgesehen, frei wählbar, muss aber eindeutig sein. Es wird aber empfohlen Listen nach dem Schema ''List_<LISTENINHALT>'' aufzubauen. Dadurch bleibt die Konfiguration für den Administrator übersichtlich und lesbar.

===== Standardlisten in Primus =====
In Primus sind von Haus aus einige Listen standardmäßig enthalten. Diese Listen sind aber nicht zwingend erforderlich und die Listeneinträge können auch geändert werden.
^Liste ^Hardcoded ^Zweck^
| [[List_WorkflowStatus]]| ''x''| Enthält die Benennung, Symbole und Farben für die Status die ein Dokument haben kann|
| List_WriteStatus| | Enthält den Text und das Symbol für schreibbar / schreibgeschützt|
| List_MODIFIED| | Enthält Text und Symbol für den [[Modified]] Status|
| [[List_FileTypes]]| ''x''| Enthält die Benennungen und Symbole für die verwalteten Dokumenttypen|
| List_FileTemp_docx| | {{tag>Klärungsbedarf}}|
| List_BOM_State| | Enthält den Text für die verschiedenen Stücklisten Status eines Stücklisteneintrags|
| List_User| | Enthält die Loginnamen der Benutzer sowie deren vollständiger Name, eine Kurzform und z.B. die Initialen|
| [[List_Material]]| ''x''| Liste der Werkstoffe die im CAD System definiert sind, der Abgleich erfolgt über eine Primusfunktion|
Für die Hardcoded Listen ist der Name von Primus vorgegeben und kann nicht frei bestimmt werden.

===== Benutzerdefinierte Listen =====
Es können unternehmensbezogen weitere Listen nach Bedarf konfiguriert werden. Es empfiehlt sich, diese Ergänzungen in der //[[Lists.xml]]// einzutragen. Die //LISTS.xml// wird mit Attribut [[Lists#include]] in den Abschnitt **Lists** eingebettet. Jede benutzerdefinierte Liste muß einen ''<Lists>'' Abschnitt haben. Es ist sinnvoll Listen auf mehrere Dateien aufzuteilen.

===== Listeneinträge =====
Listeneinträge bestehen immer aus einem [[Glossar#Leer-Tag]] mit dem Namen **entry**. Das [[Glossar#Attribut]] **value** ist erforderlich, dazu mindestens ein weiteres Attribut, i.d.R. **text**, mit dem der zugehörige Listeneintrag verknüpft ist. Es können aber beliebige weitere Attribute definiert werden. Das Attribut ''childlist'' wird für [[Hierarchische Listen]] benötigt.

==== Beispiel ====
Hier im Beispiel wird zusätzlich das Attribut ''icon'' definiert, welches den Pfad zum zugehörigen Icon angibt.
<code xml>
<Lists>
    <List_ProjectTypeIcon>
      <entry value="PROJNODE" text="Projektknoten" icon="Resources\Icons\project" />
      <entry value="CAD" text="CAD" icon="Resources\Icons\cad" />
      <entry value="DOC" text="Dokumentation" icon="Resources\Icons\office" />
      <entry value="FOLDER" text="Ordner" icon="Resources\Icons\folder" />
      <entry value="STD" text="Standard" icon="Resources\Icons\stdpart" />
    </List_ProjectTypeIcon>
</Lists>
</code>

===== include =====
Mit dem Attribut **include** ist es möglich weitere Listen die in separaten Dateien gespeichert sind, beim Start von Primus dazu zu laden. Es können mehrere Listendateien angegeben werden, diese müssen dann mit einem ''|'' getrennt werden. Es ist möglich absolute Pfade oder relative Pfade anzugeben, bei letzterem muß ggf. ein ''.'' vorangestellt werden. Der Vorteil einer absoluten Pfadangabe die auf den Server verweist ist, das Änderungen an einer Liste beim nächsten Start von Primus unmittelbar von den Clients übernommen werden, ohne das ein Update des Primus Clients ausgeführt werden muss.
Das include Attribut kann in den Listendateien ebenfalls verwendet werden, diese Verschachtelung ist aber zu vermeiden, da beim entfernen einer Liste, so evtl. weitere Listen auch nicht mehr geladen werden.
<code xml>
<Lists include=".\Resources\LISTS.xml|\\primus\PrimusSetup\Resources\SE_MATERIAL.LIST.xml|.\Resources\Lists_Kunde.xml|\\primus\PrimusSetup\Resources\List_Users.xml">
</code>

===== Siehe auch =====
  * [[Listenmapping]]
  * [[Hierarchische Listen]]

{{tag>Liste Hardcoded}}