Funzioni JavaScript predefinite

CA Service Catalog fornisce diverse opzioni per l'esecuzione di attività automatiche per i campi dei moduli, tra cui gli oggetti dati report, le espressioni e le funzioni JavaScript. Il presente argomento contiene un elenco delle funzioni Java predefinite e ne descrive le modalità di utilizzo per automatizzare le attività nei campi.

Attenersi alle istruzioni seguenti per specificare i valori per gli operandi utilizzati in diverse funzioni JavaScript predefinite. Per la maggior parte delle funzioni, i primi due operandi nell'elenco seguente sono obbligatori, mentre i restanti sono facoltativi. Verificare la sintassi di una funzione singola per capire quali operandi si applicano a tale funzione.

• Per l'attributo formId, specificare il valore dell'attributo _id del modulo su cui eseguire la funzione.
• Per _id, specificare il valore dell'attributo _id dell'elemento all'interno del modulo su cui eseguire la funzione.
• Per gli attributi name, value e index, specificare il valore per gli elementi su cui viene eseguita la funzione.
• Sono riportati inoltre alcuni operandi aggiuntivi per funzioni specifiche. Ad esempio, l'attributo index è applicabile solo ad alcuni elementi, come un gruppo di selezione.

_.serviceoption.status( )

Restituisce lo stato dell'elemento di linea a cui appartiene il modulo attuale. Utilizzare questa funzione per specificare gli attributi del modulo in modo dinamico in base allo stato dell'elemento di linea. Ad esempio, per nascondere determinati campi di modulo quando il loro stato di linea viene completato, impostare il loro attributo hidden su "_.serviceoption.status() == 200".

Nota: è possibile anche utilizzare questa funzione per nascondere o disattivare un elemento opzione di servizio. A tale scopo, utilizzare questa funzione nella casella di testo nascosta o disabilitata.

Questa funzione è particolarmente utile anche per lo stato Sospendi/Riprendi. È possibile fornire spiegazioni nei messaggi di testo per entrambi.

Nota: questa funzione non utilizza alcun parametro.

ca_fdDoFieldLookup(fieldId, reportId),

Esegue l'oggetto di dati del report, lo associa al campo di ricerca e copia i dati restituiti nei campi corrispondenti del modulo. È possibile utilizzare queste azioni per compilare i campi in base alle immissioni dell'utente in un oggetto di dati del report.

Per l'attributo fieldId, specificare il valore dell'attributo _id del campo di ricerca.

Per l'attributo reportId, specificare il valore dell'oggetto dati creato in precedenza.

ca_reportQuery(reportId, variables, onSuccess, onFailure)

Esegue un oggetto di dati del report (oggetto dati) che interroga la fonte dati, ad esempio MDB, per i dati specificati e restituisce i risultati.

• Per l'attributo reportId, specificare l'oggetto dati da interrogare.
• Per l'attributo variables, specificare la mappa JavaScript con i nomi e i valori delle variabili. Gli esempi includono {"var1":"foo","var2":"bar","var3":_.user.id}. Tali variabili corrispondono a quelle interrogate nell'oggetto dati report.
• Per l'attributo onSuccess, specificare la funzione JavaScript da eseguire dopo l'esito positivo della query. La funzione onSuccess deve acquisire un operando. Tale operando è impostato con una serie di mappe, ciascuna delle quali rappresenta una riga restituita dalla query.
• Per l'attributo onFailure, specificare la funzione JavaScript da eseguire se la chiamata ha esito negativo.

È possibile prepopolare campi basati su un oggetto di dati del report e su funzioni JavaScript.

ca_fdValidateCC(credit card number, credit card type)

Convalida il formato di un numero di carta di credito immesso dall'utente in un modulo creato.

ca_fdShowField(formId, _id)

Si applica a un campo singolo.

Individua il modulo (formId) e il campo (_id) specificati. Inoltre rende quel campo visibile se non lo è.

ca_fdShowFields(formId, _ids)

Si applica a più campi.

Individua il modulo (formId) e i campi (_ids) specificati. Inoltre rende i campi visibili se non lo sono.

Il secondo parametro è una matrice che contiene _ids di più campi sul modulo, come illustrato nell'esempio per ca_fdHideFields(formId, _ids).

ca_fdHideField(formId, _id)

Si applica a un campo singolo.

Individua il modulo (formId) e il campo (_id) specificati. Inoltre nasconde quel campo se non è già nascosto.

ca_fdHideFields(formId, _ids)

