Espressioni dei moduli adattivi adaptive-form-expressions

I moduli adattivi forniscono agli utenti finali con capacità di scripting dinamiche un’esperienza di compilazione dei moduli ottimizzata e semplificata. Consente di scrivere espressioni per aggiungere vari comportamenti, ad esempio campi e pannelli dinamici Mostra/Nascondi. Consente inoltre di aggiungere campi calcolati, rendere i campi di sola lettura, aggiungere logica di convalida e molto altro. Il comportamento dinamico si basa sull’input dell’utente o sui dati precompilati.

JavaScript è il linguaggio di espressione dei moduli adattivi. Tutte le espressioni sono espressioni JavaScript valide e utilizzano API modello di script per moduli adattivi. Queste espressioni restituiscono valori di determinati tipi. Per l’elenco completo delle classi, degli eventi, degli oggetti e delle API pubbliche dei moduli adattivi, consulta Riferimento API della libreria JavaScript per i moduli adattivi.

Best practice per la scrittura di espressioni best-practices-for-writing-expressions

Procedure consigliate per le espressioni che coinvolgono il pannello ripetuto best-practices-for-expressions-involving-repeating-panel

I pannelli ripetuti sono istanze di un pannello che viene aggiunto o rimosso dinamicamente utilizzando API di script o dati precompilati. Per informazioni dettagliate sull'utilizzo del pannello ripetuto, vedere creazione di moduli con sezioni ripetibili.

Tipi di espressione expression-types

Nei moduli adattivi è possibile scrivere espressioni per aggiungere comportamenti quali campi e pannelli dinamici Mostra/Nascondi. È inoltre possibile scrivere espressioni per aggiungere campi calcolati, rendere i campi di sola lettura, la logica di convalida e molto altro ancora. I moduli adattivi supportano le seguenti espressioni:

Espressione di accesso (espressione di abilitazione) access-expression-enablement-expression

Puoi utilizzare l’espressione di accesso per abilitare o disabilitare un campo. Se l'espressione utilizza il valore di un campo, ogni volta che il valore del campo cambia l'espressione viene riattivata.

Si applica a: field

Tipo di ritorno: L'espressione restituisce un valore booleano che indica se il campo è abilitato o disabilitato. true rappresenta che il campo è abilitato e false rappresenta il campo disabilitato.

Esempio: Per abilitare un campo solo quando il valore di field1 è impostato su X, l'espressione di accesso è: field1.value == "X"

Calcola espressione calculate-expression

L'espressione calculate viene utilizzata per calcolare automaticamente il valore di un campo utilizzando un'espressione. In genere, tale espressione utilizza la proprietà value di un altro campo. Ad esempio, field2.value + field3.value. Ogniqualvolta il valore del field2o field3cambia, l'espressione viene riattivata e il valore viene ricalcolato.

Si applica a: field

Tipo di ritorno: L'espressione restituisce un valore compatibile con il campo in cui viene visualizzato il risultato dell'espressione (ad esempio, decimale).

Esempio: L'espressione calculate per visualizzare la somma di due campi in field1 è:
field2.value + field3.value

Espressione di clic click-expression

L'espressione click gestisce le azioni eseguite sull'evento click di un pulsante. Con GuideBridge è possibile eseguire varie funzioni, ad esempio inviare, convalidare e utilizzare l’espressione di clic. Per un elenco completo delle API, vedi API di GuideBridge.

Si applica a: Campi pulsante

Tipo di ritorno: L'espressione click non restituisce alcun valore. Se un'espressione restituisce un valore, il valore viene ignorato.

Esempio: Compilazione di una casella di testo textbox1 sull’azione di clic di un pulsante con valore AEM Forms, l’espressione di clic del pulsante è textbox1.value="AEM Forms" "

Script di inizializzazione initialization-script

Lo script di inizializzazione viene attivato quando viene inizializzato un modulo adattivo. A seconda degli scenari, lo script di inizializzazione si comporta nel modo seguente:

Si applica a: campi e pannelli

Tipo di ritorno: L'espressione script di inizializzazione non restituisce alcun valore. Se un'espressione restituisce un valore, il valore viene ignorato.

Esempio: In uno scenario di precompilazione dei dati, per compilare i campi con il valore predefinito 'Adaptive Forms' quando il loro valore viene salvato come nullo, l'espressione dello script di inizializzazione è:
if(this.value==null) this.value='Adaptive Forms';

Espressione Opzioni options-expression

L'espressione options viene utilizzata per compilare dinamicamente le opzioni di un campo elenco a discesa.

Si applica a: campi elenco a discesa

Tipo di ritorno: L'espressione options restituisce una matrice di valori stringa. Ogni valore può essere una stringa semplice, ad esempio Maschio o in un formato di coppia key=value, ad esempio 1=Maschio

Esempio: Per compilare il valore di un campo, in base al valore di un altro campo, fornire un'espressione di opzioni semplici. Ad esempio, per compilare un campo, Numero di bambini , in base Stato civile espresso in un altro campo, l’espressione è:

