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.
Aufzählungs-Skripte sind Documents-Standard.
Weitere Informationen können in der Hersteller Dokumentation nachgelesen werden.