Mithilfe der Funktionen für ValueSets lassen sich ValueSets in Scripten einfacher verwenden, z. B. in Aktivitätsergebnissen vom Feldtyp Auswahlfeld. Zu den Funktionen für ValueSets gehören:
Grundlegende Informationen zu den allgemeinen Funktionen der System-Skriptsprache erhalten Sie im Dokument System-Skriptsprache: Allgemeine Funktionen.
valueSet
| Name | valueSet |
| Beschreibung | valueSet erzeugt eine Variable vom Typ Class mit Einträgen aus einem Valueset. |
| Signaturen | <variableName> valueSet(valueSet) |
| Parameter | valueSet ist der vollqualifizierte Name eines ValueSets ohne Anführungszeichen. |
| Ergebnis | Eine Variable vom Typ Class und darin für jeden Valueset-Eintrag eine Konstante mit dem technischen Namen des Eintrags und dessen numerischer ID |
| Fehlerquellen | Keine |
| Beispiele |
const State as valueSet(com.cisag.sys.workflow.ActivityState);
function close(state as Number)
{
if (state = State.DONE) {
} else {
}
}
|
| Kontext | ALL |
| Hinweise | valueSet kann nur bei der Deklaration von Konstanen verwendet werden. |
| Siehe auch | valueSetDescription, valueSetName |
valueSetDescription
| Name | valueSetDescription |
| Beschreibung | valueSetDescription gibt die Bezeichnung eines ValueSet-Eintrags zurück. |
| Signaturen | String valueSetDescription(Hashmap valueSet, Number id)
|
| Parameter | valueSet ist der Name einer als ValueSet deklarierten Konstanten oder einer HashMap mit Einträgen für das ValuseSet.
id ist die numerische ID eines Eintrags im ValueSet. |
| Ergebnis | Die übersetzbare Beschreibung eines ValueSet-Eintrages als eine Zeichenkette. |
| Fehlerquellen | Enthält das ValueSet keinen Eintrag mit der ID id, so wird der Wert nullzurückgegeben. |
| Beispiele | Das ValueSet kann nach der Deklaration mit const als Ausdruck übergeben werden:
Das ValueSet kann aber auch mithilfe des vollständigen technischen Namens übergeben werden:
|
| Kontext | ALL |
| Hinweise | Sie können die Beschreibung verwenden, um beispielsweise dem Benutzer den Wert eines ValueSet-Attributs verständlich in dessen Inhaltssprache anzuzeigen. |
| Siehe auch | valueSet, valueSetName |
Folgendes Beispiel aus der Aktivitätsdefinition help.valueSetDescription zeigt den Namen und die Bezeichnung eines Eintrags des ValueSets com.cisag.sys.workflow.ActivityState an:
const State as valueSet(com.cisag.sys.workflow.ActivityState);
function create()
{
var p_id := parameters.ID;
var r_name := "";
var r_description := "";
var name := valueSetName(State, p_id);
var description := valueSetDescription(State, p_id);
if (not isNull(name)) {
r_name := name;
r_description := description;
}
result.IS_NULL := isNull(name);
result.NAME := r_name;
result.DESCRIPTION := description;
}
valueSetName
| Name | valueSetName |
| Beschreibung | valueSetName gibt den Namen eines ValueSet-Eintrags zurück. |
| Signaturen | String valueSetName(Hashmap valueSet, Number id)
|
| Parameter | valueSet ist der Name einer als ValueSet deklarierten Konstanten oder einer HashMap mit Einträgen für das ValuseSet.
id ist die numerische ID eines Eintrags im ValueSet. |
| Ergebnis | Den Namen des ValueSet-Eintrags als eine Zeichenkette. |
| Fehlerquellen | Enthält das ValueSet keinen Eintrag mit der ID id, so wird der Wert nullzurückgegeben. |
| Beispiele | Das ValueSet kann nach der Deklaration mit const als Ausdruck übergeben werden:
Das ValueSet kann aber auch mithilfe des vollständigen technischen Namens übergeben werden:
|
| Kontext | ALL |
| Hinweise | Sie können den Namen verwenden, um beispielsweise dem Benutzer den Wert eines ValueSet-Attributs verständlich anzuzeigen. |
| Siehe auch | valueSet, valueSetDescription |
Folgendes Beispiel aus der Aktivitätsdefinition help.valueSetDescription zeigt den Namen und die Bezeichnung eines Eintrags des ValueSet com.cisag.sys.workflow.ActivityState an:
const State as valueSet(com.cisag.sys.workflow.ActivityState);
function create()
{
var p_id := parameters.ID;
var r_name := "";
var r_description := "";
var name := valueSetName(State, p_id);
var description := valueSetDescription(State, p_id);
if (not isNull(name)) {
r_name := name;
r_description := description;
}
result.IS_NULL := isNull(name);
result.NAME := r_name;
result.DESCRIPTION := description;
}