Si applica a più campi.

Individua il modulo (formId) e i campi (_ids) specificati. Inoltre nasconde i campi se non sono già nascosti.

Il secondo parametro è una matrice che contiene _ids di più campi sul modulo. Ad esempio, si desidera nascondere i campi del nome e del cognome su un modulo. L'_id del modulo è name_form, mentre i valori di _id dei campi sono first_name e last_name. In questo caso, utilizzare il codice seguente:

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

ca_fdDisableField(formId, _id)

Si applica a un campo singolo.

Individua il modulo (formId) e il campo (_id) specificati. Inoltre disattiva il campo se non è già disattivato.

ca_fdDisableFields(formId, _ids)

Si applica a più campi.

Individua il modulo (formId) e i campi (_ids) specificati. Inoltre disattiva i campi se non sono già disattivati.

Il secondo parametro è una matrice che contiene _ids di più campi sul modulo, come illustrato nell'esempio per ca_fdHideFields(formId, _ids).

ca_fdEnableField(formId, _id)

Si applica a un campo singolo.

Individua il modulo (formId) e il campo (_id) specificati. Inoltre abilita il campo se non è già abilitato.

ca_fdEnableFields(formId, _ids)

Si applica a più campi.

Individua il modulo (formId) e i campi (_ids) specificati. Inoltre abilita i campi se non sono già abilitati.

Il secondo parametro è una matrice che contiene _ids di più campi sul modulo, come illustrato nell'esempio per ca_fdHideFields(formId, _ids).

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

È possibile utilizzare entrambe queste funzioni per selezionare un valore in una casella di selezione a livello di programmazione. Queste funzioni hanno lo stesso effetto, ma si differenziano solo per come sono chiamate:

• ca_fdSelectOption seleziona l'opzione con l'attributo _id specificato, il nome e il valore nel campo di selezione.
• ca_fdSelectOptionByIndex seleziona l'opzione con l'attributo _id specificato e il valore di indice nel campo di selezione.

Considerare gli esempi riportati di seguito:

Esempio 1

In questo esempio si seleziona la prima opzione nella casella di selezione. L'esempio utilizza i seguenti valori:

• Attributo _id del modulo: form_id
• Attributo _id della casella di selezione: memory_select

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

Esempio 2

In questo esempio si seleziona la prima opzione nella casella di selezione del modulo attuale. L'esempio utilizza i seguenti valori:

• Attributo _id del modulo: ca_fd.formId
• Attributo _id della casella di selezione: memory_select

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

Se non è possibile individuare la casella di specificata, la chiamata viene ignorata e non vengono riportati errori.

Esempio 3

È possibile riscrivere gli esempi precedenti con valori espliciti per le opzioni, come segue:

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

option1

Specifica il nome di un'opzione come visualizzato nella struttura dell'Ambiente di progettazione moduli. Il valore di questa opzione è option1_value.

ca_fdUnselectOption(formId, _id, name, value)

Deseleziona l'opzione con il nome e il valore specificati nel campo di selezione con l'attributo _id corrispondente.

ca_fdUnselectOptionByIndex(formId, _id, index)

Deseleziona l'opzione all'indice corrispondente nel campo di selezione con l'attributo _id corrispondente.

ca_fdUnselectAllOptions(formId, _id)

Deseleziona tutte le opzioni nel campo di selezione con l'attributo _id corrispondente.

ca_fdGetSelectedOptions(formId, _id)

Restituisce una serie di numeri interi che indicano gli indici delle opzioni selezionate.

ca_fdGetSelectedOptionValues (formId, _id)

Restituisce un array di stringhe che indicano gli indici delle opzioni selezionate. Selezionare il primo valore di opzione nel modo seguente:

ca_fdGetSelectedOptionValues(formId, _id)[0]

Selezionare il secondo valore di opzione modificando 0 a 1. Selezionare il terzo valore di opzione modificando 1 a 2, ecc.

Questa funzione risulta particolarmente utile per utilizzare l'input dell'utente per precompilare una casella di selezione.

ca_fdSelectRadio(formId, name, _id)

Seleziona il pulsante di opzione con l'attributo _id corrispondente nel gruppo di opzioni con l'attributo nome corrispondente.

ca_fdIsSelectRadio (formId, name, _id)

Restituisce dei risultati se il pulsante di opzione indicato è selezionato.

ca_fdSelectCheckBox(formId,_id)

Seleziona la casella di controllo con l'attributo _id corrispondente.

ca_fdUnselectCheckBox(formId, _id)

Deseleziona la casella di controllo con l'attributo _id corrispondente.

ca_fdIsSelectedCheckBox(formId,_id)

Restituisce dei risultati se la casella di controllo indicata è selezionata.

ca_fdSetDateFieldValue(formId, _id, date) e funzioni correlate

Imposta il valore del campo data specificato con l'attributo _id corrispondente. Questa funzione può assumere i valori Null, String o Long integer per il parametro denominato date.

Per rimuovere il valore del campo, utilizzare una stringa vuota o il valore null.

Specificare stringhe non vuote nel formato indicato per il campo Data/ora (un elemento del modulo), come indicato di seguito:

• Se la porzione del campo Data/ora relativa all'ora è nascosta, specificare le stringhe solo nel formato data. Utilizzare l'attributo di formato del campo Data/ora oppure il formato di data dell'unità di business.
• Se invece la porzione del campo Data/ora relativa all'ora è visibile, specificare le stringhe nel formato di data e ora specificato dal campo.

In entrambi i casi, utilizzare uno spazio per separare più stringhe.

Le funzioni JavaScript correlate per l'impostazione della data sono descritte di seguito. Il testo precedente per la funzione ca_fdSetDateFieldValue(formId, _id, date) è valido anche per queste funzioni.

• ca_fdSetDateFieldMinValue(formId, _id, date) - Imposta il valore minimo della data.
• ca_fdSetDateFieldMaxValue(formId, _id, date) - Imposta il valore massimo della data.

Inoltre, per tutte le funzioni JavaScript ca_fdSetDateField* è possibile impostare la data nel numero di millisecondi a partire dall'ora di base standard (o "epoch"), ovvero la mezzanotte (00:00:00) GMT del 1° gennaio 1970. Per informazioni dettagliate sull'impostazione della data in questo modo, fare riferimento alla documentazione di programmazione Java standard, come il sito Web di Oracle oracle.com.

ca_fdGetDateFieldValue(formId, _id, date) e funzioni correlate

Ottiene il valore del campo data specificato come stringa formattata in base alla formattazione specificata per il campo data.

Le informazioni relative al campo Data/ora per la funzione precedente (ca_fdSetDateFieldValue(formId, _id, date)) sono valide anche per questa funzione.

Le funzioni JavaScript correlate per l'ottenimento della data sono descritte di seguito. Il testo precedente per la funzione ca_fdGetDateFieldValue(formId, _id, date) è valido anche per queste funzioni.

• ca_fdGetDateFieldValueInMillis(formId, _id, date) - Ottiene il valore della data in millisecondi.
• ca_fdGetDateFieldMinValue(formId, _id, date) - Ottiene il valore minimo della data.
• ca_fdGetDateFieldMinValueInMillis(formId, _id, date) - Ottiene il valore minimo della data in millisecondi.
• ca_fdGetDateFieldMaxValue(formId, _id, date) - Ottiene il valore massimo della data.
• ca_fdGetDateFieldMaxValueInMillis(formId, _id, date) - Ottiene il valore massimo della data in millisecondi.

Inoltre, per tutte le funzioni JavaScript ca_fdGetDateField* è possibile ottenere la data nel numero di millisecondi a partire dall'ora di base standard (o "epoch"), ovvero la mezzanotte (00:00:00) GMT del 1° gennaio 1970. Per informazioni dettagliate sull'ottenimento della data in questo modo, fare riferimento alla documentazione di programmazione Java standard, come il sito Web di Oracle oracle.com.

ca_fdSetTextFieldValue(formId, _id, text)

Imposta il testo del campo di testo con l'attributo _id corrispondente, che può essere un campo di testo e un'area di testo.

ca_fdGetTextFieldValue(formId, _id)

Richiama il testo del campo di testo con l'attributo _id corrispondente, che può essere un campo di testo e un'area di testo.

ca_fdFetchSelectData(formId,_id)

Fa in modo che la casella di selezione con _id specificato carichi nuovamente l'oggetto dati del report. Questa funzione risulta particolarmente utile quando l'oggetto dati del report prende in considerazione l'input utente. Si consiglia di richiamare questa funzione quando l'input viene modificato, per contribuire ad accertarsi che nella casella di selezione siano visualizzati i dati corretti.

Questa funzione risulta particolarmente utile anche per precompilare una casella di selezione con l'immissione da parte dell'utente.

Le funzioni seguenti riguardano i moduli di sistema soltanto:

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