Show Menu
ARGOMENTI×

Editor di regole per moduli adattivi

Panoramica

La funzione Editor regole di Adobe Experience Manager Forms consente agli utenti aziendali e agli sviluppatori di moduli di scrivere regole sugli oggetti modulo adattivi. Queste regole definiscono le azioni da eseguire sugli oggetti modulo in base a condizioni predefinite, input dell'utente e azioni dell'utente sul modulo. Consente di semplificare ulteriormente la compilazione dei moduli, garantendo precisione e velocità.
L'editor di regole fornisce un'interfaccia utente intuitiva e semplificata per scrivere le regole. L’editor delle regole offre un editor visivo a tutti gli utenti. Inoltre, solo per gli utenti che utilizzano i moduli, l'editor di regole fornisce un editor di codice per scrivere regole e script. Alcune delle azioni chiave che è possibile eseguire sugli oggetti modulo adattivi utilizzando le regole sono:
  • Mostrare o nascondere un oggetto
  • Abilitare o disabilitare un oggetto
  • Impostare un valore per un oggetto
  • Convalida del valore di un oggetto
  • Esecuzione di funzioni per calcolare il valore di un oggetto
  • Richiamare un servizio del modello dati del modulo ed eseguire un'operazione
  • Imposta proprietà di un oggetto
L'editor di regole sostituisce le funzionalità di scripting in AEM 6.1 Forms e nelle versioni precedenti. Tuttavia, gli script esistenti vengono mantenuti nel nuovo editor di regole. Per ulteriori informazioni sull'utilizzo degli script esistenti nell'editor delle regole, vedere Impatto dell'editor delle regole sugli script esistenti.
Gli utenti aggiunti al gruppo form-power-users possono creare nuovi script e modificare quelli esistenti. Gli utenti del gruppo form-users possono utilizzare gli script ma non creare o modificare script.

Comprendere una regola

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, il valore o la 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 Quando, Mostra, Nascondi, Abilita, Disattiva, Imposta valore di e Convalida per facilitare la scrittura delle regole. Ogni tipo di regola consente di definire condizioni e azioni in una regola. Nel documento vengono inoltre descritti in dettaglio ogni tipo di regola.
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 all'istruzione if-then nei linguaggi di programmazione.
Nell'editor delle regole, il tipo di regola Quando 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, Disattiva, Imposta valore di e Convalida nell'editor di regole applicano il costrutto della regola della condizione azione. Per impostazione predefinita, l’azione alternativa per Mostra è Nascondi e per Abilita è Disattiva e viceversa. Non è possibile modificare l'azione alternativa predefinita.
I tipi di regole disponibili, comprese le condizioni e le azioni definite nell'editor delle regole, dipendono anche dal tipo di oggetto modulo da cui si sta creando una regola. L'editor di regole visualizza solo tipi di regole e opzioni validi per la scrittura di istruzioni di condizione e azione per un particolare tipo di oggetto modulo. Ad esempio, non vengono visualizzati i tipi di regola Convalida, Imposta valore di, Abilita e Disattiva per un oggetto pannello.
Per ulteriori informazioni sui tipi di regole disponibili nell'editor delle regole, vedere Tipi di regole disponibili nell'editor delle regole.

Linee guida per la scelta di un costrutto di regola

Sebbene sia possibile ottenere la maggior parte dei casi di utilizzo utilizzando qualsiasi costrutto di regola, di seguito sono riportate alcune linee guida per scegliere un costrutto più di un altro. Per ulteriori informazioni sulle regole disponibili nell'editor delle regole, vedere Tipi di regole disponibili nell'editor delle regole.
  • Una regola tipica del pollice durante la creazione di una regola consiste nel pensarci nel contesto dell'oggetto su cui si sta scrivendo una regola. Tenere presente che si desidera nascondere o mostrare il 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 scrive una regola nel campo B (l'oggetto su cui si sta valutando una condizione), utilizzare il costrutto condizione-azione o il tipo di regola Quando. Allo stesso modo, utilizzare il costrutto della condizione azione o il tipo di regola Mostra o Nascondi nel campo A.
  • A volte, è necessario eseguire più azioni in base a una condizione. In tali casi, si consiglia di utilizzare il costrutto condizione-azione. In questo costrutto è possibile valutare una condizione una 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 Quando il tipo di regola sul campo A e specificare le 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, dove ogni regola controlla la condizione e mostra o nasconde il rispettivo campo. In questo esempio, è più efficace scrivere il tipo di regola Quando su un oggetto anziché mostrare o nascondere il tipo di regola su tre oggetti.
  • Per attivare un'azione basata su più condizioni, si consiglia di utilizzare il costrutto di condizione azione. Ad esempio, per visualizzare e nascondere il campo A valutando le condizioni nei campi B, C e D, utilizzare Mostra o Nascondi tipo di regola nel campo A.
  • Utilizzare il costrutto condizione-azione o condizione azione se la regola contiene un'azione per una condizione.
  • Se una regola cerca una condizione ed esegue immediatamente un'azione quando fornisce un valore in un campo o esce da un campo, è consigliabile scrivere una regola con il costrutto condizione-azione o il tipo di regola Quando nel campo in cui viene valutata la condizione.
  • La condizione nella regola Quando viene valutata quando un utente modifica il valore dell'oggetto a cui viene applicata la regola Quando. Tuttavia, se si desidera che l'azione venga attivata quando il valore cambia sul lato server, come nel caso di precompilazione del valore, è consigliabile scrivere una regola Quando che attivi l'azione quando il campo viene inizializzato.
  • Quando si scrivono regole per gli oggetti a discesa, pulsanti di scelta o caselle di controllo, le opzioni o i valori di questi oggetti modulo nel modulo sono precompilati nell'editor delle regole.