marital_status.value == "married" ? ["1=One", "2=two"] : ["0=Zero"].

Ogni volta che il valore di marital_status cambia campo, l’espressione viene riattivata. Puoi anche compilare il menu a discesa da un servizio REST. Per informazioni dettagliate, consulta Compilazione dinamica di elenchi a discesa.

Espressione di riepilogo summary

L'espressione Summary calcola dinamicamente il titolo di un pannello secondario di un pannello di layout a soffietto. È possibile specificare l'espressione Summary in una regola che utilizza un campo modulo o una logica personalizzata per valutare il titolo. L'espressione viene eseguita quando il modulo viene inizializzato. Se si sta precompilando un modulo, l’espressione viene eseguita dopo la precompilazione dei dati o quando viene modificato il valore dei campi dipendenti utilizzati nell’espressione.

L’espressione Riepilogo viene in genere utilizzata per gli elementi secondari ripetuti di un pannello di layout a soffietto per fornire un titolo significativo a ciascun pannello secondario.

Si applica a: Pannelli figli diretti di un pannello il cui layout è configurato come pannello a soffietto.

Tipo di ritorno: L'espressione restituisce un elemento String che diventa il titolo del pannello a soffietto.

Esempio: "Numero di conto: "+ textbox1.value

Convalida espressione validate-expression

L’espressione validate viene utilizzata per convalidare i campi utilizzando l’espressione specificata. In genere, tali espressioni utilizzano espressioni regolari insieme al valore del campo per convalidare un campo. L’espressione viene riattivata e lo stato di convalida del campo viene ricalcolato in caso di modifica del valore di un campo.

Si applica a: field

Tipo di ritorno: L'espressione restituisce un valore booleano che rappresenta lo stato di convalida del campo. Il valore false rappresenta che il campo non è valido e true rappresenta la validità del campo.

Esempio: Per un campo che rappresenta il codice postale del Regno Unito, l'espressione di convalida è:

(this.value && this.value.match(/^(GIR 0AA|[A-Z]{1,2}\d[A-Z0-9]? ?[0-9][A-Z]{2}\s*)$/i) == null) ? false : true

Nell'esempio precedente, se il valore non vuoto non corrisponde al pattern, l'espressione restituisce false per indicare che il campo non è valido.

Script per conferma del valore value-commit-script

Lo script Value Commit viene attivato quando:

Si applica a: field

Tipo di ritorno: L'espressione script di commit del valore non restituisce alcun valore. Se un'espressione restituisce un valore, il valore viene ignorato.

Esempio: Per convertire il caso degli alfabeti immessi nel campo in maiuscolo al momento del commit, il valore dell'espressione commit è:
this.value=this.value.toUpperCase()

Espressione di visibilità visibility-expression

L’espressione Visibilità viene utilizzata per controllare la visibilità del campo o del pannello. In genere, l'espressione di visibilità utilizza la proprietà value di un campo e viene riattivata ogni volta che tale valore cambia.

Si applica a: campi e pannelli

Tipo di ritorno: L'espressione restituisce un valore booleano che rappresenta il campo o il pannello visibile o meno. false indica che il campo o il pannello non è visibile e che il valore true rappresenta che il campo o il pannello è visibile.

Esempio: Per un pannello che diventa visibile solo se il valore di field1 è impostato su Maschio, l’espressione di visibilità è: field1.value == "Male"

Espressione completamento passaggio step-completion-expression

L'espressione completamento passaggi viene utilizzata per impedire all'utente di passare al passaggio successivo di un layout della procedura guidata. Queste espressioni vengono utilizzate quando i pannelli dispongono di un layout guidato (moduli con più passaggi che mostrano un passaggio alla volta). L’utente può passare al passaggio successivo, al pannello o alla sottosezione solo se tutti i valori richiesti nella sezione corrente sono riempiti e validi.

Si applica a: Pannelli con layout di elemento impostato sulla procedura guidata.

Tipo di ritorno: L'espressione restituisce un valore booleano che rappresenta il pannello corrente valido o meno. True indica che il pannello corrente è valido e che l’utente può passare al pannello successivo.

Esempio: In un modulo organizzato in vari pannelli, prima di passare al pannello successivo viene convalidato il pannello corrente. In questi casi, vengono utilizzate le espressioni di completamento dei passaggi. In genere, queste espressioni utilizzano l’API di convalida GuideBridge. Un esempio di espressione di completamento del passaggio è:
window.guideBridge.validate([],this.panel.navigationContext.currentItem.somExpression)

Convalida in modulo adattivo validations-in-adaptive-form

Esistono diversi metodi per aggiungere la convalida dei campi a un modulo adattivo. Se in un campo viene aggiunto un controllo di convalida, True rappresenta che il valore immesso nel campo è valido. False rappresenta che il valore non è valido. Se passi il tasto Tab all’interno e all’esterno di un campo, il messaggio di errore non viene generato.

I metodi per aggiungere convalide a un campo sono i seguenti:

Obbligatorio required

