Editor di regole per moduli adattivi adaptive-forms-rule-editor
Panoramica overview
La funzione editor di regole in Adobe Experience Manager Forms consente agli utenti aziendali e agli sviluppatori di Forms di scrivere regole sugli oggetti modulo adattivi. Queste regole definiscono le azioni da eseguire sugli oggetti modulo in base a condizioni preimpostate, input dell’utente e 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 delle regole offre un editor visivo per tutti gli utenti. Inoltre, solo per i moduli che alimentano gli utenti, l'editor di regole fornisce un editor di codice per scrivere regole e script. Alcune delle azioni chiave che è possibile eseguire sugli oggetti modulo adattivo utilizzando le regole sono:
- Mostrare o nascondere un oggetto
- Attivare o disattivare un oggetto
- Impostare un valore per un oggetto
- Convalida il valore di un oggetto
- Esegui funzioni per calcolare il valore di un oggetto
- Richiamare un servizio del modello dati del modulo ed eseguire un’operazione
- Imposta la proprietà di un oggetto
L’editor di regole sostituisce le funzionalità di scripting di AEM 6.1 Forms e versioni precedenti. Tuttavia, gli script esistenti vengono mantenuti nel nuovo editor di regole. Per ulteriori informazioni sull'utilizzo degli script esistenti nell'editor di regole, vedi Impatto dell'editor di regole sugli script esistenti
Gli utenti aggiunti al gruppo forms-power-users possono creare nuovi script e modificare quelli esistenti. Gli utenti del gruppo utenti-moduli possono utilizzare gli script ma non creare o modificare gli script.
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 valutate effettuando 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) restituita 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 di regole. Ogni tipo di regola ti consente di definire condizioni e azioni in una regola. Il documento spiega ulteriormente ogni tipo di regola in dettaglio.
Una regola segue in genere uno dei seguenti costrutti:
Azione condizione In questo costrutto, una regola definisce innanzitutto una condizione seguita da un'azione da attivare. La costruzione è paragonabile all'istruzione if-then nei linguaggi di programmazione.
Nell’editor delle regole, il Quando tipo di regola applica il costrutto condizione-azione.
Action-Condition In questo costrutto, una regola definisce innanzitutto un'azione da attivare seguita da condizioni di 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 regole Mostra, Nascondi, Abilita, Disabilita, Imposta valore di e Convalida nell'editor delle regole impongono il costrutto della regola della condizione azione. Per impostazione predefinita, l'azione alternativa 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, vedi Tipi di regole disponibili nell’editor delle regole.
Linee guida per la scelta di un costrutto di regole guidelines-for-choosing-a-rule-construct
Sebbene sia possibile ottenere la maggior parte dei casi di utilizzo utilizzando qualsiasi costrutto di regole, di seguito sono riportate alcune linee guida per scegliere un costrutto più un altro. Per ulteriori informazioni sulle regole disponibili nell'editor delle regole, vedi Tipi di regole disponibili nell’editor delle regole.
-
Una regola tipica del pollice durante la creazione di una regola consiste nel pensarla 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 scrivi una regola sul campo B (l'oggetto su cui stai valutando una condizione), utilizza il costrutto condizione-azione o il tipo di regola When. Allo stesso modo, utilizza il costrutto della condizione azione o il tipo di regola Mostra o Nascondi sul campo A.
-
A volte, è necessario eseguire più azioni in base a una condizione. In questi 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 da un 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 sui campi B, C e D, dove 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é il tipo di regola Show o Hide su tre oggetti.
-
Per attivare un'azione basata su più condizioni, si consiglia di utilizzare il costrutto a condizione di 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.
-
Utilizza il costrutto condizione-azione o condizione azione se la regola contiene un'azione per una condizione.
-
Se una regola verifica 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 Quando sul campo in cui viene valutata la condizione.
-
La condizione nella regola When viene valutata quando un utente modifica il valore dell'oggetto in cui viene applicata la regola When. Tuttavia, se si desidera che l'azione si attivi quando il valore cambia sul lato server, come nel caso di precompilazione del valore, è consigliabile scrivere una regola When che attivi l'azione quando il campo viene inizializzato.
-
Quando si scrivono regole per oggetti a discesa, pulsanti di scelta o caselle di controllo, le opzioni o i valori di questi oggetti modulo sono precompilati nell’editor di regole.
Tipi ed eventi di operatori disponibili nell'editor delle regole available-operator-types-and-events-in-rule-editor
L'editor di regole fornisce i seguenti operatori logici ed eventi utilizzando i quali puoi creare regole.
- È uguale a
- È diverso da
- Inizia con
- Termina con
- Contiene
- È vuoto
- Non è vuoto
- Selezionato: Restituisce true quando l’utente seleziona una particolare opzione per un pulsante di scelta casella, elenco a discesa e un pulsante di scelta.
- È inizializzato (evento): Restituisce true quando viene eseguito il rendering di un oggetto modulo 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 delle 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 ogni tipo di regola in dettaglio. Per ulteriori informazioni sulla scrittura di regole nell'editor di regole, vedi Regole di scrittura.
Quando when
La Quando il tipo di regola segue azione alternata condizione-azione costrutto di regole, o a volte solo condizione-azione costruzione. In questo tipo di regola, devi prima specificare una condizione per la valutazione seguita da un'azione da attivare se la condizione è soddisfatta ( True). Quando utilizzi il tipo di regola When, puoi utilizzare più operatori AND e OR per creare espressioni nidificate.
Utilizzando il tipo di regola When, è possibile valutare una condizione di 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 quel componente le opzioni vengono recuperate automaticamente e rese disponibili al creatore di regole. 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:
Quando scrivi una regola When, puoi attivare l'azione Clear Value Of (Cancella valore dell'azione). Cancella valore dell'azione cancella il valore dell'oggetto specificato. L’opzione Cancella valore di 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 Disattiva l’oggetto specificato.
Richiamare il servizio Richiama un servizio configurato in un modello dati del modulo. Quando si sceglie l'operazione Invoke Service, viene visualizzato un campo. Toccando il campo , vengono visualizzati tutti i servizi configurati in tutti i modelli di dati modulo nell’istanza AEM. Quando si sceglie 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 la 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 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, consulta Integrazione dei dati di AEM Forms.
Imposta 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 l'espressione o la funzione matematica, il valore di una proprietà di un oggetto o il valore di output di un servizio del modello dati di modulo configurato. Quando si sceglie l’opzione del servizio Web, vengono visualizzati tutti i servizi configurati in tutti i modelli di dati modulo nell’istanza AEM. Quando si sceglie 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 modulo, consulta Integrazione dei dati di AEM Forms.
Imposta proprietà Imposta il valore di una proprietà dell'oggetto specificato.
Cancella Valore Di Cancella il valore dell'oggetto specificato.
Imposta messa a fuoco Imposta lo stato attivo sull'oggetto specificato.
Salva modulo Salva il modulo.
Invia Forms Invia il modulo.
Ripristina modulo Reimposta 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 set-value-of
La Imposta valore di il 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 da una funzione, un valore di una proprietà di un altro oggetto o l'output di un servizio del modello dati modulo. Allo stesso modo, è possibile verificare la presenza di una condizione su un componente, una stringa, una proprietà o valori derivati da una funzione o un'espressione matematica.
Tenere presente che 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 seguente struttura:
Imposta 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 o servizio Web di un modello dati);
Quando (facoltativo):
(Condizione 1 E condizione 2 E condizione 3) è TRUE;
Nell'esempio seguente il valore viene inserito in dependentid come input e imposta il valore del Relation all'output del Relation argomento getDependent servizio del modello dati del modulo.
Esempio di regola Imposta valore utilizzando il servizio del modello dati del modulo
Mostra show
Utilizzo della Mostra tipo di regola, è possibile scrivere una regola per mostrare o nascondere un oggetto modulo in base al fatto che una condizione sia soddisfatta o meno. Il tipo di regola Mostra 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
Simile al tipo di regola Mostra, puoi utilizzare la Nascondi tipo di regola 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 nel caso in cui la condizione non sia soddisfatta o restituisca 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;
Attiva enable
La Abilita Il tipo di regola consente di abilitare o disabilitare un oggetto modulo in base al fatto che una condizione sia soddisfatta o meno. Il tipo di regola Abilita attiva inoltre attiva l'azione Disabilita 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
Simile al tipo di regola Abilita, la Disattiva il tipo di regola consente di abilitare o disabilitare un oggetto modulo in base al fatto che una condizione sia soddisfatta o meno. Il tipo di regola Disattiva attiva anche l'azione Abilita nel caso in cui la condizione non sia soddisfatta o restituisca False.
Una regola Disabilita tipica è strutturata come segue:
Disable Object A;
When:
(Condition 1 OR Condition 2 OR Condition 3) is TRUE;
Else:
Enable Object A;
Convalida validate
La Convalida il tipo di regola 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 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 delle 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 creazione.
Per avviare l'interfaccia utente dell'editor di regole:
-
Apri un modulo adattivo in modalità di authoring.
-
Toccare l’oggetto modulo per il quale si desidera scrivere una regola e nella barra degli strumenti del componente toccare
In questa visualizzazione sono elencate tutte le regole esistenti sugli oggetti modulo selezionati. Per informazioni sulla gestione delle regole esistenti, consulta Gestire le regole.
-
Tocca 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.
Diamo un’occhiata dettagliata a ciascun componente dell’interfaccia utente dell’editor di regole.
A. Visualizzazione della regola del componente a-component-rule-display
Visualizza il titolo dell’oggetto modulo adattivo attraverso 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 Salario 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 visualizzazione gerarchica di tutti gli oggetti contenuti nel modulo adattivo. Visualizza il titolo e il tipo degli oggetti. Quando si scrive 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 è stata applicata 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 quali Somma di, Min di, Max di, Media di, Numero di e Convalida del modulo. È possibile utilizzare queste funzioni per calcolare i valori in pannelli e righe di tabella ripetibili e utilizzarli nelle istruzioni di azione e condizione durante la scrittura delle regole. Tuttavia, puoi creare funzioni personalizzate anche.
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, consulta Copiare e incollare le regole.
C. Attiva/disattiva oggetti e funzioni modulo c-form-objects-and-functions-toggle-br
Quando viene toccato, il pulsante di attivazione/disattivazione attiva il riquadro oggetti modulo e funzioni.
D. Editor di regole visive d-visual-rule-editor
L’editor di regole visive è l’area in modalità editor visivo dell’interfaccia utente dell’editor di regole in cui si scrivono le regole. Ti consente di selezionare un tipo di regola e di conseguenza di definire condizioni e azioni. Quando si definiscono condizioni e azioni in una regola, è possibile trascinare oggetti e funzioni modulo dal riquadro Oggetti modulo e funzioni.
Per ulteriori informazioni sull’utilizzo dell’editor di regole visive, consulta Regole di scrittura.
E. Switcher editor di codice visivo e-visual-code-editors-switcher
Gli utenti del gruppo forms-power-users possono accedere all'editor di codice. Per altri utenti, l'editor di codice non è disponibile. Se disponi dei diritti, puoi passare dalla modalità editor visivo alla modalità editor di codice dell’editor di regole e viceversa, utilizzando il commutatore posto sopra l’editor di regole. Quando avvii l’editor di regole la prima volta, questo viene aperto 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 modifichi una regola o scrivi una regola nell'editor di codice, non puoi tornare all'editor visivo per quella regola a meno che non cancelli l'editor di codice.
AEM Forms tiene traccia della modalità editor regole utilizzata per ultima per scrivere una regola. Quando avvii l'editor di regole la prossima volta, questo si apre in quella modalità. Tuttavia, puoi anche configurare una modalità predefinita per aprire l’editor di regole nella modalità specificata. Per eseguire questa operazione:
-
Vai AEM console Web all'indirizzo https://[host]:[porta]/system/console/configMgr.
-
Fai clic per modificare Configurazione del canale web per moduli adattivi e comunicazioni interattive.
-
scegli Editor visivo o Editor di codice dal Modalità predefinita per l’editor di regole a discesa
-
Fai clic su Salva.
F. Pulsanti Fine e Annulla f-done-and-cancel-buttons
La Fine viene utilizzato per salvare una regola. È possibile salvare una regola incompleta. Tuttavia, incomplete non sono valide e non vengono eseguite. Le regole salvate in un oggetto modulo vengono elencate quando si avvia l'editor di regole la prossima volta dallo stesso oggetto modulo. In questa visualizzazione puoi gestire le regole esistenti. Per ulteriori informazioni, consulta Gestire le regole.
La Annulla elimina le modifiche apportate a una regola e chiude l’editor di regole.
Regole di scrittura write-rules
Puoi scrivere regole utilizzando l’editor di regole visive o l’editor di codice. Quando avvii l’editor di regole la prima volta, questo viene aperto in modalità editor visivo. Puoi passare alla modalità editor di codice e alle regole di scrittura. Tuttavia, se scrivi o modifichi una regola nell'editor di codice, non puoi passare all'editor visivo per tale regola a meno che non 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.
Per prima cosa, vediamo 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 del prestito nel modulo di domanda di prestito di esempio richiede ai richiedenti di specificare lo stato civile, lo stipendio e, se coniugati, 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 . Per implementare lo scenario, applica le seguenti regole:
- Il campo Stipendio del coniuge viene visualizzato solo quando lo Stato civile è sposato.
- L'importo di ammissibilità al prestito è pari al 50% dello stipendio totale.
Esegui i seguenti passaggi per scrivere le regole:
-
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.
Aprire il modulo di richiesta di prestito in modalità di authoring. Tocca Stato civile componente e tocco
Quando si avvia l'editor di regole, la regola When è selezionata per impostazione predefinita. Inoltre, l'oggetto modulo (in questo caso, Stato civile) dal quale è stato avviato l'editor di regole viene specificato nell'istruzione When.
Sebbene non sia possibile modificare o modificare l’oggetto selezionato, è possibile utilizzare l’elenco a discesa della regola, come illustrato di seguito, per selezionare un altro tipo di regola. Per creare una regola su un altro oggetto, tocca Annulla per uscire dall’editor di regole e avviarla nuovamente dall’oggetto modulo desiderato.
-
Tocca Seleziona stato a discesa e seleziona è uguale a. La Immettere una stringa viene visualizzato il campo .
Nel pulsante di opzione Stato civile, Sposato e Singolo opzioni assegnate 0 e 1 rispettivamente. È possibile verificare i valori assegnati nella scheda Titolo della finestra di dialogo del pulsante di scelta Modifica , come illustrato di seguito.
-
In Immettere una stringa campo nella regola, specifica 0.
La condizione è stata definita come
When Marital Status is equal to Married. Quindi, definire l'azione da eseguire se questa condizione è True. -
Nell’istruzione Then, seleziona Mostra dal Seleziona azione a discesa.
-
Trascina la Stipendio del coniuge dalla scheda Oggetti modulo Rilascia oggetto o seleziona qui campo . In alternativa, tocca Rilascia oggetto o seleziona qui e seleziona il Stipendio del coniuge dal menu a comparsa, in cui sono elencati tutti gli oggetti modulo.
La regola viene visualizzata come segue nell'editor di regole.
Tocca Fine per salvare la regola.
-
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.
note note NOTE In alternativa, è possibile scrivere una regola Show sul campo Stipendio coniuge, invece di due regole When sul campo Stato coniugale, per implementare lo stesso comportamento. 
-
Successivamente, scrivere una regola per calcolare l'importo di idoneità del prestito, che corrisponde al 50% dello stipendio totale, e visualizzarlo nel campo Idoneità del prestito. Per ottenere questo risultato, crea Imposta valore di regole sul campo Idoneità al prestito .
In modalità di authoring, tocca il pulsante Idoneità al prestito campo e tocco
-
Seleziona Imposta valore di regola dal menu a discesa regola.
-
Tocca Seleziona opzione e seleziona Espressione matematica. Si apre un campo per scrivere un’espressione matematica.
-
Nel campo espressione:
- Seleziona o trascina la selezione dalla scheda Oggetto Forms Salario nel primo campo Rilascia oggetto o seleziona qui campo .
- Seleziona Plus dal Seleziona operatore campo .
- Seleziona o trascina la selezione dalla scheda Oggetto Forms Stipendio del coniuge campo dell'altro Rilascia oggetto o seleziona qui campo .
-
Quindi, tocca l’area evidenziata intorno al campo espressione e tocca Estendi espressione.
Nel campo espressione estesa, seleziona diviso per dal Seleziona operatore campo e Numero dal Seleziona opzione campo . Quindi, specifica 2 nel campo numero.
note note NOTE È possibile creare espressioni complesse utilizzando componenti, funzioni, espressioni matematiche e valori di proprietà dal campo Seleziona opzione . Quindi, creare una condizione, che quando restituisce True, viene eseguita dall'espressione.
-
Tocca Aggiungi condizione per aggiungere un’istruzione When.
Nell’istruzione When:
- Seleziona o trascina la selezione dalla scheda Oggetto Forms Stato civile nel primo campo Rilascia oggetto o seleziona qui campo .
- Seleziona i è uguale a dal Seleziona operatore campo .
- Seleziona Stringa nell’altro Rilascia oggetto o seleziona qui campo e specifica Sposato in Immettere una stringa campo .
La regola viene finalmente visualizzata come segue nell'editor di regole.
Tocca Fine per salvare la regola.
-
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.
Utilizzo dell’editor di codice using-code-editor
Gli utenti aggiunti al gruppo forms-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. Puoi passare dall’editor visivo all’editor di codice per visualizzare il codice generato. Tuttavia, se modifichi il codice della regola nell'editor di codice, non puoi tornare all'editor visivo. Se preferisci scrivere regole nell'editor di codice anziché nell'editor visivo, puoi scrivere nuove regole nell'editor di codice. Il commutatore degli editor di codice visivo consente di passare da una modalità all'altra.
JavaScript per l’editor di codice è 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.
Per ulteriori informazioni sulle linee guida per la scrittura di regole nell'editor di codice, vedi Espressioni dei moduli adattivi.
Durante la scrittura di codice JavaScript nell’editor di regole, i seguenti suggerimenti visivi sono utili per la struttura e la sintassi:
- Elementi di rilievo della sintassi
- Rientro automatico
- Suggerimenti e suggerimenti per gli oggetti modulo, le funzioni e le relative proprietà
- Completamento automatico dei nomi dei componenti del modulo e delle funzioni JavaScript comuni
Funzioni personalizzate nell’editor di regole custom-functions
Oltre alle funzioni predefinite come *Somma di, *che sono elencate in Uscita funzioni, è possibile scrivere funzioni personalizzate di cui si ha spesso bisogno. Assicurati che la funzione che scrivi sia accompagnata dal jsdoc sopra.
Accompagnato jsdoc è richiesto:
- Se desideri una configurazione e una descrizione personalizzate.
- Poiché esistono diversi modi per dichiarare una funzione in
JavaScript,e i commenti consentono di tenere traccia delle funzioni.
Per ulteriori informazioni, consulta usejsdoc.org.
Supportato jsdoc tag:
-
Privato
Sintassi:
@privateUna funzione privata non è inclusa come funzione personalizzata.
-
Nome
Sintassi:
@name funcName <Function Name>Alternativa
,puoi utilizzare:@function funcName <Function Name>o@funcfuncName <Function Name>.funcNameè il nome della funzione (non sono consentiti spazi).<Function Name>è il nome visualizzato della funzione. -
Membro
Sintassi:
@memberof namespaceAssocia uno spazio dei nomi alla funzione .
-
Parametro
Sintassi:
@param {type} name <Parameter Description>In alternativa, puoi utilizzare:
@argument{type} name <Parameter Description>o@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:- stringa
- numero
- booleano
Tutti gli altri tipi di parametri sono classificati in una delle categorie precedenti. Nessuno non supportato. Assicurati di selezionare uno dei tipi indicati sopra. I tipi non sono sensibili all’uso di maiuscole e minuscole. Gli spazi non sono consentiti nel parametro
name.<Parameter Descrption> -
Tipo di ritorno
Sintassi:
@return {type}In alternativa, puoi utilizzare
@returns {type}.Aggiunge informazioni sulla funzione, ad esempio la sua finalità.
{type} rappresenta il tipo restituito dalla funzione. I tipi di restituzione consentiti sono:
- stringa
- numero
- booleano
- data
- array
Tutti gli altri tipi di restituzione sono classificati in una delle situazioni precedenti. Nessuno non supportato. Assicurati di selezionare uno dei tipi indicati sopra. I tipi restituiti non fanno distinzione tra maiuscole e minuscole.
Aggiunta di una funzione personalizzata
Ad esempio, si desidera aggiungere una funzione personalizzata che calcoli l'area di un quadrato. La lunghezza laterale è l’input dell’utente alla funzione personalizzata, che viene accettata utilizzando una casella numerica del modulo. L’output calcolato viene visualizzato in un’altra casella numerica del modulo. Per aggiungere una funzione personalizzata, devi prima creare una libreria client e poi aggiungerla all'archivio CRX.
Esegui i seguenti passaggi per creare una libreria client e aggiungerla nell'archivio CRX.
-
Crea una libreria client. Per ulteriori informazioni, consulta Utilizzo delle librerie lato client.
-
In CRXDE, aggiungi una proprietà
categoriescon valore di tipo stringa comecustomfunctionalclientlibcartella.note note NOTE customfunctionè una categoria di esempio. Puoi scegliere qualsiasi nome per la categoria creata nellaclientlibcartella.
Dopo aver aggiunto la libreria client nell’archivio CRX, utilizzala nel modulo adattivo. Consente di utilizzare la funzione personalizzata come regola nel modulo. Esegui i seguenti passaggi per aggiungere la libreria client nel modulo adattivo.
-
Apri il modulo in modalità di modifica.
Per aprire un modulo in modalità di modifica, selezionalo e tocca Apri.
-
In modalità di modifica, seleziona un componente, quindi tocca
-
Nella barra laterale, in Nome libreria client , aggiungi la libreria client. (
customfunctionnell'esempio.)
-
Seleziona la casella numerica di input e tocca
-
Tocca Crea regola. Utilizzando le opzioni visualizzate di seguito, creare una regola per salvare il valore al quadrato dell'input nel campo Output del modulo.
Tipi supportati per la dichiarazione della funzione function-declaration-supported-types
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 e istruzione della funzione
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: 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;
}
}
};
jsdoc per ogni funzione personalizzata. Nonostante jsdoccommenti incoraggiati, includi un jsdoccommento per contrassegnare la funzione come funzione personalizzata. Abilita la gestione predefinita della funzione personalizzata.Gestire le regole manage-rules
Tutte le regole esistenti in un oggetto modulo vengono elencate quando si tocca l’oggetto e si tocca
È 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, tocca
-
Riordina: Qualsiasi nuova regola creata viene impilata in fondo all'elenco delle regole. Le regole vengono eseguite dall’alto verso il basso. La regola nella parte superiore viene eseguita per prima, seguita da altre regole dello stesso tipo. Ad esempio, se le regole When, Show, Enable e When si trovano 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 .
Per modificare l’ordine di una regola, tocca
-
Modifica: Per modificare una regola, seleziona la casella di controllo accanto al titolo della regola. Vengono visualizzate altre opzioni per modificare ed eliminare la regola. Tocca Modifica per aprire la regola selezionata nell'editor di regole in modalità visiva o nell'editor di codice, a seconda della modalità utilizzata per creare la regola.
-
Elimina: Per eliminare una regola, selezionala e tocca Elimina.
-
Attiva/Disattiva: Potrebbe essere necessario sospendere temporaneamente l’utilizzo di una regola. Puoi selezionare una o più regole e toccare Disabilita nella barra degli strumenti Azioni per disattivarle. Se una regola è disabilitata, non viene eseguita in fase di runtime. Per abilitare una regola disabilitata, puoi selezionarla e toccare Abilita nella barra degli strumenti delle azioni. Nella colonna dello stato della regola viene visualizzato se la regola è abilitata o disabilitata.
Copiare e incollare le regole copy-paste-rules
Puoi copiare e incollare una regola da un campo ad altri campi simili per risparmiare tempo.
Per copiare e incollare le regole, procedi come segue:
-
Toccare l’oggetto modulo da cui si desidera copiare una regola e, nella barra degli strumenti del componente, toccare
Per informazioni sulla gestione delle regole esistenti, consulta Gestire le regole.
-
Seleziona la casella di controllo accanto al titolo della regola. Vengono visualizzate opzioni aggiuntive per gestire la regola. Tocca Copia.
-
Selezionare un altro oggetto modulo al quale si desidera incollare la regola e toccare Incolla. Inoltre, puoi modificare la regola per apportare 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. -
Tocca 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 una regola nidificata che visualizza un messaggio all'utente sull'idoneità per la custodia di un figlio quando vengono soddisfatte le condizioni richieste.
Puoi anche trascinare le condizioni all’interno di una regola per modificarla. Tocca e passa il puntatore del mouse sulla maniglia (
Condizioni di espressione della data dateexpression
L’editor di regole consente di utilizzare confronti di date per creare condizioni.
Di seguito è riportato un esempio di condizione che visualizza un oggetto di testo statico se l'ipoteca sulla casa è già stata acquisita, che l'utente indica compilando il campo data.
Quando la data del mutuo della proprietà compilata dall'utente è passata, nel modulo adattivo viene visualizzata una nota relativa al 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 Entrate).
Quando la data di compilazione è precedente alla data corrente, nel modulo viene visualizzato il messaggio di testo (Entrate) come segue:
Condizioni di confronto dei numeri number-comparison-conditions
L’editor delle regole ti consente di creare condizioni che confrontano due numeri.
Di seguito è riportato un esempio di condizione che visualizza un oggetto di testo statico se il numero di mesi in cui un richiedente risiede al suo indirizzo corrente è inferiore a 36.
Se l'utente indica di aver soggiornato presso il suo indirizzo residenziale attuale per meno di 36 mesi, il modulo indica che può essere richiesta una prova supplementare della residenza.
Impatto dell'editor di regole sugli script esistenti impact-of-rule-editor-on-existing-scripts
Nelle versioni AEM Forms precedenti al feature pack 1 di Forms 6.1, gli autori e gli sviluppatori dei moduli utilizzavano per scrivere espressioni nella scheda Script della finestra di dialogo Modifica componente per aggiungere un comportamento dinamico ai moduli adattivi. La scheda Script viene ora sostituita dall’editor di regole.
Tutti gli script o le espressioni che è necessario scrivere nella scheda Script sono disponibili nell’editor di regole. Sebbene non sia possibile visualizzarli o modificarli nell'editor visivo, se fai parte del gruppo utenti di forms-power-users puoi modificare gli script nell'editor di codice.
Regole di esempio example
Richiamare il servizio del modello dati del modulo invoke
Considera 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'ammontare e il tasso di interesse dell'IME. È possibile creare un modello dati modulo utilizzando il servizio Web come origine dati. È possibile aggiungere oggetti del modello dati e un get 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 degli utenti 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 del servizio Invoke 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 domanda di prestito, si desidera acquisire 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 lo stato attivo sul campo ID cliente . Il modulo di domanda di prestito presenta le seguenti componenti:
-
Un pulsante di scelta, Sei un cliente Geometrixx esistente?, 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 scrivi una regola When 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 When è la condizione che, quando restituisce True, esegue le azioni specificate nella sezione Then.
La regola viene visualizzata come segue nell'editor di codice.
Utilizzo di un output di funzione in una regola using-a-function-output-in-a-rule
In un modulo di ordine di acquisto è disponibile la tabella seguente, in cui gli utenti compileranno i loro 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 in questa riga è Quantità totale.
A. Riga1 B. Quantità C. Quantità totale
A questo punto, è necessario aggiungere quantità specificate nella colonna Quantità prodotto per tutti i prodotti e visualizzare la somma nella cella Quantità totale. Per ottenere questo risultato, scrivi una regola Imposta valore di sulla cella Quantità totale come mostrato di seguito.
Convalida di un valore di campo utilizzando un’espressione validating-a-field-value-using-expression
Nel modulo di ordine di acquisto illustrato nell'esempio precedente, si desidera impedire all'utente di ordinare più di una quantità di qualsiasi prodotto il cui prezzo è superiore a 10000. A questo scopo, puoi scrivere una regola Convalida come mostrato di seguito.