Tipi di operatori ed eventi disponibili nell'editor delle regole

L'editor di regole fornisce i seguenti operatori logici ed eventi tramite i quali è possibile creare le regole.
  • È uguale a
  • Non è uguale a
  • Inizia con
  • Termina con
  • Contiene
  • È vuoto
  • Non è vuoto
  • ​Con: Restituisce true quando l'utente seleziona una particolare opzione per un pulsante di scelta, un pulsante di scelta a discesa e una casella di controllo.
  • ​È inizializzato (evento): Restituisce true quando un oggetto modulo viene riprodotto nel browser.
  • ​È 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

L'editor di regole fornisce un set di tipi di regole predefiniti che è possibile utilizzare per scrivere regole. Vediamo ogni tipo di regola nei dettagli. Per ulteriori informazioni sulla scrittura di regole nell'editor di regole, vedere Regole di scrittura.

Quando

Il tipo di regola Quando segue il costrutto della regola di azione alternata condizione-azione o, talvolta, solo il costrutto condizione-azione . In questo tipo di regola, specificare prima una condizione per la valutazione seguita da un'azione da attivare se la condizione è soddisfatta ( True ). Quando si utilizza il tipo di regola Quando, è possibile utilizzare più operatori AND e OR per creare espressioni Espressioni nidificate nidificate.
Utilizzando il tipo di regola Quando, è possibile valutare una condizione su un oggetto modulo ed eseguire azioni su uno o più oggetti.
In parole semplici, una regola Quando 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;

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 automaticamente e rese disponibili 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 Quando, potete attivare l'azione Cancella valore di. Cancella valore dell'azione cancella il valore dell'oggetto specificato. L'opzione Cancella valore come opzione nell'istruzione When consente di creare condizioni complesse con più campi.
Nascondi nasconde l'oggetto specificato.
Mostra Mostra l'oggetto specificato.
Abilita Abilita l'oggetto specificato.
Disattiva disabilita l'oggetto specificato.
Richiama il servizio Richiama un servizio configurato in un modello dati del modulo. Quando si sceglie l'operazione di richiamo del servizio, viene visualizzato un campo. Toccando il campo, vengono visualizzati tutti i servizi configurati in tutti i modelli di dati del modulo nell'istanza di AEM. Scegliendo un servizio del modello dati modulo, vengono visualizzati campi aggiuntivi in cui è possibile mappare gli oggetti modulo con i parametri di input e output per il servizio specificato. Vedere regola di esempio per richiamare i servizi del modello dati del modulo.
Oltre al servizio del modello dati modulo, è possibile specificare un URL WSDL diretto per richiamare un servizio Web. Tuttavia, un servizio del modello dati modulo presenta molti vantaggi e l'approccio consigliato per richiamare un servizio.
Per ulteriori informazioni sulla configurazione dei servizi nel modello dati del modulo, consultate Integrazione dati di AEM Forms.
Impostare il valore Computes e impostare il valore dell'oggetto specificato. È possibile impostare il valore dell'oggetto su una stringa, il valore di un altro oggetto, il valore calcolato utilizzando l'espressione o la funzione matematica, il valore di una proprietà di un oggetto o il valore di output da un servizio del modello dati del modulo configurato. Quando si sceglie l'opzione del servizio Web, vengono visualizzati tutti i servizi configurati in tutti i modelli di dati del modulo nell'istanza di AEM. Scegliendo un servizio del modello dati modulo, vengono visualizzati campi aggiuntivi 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 del modulo, consultate Integrazione dati di AEM Forms.
Imposta proprietà Imposta il valore di una proprietà dell'oggetto specificato.
Cancella valore Cancella il valore dell'oggetto specificato.
Imposta lo stato attivo dell'oggetto specificato.
Salva modulo Salva il modulo.
Invia moduli Invia il modulo.
Ripristina modulo Ripristina il modulo.
Convalida modulo Convalida il modulo.
Aggiungi istanza Aggiunge un'istanza del pannello o della riga di tabella ripetibili specificati.
Rimuovi istanza Rimuove un'istanza del pannello o della riga di tabella ripetibili specificati.

Imposta valore di

Il valore impostato del tipo di regola consente di impostare il valore di un oggetto modulo a seconda che la condizione specificata sia soddisfatta o meno. Il valore può essere impostato su un 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 dati del 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 i pannelli e i pulsanti della barra degli strumenti. Una regola Set Value Of standard ha la struttura seguente:
Impostate il valore dell'oggetto A su:
(stringa ABC) OR (proprietà dell'oggetto X dell'oggetto C) OR (valore da una funzione) OR (valore da un'espressione matematica) OR (valore di output di un servizio del modello dati o di un servizio Web);
Quando (facoltativo):
(condizione 1 E condizione 2 E condizione 3) è TRUE;
L'esempio seguente prende il valore in dependentid campo come input e imposta il valore del Relation campo sull'output dell' Relation argomento del servizio del modello dati del getDependent modulo.
Esempio di regola Imposta valore tramite il servizio del modello dati del modulo
È inoltre possibile utilizzare Imposta valore regola per compilare tutti i valori di un componente elenco a discesa dall'output di un servizio del modello dati del modulo o di un servizio Web. Tuttavia, accertatevi che l'argomento di output scelto sia di tipo matrice. Tutti i valori restituiti in una matrice diventano disponibili nell'elenco a discesa specificato.

Mostra

Utilizzando il tipo di regola Mostra , è possibile scrivere una regola per mostrare o nascondere un oggetto modulo a seconda che una condizione sia soddisfatta o meno. Il tipo di regola Mostra attiva anche l'azione Nascondi se la condizione non è soddisfatta o restituisce 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

Simile al tipo di regola Mostra, è possibile utilizzare il tipo di regola Nascondi per mostrare o nascondere un oggetto modulo in base al fatto che una condizione sia soddisfatta o meno. Il tipo di regola Nascondi attiva anche l'azione Mostra se la condizione non è soddisfatta o restituisce False .
Una regola Nascondi tipica è strutturata come segue:
Hide Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Show Object A;

Abilita

Il tipo di regola Abilita consente di abilitare o disabilitare un oggetto modulo a seconda che una condizione sia soddisfatta o meno. Il tipo di regola Abilita attiva anche l'azione Disattiva nel caso in cui la condizione non sia soddisfatta o restituisca False .
Una regola Enable tipica è strutturata come segue:
Enable Object A;
When:
(Condition 1 AND Condition 2 AND Condition 3) is TRUE;
Else:
Disable Object A;

Disattiva

Simile al tipo di regola Abilita, il tipo di regola Disattiva consente di abilitare o disabilitare un oggetto modulo in base al fatto 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

Il tipo di regola Validate 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 speciali o numeri.
Una regola Convalida tipica è strutturata come segue:
Validate Object A;
Using:
(Expression 1 AND Expression 2 AND Expression 3) is TRUE;
Se il valore specificato non è conforme alla regola Validate, è possibile visualizzare all'utente un messaggio di convalida. È possibile specificare il messaggio nel campo del messaggio di convalida script delle proprietà del componente nella barra laterale.

Interfaccia utente dell'editor di regole

L'editor di regole fornisce un'interfaccia utente completa ma semplice per scrivere e gestire le regole. È possibile avviare l'interfaccia utente dell'editor di regole da un modulo adattivo in modalità di creazione.
Per avviare l'interfaccia utente dell'editor di regole:
  1. Aprire un modulo adattivo in modalità di creazione.
  2. Toccare l'oggetto modulo per il quale si desidera scrivere una regola e nella barra degli strumenti del componente toccare di modifica. Viene visualizzata l'interfaccia utente dell'editor di regole.
    In questa visualizzazione sono elencate tutte le regole esistenti sugli oggetti modulo selezionati. Per informazioni sulla gestione delle regole esistenti, consultate Gestire le regole .
  3. Toccate 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.
    Fare clic per ingrandire Esaminiamo in dettaglio ciascun componente dell'interfaccia utente dell'editor di regole.

A. Visualizzazione di regole di componente

Visualizza il titolo dell'oggetto modulo adattivo tramite il quale sono stati avviati 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 Salario e il tipo di regola selezionato è Quando.

B. Form objects and functions

Il riquadro a sinistra nell'interfaccia utente dell'editor di regole include due schede: Oggetti e funzioni di Forms
La scheda Oggetti modulo mostra una visualizzazione 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. Durante la creazione o la modifica di una regola quando si trascina un oggetto o una funzione in un segnaposto, il segnaposto assume automaticamente il tipo di valore appropriato.
Gli oggetti modulo a cui sono applicate una o più regole valide sono contrassegnati con un punto verde. Se una delle regole applicate a un oggetto modulo non è valida, l'oggetto modulo è contrassegnato da un punto giallo.
La scheda Funzioni include un set di funzioni integrate, 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 utilizzarle nelle istruzioni di azione e condizione durante la scrittura delle regole. È tuttavia possibile creare anche funzioni Funzioni personalizzate nell'editor di regole personalizzate.
È possibile eseguire la ricerca del testo nei nomi e nei titoli di oggetti e funzioni delle schede Oggetti e funzioni di Forms.
Nella struttura ad albero a sinistra degli oggetti modulo è possibile toccare gli oggetti modulo per visualizzare le regole applicate a ciascuno di essi. 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, consultate Copiare e incollare le regole .

C. Oggetti e funzioni del modulo

Quando viene toccato, il pulsante di attivazione/disattivazione attiva il riquadro oggetti modulo e funzioni.

D. Editor di regole visive

L'editor di regole visive è l'area nella modalità di editor visivo dell'interfaccia utente dell'editor di regole in cui si scrivono le regole. Consente di selezionare un tipo di regola e di definire di conseguenza condizioni e azioni. Quando si definiscono le condizioni e le azioni in una regola, è possibile trascinare oggetti modulo e funzioni dal riquadro Oggetti modulo e funzioni.
Per ulteriori informazioni sull'utilizzo dell'editor di regole visive, vedere Regole di scrittura.

E. Switcher editor di codice visivo

Gli utenti del gruppo form-power-users possono accedere all'editor di codice. Per altri utenti, l’editor di codice non è disponibile. Se disponete dei diritti, potete passare dalla modalità editor visivo alla modalità editor di codice dell'editor di regole e viceversa, utilizzando lo switcher immediatamente sopra l'editor di regole. Quando avviate l'editor di regole la prima volta, questo si apre in modalità editor visivo. È possibile scrivere regole in modalità editor visivo o passare alla modalità editor di codice per scrivere uno script di regola. Tuttavia, se modificate una regola o scrivete una regola nell'editor di codice, non potete tornare all'editor visivo per tale regola a meno che non cancellate l'editor di codice.
AEM Forms tiene traccia della modalità editor regole utilizzata per l'ultima volta per scrivere una regola. Quando si avvia l'editor di regole la prossima volta, questo si apre in tale modalità. Tuttavia, potete anche configurare una modalità predefinita per aprire l'editor di regole nella modalità specificata. A questo scopo:
  1. Andate alla console Web di AEM all'indirizzo https:// #: #/sistema/console/configMgr.
  2. Fare clic per modificare il servizio di configurazione del modulo adattivo.
  3. scegliere Editor ​visivo o Editor di codice dal menu a discesa Modalità predefinita per Editor regola
  4. Fai clic su Salva .

F. Pulsanti Fine e Annulla

Per salvare una regola viene utilizzato il pulsante Fine . È possibile salvare una regola incompleta. Tuttavia, incompleti non sono validi e non vengono eseguiti. Le regole salvate in un oggetto modulo vengono elencate al successivo avvio dell'editor di regole dallo stesso oggetto modulo. È possibile gestire le regole esistenti in tale visualizzazione. Per ulteriori informazioni, consultate Gestire le regole .
Il pulsante Annulla elimina tutte le modifiche apportate a una regola e chiude l'editor di regole.

Regole di scrittura

Potete scrivere le regole utilizzando l'editor di regole visive o l'editor di codice. Quando si avvia per la prima volta l'editor di regole, questo si apre in modalità editor visivo. È possibile passare alla modalità editor di codice e scrivere regole. Tuttavia, se si scrive o si modifica una regola nell'editor di codice, non è possibile passare all'editor visivo per tale regola a meno che non si cancelli l'editor di codice. Quando si avvia l'editor di regole la prossima volta, questo si apre nella modalità utilizzata l'ultima volta per creare la regola.
Vediamo innanzitutto come scrivere regole utilizzando l'editor visivo.

Utilizzo dell’editor visivo

Comprendere come creare una regola nell'editor visivo utilizzando il seguente modulo di esempio.
La sezione Requisiti del prestito nel modulo di domanda di prestito di esempio richiede ai richiedenti di specificare il loro stato civile, lo stipendio e, se sposati, lo stipendio del coniuge. In base agli input dell'utente, la regola calcola l'importo di idoneità del prestito e viene visualizzata nel campo Idoneità del prestito. Applicate le seguenti regole per implementare lo scenario:
  • Il campo Stipendio del coniuge viene visualizzato solo quando lo Stato coniugale è sposato.
  • L'importo di ammissibilità al prestito è pari al 50% dello stipendio totale.
Effettuare le seguenti operazioni per scrivere le regole:
  1. Innanzitutto, scrivere la regola per controllare la visibilità del campo Stipendio coniuge in base all'opzione selezionata dall'utente per il pulsante di scelta Stato coniugale.
    Aprire il modulo di richiesta di prestito in modalità di creazione. Toccate il componente Stato ​civile e toccate le regole modifica. Quindi, toccate Crea per avviare l'editor delle regole.
    Quando si avvia l'editor delle regole, la regola Quando è selezionata per impostazione predefinita. Inoltre, l'oggetto modulo (in questo caso, Stato civile) dal quale è stato avviato l'editor di regole è specificato nell'istruzione When.
    Anche se non è possibile modificare l'oggetto selezionato, è possibile utilizzare il menu a discesa Regola, come illustrato di seguito, per selezionare un altro tipo di regola. Se si desidera creare una regola su un altro oggetto, toccare Annulla per uscire dall'editor delle regole e avviarlo nuovamente dall'oggetto modulo desiderato.
  2. Toccate Seleziona stato e selezionate è uguale a. Viene visualizzato il campo Immettere una stringa .
    Nel pulsante di scelta Stato civile, alle opzioni Sposato e Singolo vengono assegnati rispettivamente 0 e 1 . È possibile verificare i valori assegnati nella scheda Titolo della finestra di dialogo del pulsante di scelta Modifica, come illustrato di seguito.
  3. Nel campo Immettere una stringa nella regola, specificare 0 .
    La condizione è stata definita come When Marital Status is equal to Married . Quindi, definire l'azione da eseguire se questa condizione è True.
  4. Nell'istruzione Quindi, selezionare Mostra dal menu a discesa Seleziona azione .
  5. Trascinare il campo Stipendio ​coniuge dalla scheda Oggetti modulo dell'oggetto Drop oppure selezionare il campo here . In alternativa, toccare l'oggetto Drop (Rilascia) o selezionare qui field (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.
    Toccate Fine per salvare la regola.
  6. Ripetere i passaggi da 1 a 5 per definire un'altra regola per nascondere il campo Stipendio coniuge se lo Stato coniugale è Singolo. La regola viene visualizzata come segue nell'editor di regole.
    In alternativa, è possibile scrivere una regola Mostra nel campo Stipendio coniuge, invece di due regole Quando nel campo Stato coniugale, per implementare lo stesso comportamento.
  7. Quindi, scrivere una regola per calcolare l'importo di idoneità del prestito, che corrisponde al 50% dello stipendio totale, e visualizzarla nel campo Idoneità del prestito. A tal fine, creare un valore impostato delle regole nel campo Idoneità del prestito.
    In modalità di authoring, toccate il campo Idoneità prestito e toccate le regole modifica. Quindi, toccate Crea per avviare l'editor delle regole.
  8. Selezionate Imposta valore regola dal menu a discesa Regola.
  9. Toccate Seleziona opzione e selezionate Espressione ​matematica. Si apre un campo per scrivere un'espressione matematica.
  10. Nel campo espressione:
    • Selezionare o trascinare dalla scheda Oggetto modulo il campo Stipendio del primo oggetto Drop oppure selezionare il campo qui .
    • Selezionare Plus dal campo Seleziona operatore .
    • Selezionare o trascinare il campo Stipendio del coniuge dalla scheda Oggetto Forms nell'altro oggetto Drop oppure selezionare il campo qui .
  11. Quindi, toccate l'area evidenziata intorno al campo espressione e toccate Estendi espressione .
    Nel campo espressione estesa, selezionare diviso per dal campo Seleziona operatore e Numero dal campo Seleziona opzione . Quindi, specificate 2 nel campo numerico.
    È possibile creare espressioni complesse utilizzando componenti, funzioni, espressioni matematiche e valori delle proprietà dal campo Seleziona opzione.
    Quindi, creare una condizione, che quando restituisce True, viene eseguita dall'espressione.
  12. Toccate Aggiungi condizione per aggiungere un'istruzione When.
    Nell'istruzione When:
    • Selezionare o trascinare dalla scheda Oggetto Forms il campo Stato ​civile del primo oggetto Drop oppure selezionare il campo qui .
    • Seleziona è uguale al campo Seleziona operatore .
    • Selezionare Stringa nell'altro oggetto Drop oppure selezionare qui field e specificare Sposato nel campo Enter a String .
    La regola viene finalmente visualizzata come segue nell'editor di regole.
    Toccate Fine per salvare la regola.
  13. Ripetere i passaggi da 7 a 12 per definire un'altra regola per calcolare l'idoneità del 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à del prestito nella regola Quando creata per mostrare o nascondere il campo Stipendio del coniuge. La regola combinata risultante quando Stato civile è Single viene visualizzata come segue nell'editor delle regole.
Analogamente, è possibile scrivere una regola combinata per controllare la visibilità del campo Stipendio del coniuge e calcolare l'idoneità del prestito quando lo Stato del matrimonio è sposato.

Utilizzo dell'editor di codice

Gli utenti aggiunti al gruppo form-power-users possono utilizzare l'editor di codice. L'editor di regole genera automaticamente il codice JavaScript per qualsiasi regola creata utilizzando l'editor visivo. È possibile passare dall'editor visivo all'editor di codice per visualizzare il codice generato. Tuttavia, se modificate il codice della regola nell'editor di codice, non potete tornare all'editor visivo. Se preferite scrivere le regole nell'editor di codice piuttosto che nell'editor visivo, potete scrivere di nuovo le regole nell'editor di codice. Lo switcher di modifica del codice visivo consente di passare da una modalità all'altra.
JavaScript dell'editor di codice è il linguaggio di espressione dei moduli adattivi. Tutte le espressioni sono espressioni JavaScript valide e utilizzano API per modelli di script di 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, consultare il documento Riferimento API della libreria JavaScript per i moduli adattivi.
Per ulteriori informazioni sulle linee guida per la scrittura di regole nell'editor di codice, vedere Espressioni modulo adattive.
Durante la scrittura di codice JavaScript nell'editor delle regole, i seguenti suggerimenti visivi sono utili per la struttura e la sintassi:
  • Evidenziazione della sintassi
  • Rientro automatico
  • Suggerimenti e suggerimenti per oggetti modulo, funzioni e relative proprietà
  • Completamento automatico dei nomi dei componenti e delle funzioni JavaScript comuni

Funzioni personalizzate nell'editor di regole

Oltre alle funzioni pronte all'uso come *Somma di, *elencate in Output funzioni, è possibile scrivere funzioni personalizzate di cui si ha spesso bisogno. Assicurarsi che la funzione scritta sia accompagnata da quanto jsdoc sopra.
È jsdoc necessario accompagnare:
  • Se desiderate una configurazione e una descrizione personalizzate.
  • Poiché esistono diversi modi per dichiarare una funzione in JavaScript, e commenti, è possibile tenere traccia delle funzioni.
For more information, see usejsdoc.org .
Tag supportati jsdoc :
  • Privato
    Sintassi: @private
    Una funzione privata non è inclusa come funzione personalizzata.
  • Nome
    Sintassi: @name funcName <Function Name>
    In alternativa , è possibile utilizzare: @function funcName <Function Name> o o @func funcName <Function Name> .
    funcName è il nome della funzione (non sono consentiti spazi).
    <Function Name> è il nome visualizzato della funzione.
  • Membro
    Sintassi: @memberof namespace
    Associa uno spazio dei nomi alla funzione.
  • Parametro
    Sintassi: @param {type} name <Parameter Description>
    In alternativa, potete utilizzare: @argument``{type} name <Parameter Description> oppure @arg``{type} name <Parameter Description> .
    Mostra i parametri utilizzati dalla funzione. Una funzione può avere più tag di parametro, un tag per ogni parametro nell'ordine di occorrenza.
    {type} rappresenta il tipo di parametro. I tipi di parametri consentiti sono:
    1. string
    2. numero
    3. booleano
    Tutti gli altri tipi di parametri sono classificati in una delle categorie precedenti. Nessuno non è supportato. Accertatevi di selezionare uno dei tipi riportati sopra. I tipi non fanno distinzione tra maiuscole e minuscole. Gli spazi non sono consentiti nel parametro name . <Parameter Descrption>
  • Tipo di restituzione
    Sintassi: @return {type}
    In alternativa, potete utilizzare @returns {type} .
    Aggiunge informazioni sulla funzione, ad esempio l'obiettivo.
    rappresenta il tipo restituito dalla funzione. I tipi restituiti consentiti sono:
    1. string
    2. numero
    3. booleano
    4. data
    5. array
    Tutti gli altri tipi di reso sono classificati in una delle categorie precedenti. Nessuno non è supportato. Accertatevi di selezionare uno dei tipi riportati sopra. I tipi restituiti non fanno distinzione tra maiuscole e minuscole.
I commenti prima della funzione personalizzata vengono utilizzati per il riepilogo. Il riepilogo può estendersi a più righe finché non viene rilevato un tag. Limita la dimensione a un singolo per una descrizione sintetica nel generatore di regole.
Aggiunta di una funzione personalizzata
Ad esempio, si desidera aggiungere una funzione personalizzata che calcola l'area di un quadrato. La lunghezza laterale è l'input dell'utente alla funzione personalizzata, che viene accettata utilizzando una casella numerica nel modulo. L'output calcolato viene visualizzato in un'altra casella numerica del modulo. Per aggiungere una funzione personalizzata, è innanzitutto necessario creare una libreria client e quindi aggiungerla all'archivio CRX.
Per creare una libreria client e aggiungerla nell'archivio CRX, procedere come segue.
  1. Creare una libreria client. Per ulteriori informazioni, consultate Utilizzo delle librerie lato client.
  2. In CRXDE, aggiungete una proprietà categories con il valore del tipo di stringa customfunction alla clientlib cartella.
    customfunction è una categoria di esempio. Potete scegliere qualsiasi nome per la categoria creata nella clientlib cartella.
Dopo aver aggiunto la libreria client nell'archivio CRX, utilizzatela nel modulo adattivo. Consente di utilizzare la funzione personalizzata come regola nel modulo. Per aggiungere la libreria client al modulo adattivo, effettuare le operazioni seguenti.
  1. Aprire il modulo in modalità di modifica.
    Per aprire un modulo in modalità di modifica, selezionare un modulo e toccare Apri .
  2. In modalità di modifica, selezionare un componente, quindi toccare il livello campo > Contenitore modulo adattivo, quindi toccare .
  3. Nella barra laterale, in Nome libreria client, aggiungete la libreria client. ( customfunction nell'esempio).
  4. Selezionate la casella numerica di input e toccate di modifica per aprire l'editor di regole.
  5. Toccate Crea regola . Utilizzando le opzioni visualizzate di seguito, creare una regola per salvare il valore quadrato dell'input nel campo Output del modulo. regolaToccate Fine . Viene aggiunta la funzione personalizzata.

Tipi supportati per la dichiarazione di funzione

Istruzione Function
function area(len) {
    return len*len;
}

Questa funzione è inclusa senza jsdoc commenti.
Espressione funzione
var area;
//Some codes later
/** */
area = function(len) {
    return len*len;
};

Espressione funzione e istruzione
var b={};
/** */
b.area = function(len) {
    return len*len;
}

Dichiarazione di funzione come variabile
/** */
var x1,
    area = function(len) {
        return len*len;
    },
    x2 =5, x3 =true;

Limitazione: la funzione personalizzata seleziona solo la prima dichiarazione di funzione dall'elenco delle variabili, se insieme. È possibile utilizzare l'espressione di funzione per ogni funzione dichiarata.
Dichiarazione di funzione come oggetto
var c = {
    b : {
        /** */
        area : function(len) {
            return len*len;
        }
    }
};

Assicurarsi di utilizzare jsdoc per ogni funzione personalizzata. Sebbene jsdoc i commenti siano incoraggiati, includete un jsdoc commento vuoto per contrassegnare la funzione come funzione personalizzata. Attiva la gestione predefinita della funzione personalizzata.

Gestisci regole

Eventuali regole esistenti in un oggetto modulo vengono elencate quando si tocca l'oggetto e si tocca . Potete visualizzare il titolo e un'anteprima del riepilogo della regola. Inoltre, l'interfaccia utente consente di espandere e visualizzare il riepilogo completo delle regole, modificare l'ordine delle regole, modificare le regole ed eliminarle.
È possibile eseguire le azioni seguenti 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, toccate della regola per espanderlo.
  • Riordina : Qualsiasi nuova regola creata viene sovrapposta in fondo all'elenco delle regole. Le regole vengono eseguite dall'alto verso il basso. La regola nella parte superiore viene eseguita prima da altre regole dello stesso tipo. Ad esempio, se le regole Quando, Mostra, Abilita e Quando si trovano rispettivamente nelle posizioni Primo, Secondo, Terzo e Quarto dall'alto, la regola Quando nella parte superiore viene eseguita per prima dalla regola Quando nella quarta posizione. Le regole Mostra e Abilita verranno quindi eseguite.
    Per modificare l'ordine di una regola, toccate di ordinamento oppure trascinatela nell'ordine desiderato nell'elenco.
  • Modifica : Per modificare una regola, selezionate la casella di controllo accanto al titolo della regola. Vengono visualizzate ulteriori opzioni per modificare ed eliminare la regola. Toccate Modifica per aprire la regola selezionata nell'editor di regole in modalità visiva o editor di codice, a seconda della modalità utilizzata per creare la regola.
  • Elimina : Per eliminare una regola, selezionatela e toccate Elimina .
  • Attiva/Disattiva : Potrebbe essere necessario sospendere temporaneamente l'utilizzo di una regola. Potete selezionare una o più regole e toccare Disattiva nella barra degli strumenti Azioni per disattivarle. Se una regola è disabilitata, non viene eseguita in fase di esecuzione. Per abilitare una regola disattivata, potete selezionarla e toccare Attiva nella barra degli strumenti delle azioni. La colonna di stato della regola indica se la regola è abilitata o disabilitata.

Regole di copia e incolla

È possibile copiare e incollare una regola da un campo ad altri campi simili per risparmiare tempo.
Per copiare e incollare le regole, effettuate le seguenti operazioni:
  1. Toccate l'oggetto modulo dal quale desiderate copiare una regola e, nella barra degli strumenti del componente, toccate . 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, consultate Gestire le regole .
  2. Selezionate la casella di controllo accanto al titolo della regola. Vengono visualizzate ulteriori opzioni per gestire la regola. Tocca Copia .
  3. Selezionare un altro oggetto modulo al quale si desidera incollare la regola e toccare Incolla . Inoltre, potete modificare la regola per apportarvi delle modifiche.
    È 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 click. È possibile incollare una regola con un evento click su un pulsante ma non su una casella di controllo.
  4. Toccate Fine per salvare la regola.

Espressioni nidificate

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 una regola nidificata che visualizza un messaggio all'utente in merito all'idoneità per la custodia di un figlio quando vengono soddisfatte le condizioni richieste.
Potete anche trascinare le condizioni all'interno di una regola per modificarla. Toccate e passate il mouse sulla maniglia ( ) prima di una condizione. Una volta che il puntatore si trasforma in un simbolo a mano come mostrato di seguito, trascinare la condizione in qualsiasi punto della regola. La struttura della regola cambia.

Condizioni di espressione data

L'editor delle regole consente di utilizzare il confronto delle date per creare condizioni.
Di seguito è riportata una condizione di esempio che visualizza un oggetto di testo statico se il mutuo sulla casa è già in uso, che l'utente indica compilando il campo data.
Quando la data del mutuo dell'immobile, come compilato dall'utente, è passata, nel modulo adattivo viene visualizzata una nota sul calcolo del reddito. La regola seguente confronta la data compilata dall'utente con la data corrente e, se la data compilata dall'utente è precedente alla data corrente, nel modulo viene visualizzato il messaggio di testo (denominato Reddito).
Quando la data di compilazione è precedente alla data corrente, il modulo visualizza il messaggio di testo (Entrate) come segue:

Condizioni di confronto numeri

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 il richiedente si trova all'indirizzo corrente è inferiore a 36.
Se l'utente indica che ha soggiornato presso il suo attuale indirizzo di residenza per meno di 36 mesi, il modulo riporta una notifica che può essere richiesta una prova supplementare di residenza.

Impatto dell'editor di regole sugli script esistenti

Nelle versioni di AEM Forms precedenti al feature pack 1 di AEM 6.1 Forms, gli autori e gli sviluppatori di moduli utilizzavano per scrivere espressioni nella scheda Script della finestra di dialogo Modifica componente per aggiungere comportamenti dinamici ai moduli adattivi. La scheda Script viene ora sostituita dall'editor di regole.
Gli script o le espressioni che è necessario scrivere nella scheda Script sono disponibili nell'editor delle regole. Anche se non è possibile visualizzarli o modificarli nell'editor visivo, se si fa parte del gruppo di utenti di moduli è possibile modificare gli script nell'editor di codice.

Regole di esempio

Invoke form data model service

Considerare un servizio Web GetInterestRates che prende l'importo del prestito, la durata e il punteggio di credito del richiedente come input e restituisce un piano di prestito che include l'importo e il tasso di interesse dell'IME. È possibile creare un modello dati del modulo utilizzando il servizio Web come origine dati. È possibile aggiungere oggetti modello dati e un get servizio al modello di modulo. Il servizio viene visualizzato nella scheda Servizi del modello dati del modulo. Quindi, creare un modulo adattivo che includa i campi degli oggetti del modello dati per acquisire gli input dell'utente per l'importo del prestito, la durata e il punteggio di credito. Aggiungere un pulsante che attivi il servizio Web per recuperare i dettagli del piano. L'output viene compilato nei campi appropriati.
La regola seguente mostra come configurare l'azione del servizio Invoke per eseguire lo scenario di esempio.

Attivazione di più azioni mediante la regola Quando

In un modulo di domanda di prestito, si desidera verificare 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, è necessario impostare l'attenzione sul campo ID cliente. Il modulo di domanda di prestito include i seguenti componenti:
  • Un pulsante di scelta, Siete già clienti Geometrixx? , che fornisce le opzioni Sì e No. Il valore per Sì è 0 e No è 1 .
  • Un campo di testo, ID cliente Geometrixx, per specificare l’ID cliente.
Quando si scrive una regola Quando sul pulsante di scelta per implementare questo comportamento, la regola viene visualizzata come segue nell'editor di regole visive.
Nella regola di esempio, l'istruzione nella sezione Quando è la condizione, che quando restituisce True, esegue le azioni specificate nella sezione Then.
La regola viene visualizzata come segue nell'editor di codice.

Utilizzo dell'output di una funzione in una regola

In un modulo di ordine di acquisto è presente la tabella seguente, nella quale gli utenti compileranno 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 dell’elemento è Row1 .
  • Il titolo della cella nella colonna Quantità prodotto della riga ripetibile è Quantità. Il nome dell'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
A questo punto, si desidera aggiungere quantità specificate nella colonna Quantità prodotto per tutti i prodotti e visualizzare la somma nella cella Quantità totale. A tal fine, è possibile scrivere una regola Imposta valore di nella cella Quantità totale come illustrato di seguito.

Convalida del valore di un campo con espressione

Nel modulo di ordine di acquisto illustrato nell'esempio precedente, si desidera impedire all'utente di ordinare più quantità di qualsiasi prodotto il cui prezzo sia superiore a 10000. A tal fine, puoi scrivere una regola di convalida come mostrato di seguito.