Verwenden des Formulardesigners › So verwenden Sie JavaScript-Ausdrücke in Feldern: › Objekte und Eigenschaften, die in JavaScript-Ausdrücken spezifiziert werden können

Objekte und Eigenschaften, die in JavaScript-Ausdrücken spezifiziert werden können

Sie spezifizieren Objekte und Eigenschaften in JavaScript-Ausdrücken. Sie können diese Ausdrücke für die Laufzeitwerte des Attributs "value" für die Elemente verwenden, die Sie als Felder auf Formularen verwenden. Diese Ausdrücke werden typischerweise in folgendem Format angegeben: $(_.object.property).

Um beispielsweise den Laufzeitwert des angemeldeten Anwenders zu erfassen, der ein Formular für einen Auftrag ausfüllt, verwenden Sie $(_.user.firstName). Sie können Zeichenfolgen auch verketten, dies wird weiter hinten in diesem Abschnitt behandelt.

Diese Variablen gelten nur für Formulardesigner-Formulare! Sie sind den Objekten und Eigenschaften, die in Formularvariablen für CA Workflow definiert werden, ähnlich, jedoch nicht völlig mit ihnen identisch. Wenn Sie Formulare des Formulardesigners und CA Workflow-Formulare nebeneinander verwenden, achten Sie darauf, die korrekten Objekte und Eigenschaften für den jeweiligen Formulartyp zu verwenden.

Formulare

Das Formularobjekt enthält folgende Eigenschaft, die Sie in JavaScript-Ausdrücken oder als ersten Parameter in JavaScript-Funktionen verwenden können: ca_fd.formId.

"formId" bezieht sich auf das aktive Formular. Das Formular ist in aktiv, wenn ein Feld im Formular ein Event auslöst. Es folgen ein paar Beispielaktionen, die Formulare aktivieren:

• Der Anwender öffnet das Formular, während an einem Auftrag gearbeitet wird und aktiviert somit das JavaScript-Attribut "onLoad".
• Der Anwender klickt auf eine Bezeichnung oder ein Bild, das das JavaScript-Attribut "onClick" aktiviert.
• Der Anwender übergibt das Formular, das das JavaScript-Attribut "onSubmit" aktiviert.

Anwender

Das Anwenderobjekt enthält ein Array der Anwendereigenschaften, auf das Sie mit _.user zugreifen können.

Jedes Anwenderobjekt listet folgende Eigenschaften in zugehörigen Gruppen auf:

• ID, UUID, Status (0 = aktiv, 1 = inaktiv)
• firstName, lastName, middleName, commonName, alias, title
• Gruppen

  Die Eigenschaft "_.user.groups" gibt den Namen einer Anwendergruppe in CA EEM an. Sie können diese Eigenschaft verwenden, um ein Feld zu manipulieren, das darauf basiert, ob der Anwender einer bestimmten CA EEM-Gruppe gehört. Weitere Informationen finden Sie im Beispielabschnitt.

  Die Eigenschaft "_.user.groups" enthält ein Array mit allen CA EEM-Gruppen, denen der Anwender angehört.

• manager, delegate, description
• phone (ein Array: phone[0] = primär und phone[1] = sekundär)
• mobile, fax, pager, email
• timezone, localeLanguage, localeCountry, defaultRole, defaultDomain, location.uuid, location.name, location.city, location.state, location.country, location.postalCode, location.phone, location.fax, location.description, location.address[0-5]
• roles.<domain>

Beispiele

Sie können die Eigenschaft "_.user.groups" verwenden, damit ein Feld für die Mitglieder einer CA EEM-Gruppe, z. B. der Gruppe der Entwickler, nicht angezeigt wird. Legen Sie dazu das HTML-Attribut "Hidden" folgendermaßen fest:

_.user.groups.indexOf("Entwickler") >= 0

Sie können aber auch ein Feld für Anwender anzeigen, die kein Mitglied einer CA EEM-Gruppe sind. Legen Sie dazu den Wert des HTML-Attributs "Hidden" folgendermaßen fest:

_.user.groups.indexOf("Entwickler") < 0

Business Unit

Das Geschäftsbereichsobjekt enthält ein Array der Geschäftsbereichseigenschaften, auf das Sie mit _.bu zugreifen können.

Jedes Geschäftsbereichsobjekt listet folgende Eigenschaften in zugehörigen Gruppen auf:

