Anpassung › Anpassen der Webschnittstelle › Servervariablen › Geschäftsobjektvariablen

Geschäftsobjektvariablen

Geschäftsobjektvariablen stellen ein CA SDM-Objekt wie einen Issue oder Request dar. Um auf ein Objekt zuzugreifen, müssen Sie mit dem Variablennamen gefolgt von einem Punkt (.) gefolgt von dem Namen des Attributs, das Sie anzeigen möchten, beginnen. Zum Beispiel bei einem Issue, in der das Objekt gemäß Konvention durch die Variable args dargestellt wird, können Sie die Beschreibung, das Öffnungsdatum, die Telefonnummer des Bevollmächtigten, die Anzahl der Aktivitäten für den Issue und die Beschreibung der ersten Aktivität anzeigen, wie im Folgenden dargestellt:

$args.description
$args.open_date
$args.assignee.phone_number
$args.act_log.length
$args.act_log.0.description

Sie können geschweifte Klammern verwenden, um den Variablennamen zu begrenzen, wenn er nicht von Leerzeichen umgeben ist. Sie ist z. B. sowohl „$foo bar“ als auch „${foo}bar“ gültig. Sie können auch die Variable „args“ verwenden, um auf andere Werte als Attribute (z. B. $args.KEEP.name, wie unter Unterstützte Vorgänge beschrieben) zuzugreifen.

Es ist möglich, dass eine Variable, die kein Attribut ist, nicht definiert werden kann. Es kann z. B. möglich sein, auf ein Formular von zwei unterschiedlichen Orten aus zuzugreifen, von denen aber nur einer einen Wert für $args.KEEP.foo liefert. Sie können einen Standardwert für einen $args-Verweis mit der folgenden Syntax angeben, wobei die Zeichenfolge nach dem Doppelpunkt durch den Verweis ersetzt wird, wenn variable nicht definiert ist:

${args.variable:default}

Zeitzonen-Datumsvariablen

Zeitzonen-Datumsvariablen sind ein Sonderfall der Geschäftsobjektvariablen. Sie bieten die Möglichkeit, universelle Daten (UTC), die als Ganzzahlen dargestellt werden, in Zeichenfolgedaten zu konvertieren, die an die Zeitzone des Browsers des Anwenders angepasst sind. Die Variable für die Darstellung von Ganzzahlendaten lautet:

$args.attr_name_INT_DATE

Beispiel: $args.open_date_INT_DATE

Factory-Datumsvariablen

Factory-Datumsvariablen sind ein Sonderfall der Geschäftsobjektvariablen. Eine Factory-Datumsvariable wird durch Informationen über ein referenziertes Objekt ersetzt. Sieben solcher Variablen sind verfügbar:

$args.attr_name.COMMON_NAME

Der allgemeine Name (extern lesbare Zeichenfolge) der Tabelle, auf die von dem Attribut verwiesen wird. Beispiel: In dem Formular „Request – Detail“ entspricht der Wert für „$args.assignee.COMMON_NAME“ dem Kombinationsnamen („last, first, middle“) des Bevollmächtigten.

$args.attr_name.COMMON_NAME_ATTR

Der Attributname des allgemeinen Namens in der Tabelle, auf die von dem Attribut verwiesen wird. Beispiel: In dem Formular „Request – Detail“ ist der Wert für „$args.assignee.COMMON_NAME_ATTR“ gleich „combo_name“.

$args.FACTORY_attr_name

Der Name der Factory, die dem angegebenen Attribut zugeordnet ist. Beispiel: In dem Formular „Request – Detail“ ist der Wert für „$args.FACTORY_assignee“ gleich „agt“.

$args.LENGTH_attr_name

Die maximale Länge des Attributs. Beispiel: In dem Formular „Request – Detail“ ist der Wert für „$args.LENGTH_summary“ gleich „240“.

$args.attr_name.REL_ATTR

Das relative Attribut (Fremdschlüssel) des Attributs. Beispiel: in dem Formular „Request – Detail“ entspricht der Wert für „$args.assignee.REL_ATTR“ dem Wert des ID-Feldes für den Bevollmächtigten.

$args.attr_name.REL_ATTR_ATTR

Der Attributname von rel_attr in der Tablle, auf die dieses Attribut verweist. Beispiel: In dem Formular „Request – Detail“ ist der Wert für „$args.assignee.REL_ATTR_ATTR“ gleich „id“.

$args.REQUIRED_attr_name

Eine Zeichenfolge, entweder „0“ oder „1“, die angibt, ob das referenzierte Attribut erforderlich ist.

$args.attr_name.SELECTIONS

Eine Liste der gültigen Auswahlmöglichkeiten für attr_name. Dieser Wert ist eine leere Zeichenfolge, wenn attr_name kein Verweis auf eine andere Tabelle ist, oder wenn die Größe der Tabelle, auf die attr_name verweist, den Wert der Konfigurationsdateieigenschaft SelListCacheMax überschreitet. Andernfalls ist die SELECTIONS-Variable eine Zeichenfolge, die den allgemeinen Namen und das relative Attribut von allen Einträgen in der referenzierten Tabelle enthält. Nachfolgende Werte werden von der Zeichenfolge „@,@“ getrennt, so dass der Wert der Variablen das folgende Format aufweist:

„cname1@,@rel_attr1@,@cname2@,@rel_attr2“

$args.factory_SEL_UNDER_LIMIT

Eine Zeichenfolge, entweder „0“ oder „1“, die angibt, ob die aktuelle Anzahl an Zeilen in der Tabelle, die factory entspricht, geringer als der Wert der Konfigurationsdateieigenschaft SelListCacheMax ist. Diese Variable wird zu Gunsten der SELECTIONS-Variablen missbilligt, die in allen neuen Formularen verwendet werden sollte.

Factory-Datumsvariablen, die einen Verweis mit Punkten (COMMON_NAME, REL_ATTR und SELECTIONS) enthalten, können mit einem Verweis mit Punkten von beliebiger Länge verwendet werden. Beispiel: In einem Formular „Request – Detail“ kann „$args.assignee.organization.COMMON_NAME“ durch den externen Namen der Organisation des Bevollmächtigten ersetzt werden.