Vordefinierte JavaScript-Funktionen

CA Service Catalog bietet verschiedene Möglichkeiten für die Ausführung von automatisierten Tasks in Formularfeldern, darunter Berichtsdatenobjekte, JavaScript-Ausdrücke und JavaScript-Funktionen. In diesem Abschnitt werden die vordefinierten JavaScript-Funktionen aufgelistet und ein Überblick über die optionale Verwendung dieser Funktionen zur Automatisierung der Tasks in Feldern gegeben.

Verwenden Sie die folgenden Richtlinien, um Werte für die Operanden festzulegen, die in verschiedenen vordefinierten JavaScript-Funktionen verwendet werden. Für die meisten Funktionen sind die ersten zwei Operatoren in der folgenden Liste erforderlich, und die verbleibenden sind optional. Überprüfen Sie die Syntax für eine individuelle Funktion, um zu sehen, welche Operatoren für diese Funktion gelten.

• Geben Sie für formId den Wert des Attributes _id des Formulars an, für das die Funktion ausgeführt werden soll.
• Geben Sie für _id den Wert des Attributes _id des Elementes in diesem Formular an, für das die Funktion ausgeführt werden soll.
• Für "name", "value" und "index" geben Sie die Werte dieser Attribute für das Element an, für das die Funktion ausgeführt wird.
• Weitere Operanden werden, sofern zutreffend, für spezifische Funktionen erwähnt. Beispielsweise gilt das Attribut "index" nur für bestimmte Elemente, wie z. B. eine Auswahlgruppe.

_.serviceoption.status( )

Gibt den Status der Position zurück, zu der das aktuelle Formular gehört. Verwenden Sie diese Funktion, um je nach Status der Position Formularattribute dynamisch anzugeben. Um beispielsweise bestimmte Formularfelder auszublenden, wenn die Statuszeile abgeschlossen ist, legen Sie das versteckte Attribut auf "_.serviceoption.status() == 200" fest.

Hinweis: Sie können diese Funktion auch verwenden, um ein Serviceoptionselement auszublenden oder zu deaktivieren. Verwenden Sie dazu diese Funktion im versteckten oder deaktivierten Textfeld.

Diese Funktion ist auch besonders nützlich für die Status "Zurückhalten" und "Fortsetzen". Sie können für beide Gründe in Textmeldungen angeben.

Hinweis: Diese Funktion übernimmt keine Parameter.

ca_fdDoFieldLookup(fieldId, reportId),

Führt das Berichtsdatenobjekt aus, ordnet es dem Suchfeld zu und kopiert die zurückgegebenen Daten in die entsprechenden Formularfelder. Sie können diese Aktionen verwenden, um Felder auf der Basis der Anwendereingabe in einem Berichts-Datenobjekt aufzufüllen.

Geben Sie für fieldId den Wert des Attributes _id des Suchfeldes an.

Geben Sie für reportId den Wert des zuvor erstellten Datenobjektes an.

ca_reportQuery(reportId, variables, onSuccess, onFailure)

Führt ein Berichtsdatenobjekt (Datenobjekt) durch, das die Datenquelle (z. B. die MDB) nach den von Ihnen angegebenen Daten durchsucht und die Ergebnisse zurückgibt.

