Aufzählungs-Skripte (enumval)

In Documents können Skripte fürAufzählungen erstellt werden. Das Ergebnis kann zum Beispiel als Aufzählungsliste in einem Feld verwendet werden. In Aufzählungs-Skripten gibt es immer das Array "enumval". Aufzählungs-Skripte sind Documents-Standard. Weitere Informationen finden Sie entsprechend beim Hersteller.

 

Verwendung in Auswahllisten-Feldern

Bei Aufzählungswerten für ein Auswahllisten-Feld kann zwischen einem technischen Wert und einem Anzeigewert unterschieden werden. Die Angaben werden durch ein ";" getrennt. Das folgende Beispiel speichert im Auswahllisten-Feld den Wert "0" oder "1". Dem Benutzer wird je nach Anmeldesprache ein Text angezeigt.

// Einfaches Beispiel für ein Aufzählungsskript mit technischem Wert und Anzeige-Wert
enumval.push("0;de:Aus;en:Off");
enumval.push("1;de:An;en:On")

Die Skripte werden so eingebunden:

 

Anzeige-Steuerung (z. B. die Anzeige von benutzerdefinierten Aktionen)

Aufzählungs-Skripte können auch verwendet werden, um Register, Dokumenten- oder Email-Vorlagen oder benutzerdefinierte Aktionen auszublenden oder Sie können verwendet werden um einen Schreibschutz auf Felder zu setzen oder um Felder ein- oder auszublenden.

Die häufigste Verwendung ist das Ausblenden von benutzerdefinierten Aktionen. Standardmäßig werden alle benutzerdefinierten Aktionen eingeblendet. In der Regel wünscht man sich eher den umgekehrten Fall, dass die Aktionen nur zum passenden Zeitpunkt für die passenden Benutzer angezeigt werden. Hierfür kann am Mappentypen auf dem Register "Scripting" ein Skript hinterlegt werden.

Das Array "enumval" listet beim Skript-Aufruf bereits alle benutzerdefinierten Aktionen mit dem technischen Namen, denn wie erwähnt werden alle benutzerdefinierten Aktionen standardmäßig immer angezeigt.

"enumval[0]" enthält zum Beispiel den ersten Eintrag. Wenn man den Screenshot als Beispiel nimmt würde der String "UDA_AllowDuplicate" der zugehörige Wert sein. Das Array wird in der Regel mit einer einfachen for-Schleife durchlaufen und innerhalb der Schleife kann via if()-Abfragen oder via switch() .. case geprüft werden um welche Aktion es sich handelt. Um eine Aktion auszublenden muss der Wert auf einen Leerstring "" gesetzt werden.

In den ausgelieferten Modulen wird das Skript für die Anzeige der benutzerdefinierten Aktionen generell als UserExit-Skript ausgeliefert, denn in diesem Skript müssen in den Projekten fast immer Anpassungen vorgenommen werden. Für gewöhnlich werden Feldwerte oder Eigenschaften der aktuellen Mappe und/oder Gruppenzugehörigkeiten des aktuell angemeldeten Benutzers abgefragt und ausgewertet.

Diese Skripte werden relativ häufig aufgerufen. Damit das Kundensystem performant bleibt sollten aufwändige Prozeduren wie Abfragen auf externe Systeme, aufwändige Berechnungen oder sync()-Befehle möglichst vermieden werden.

Aufzählungs-Skripte sind Documents-Standard.
Weitere Informationen können in der Hersteller Dokumentation nachgelesen werden.