• id, name
• type (Typ des Geschäftsbereichs: SP=Service Provider, ST=kann über untergeordnete Geschäftsbereiche verfügen, TE=kann nicht über untergeordnete Geschäftsbereiche verfügen)
• singleAccountMode ("Wahr oder "Falsch")
• status (0=inaktiv, 1=aktiv)
• openedDate, description, timezone, federalTaxId, stateTaxId, taxRegion, currency, dateFormat, parent (parent bu id)
• email, website, primaryContact (contact userid), location.uuid, location.name, location.city, location.state, location.country, location.postalCode, location.phone, location.fax, location.description, location.address[0-5]
• data1, data2, data3, data4, and data5

Request

Das Auftragsobjekt enthält ein Array der Auftragseigenschaften, auf das Sie mit _.request zugreifen können.

Jedes Auftragsobjekt listet folgende Eigenschaften in zugehörigen Gruppen auf:

• id, name, requestedFor, requstedForAccountId, requestedBy, requestedByAccountId
• description, priority, status
• dateCreated, completionDate, dateRequired, und lastModified
• newDateRequired, newName, und newPriority

  Diese Eigenschaften stellen den neuen Wert eines Objekts dar, sobald der Anwender das Objekt während des Lebenszyklus eines Auftrags aktualisiert. (Der Anwender ist normalerweise ein Auftragsmanager oder der Anforderer.)

  Der Anwender kann das Objekt beispielsweise aktualisieren, während die ausstehende Aktion für das Element mit der zugeordneten Eigenschaft genehmigt, abgelehnt oder erzwungen wird. Der neue Wert wird sofort übernommen, sobald der Anwender die Eigenschaft aktualisiert. Speichern ist nicht erforderlich.

  Wenn Formulare erstellt oder bearbeitet werden, können Sie diese Eigenschaften nach eigenem Ermessen verwenden. Zum Beispiel können Sie diese Eigenschaften in einer anwenderspezifischen JavaScript-Funktion zur Validierung verwenden, die Sie im JavaScript-Attribut "OnSubmit" verwenden. Wenn ein Anwender beispielsweise ein ungültiges Datum eingibt, wie z. B. einen Feiertag, kann Ihre anwenderspezifische JavaScript-Funktion einen Text anzeigen, der die gültigen Daten erklärt.

Service

Das Serviceobjekt enthält ein Array der Auftragseigenschaften, auf das Sie mit _.service zugreifen können.

Jedes Service-Objekt listet folgende Eigenschaften in zugehörigen Gruppen auf:

• id, bu, name, description
• status(0=gelöscht, 1=verfügbar, 2=nicht verfügbar, 3=erstellt, 4=storniert, 5=gesamt)
• website, code, version, dateAvailable, dateUnavailable, dateCreated, dateCancelled

Serviceoptionsgruppen

Das Serviceoptionsgruppenobjekt enthält ein Array der Serviceoptionen, auf das Sie mit _.sog.name zugreifen können.

Jede Serviceoptionsgruppe listet folgende Eigenschaften in zugehörigen Gruppen auf:

• id, bu, name, description
• status(0=gelöscht, 1=verfügbar, 2=nicht verfügbar, 3=erstellt, 4=storniert, 5=gesamt)
• code
• dateAvailable, dateUnavailable, dateCreated, dateCancelled

Serviceoptionen

Das Serviceoptionsobjekt gilt nur für die vordefinierte JavaScript-Funktion "_.serviceoption.status( )".

Die Funktion "_.serviceoption.status( )" enthält eine einzelne Eigenschaft mit dem Namen "newStatus".

Hinweis: Diese Funktion übernimmt keine Parameter.

newStatus--

Gibt den neuen Wert für den Status an, wenn eine Anwenderaktion den Status der Serviceoption aktualisiert. Diese Eigenschaft übernimmt den neuen Wert für den Status, sobald der Anwender einen der folgenden Schritte ausführt:

• Wählt einen neuen Statuswert aus der Dropdown-Liste in der Spalte "Aktion" aus, während ein Auftrag mit ausstehender Aktion verwaltet wird. Normalerweise wird diese Aktion von einem Auftragsmanager ausgeführt. Der Wert von "newStatus" ändert sich dynamisch, sobald der Anwender den neuen Status der Serviceoption auswählt.
• Öffnet eine Seite oder ein Dialogfeld, das den Status in einen festen Wert ändert, wenn der Anwender auf "OK" klickt. Wenn ein Anwender beispielsweise einen Auftrag erstellt, wird der Wert von "newStatus" dynamisch geändert, sobald der Anwender den Auftrag erstellt. In diesem Beispiel wird der Wert von "newStatus" sofort in "Übergeben" geändert.

In beiden Fällen ändert sich der Wert von "_.serviceoption.newStatus( )" sofort. Im Gegensatz dazu bleibt der Wert von "_.serviceoption.status( )" unverändert, bis die Seite übergeben und aktualisiert wird.

Hinweis: JavaScript-Funktionen, die mit Statusänderungen zusammenhängen, ändern ihr Verhalten nicht, wenn sie von davon abhängig sind, dass der Anwender die Seite oder das Dialogfeld fertigstellt. (Normalerweise wird für diese Aktion auf "OK" geklickt). Zum Beispiel weist die JavaScript-Funktion "onSubmit" normalerweise auf Statusänderungen hin. Die Funktion "onSubmit" wird nur ausgeführt, wenn der Anwender die Seite oder das Dialogfeld fertigstellt, nicht wenn der Wert von "newStatus" sich ändert.

Beispiele

Sie können die Eigenschaft "newStatus" verwenden, damit Ihre Implementierung Reservierungen effizient verarbeitet. Nehmen Sie beispielsweise an, dass ein Anwender einen Hauptauftrag für einen Computer und zusätzliche Aufträge für zugehörige Optionen übergibt. Diese Optionen schließen zusätzlichen Speicher, eine aktualisierte Tastatur usw. ein. Sie können eine anwenderspezifische JavaScript-Funktion so erstellen, dass wenn der Hauptauftrag abgelehnt wird, die Funktion "onSubmit" für alle optionalen Aufträge ausgeführt wird. Beispiele für optionale Aufträge beinhalten Zubehör, zusätzlichen Speicher usw. ein. Zum Beispiel ergibt folgender Ausdruck den Wert "Wahr", wenn der ursprüngliche Status 400 ist, und wenn "newStatus" auf 800 geändert wird:

 if (_.serviceoption.status() == 400 && _.serviceoption.newStatus == 800)...

Operatoren

Hier werden die Operatoren beschrieben, die hauptsächlich für das Formulardesign eingesetzt werden. Für eine vollständige Beschreibung der Standardoperatoren siehe die JavaScript-Standardreferenz, die Ihre Organisation verwendet, z. B. www.developers.sun.com oder www.javascript.com.

Sie können in Ihrem JavaScript-Ausdruck alle Standardoperatoren außer Zuordnungsoperatoren angeben.

Die Zuordnungsoperatoren lauten: =, +=, -=, *=, /= .

Zum Beispiel ist folgender Ausdruck ungültig, da der Zuweisungsoperator = verwendet wird:

$(var x = 1+2)

Erforderliche Rückgabewerte

Geben Sie JavaScript-Ausdrücke an, die für die Attribute "disabled", "checked" und " hidden" verwendet werden, die einen der folgenden Werte zurückgeben:

• wahr oder "wahr"
• falsch oder "falsch"

Wenn der Ausdruck einen anderen Wert zurückgibt, ersetzt CA Service Catalog diesen Wert durch "falsch". Wenn Sie "$(_.user.firstName)" für das Attribut "disabled" eines Textfeldes angeben, wird das Feld also nicht deaktiviert - es sei denn, der Vorname des Anwenders lautet "wahr".

Verkettungsoperatoren

Sie können optional zwei Zeichenfolgen mithilfe des Operators + miteinander verketten.

Zum Beispiel gibt $ ('Hallo'+ _.user.firstName +'' + _.user.lastName) folgenden Text zurück: Hallo Vorname Nachname. "Hallo John Doe" und "Hallo Jane Smith" sind Beispiele.

Vergleichsoperatoren

Alternativ können Sie folgende Vergleichsoperatoren verwenden:

• == ist gleich
• === ist genau gleich (Wert und Typ)
• != Ungleich
• > Wert ist größer als
• < Wert ist kleiner als
• >= Wert ist größer oder gleich
• <= Wert ist kleiner oder gleich

Beispiele, die im Formulardesigner verwendet werden, finden Sie unter folgenden Abschnitten:

• So können Sie ein Feld auf Basis von Auftragsstatus, Geschäftsbereich, Rolle oder anderen Kriterien ein- oder ausblenden:
• Auswählen oder Löschen von Feldern, die standardmäßig auf Auftragsstatus, Rolle, Geschäftsbereich oder anderen Kriterien basieren

Logische Operatoren

Alternativ können Sie folgende logische Operatoren verwenden:

• und (&&)
• oder (||)
• nicht (!)

Beispiele, die im Formulardesigner verwendet werden, finden Sie unter folgenden Abschnitten:

• So können Sie ein Feld auf Basis von Auftragsstatus, Geschäftsbereich, Rolle oder anderen Kriterien ein- oder ausblenden:
• Auswählen oder Löschen von Feldern, die standardmäßig auf Auftragsstatus, Rolle, Geschäftsbereich oder anderen Kriterien basieren