• Geben Sie für reportId das Datenobjekt an, das Sie abfragen möchten.
• Geben Sie für Variablen die JavaScript-Map mit den Namen und Werten der Variablen an. Beispiele umfassen {var1":"foo","var2":"bar","var3":_.user.id}. Diese Variablen stimmen mit denjenigen überein, die Sie im Berichtsdatenobjekt abfragen.
• Geben Sie für onSuccess die JavaScript-Funktion an, die durchgeführt werden soll, wenn die Abfrage erfolgreich zurückgibt. Die Funktion "onSuccess" benötigt einen Operanden. Dieser Operand wird eingestellt mit assoziativen Arrays (Maps), die jeweils eine Zeile darstellen, die von der Abfrage zurückgegeben wird.
• Geben Sie für "onFailure" die JavaScript-Funktion an, die durchgeführt werden soll, wenn der Aufruf fehlschlägt.

Sie können Felder vorbelegen, die auf einem Berichtsdatenobjekt und JavaScript-Funktionen basieren.

ca_fdValidateCC(credit card number, credit card type)

Validiert das Format einer Kreditkartennummer, die ein Anwender in einem von Ihnen erstellen Formular eingibt.

ca_fdShowField(formId, _id)

Gilt für ein einzelnes Feld.

Findet das angegebene Formular (formId) und das angegebene Feld (_id). Macht auch dieses Feld sichtbar, wenn es nicht bereits sichtbar ist.

ca_fdShowFields(formId, _ids)

Gilt für mehrere Felder.

Findet das angegebene Formular (formId) und das angegebene Feld (_ids). Macht auch diese Felder sichtbar, wenn sie nicht bereits sichtbar sind.

Der zweite Parameter ist ein Array, das die "_ids" von mehreren Feldern auf dem Formular enthält, wie im Beispiel für "ca_fdHideFields(formId, _ids)" angezeigt.

ca_fdHideField(formId, _id)

Gilt für ein einzelnes Feld.

Findet das angegebene Formular (formId) und das angegebene Feld (_id). Blendet auch dieses Feld aus, wenn es nicht bereits ausgeblendet ist.

ca_fdHideFields(formId, _ids)

Gilt für mehrere Felder.

Findet das angegebene Formular (formId) und die angegebenen Felder (_ids). Blendet auch diese Felder aus, wenn sie nicht bereits ausgeblendet sind.

Der zweite Parameter ist ein Array, das die "_ids" von mehreren Feldern auf dem Formular enthält. Sie möchten beispielsweise auf einem Formular sowohl die Felder für Vornamen als auch die Felder für Nachnamen ausblenden. Auch ist die _id des Formulars ist "name_form", und die _id-Werte der Felder sind "first_name" und "last_name". Verwenden Sie in diesem Fall den folgenden Code:

ca_fdHideFields("name_form", ["first_name","last_name"]

ca_fdDisableField(formId, _id)

Gilt für ein einzelnes Feld.

Findet das angegebene Formular (formId) und das angegebene Feld (_id). Deaktiviert auch das Feld, wenn es nicht bereits deaktiviert ist.

ca_fdDisableFields(formId, _ids)

Gilt für mehrere Felder.

Findet das angegebene Formular (formId) und die angegebenen Felder (_ids). Deaktiviert auch diese Felder, wenn sie nicht bereits deaktiviert sind.

Der zweite Parameter ist ein Array, das die "_ids" von mehreren Feldern auf dem Formular enthält, wie im Beispiel für "ca_fdHideFields(formId, _ids)" angezeigt.

ca_fdEnableField(formId, _id)

Gilt für ein einzelnes Feld.

Findet das angegebene Formular (formId) und das angegebene Feld (_id). Aktiviert auch das Feld, wenn es nicht bereits aktiviert ist.

ca_fdEnableFields(formId, _ids)

Gilt für mehrere Felder.

Findet das angegebene Formular (formId) und die angegebenen Felder (_ids). Aktiviert auch diese Felder, wenn sie nicht bereits aktiviert sind.

Der zweite Parameter ist ein Array, das die "_ids" von mehreren Feldern auf dem Formular enthält, wie im Beispiel für "ca_fdHideFields(formId, _ids)" angezeigt.

ca_fdSelectOption(formId, _id, name, value) und ca_fdSelectOptionByIndex(formId, _id, index)

Sie können eine der beiden Funktionen verwenden, um einen Wert in einem ausgewählten Feld programmatisch auszuwählen. Diese Funktionen haben dieselben Auswirkungen und unterscheiden sich nur in der Weise, wie sie aufgerufen werden:

• "ca_fdSelectOption" aktiviert die Option mit dem angegebenen _id-Attribut, Namen und Wert im Auswahlfeld.
• "ca_fdSelectOptionByIndex" aktiviert die Option mit dem angegebenen _id-Attribut und Indexwert im Auswahlfeld.

Lesen Sie sich folgende Beispiele sorgfältig durch:

Beispiel 1

Dieses Beispiel aktiviert die erste Option im Auswahlfeld. Dieses Beispiel verwendet folgende Werte:

• _id-Attribut des Formulars: form_id
• _id-Attribut des Auswahlfelds: memory_select

  ca_fdSelectOption(‘form_id’, ‘memory_select’, 1) :
  

Beispiel 2

Dieses Beispiel aktiviert die erste Option im Auswahlfeld des aktuellen Formulars. Dieses Beispiel verwendet folgende Werte:

• _id-Attribut des Formulars: ca_fd.formId
• _id-Attribut des Auswahlfelds: memory_select

  ca_fdSelectOption(ca_fd.formId, ‘memory_select’, 1) :
  

Wenn das angegebene Auswahlfeld nicht gefunden werden kann, wird der Aufruf ignoriert und es werden keine Fehler gemeldet.

Beispiel 3

Sie können folgendermaßen die vorherigen Beispiele mit expliziten Werten für die Optionen umschreiben:

ca_fdSelectOption(‘form_id’, ‘memory_select’, ‘option1’, ‘option1_value’), ca_fdSelectOption(ca_fd.formId, ‘memory_select’, ‘option1’, ‘option1_value’):

option1

Gibt den Namen einer Option so an, wie er in der Formulardesignerstruktur angezeigt wird. Der Wert dieser Option ist "option1_value".

ca_fdUnselectOption(formId, _id, name, value)

Hebt die Auswahl der Option mit dem angegebenen Namen und Wert im Feld "Auswählen" mit dem entsprechenden _id Attribut auf.

ca_fdUnselectOptionByIndex(formId, _id, index)

Hebt die Auswahl der Option beim entsprechenden Index im Feld "Auswählen" mit dem entsprechenden _id Attribut auf.

ca_fdUnselectAllOptions(formId, _id)

Hebt die Auswahl aller Optionen im ausgewählten Feld mit dem entsprechenden _id-Attribut auf.

ca_fdGetSelectedOptions(formId, _id)

Gibt ein Array mit Ganzzahlen zurück, die die Indizes der ausgewählten Optionen angeben.

ca_fdGetSelectedOptionValues (formId, _id)

Gibt ein Array von Zeichenfolgen zurück, die den Wert der ausgewählten Optionen angeben. Wählen Sie den Wert der ersten Option wie folgt:

ca_fdGetSelectedOptionValues(formId, _id)[0]

Wählen Sie den Wert der zweiten Option, indem Sie die 0 in 1 ändern; wählen Sie den Wert der dritten Option, indem Sie die 1 in 2 ändern usw.

Diese Funktion ist besonders nützlich, um Anwendereingaben für das Vorausfüllen von Auswahlfeldern zu verwenden.

ca_fdSelectRadio(formId, name, _id)

Wählt ein Optionsfeld mit der entsprechenden _id in dem Optionsgruppenfeld mit entsprechenden "name"-Attribut aus.

ca_fdIsSelectRadio (formId, name, _id)

Gibt zurück, ob das angegebene Optionsfeld ausgewählt wurde.

ca_fdSelectCheckBox(formId,_id)

Wählt das Optionsfeld mit dem entsprechenden _id Attribut aus.

ca_fdUnselectCheckBox(formId, _id)

Löscht das Kontrollkästchen mit dem entsprechenden _id Attribut.

ca_fdIsSelectedCheckBox(formId,_id)

Gibt zurück, ob das ausgewählte Kontrollkästchen ausgewählt wurde.

ca_fdSetDateFieldValue(formId, _id, date) und zugehörige Funktionen

Legt den Wert des angegebenen Datumsfeldes mit entsprechendem _id-Attribut fest. Diese Funktion kann Null, Zeichenfolgen oder lange Integer-Werte für den Parameter "date" erhalten.

Um den Feldwert zu löschen, verwenden Sie eine leere Zeichenfolge und Null.

Geben Sie nicht leere Zeichenfolgen im für das Feld für Datum/Uhrzeit (ein Element des Formulars) angegebenen Format an, wie folgt:

• Wenn die Uhrzeit des Feldes für Datum und Uhrzeit ausgeblendet ist, geben Sie die Zeichenfolgen nur im Datumsformat an. Verwenden Sie entweder das Formatattribut des Feldes für Datum und Uhrzeit oder das Datumsformat des Geschäftsbereichs.
• Wenn der Zeitbereich des Feldes für Datum/Uhrzeit sichtbar ist, geben Sie die Zeichenfolgen im Datums-/Zeitformat dieses Feldes an.

Trennen Sie in beiden Fällen mehrere Zeichenfolgen durch ein Leerzeichen ab.

Folgende JavaScript-Funktionen sind für das Festlegen des Datums verfügbar. Der vorhergehende Text für die Funktion "ca_fdSetDateFieldValue(formId, _id, date)" gilt auch für diese Funktionen.

• ca_fdSetDateFieldMinValue(formId, _id, date) - Legt den Minimalwert des Datums fest.
• ca_fdSetDateFieldMaxValue(formId, _id, date) - Legt den Maximalwert des Datums fest.

Außerdem können Sie für alle "ca_fdSetDateField*"-JavaScript-Funktionen das Datum als Anzahl von Millisekunden ab der "Epoche" festlegen. Die Epoche ist die Standardbasiszeit ab Mitternacht (00:00:00) GMT, 1. Januar 1970. Informationen darüber, wie Sie das Datum auf diese Weise festlegen, finden Sie in der Standard-Java-Programmierreferenz, zum Beispiel auf der Oracle-Website, oracle.com.

ca_fdGetDateFieldValue(formId, _id, date) und zugehörige Funktionen

Ruft den Datumswert des angegebenen Datumfeldes als Zeichenfolge ab, die entsprechend der für das Datumsfeld angegebenen Formatierung formatiert ist.

Die Information über das Feld für Datum und Uhrzeit für die vorhergehende Funktion (ca_fdSetDateFieldValue(formId, _id, date)) gilt auch für diese Funktion.

Folgende JavaScript-Funktionen sind für das Abrufen des Datums verfügbar. Der vorhergehende Text für die Funktion "ca_fdGetDateFieldValue(formId, _id, date)" gilt auch für diese Funktionen.

• ca_fdGetDateFieldValueInMillis(formId, _id, date) – Ruft den Wert des Datums in Millisekunden ab.
• ca_fdGetDateFieldMinValue(formId, _id, date) – Ruft den Minimalwert des Datums ab.
• ca_fdGetDateFieldMinValueInMillis(formId, _id, date) – Ruft den Minimalwert des Datums in Millisekunden ab.
• ca_fdGetDateFieldMaxValue(formId, _id, date) – Ruft den Maximalwert des Datums ab.
• ca_fdGetDateFieldMaxValueInMillis(formId, _id, date) – Ruft den Maximalwert des Datums in Millisekunden ab.

Außerdem können Sie für alle "ca_fdGetDateField*"-JavaScript-Funktionen das Datum als Anzahl von Millisekunden ab der "Epoche" abrufen. Die Epoche ist die Standardbasiszeit ab Mitternacht (00:00:00) GMT, 1. Januar 1970. Informationen darüber, wie Sie das Datum auf diese Weise abrufen, finden Sie in der Standard-Java-Programmierreferenz, zum Beispiel auf der Oracle-Website, oracle.com.

ca_fdSetTextFieldValue(formId, _id, text)

Stellt den Text des Textfeldes mit dem entsprechenden _id Attribut ein (kann Textfeld und Textbereich sein).

ca_fdGetTextFieldValue(formId, _id)

Ruft den Text des Textfeldes mit dem entsprechenden _id Attribut ab (kann Textfeld und Textbereich sein).

ca_fdFetchSelectData(formId,_id)

Bewirkt, dass das Auswahlfeld mit der angegebenen _id das Berichtsdatenobjekt noch einmal abruft. Diese Funktion ist besonders dann nützlich, wenn das Berichtsdatenobjekt Anwendereingaben berücksichtigt. Wir empfehlen, diese Funktion aufzurufen, wenn diese Eingabe sich ändert, damit sichergestellt ist, dass das Auswahlfeld die korrekten Daten anzeigt.

Diese Funktion ist auch besonders nützlich, um Anwendereingaben für das Vorausfüllen von Auswahlfeldern zu verwenden.

Folgende Funktionen gelten nur für Systemformulare:

• custom_onPriorityChange(newPriority)
• custom_onDateRequiredChange(newDateRequired)
• custom_onRequestedForChange(type, id, name, shippingAddress)