Aggiungere regole a un componente core modulo adattivo adaptive-forms-rule-editor
Questo articolo contiene le funzioni più recenti dell’Editor regole di Adaptive Forms Core Components, che sono:
- Supporto per l’implementazione di condizioni nidificate con la funzionalità When-then-else
- Convalidare o reimpostare pannelli e moduli, inclusi i campi
- Supporto di funzioni JavaScript moderne, come le funzioni let e arrow (supporto ES10) all’interno delle funzioni personalizzate.
La funzione Editor regole facilita la scrittura di regole su oggetti Modulo adattivo da parte di utenti aziendali e sviluppatori di Forms. Queste regole definiscono le azioni da attivare sugli oggetti modulo in base alle condizioni preimpostate, agli input dell'utente e alle azioni dell'utente sul modulo. Consente di semplificare ulteriormente l’esperienza di compilazione dei moduli, garantendo precisione e velocità.
L’editor di regole fornisce un’interfaccia utente intuitiva e semplificata per scrivere regole. L’editor di regole offre un editor visivo per tutti gli utenti. Alcune delle azioni chiave eseguite sugli oggetti modulo adattivo utilizzando le regole sono:
- Mostrare o nascondere un oggetto
- Attivare o disattivare un oggetto
- Impostare un valore per un oggetto
- Convalidare il valore di un oggetto
- Eseguire funzioni per calcolare il valore di un oggetto
- Richiamare un modello dati del modulo (FDM) ed eseguire un’operazione
- Impostare la proprietà di un oggetto
Gli utenti aggiunti al gruppo forms-power-users
possono creare gli script e modificare quelli esistenti. Gli utenti di forms-users group
possono utilizzare gli script ma non crearli o modificarli.
Informazioni su una regola understanding-a-rule
Una regola è una combinazione di azioni e condizioni. Nell’editor delle regole, le azioni includono attività quali nascondere, mostrare, abilitare, disabilitare o calcolare il valore di un oggetto in un modulo. Le condizioni sono espressioni booleane che vengono valutate eseguendo controlli e operazioni sullo stato, sul valore o sulla proprietà di un oggetto modulo. Le azioni vengono eseguite in base al valore ( True
o False
) restituito valutando una condizione.
L’editor di regole fornisce un set di tipi di regole predefiniti, ad esempio When, Show, Hide, Enable, Disable, Set Value Of e Validate, per facilitare la scrittura delle regole. Ogni tipo di regola ti consente di definire condizioni e azioni in una regola. Il documento spiega ulteriormente ogni tipo di regola nei dettagli.
Una regola segue in genere uno dei seguenti costrutti:
Condizione-Azione In questo costrutto, una regola definisce innanzitutto una condizione seguita da un'azione da attivare. Il costrutto è paragonabile a if-then statement
nei linguaggi di programmazione.
Nell'editor di regole, il tipo di regola When applica il costrutto condizione-azione.
Action-Condition In questo costrutto, una regola definisce innanzitutto un'azione da attivare seguita da condizioni per la valutazione. Un’altra variante di questo costrutto è action-condition-alternate action, che definisce anche un’azione alternativa da attivare se la condizione restituisce False.
I tipi di regola Mostra, Nascondi, Abilita, Disabilita, Imposta valore di e Convalida nell'editor di regole applicano il costrutto di regola action-condition
. Per impostazione predefinita, l'azione alternativa per Mostra è Nascondi e per Abilita è Disabilita e viceversa. Non è possibile modificare l'azione alternativa predefinita.
Per ulteriori informazioni sui tipi di regole disponibili nell'editor di regole, vedere Tipi di regole disponibili nell'editor di regole.
Linee guida per la scelta di un costrutto regola guidelines-for-choosing-a-rule-construct
Sebbene sia possibile ottenere la maggior parte dei casi d’uso utilizzando qualsiasi costrutto di regola, di seguito sono riportate alcune linee guida per scegliere un costrutto rispetto a un altro. Per ulteriori informazioni sulle regole disponibili nell'editor di regole, vedere Tipi di regole disponibili nell'editor di regole.
-
Una regola tipica del pollice durante la creazione di una regola è pensarla nel contesto dell'oggetto su cui si sta scrivendo una regola. Si supponga di voler nascondere o visualizzare un campo B in base al valore specificato dall'utente nel campo A. In questo caso, si sta valutando una condizione nel campo A e, in base al valore restituito, si sta attivando un'azione nel campo B.
Pertanto, se si sta scrivendo una regola nel campo B (l'oggetto su cui si sta valutando una condizione), utilizzare il costrutto
condition-action
o il tipo di regolaWhen
. Analogamente, utilizzare il costruttoaction-condition
o il tipo di regolaShow or Hide
nel campo A. -
A volte, è necessario eseguire più azioni in base a una condizione. In questi casi, si consiglia di utilizzare il costrutto
condition-action
. In questo costrutto, puoi valutare una condizione una sola volta e specificare più istruzioni di azione.Ad esempio, per nascondere i campi B, C e D in base alla condizione che verifica il valore specificato dall'utente nel campo A, scrivere una regola con il costrutto condizione-azione o il tipo di regola When nel campo A e specificare azioni per controllare la visibilità dei campi B, C e D. In caso contrario, sono necessarie tre regole separate per i campi B, C e D, in cui ogni regola controlla la condizione e mostra o nasconde il rispettivo campo. In questo esempio, è più efficiente scrivere il tipo di regola When su un oggetto anziché Show o Hide su tre oggetti.
-
Per attivare un’azione in base a più condizioni, si consiglia di utilizzare il costrutto azione-condizione. Ad esempio, per mostrare e nascondere il campo A valutando le condizioni nei campi B, C e D, utilizzare Mostra o Nascondi tipo di regola nel campo A.
-
Utilizza il costrutto condizione-azione o condizione azione se la regola contiene un’azione per una condizione.
-
Se una regola verifica la presenza di una condizione ed esegue immediatamente un'azione quando fornisce un valore in un campo o esce da un campo, si consiglia di scrivere una regola con il costrutto condizione-azione o il tipo di regola When nel campo in cui viene valutata la condizione.
-
La condizione nella regola When viene valutata quando un utente modifica il valore dell'oggetto su cui viene applicata la regola When. Tuttavia, se desideri che l’azione si attivi quando il valore cambia sul lato server, come per il prepopolamento del valore, è consigliabile scrivere una regola When che attivi l’azione quando il campo viene inizializzato.
-
Quando si scrivono regole per gli oggetti menu a discesa, pulsanti di scelta o caselle di controllo, le opzioni o i valori di tali oggetti modulo nel modulo vengono precompilati nell’editor di regole.
Tipi di operatori ed eventi disponibili nell’editor di regole available-operator-types-and-events-in-rule-editor
L’editor di regole fornisce i seguenti operatori logici ed eventi utilizzando i quali è possibile creare regole.
- È Uguale A
- È Diverso Da
- Inizia con
- Termina Con
- Contiene
- Non contiene
- È Vuoto
- Non È Vuoto
- Ha selezionato: Restituisce true quando l'utente seleziona un'opzione particolare per una casella di controllo, un elenco a discesa o un pulsante di scelta.
- È inizializzato (evento): Restituisce true quando viene eseguito il rendering di un oggetto modulo nel browser.
- È stato modificato (evento): Restituisce true quando l'utente modifica il valore immesso o l'opzione selezionata per un oggetto modulo.
Tipi di regole disponibili nell’editor di regole available-rule-types-in-rule-editor
L’editor di regole fornisce un set di tipi di regole predefiniti che è possibile utilizzare per scrivere regole. Esaminiamo in dettaglio ogni tipo di regola. Per ulteriori informazioni sulla scrittura di regole nell'editor di regole, vedere Scrivi regole.
Quando whenruletype
Il tipo di regola When segue il costrutto della regola condition-action-alternate action oppure, a volte, solo il costrutto condition-action. In questo tipo di regola si specifica innanzitutto una condizione per la valutazione seguita da un'azione da attivare se la condizione viene soddisfatta ( True
). Durante l'utilizzo del tipo di regola When, è possibile utilizzare più operatori AND e OR per creare espressioni nidificate.
Utilizzando il tipo di regola When, è possibile valutare una condizione in un oggetto modulo ed eseguire azioni su uno o più oggetti.
In parole semplici, una regola When tipica è strutturata come segue:
When on Object A:
(Condition 1 AND Condition 2 OR Condition 3) is TRUE;
Then, do the following:
Action 2 on Object B;
AND
Action 3 on Object C
;
Else, do the following:
Action 2 on Object C;
_
Quando si dispone di un componente con più valori, ad esempio pulsanti di scelta o elenco, durante la creazione di una regola per tale componente le opzioni vengono recuperate e rese disponibili automaticamente al creatore della regola. Non è necessario digitare nuovamente i valori delle opzioni.
Ad esempio, un elenco include quattro opzioni: Rosso, Blu, Verde e Giallo. Durante la creazione della regola, le opzioni (pulsanti di scelta) vengono recuperate automaticamente e rese disponibili al creatore della regola come segue:
Durante la scrittura di una regola When, puoi attivare l'azione Cancella valore di. L'azione Clear Value Of
cancella il valore dell'oggetto specificato. L'utilizzo di Clear Value of
come opzione nell'istruzione When consente di creare condizioni complesse con più campi. È possibile aggiungere l'istruzione Else per aggiungere ulteriori condizioni.
Più campi consentiti in When allowed-multiple-fields
Nella condizione When è possibile aggiungere altri campi oltre al campo a cui viene applicata la regola.
Ad esempio, utilizzando il tipo di regola When, è possibile valutare una condizione su diversi oggetti modulo ed eseguire l'azione:
When:
(Object A Condition 1)
AND/OR
(Object B Condtion 2)
Then, do the following:
Action 1 on Object A
_
Considerazioni durante l’utilizzo di più campi consentiti nella funzione condizione When
- Verificare che il componente core e la versione della specifica siano impostati sulla versione più recente per utilizzare questa funzionalità nell'editor di regole.
- Se le regole vengono applicate a campi diversi all’interno della condizione When, la regola viene attivata anche se solo uno di questi campi viene modificato.
Se nella funzione Condizione When sono presenti più campi consentiti, segui i passaggi di risoluzione dei problemi descritti di seguito.
- Apri il modulo in modalità di modifica.
- Apri il browser Contenuti e seleziona il componente Contenitore guida del modulo adattivo.
- Fare clic sull'icona delle proprietà del Contenitore Guida TV . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).
- Fai clic su Fine e salva di nuovo la finestra di dialogo.
Nascondi Nasconde l'oggetto specificato.
Mostra mostra l'oggetto specificato.
Abilita Abilita l'oggetto specificato.
Disabilita Disabilita l'oggetto specificato.
Richiama servizio Richiama un servizio configurato in un modello dati modulo (FDM). Quando scegli l’operazione Richiama servizio, viene visualizzato un campo. Quando tocca il campo, vengono visualizzati tutti i servizi configurati in tutti i modelli di dati del modulo (FDM) nell'istanza Experience Manager. Quando si sceglie un servizio Modello dati modulo, vengono visualizzati più campi in cui è possibile mappare gli oggetti modulo con i parametri di input e output per il servizio specificato. Vedi regola di esempio per richiamare i servizi del modello dati modulo (FDM).
Oltre al servizio Modello dati modulo, è possibile specificare un URL WSDL diretto per richiamare un servizio Web. Tuttavia, un servizio di modello dati modulo presenta molti vantaggi e l’approccio consigliato per richiamare un servizio.
Per ulteriori informazioni sulla configurazione dei servizi nel modello dati modulo, vedere Experience Manager Forms Integrazione dati.
Imposta il valore di Calcola e imposta il valore dell'oggetto specificato. È possibile impostare il valore dell'oggetto su una stringa, il valore di un altro oggetto, il valore calcolato utilizzando un'espressione matematica o una funzione, il valore di una proprietà di un oggetto o il valore di output di un servizio Form Data Model configurato. Quando si sceglie l'opzione Servizio Web, vengono visualizzati tutti i servizi configurati in tutti i modelli di dati del modulo (FDM) nell'istanza Experience Manager. Quando si sceglie un servizio Modello dati modulo, vengono visualizzati più campi in cui è possibile mappare gli oggetti modulo con i parametri di input e output per il servizio specificato.
Per ulteriori informazioni sulla configurazione dei servizi nel modello dati modulo, vedere Experience Manager Forms Integrazione dati.
Il tipo di regola Imposta proprietà consente di impostare il valore di una proprietà dell'oggetto specificato in base a un'azione condizione. È possibile impostare la proprietà su una delle seguenti opzioni:
- visibile (booleano)
- label.value (Stringa)
- label.visible (booleano)
- description (String)
- abilitato (booleano)
- readOnly (booleano)
- obbligatorio (booleano)
- screenReaderText (stringa)
- valido (booleano)
- errorMessage (stringa)
- impostazione predefinita (numero, stringa, data)
- enumNames (Stringa[])
- chartType (String)
Ad esempio, consente di definire regole per visualizzare la casella di testo quando si fa clic su un pulsante. Per definire una regola è possibile utilizzare una funzione personalizzata, un oggetto modulo, una proprietà oggetto o un output di servizio.
Per definire una regola basata su una funzione personalizzata, selezionare Output funzione dall'elenco a discesa e trascinare una funzione personalizzata dalla scheda Funzioni. Se l'azione della condizione viene soddisfatta, la casella di immissione testo diventa visibile.
Per definire una regola basata su un oggetto modulo, selezionare Oggetto modulo dall'elenco a discesa e trascinare un oggetto modulo dalla scheda Oggetti modulo. Se l’azione della condizione viene soddisfatta, la casella di immissione testo diventa visibile nel modulo adattivo.
Una regola Imposta proprietà basata su una proprietà oggetto consente di rendere visibile la casella di input di testo in un modulo adattivo basato su un’altra proprietà oggetto inclusa nel modulo adattivo.
La figura seguente illustra un esempio di attivazione dinamica della casella di controllo in base al fatto che la casella di testo è nascosta o visualizzata in un modulo adattivo:
Cancella valore di Cancella il valore dell'oggetto specificato.
Imposta stato attivo Imposta lo stato attivo sull'oggetto specificato.
Invia modulo invia il modulo.
Reimposta Reimposta il modulo o l'oggetto specificato.
Convalida convalida il modulo o l'oggetto specificato.
Aggiungi istanza Aggiunge un'istanza del pannello o della riga di tabella ripetibile specificata.
Rimuovi istanza Rimuove un'istanza del pannello o della riga di tabella ripetibile specificata.
Output funzione Definisce una regola basata su funzioni predefinite o personalizzate.
Accedi a Consente di passare ad altri Forms adattivi, ad altre risorse quali immagini o frammenti di documenti o a un URL esterno.
Evento di invio Attiva azioni o comportamenti specifici in base a condizioni o eventi predefiniti.
Imposta valore di set-value-of
Il tipo di regola Imposta valore di consente di impostare il valore di un oggetto modulo a seconda che la condizione specificata sia soddisfatta o meno. Il valore può essere impostato sul valore di un altro oggetto, una stringa letterale, un valore derivato da un'espressione matematica o una funzione, un valore di una proprietà di un altro oggetto o l'output di un servizio del modello di dati modulo. Analogamente, è possibile verificare la presenza di una condizione su un componente, una stringa, una proprietà o valori derivati da una funzione o un'espressione matematica.
Il tipo di regola Imposta valore di non è disponibile per tutti gli oggetti modulo, ad esempio pannelli e pulsanti della barra degli strumenti. Una regola Set Value Of standard ha la seguente struttura:
Imposta il valore dell'oggetto A su:
(stringa ABC) OPPURE
(proprietà dell'oggetto X dell'oggetto C) OPPURE
(valore da una funzione) OPPURE
(valore da un'espressione matematica) OPPURE
(valore di output di un servizio di modello dati);
Quando (facoltativo):
(Condizione 1 E Condizione 2 E Condizione 3) è VERO;
Nell'esempio seguente viene selezionato il valore di Question2
as True
e impostato il valore di Result
as correct
.
Esempio di Set Valore regola mediante l'utilizzo del servizio Form Data Model.
Mostrare show
Utilizzando il tipo di regola Mostra, è possibile scrivere una regola per mostrare o nascondere un oggetto modulo in base al soddisfacimento o meno di una condizione. Il tipo di regola Show attiva anche l'azione Nascondi nel caso in cui la condizione non sia soddisfatta o restituisca False
.
Una regola Show tipica è strutturata come segue:
Show Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Else:
Hide Object A;
Nascondi hide
Analogamente al tipo di regola Mostra, è possibile utilizzare il tipo di regola Nascondi per mostrare o nascondere un oggetto modulo in base al soddisfacimento o meno di una condizione. Il tipo di regola Nascondi attiva anche l'azione Mostra se la condizione non è soddisfatta o restituisce False
.
Una tipica regola Nascondi è strutturata come segue:
Hide Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Show Object A;
Abilita enable
Il tipo di regola Enable consente di abilitare o disabilitare un oggetto modulo in base al soddisfacimento o meno di una condizione. Il tipo di regola Enable attiva anche l'azione Disable nel caso in cui la condizione non sia soddisfatta o restituisca False
.
Una regola di abilitazione tipica è strutturata come segue:
Enable Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Disable Object A;
Disattiva disable
Analogamente al tipo di regola Abilita, il tipo di regola Disabilita consente di abilitare o disabilitare un oggetto modulo a seconda che una condizione sia soddisfatta o meno. Il tipo di regola Disable attiva anche l'azione Enable nel caso in cui la condizione non sia soddisfatta o restituisca False
.
Una regola di Disattivazione tipica è strutturata come segue:
Disable Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Else:
Enable Object A;
Convalida validate
Il tipo di regola Convalida convalida il valore in un campo utilizzando un'espressione. È ad esempio possibile scrivere un'espressione per verificare che la casella di testo per specificare il nome non contenga caratteri o numeri speciali.
Una regola di convalida tipica è strutturata come segue:
Validate Object A;
Using:
(Expression 1 AND Expression 2 AND Expression 3) is TRUE;
Interfaccia utente dell’editor di regole understanding-the-rule-editor-user-interface
L’editor di regole fornisce un’interfaccia utente completa ma semplice per scrivere e gestire le regole. Puoi avviare l’interfaccia utente dell’editor di regole da un modulo adattivo in modalità di authoring.
Per avviare l’interfaccia utente dell’editor di regole:
-
Apri un modulo adattivo in modalità di authoring.
-
Selezionare l'oggetto modulo per il quale si desidera scrivere una regola e nella barra degli strumenti del componente selezionare . Viene visualizzata l’interfaccia utente dell’editor di regole.
Tutte le regole esistenti sugli oggetti modulo selezionati sono elencate in questa visualizzazione. Per informazioni sulla gestione delle regole esistenti, vedere Gestire le regole.
-
Seleziona Crea per scrivere una nuova regola. L’editor visivo dell’interfaccia utente dell’editor di regole si apre per impostazione predefinita quando si avvia l’editor di regole la prima volta.
Esaminiamo in dettaglio ogni componente dell’interfaccia utente dell’editor di regole.
A. Visualizzazione delle regole dei componenti a-component-rule-display
Visualizza il titolo dell'oggetto modulo adattivo tramite il quale è stato avviato l'editor di regole e il tipo di regola attualmente selezionato. Nell’esempio precedente, l’editor di regole viene avviato da un oggetto Modulo adattivo denominato Domanda 1 e il tipo di regola selezionato è Quando.
B. Oggetti e funzioni del modulo b-form-objects-and-functions-br
Il riquadro a sinistra nell'interfaccia utente dell'editor di regole include due schede: Oggetti Forms e Funzioni.
La scheda Oggetti modulo mostra una vista gerarchica di tutti gli oggetti contenuti nel modulo adattivo. Visualizza il titolo e il tipo degli oggetti. Durante la scrittura di una regola, è possibile trascinare gli oggetti modulo nell’editor di regole. Quando si trascina un oggetto o una funzione in un segnaposto durante la creazione o la modifica di una regola, il segnaposto assume automaticamente il tipo di valore appropriato.
Gli oggetti modulo a cui sono applicate una o più regole valide sono contrassegnati da un punto verde. Se una delle regole applicate a un oggetto modulo non è valida, l'oggetto modulo viene contrassegnato con un punto giallo.
La scheda Funzioni include un set di funzioni incorporate, ad esempio Somma di, Min di, Max di, Media di, Numero di e Convalida modulo. È possibile utilizzare queste funzioni per calcolare i valori nei pannelli e nelle righe di tabella ripetibili e utilizzarli nelle istruzioni di azione e condizione durante la scrittura delle regole. Tuttavia, puoi anche creare funzioni personalizzate.
Nella figura sono illustrate alcune delle funzioni elencate di seguito:
Nell'albero sinistro degli oggetti modulo è possibile selezionare gli oggetti modulo per visualizzare le regole applicate a ciascuno degli oggetti. Non solo è possibile spostarsi tra le regole dei vari oggetti modulo, ma è anche possibile copiare e incollare le regole tra gli oggetti modulo. Per ulteriori informazioni, vedere Copiare e incollare le regole.
C. Attivazione/disattivazione di funzioni e oggetti modulo c-form-objects-and-functions-toggle-br
Quando viene toccato, questo pulsante attiva o disattiva il riquadro delle funzioni e degli oggetti del modulo.
D. Editor di regole visive visual-rule-editor
L’editor di regole visive è l’area in cui si scrivono le regole nella modalità editor visivo dell’interfaccia utente dell’editor di regole. Ti consente di selezionare un tipo di regola e di definire di conseguenza condizioni e azioni. Quando si definiscono condizioni e azioni in una regola, è possibile trascinare gli oggetti modulo e le funzioni dal riquadro Oggetti modulo e funzioni.
Per ulteriori informazioni sull'utilizzo dell'editor di regole visive, vedere Scrivere regole.
E. Tasti Done e cancel done-and-cancel-buttons
Il pulsante Fine viene utilizzato per salvare una regola. È possibile salvare una regola incompleta. Tuttavia, gli incompleti vengono non valido e non vengono eseguiti. Le regole salvate in un oggetto modulo vengono elencate quando si lanciare la regola editor successiva dallo stesso oggetto modulo. È possibile gestire regole esistenti in questa visualizzazione. Per ulteriori informazioni, vedere Gestire le regole.
Il Annulla pulsante elimina tutte le modifiche apportate a un regola e chiude il regola editor.
Scrivere regole write-rules
È possibile scrivere regole utilizzando i regola editor visivi
Vediamo innanzitutto come scrivere regole utilizzando l’editor visivo.
Utilizzo dell’editor visivo using-visual-editor
Comprendiamo come creare una regola nell’editor visivo utilizzando il seguente modulo di esempio.
La sezione Requisiti di prestito nel modulo di applicazione di prestito di esempio richiede ai richiedenti di specificare il proprio stato civile, lo stipendio e, se sposati, lo stipendio del coniuge. In base agli input dell’utente, la regola calcola l’importo di idoneità al prestito e viene visualizzata nel campo Idoneità al prestito. Per implementare lo scenario, applica le seguenti regole:
- Il campo Stipendio coniuge viene visualizzato solo quando lo stato civile è sposato.
- L’importo di ammissibilità al prestito è pari al 50% dello stipendio totale.
Per scrivere le regole, effettua le seguenti operazioni:
-
Innanzitutto, scrivi la regola per controllare la visibilità del campo Stipendio coniuge in base all’opzione selezionata dall’utente per il pulsante di opzione Stato civile.
Apri il modulo di richiesta di prestito in modalità di creazione. Selezionare il componente Stato civile e selezionare . Quindi, seleziona Crea per avviare l'editor di regole.
Quando si avvia l'editor di regole, la regola When è selezionata per impostazione predefinita. Inoltre, l'oggetto modulo (in questo caso, Stato civile) da cui è stato avviato l'editor di regole è specificato nell'istruzione When.
Sebbene non sia possibile modificare l'oggetto selezionato, è possibile utilizzare l'elenco a discesa delle regole, come illustrato di seguito, per selezionare un altro tipo di regola. Se desideri creare una regola su un altro oggetto, seleziona Annulla per uscire dall’editor di regole e riavviarlo dall’oggetto modulo desiderato.
-
Seleziona l'elenco a discesa Seleziona stato e seleziona è uguale a. Viene visualizzato il campo Enter a String.
-
Nel campo Immettere una stringa nella regola, selezionare Sposato dal menu a discesa.
La condizione è stata definita come
When Marital Status is equal to Married
. Quindi, definisci l’azione da eseguire se questa condizione è True. -
Nell'istruzione Then, selezionare Show dal menu a discesa Select Action.
-
Trascina il campo Stipendio coniuge dalla scheda Oggetti modulo del campo Rilascia oggetto o seleziona qui. In alternativa, selezionare il campo Rilascia l'oggetto o seleziona qui e selezionare il campo Stipendio coniuge dal menu a comparsa, che elenca tutti gli oggetti modulo nel modulo.
Quindi, definisci l’azione da eseguire se questa condizione è False.
-
Fare clic su Aggiungi sezione Else per aggiungere un'altra condizione per il campo Stipendio coniuge, nel caso in cui si selezioni Stato civile come singolo.
-
Nell'istruzione Else, selezionare Nascondi dal menu a discesa Seleziona azione.
-
Trascina il campo Stipendio coniuge dalla scheda Oggetti modulo del campo Rilascia oggetto o seleziona qui. In alternativa, selezionare il campo Rilascia l'oggetto o seleziona qui e selezionare il campo Stipendio coniuge dal menu a comparsa, che elenca tutti gli oggetti modulo nel modulo.
La regola viene visualizzata come segue nell’editor di regole.
-
Seleziona Fine per salvare la regola.
-
Scrivere quindi una regola per calcolare l'importo dell'idoneità al prestito, che corrisponde al 50% dello stipendio totale, e visualizzarlo nel campo Idoneità al prestito. Per ottenere questo risultato, crea Imposta il valore di regole nel campo Idoneità al prestito.
In modalità creazione, seleziona il campo Idoneità prestito e seleziona . Quindi, seleziona Crea per avviare l'editor di regole.
-
Selezionare Imposta valore di regola dal menu a discesa delle regole.
-
Seleziona Seleziona opzione e seleziona Espressione matematica. Viene aperto un campo per scrivere espressioni matematiche.
-
Nel campo espressione:
-
Seleziona o trascina dalla scheda Oggetto Forms il campo Stipendio nel primo campo Rilascia oggetto o seleziona qui.
-
Seleziona Plus dal campo Seleziona operatore.
-
Seleziona o trascina dalla scheda Oggetto Forms il campo Stipendio coniuge nell'altro campo Rilascia oggetto o seleziona qui.
-
-
Quindi, seleziona nell'area evidenziata intorno al campo espressione e seleziona Estendi espressione.
Nel campo espressione estesa, selezionare diviso per dal campo Seleziona operatore e Numero dal campo Seleziona opzione. Specificare quindi 2 nel campo numerico.
note note NOTE È possibile creare espressioni complesse utilizzando componenti, funzioni, espressioni matematiche e valori di proprietà dal campo Seleziona opzione. Successivo, creare una condizione che, quando restituisce True, viene eseguita l'espressione.
-
Selezionare Aggiungi condizione per aggiungere un'istruzione Quando.
Nell'istruzione When:
-
Seleziona o trascina dalla scheda Oggetto Forms il campo Stato civile nel primo campo Rilascia oggetto o seleziona qui.
-
Selezionare è uguale a dal campo Seleziona operatore.
-
Seleziona Stringa nell'altro Rilascia l'oggetto o seleziona qui campo e specifica Sposato nel campo Immetti una stringa.
La regola viene infine visualizzata come segue nell’editor di regole.
-
-
Seleziona Fine. Salva la regola.
-
Ripetere i passaggi da 7 a 14 per definire un'altra regola per calcolare l'idoneità al prestito se lo stato civile è Single. La regola viene visualizzata come segue nell’editor di regole.
In alternativa, è possibile utilizzare la regola Imposta valore di per calcolare l'idoneità al prestito nella regola Quando creata per mostrare-nascondere il campo Stipendio coniuge. La regola combinata risultante quando Stato civile è Singolo viene visualizzata come segue nell’editor delle regole.
È possibile scrivere una regola combinata per controllare la visibilità del campo Stipendio coniuge e calcolare l'idoneità al prestito quando lo stato civile è Sposato utilizzando la condizione Else.
Funzioni personalizzate nell’editor di regole custom-functions
Oltre alle funzioni predefinite, come Somma di, elencate in Output funzioni, è possibile utilizzare anche funzioni personalizzate nell'editor di regole. L’editor di regole supporta la sintassi JavaScript ECMAScript 2019 per gli script e le funzioni personalizzate. Per istruzioni sulla creazione di funzioni personalizzate, consulta l'articolo Funzioni personalizzate in Forms adattivo
Gestisci regole manage-rules
Tutte le regole esistenti in un oggetto modulo vengono elencate quando si seleziona l'oggetto e si seleziona . Puoi visualizzare il titolo e un’anteprima del riepilogo delle regole. Inoltre, l’interfaccia utente consente di espandere e visualizzare il riepilogo completo delle regole, modificarne l’ordine, modificarne le regole ed eliminarle.
Puoi eseguire le seguenti azioni sulle regole:
-
Espandi/comprimi: la colonna Contenuto nell'elenco delle regole visualizza il contenuto della regola. Se l'intero contenuto della regola non è visibile nella visualizzazione predefinita, selezionare per espanderlo.
-
Riordina: tutte le nuove regole create sono sovrapposte nella parte inferiore dell'elenco di regole. Le regole vengono eseguite dall'alto verso il basso. La regola in alto viene eseguita per prima, seguita da altre regole dello stesso tipo. Ad esempio, se disponi di regole When, Show, Enable e When rispettivamente in prima, seconda, terza e quarta posizione dall'alto, la regola When nella parte superiore viene eseguita per prima seguita dalla regola When nella quarta posizione. Vengono quindi eseguite le regole Mostra e Abilita.
È possibile modificare l'ordine di una regola toccando o trascinandola nell'ordine desiderato nell'elenco. -
Modifica: per modificare una regola, selezionare la casella di controllo accanto al titolo della regola. Vengono visualizzate le opzioni per modificare ed eliminare la regola. Seleziona Modifica per aprire la regola selezionata nell'editor regole .
-
Elimina: per eliminare una regola, selezionarla e selezionare Elimina.
-
Attiva/Disattiva: quando è necessario sospendere temporaneamente l'utilizzo di una regola, è possibile selezionare una o più regole e selezionare Disattiva nella barra degli strumenti Azioni per disattivarle. Se una regola è disabilitata, non viene eseguita in fase di esecuzione. Per abilitare una regola disabilitata, selezionala e seleziona Abilita nella barra degli strumenti delle azioni. La colonna di stato della regola indica se la regola è abilitata o disabilitata.
Regole di copia e incolla copy-paste-rules
Per risparmiare tempo, puoi copiare e incollare una regola da un campo ad altri campi simili.
Per copiare e incollare le regole, effettuare le seguenti operazioni:
-
Selezionare l'oggetto modulo da cui si desidera copiare una regola e nella barra degli strumenti del componente selezionare . Viene visualizzata l’interfaccia utente dell’editor di regole con l’oggetto modulo selezionato e le regole esistenti.
Per informazioni sulla gestione delle regole esistenti, vedere Gestire le regole.
-
Selezionare la casella di controllo accanto al titolo della regola per visualizzare le opzioni per la gestione della regola. Seleziona Copia.
-
Selezionare un altro oggetto modulo in cui incollare la regola e selezionare Incolla. Inoltre, puoi modificare la regola per apportarvi modifiche.
note note NOTE È possibile incollare una regola in un altro oggetto modulo solo se tale oggetto supporta l'evento della regola copiata. Ad esempio, un pulsante supporta l’evento clic. È possibile incollare una regola con un evento clic su un pulsante ma non su una casella di controllo. -
Seleziona Fine per salvare la regola.
Espressioni nidificate nestedexpressions
L’editor di regole consente di utilizzare più operatori AND e OR per creare regole nidificate. È possibile combinare più operatori AND e OR nelle regole.
Di seguito è riportato un esempio di regola nidificata che visualizza un messaggio per l’utente sull’idoneità per la custodia di un bambino quando vengono soddisfatte le condizioni richieste.
Puoi anche trascinare le condizioni all’interno di una regola per modificarla. Seleziona e passa il puntatore del mouse sull'handle ( ) prima di una condizione. Una volta che il puntatore si trasforma nel simbolo della mano, come illustrato di seguito, trascinare e rilasciare la condizione in qualsiasi punto della regola. La struttura della regola cambia.
Condizioni dell'espressione data dateexpression
La regola editor consente di utilizzare i confronti di date per creare condizioni.
Di seguito è riportata una condizione di esempio che visualizza un oggetto di testo statico se l'ipoteca sulla casa è già stata presa, che il utente indica compilando il campo data.
Quando la data di ipoteca dell'immobile compilata dal utente è passata, il modulo adattivo visualizza una nota sul calcolo del reddito. Nella regola seguente viene confrontata la data compilata dall'utente con la data corrente e se la data compilata dal utente è precedente alla data corrente, nel modulo viene visualizzato il messaggio di testo (denominato Reddito).
Quando la data di compilazione è precedente alla data corrente, nel modulo viene visualizzato il messaggio di testo (Entrate) nel modo seguente:
Condizioni di confronto dei numeri number-comparison-conditions
L’editor di regole consente di creare condizioni che confrontano due numeri.
Di seguito è riportata una condizione di esempio che visualizza un oggetto di testo statico se il numero di mesi in cui un richiedente soggiorna all'indirizzo corrente è inferiore a 36.
Quando l’utente indica di vivere all’attuale indirizzo residenziale per meno di 36 mesi, il modulo mostra una notifica che indica che è possibile richiedere più prove di residenza.
Regole di esempio example
Richiama servizio modello dati modulo invoke
Si consideri un servizio Web GetInterestRates
che accetta come input l'importo del prestito, la locazione e il punteggio di credito del richiedente e restituisce un piano di prestito che include l'importo dell'IME e il tasso di interesse. È possibile creare un modello dati modulo (FDM) utilizzando il servizio Web come origine dati. Gli oggetti modello dati e un servizio get
vengono aggiunti al modello di modulo. Il servizio viene visualizzato nella scheda Servizi del modello dati del modulo (FDM). Quindi, crea un modulo adattivo che includa i campi dagli oggetti modello dati per acquisire gli input dell’utente per l’importo del prestito, la durata e il punteggio di credito. Aggiungi un pulsante che attiva il servizio web per recuperare i dettagli del piano. L’output viene compilato nei campi appropriati.
La regola seguente mostra come configurare l’azione Richiama servizio per eseguire lo scenario di esempio.
Attivazione di più azioni tramite la regola When triggering-multiple-actions-using-the-when-rule
In un modulo di richiesta di prestito, si desidera stabilire se il richiedente è un cliente esistente o meno. In base alle informazioni fornite dall'utente, il campo ID cliente deve essere visualizzato o nascosto. Inoltre, se l’utente è un cliente esistente, imposta il campo ID cliente come elemento attivo. Il modulo di richiesta di prestito presenta le seguenti componenti:
-
Un pulsante di scelta, Sei già un cliente del Geometrixx?, che fornisce Sì e No opzioni. Il valore per Sì è 0 e No è 1.
-
Un campo di testo, ID cliente Geometrixx, per specificare l'ID cliente.
Quando scrivi una regola When sul pulsante di scelta per implementare questo comportamento, la regola viene visualizzata come segue nell’editor di regole visive.
Regola nell’editor visivo
Nella regola di esempio, l'istruzione nella sezione When è la condizione che, quando restituisce True, esegue le azioni specificate nella sezione Then.
Utilizzo di un output di funzione in una regola using-a-function-output-in-a-rule
In un modulo ordine fornitore è disponibile la tabella seguente, in cui gli utenti compilano i propri ordini. In questa tabella:
- La prima riga è ripetibile, in modo che gli utenti possano ordinare più prodotti e specificare quantità diverse. Il nome elemento è
Row1
. - Il titolo della cella nella colonna Quantità prodotto della riga ripetibile è Quantità. Il nome elemento per questa cella è
productquantity
. - La seconda riga della tabella non è ripetibile e il titolo della cella nella colonna Quantità prodotto di questa riga è Quantità totale.
A. Riga1 B. Quantità C. Quantità Totale
Ora si desidera aggiungere le quantità specificate nella colonna Quantità prodotto per tutti i prodotti e visualizzare la somma nella cella Quantità totale. È possibile ottenere tale somma scrivendo una regola Imposta valore di nella cella Quantità totale come illustrato di seguito.
Regola nell’editor visivo
Convalida di un valore di campo tramite espressione validating-a-field-value-using-expression
Nel modulo dell'ordine di acquisto illustrato nell'esempio precedente, si desidera impedire agli utenti di ordinare più di una quantità di qualsiasi prodotto il cui prezzo sia superiore a 10000. Per eseguire questa convalida, è possibile scrivere una regola di convalida come illustrato di seguito.
Regola nell’editor visivo