Per rendere obbligatorio un componente, nella Modifica finestra di dialogo del componente, è possibile selezionare l’opzione Titolo e testo > Obbligatorio. È inoltre possibile aggiungere il messaggio obbligatorio (facoltativo). .

Pattern di convalida validation-patterns

Per un campo sono disponibili più pattern di convalida predefiniti. Per selezionare un pattern di convalida, nella Modifica finestra di dialogo del componente, individua il Pattern e seleziona pattern. È possibile creare un pattern di convalida personalizzato in un Pattern casella di testo. Viene restituito lo stato di convalida True solo se i dati compilati sono conformi al pattern di convalida, altrimenti False viene restituito . Per creare un pattern di convalida personalizzato, consultare Supporto della clausola immagine per i moduli HTML5.

Espressioni di convalida validation-expressions

È inoltre possibile calcolare la convalida di un campo utilizzando espressioni in campi diversi. Queste espressioni sono scritte all'interno di Script di convalida campo Script scheda di Modifica finestra di dialogo del componente. Lo stato di convalida di un campo dipende dal valore restituito dall’espressione. Per informazioni su come scrivere tali espressioni, consulta Convalida espressione.

Informazioni aggiuntive additional-information

Utilizzo del formato di visualizzazione dei campi using-field-display-format

Il formato di visualizzazione può essere utilizzato per visualizzare i dati in diversi formati. Ad esempio, è possibile utilizzare il formato di visualizzazione per visualizzare un numero di telefono con trattini, formattare il codice postale o selezionare la data. Questi modelli di visualizzazione possono essere selezionati Pattern della sezione Modifica finestra di dialogo di un componente. È possibile scrivere pattern di visualizzazione personalizzati simili ai pattern di convalida sopra menzionati.

GuideBridge - API ed eventi guidebridge-apis-and-events

GuideBridge è una raccolta di API che possono essere utilizzate per interagire con i moduli adattivi nel modello di memoria in un browser. Per un’introduzione dettagliata all’API Guide Bridge, ai metodi di classe, agli eventi esposti, vedi Riferimento API della libreria JavaScript per i moduli adattivi.

Utilizzo di GuideBridge in varie espressioni guidebridge-usage-in-various-expressions

Utilizzo di GuideBridge all’esterno delle espressioni  using-guidebridge-outside-expressions-nbsp

È inoltre possibile utilizzare le API GuideBridge al di fuori delle espressioni. Ad esempio, è possibile utilizzare l’API GuideBridge per impostare la comunicazione tra il HTML di pagina che ospita il modulo adattivo e il modello di modulo. Inoltre, è possibile impostare il valore proveniente dall’elemento padre di Iframe che ospita il modulo.

Per utilizzare l’API GuideBridge per l’esempio precedente, acquisire un’istanza di GuideBridge. Per acquisire l'istanza, ascolta bridgeInitializeStartevento windowoggetto:

window.addEventListener("bridgeInitializeStart", function(evnt) {

     // get hold of the guideBridge object

     var gb = evnt.detail.guideBridge;

     //wait for the completion of AF

     gb.connect(function (){

        //this function will be called after Adaptive Form is initialized

     })

})

Per utilizzare GuideBridge dopo l’inizializzazione del modulo (il bridgeInitializeComplete viene inviato l'evento), ottieni l'istanza GuideBridge utilizzando window.guideBridge. È possibile controllare lo stato di inizializzazione di GuideBridge utilizzando guideBride.isConnected API.

Eventi GuideBridge guidebridge-events

GuideBridge fornisce inoltre alcuni eventi per gli script esterni nella pagina di hosting. Gli script esterni possono ascoltare questi eventi ed eseguire varie operazioni. Ad esempio, ogni volta che il nome utente in un modulo cambia, cambia anche il nome visualizzato nell’intestazione della pagina. Per maggiori dettagli su tali eventi, vedi Riferimento API della libreria JavaScript per i moduli adattivi.

Utilizza il codice seguente per registrare i gestori:

guideBridge.on("elementValueChanged", function (event, data)  {

      // execute some logic when value of a field is changed

});

Creazione di pattern personalizzati per un campo creating-custom-patterns-for-a-field

Come indicato in precedenza, i moduli adattivi consentono all’autore di fornire pattern per la convalida o i formati di visualizzazione. Oltre a utilizzare pattern predefiniti, è possibile definire pattern personalizzati riutilizzabili per un componente modulo adattivo. Ad esempio, è possibile definire un campo di testo o un campo numerico. Una volta definiti, è possibile utilizzare questi pattern in tutti i moduli per uno specifico tipo di componente. Ad esempio, è possibile creare un pattern personalizzato per un campo di testo e utilizzarlo nei campi di testo nei relativi moduli adattivi. È possibile selezionare il pattern personalizzato accedendo alla sezione del pattern nella finestra di dialogo di modifica di un componente. Per informazioni dettagliate sulla definizione o sul formato del pattern, consulta Supporto della clausola immagine per i moduli HTML5.

Per creare un pattern personalizzato per un tipo di campo specifico e riutilizzarlo per altri campi dello stesso tipo, effettua le seguenti operazioni: