Interfaccia utente dell’editor di regole per moduli adattivi basati su componenti core
L’interfaccia utente dell’Editor regole per Forms adattivo basato su componenti core ottimizza il processo di creazione dei moduli in Adobe Experience Manager (AEM). Consente sia agli utenti aziendali che agli sviluppatori di implementare comportamenti dinamici e logiche complesse nei moduli scrivendo regole che attivano azioni in base a condizioni predefinite, input utente e interazioni. Questa funzione supporta le funzionalità moderne di JavaScript fino a ES2022 e offre un editor visivo intuitivo che semplifica il processo di scrittura delle regole.
L’editor di regole è fondamentale per semplificare l’esperienza di compilazione dei moduli, garantendo sia precisione che efficienza. Consente la convalida o il ripristino di pannelli e moduli e l'esecuzione di funzioni personalizzate per il calcolo dei valori degli oggetti modulo. Grazie al supporto delle condizioni nidificate e alla possibilità di richiamare i servizi del modello dati modulo, l’interfaccia utente dell’editor di regole è un componente fondamentale per la creazione di moduli reattivi, di facile utilizzo e adattivi.
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
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, diventa attivo il riquadro Oggetti modulo o il riquadro Funzioni.
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 di un 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, i dati incompleti non sono validi e non vengono eseguiti. Le regole salvate su un oggetto modulo vengono elencate quando si avvia l’editor di regole la prossima volta dallo stesso oggetto modulo. Puoi gestire le regole esistenti in tale vista. Per ulteriori informazioni, vedere Gestione regole.
Il pulsante Annulla elimina le modifiche apportate a una regola e chiude l'editor di regole.
Scrivi regole write-rules
È possibile scrivere regole utilizzando l'editor di regole visive
Vediamo innanzitutto come scrivere regole utilizzando un editor visivo.
+++
Comprendiamo come creare una regola in un editor visivo utilizzando il seguente modulo di esempio.
La sezione Requisiti del prestito nell'esempio di modulo di domanda di prestito richiede ai richiedenti di specificare il loro stato civile, lo stipendio e, in caso di matrimonio, 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 regole, esegui i seguenti passaggi:
-
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
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.
-
Per salvare la regola, fai clic su Fine.
note note |
---|
NOTE |
In alternativa, è possibile scrivere una regola Mostra nel campo Stipendio coniuge, anziché una regola Quando nel campo Stato civile, per implementare lo stesso comportamento. |
-
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 Regole per il valore impostato su nel campo Ammissibilità al prestito.
In modalità creazione, seleziona il campo Idoneità prestito e seleziona
-
Selezionare Imposta valore di regola dal menu a discesa delle regole.
-
Seleziona Seleziona opzione e scegli Espressione matematica. Si apre un campo in cui 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, seleziona 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. Quindi, crea una condizione, che quando restituisce True, l’espressione viene eseguita.
-
Selezionare Aggiungi condizione per aggiungere un'istruzione When.
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 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
-
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 nella 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 -
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 di 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
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. -
Per salvare la regola, fai clic su Fine.
Passaggio successivo
Per comprendere i vari tipi di operatori e gli eventi nell'editor di regole di un modulo adattivo, consulta l'articolo Tipi di operatori e eventi disponibili nell'editor di regole di un modulo adattivo.
Consulta anche
- Introduzione all’editor di regole per moduli adattivi basati su componenti core
- Tipi di operatori ed eventi nell’editor di regole di un modulo adattivo basato su componenti core
- Interfaccia utente dell’editor di regole per moduli adattivi basati su componenti core
- Diversi casi d’uso dell’editor di regole per un modulo adattivo basato su componenti core
- Differenza nelle varie edizioni dell’editor di regole
- Utilizzo di funzioni asincrone in un modulo adattivo
- Miglioramenti a Avvia servizio nell’editor di regole visive per i moduli basati su componenti core
- Introduzione alle funzioni personalizzate per moduli adattivi basati su componenti core
- Creare una funzione personalizzata per un modulo adattivo basato su componenti core
- Oggetto ambito nelle funzioni personalizzate
- Esempi di sviluppo e utilizzo di una funzione personalizzata