Tipi di operatori ed eventi nell’editor di regole di un modulo adattivo basato su componenti core

Ultimo aggiornamento: 25 aprile 2025
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Principiante
  • Intermedio
  • Utente
  • Sviluppatore

In AEM Forms as a Cloud, l’editor di regole include vari tipi di operatori ed eventi che ti consentono di definire ed eseguire condizioni e azioni complesse con facilità.

I tipi di operatore disponibili nell’editor di regole di un modulo adattivo forniscono un framework affidabile per la creazione di condizioni precise. Consentono di manipolare i dati, eseguire calcoli e combinare più condizioni in modo logico e coerente. Sia che si stiano confrontando valori, eseguendo operazioni aritmetiche o manipolando stringhe, questi operatori garantiscono che le regole siano flessibili e potenti.

Gli eventi nell’editor delle regole fungono da trigger per l’attivazione delle regole. Definiscono le azioni specifiche che si verificano quando vengono soddisfatte determinate condizioni. Sfruttando diversi tipi di eventi, puoi automatizzare le risposte a un’ampia gamma di scenari, ad esempio interazioni degli utenti, orari pianificati, modifiche nei dati e stati del sistema. Con la possibilità di specificare questi trigger, puoi creare regole dinamiche e reattive che soddisfano i tuoi requisiti specifici.

Comprendendo e utilizzando i tipi di operatori e gli eventi disponibili, puoi sfruttare appieno il potenziale dell’editor di regole, che consente di creare regole efficienti ed efficaci in grado di soddisfare esigenze specifiche e migliorare le funzionalità generali del sistema.

Tipi di operatori ed eventi disponibili nell’editor di regole

L’editor di regole fornisce i seguenti operatori logici ed eventi utilizzando i quali è possibile creare regole.

  • È uguale a - Controlla se l'oggetto modulo corrisponde a un valore specificato.
  • Is Not Equal To - Controlla se l'oggetto modulo non corrisponde a un valore specificato.
  • Inizia con : controlla se l'oggetto modulo inizia con una stringa specificata.
  • Termina con : controlla se l'oggetto modulo termina con una stringa specificata.
  • Contiene : controlla se l'oggetto modulo include una sottostringa specificata.
  • Non contiene : controlla se l'oggetto modulo non include una sottostringa specificata.
  • È vuoto : controlla se l'oggetto modulo è vuoto o non fornito.
  • Non è vuoto : controlla se l'oggetto modulo è presente e non vuoto.
  • Ha selezionato - Restituisce true quando un utente seleziona una casella di controllo, un elenco a discesa o un pulsante di scelta specifica.
  • È inizializzato (evento) - Restituisce true quando viene eseguito il rendering di un oggetto modulo nel browser.
  • È stato modificato (evento) - Restituisce true quando un utente modifica il valore o la selezione di un oggetto modulo.
  • È selezionato (evento) - Restituisce true quando un utente fa clic su un oggetto modulo, ad esempio un pulsante. Un utente può aggiungere più condizioni al clic sul pulsante.
  • Valido - Controlla se un oggetto modulo soddisfa i criteri di convalida.
  • Non valido - Controlla se un oggetto modulo non soddisfa i criteri di convalida.

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. Esaminiamo in dettaglio ogni tipo di regola. Per ulteriori informazioni sulla scrittura di regole nell'editor di regole, vedere Scrivi regole.

Quando

Il tipo di regola When segue il costrutto della regola condition-action-alternate action oppure, a volte, solo il costrutto condition-action. In questo tipo di regola si specifica innanzitutto una condizione per la valutazione seguita da un'azione da attivare se la condizione viene soddisfatta ( True). Durante l'utilizzo del tipo di regola When, è possibile utilizzare più operatori AND e OR per creare espressioni nidificate.

Utilizzando il tipo di regola When, è possibile valutare una condizione in un oggetto modulo ed eseguire azioni su uno o più oggetti.

In parole semplici, una regola When tipica è strutturata come segue:

When on Object A:

(Condition 1 AND Condition 2 OR Condition 3) is TRUE;

Then, do the following:

Action 2 on Object B;
AND
"Azione 3 sull’oggetto C;

Else, do the following:

Action 2 on Object C;
_

Quando si dispone di un componente con più valori, ad esempio pulsanti di scelta o elenco, durante la creazione di una regola per tale componente le opzioni vengono recuperate e rese disponibili automaticamente al creatore della regola. Non è necessario digitare nuovamente i valori delle opzioni.

Ad esempio, un elenco include quattro opzioni: Rosso, Blu, Verde e Giallo. Durante la creazione della regola, le opzioni (pulsanti di scelta) vengono recuperate e rese disponibili automaticamente al creatore della regola come segue:

Più valori visualizza le opzioni

Durante la scrittura di una regola When, puoi attivare l'azione Cancella valore di. Cancella valore dell'azione cancella il valore dell'oggetto specificato. L'opzione Clear Value (Cancella valore) nell'istruzione When consente di creare condizioni complesse con più campi. È possibile aggiungere l'istruzione Else per aggiungere ulteriori condizioni

Cancella valore di

NOTA
Quando il tipo regola supporta solo istruzioni then-else a livello singolo.
Campi multipli consentiti in Quando

Nella condizione Quando, è possibile aggiungere altri campi oltre al campo a cui è applicato il regola.

Ad esempio, utilizzando il tipo di regola When, è possibile valutare una condizione su diversi oggetti modulo ed eseguire l'azione:

Quando:

(Oggetto A Condizione 1)

E/O

(Oggetto B Condizione 2)

Quindi, effettua le seguenti operazioni:

Azione 1 sull'oggetto A

_

Più campi consentiti in When

Considerazioni durante l'utilizzo di più campi consentiti nella funzionalità condizione When

  • Assicurati che il componente core sia impostato sulla versione 3.0.14 o successiva per utilizzare questa funzione nell'editor di regole.
  • Se le regole vengono applicate a campi diversi all’interno della condizione When, la regola viene attivata anche se solo uno di questi campi viene modificato.
  • È possibile aggiungere solo più campi nella condizione When per una regola AND. Impossibile eseguire una regola OR.
NOTA
Per aggiungere più condizioni che includono un clic su pulsante, assicurati che l’evento clic su pulsante sia inserito come prima condizione. When button is clicked AND text input equals '5' ad esempio è valido, mentre When text input equals '5' AND button is clicked non è supportato.

Se nella funzione Condizione When sono presenti più campi consentiti, segui i passaggi di risoluzione dei problemi descritti di seguito.

  1. Apri il passaggio in modalità di modifica.
  2. Apri il browser Contenuti e seleziona il componente Contenitore guida del modulo adattivo.
  3. Fare clic sull'icona delle proprietà del Contenitore Guida TV Proprietà Guida . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).
  4. Fai clic su Fine e salva di nuovo la finestra di dialogo.

Nascondi Nasconde l'oggetto specificato.

Mostra mostra l'oggetto specificato.

Abilita Abilita l'oggetto specificato.

Disabilita Disabilita l'oggetto specificato.

Richiama servizio Richiama un servizio configurato in un modello dati modulo (FDM). Quando scegli l’operazione Richiama servizio, viene visualizzato un campo. Quando tocca il campo, vengono visualizzati tutti i servizi configurati in tutti i modelli di dati del modulo (FDM) nell'istanza Experience Manager. Quando si sceglie un servizio Modello dati modulo, vengono visualizzati più campi in cui è possibile mappare gli oggetti modulo con i parametri di input per il servizio specificato. Puoi mappare i parametri di output tramite l’opzione payload dell’evento per il servizio specificato. Puoi anche creare regole per la gestione delle risposte di esito positivo e negativo dell’operazione Richiama servizio utilizzando l’editor di regole.

NOTA
Per ulteriori informazioni sul servizio Invoke, fare clic qui.

Vedere l'regola di esempio per richiamare i servizi FDM (Form Data Model).

Oltre al servizio Modello dati modulo, è possibile specificare un URL WSDL diretto per richiamare un servizio Web. Tuttavia, un servizio Form Data Model presenta numerosi vantaggi e l'approccio consigliato per richiamare un servizio.

Per ulteriori informazioni sulla configurazione dei servizi in FDM (Form Data Model), vedere Experience Manager Forms Integrazione dei dati.

Imposta il valore di Calcola e imposta il valore dell'oggetto specificato. È possibile impostare il valore dell'oggetto su una stringa, il valore di un altro oggetto, il valore calcolato utilizzando un'espressione o una funzione matematica, il valore di una proprietà di un oggetto o il valore di output di un servizio Form Data Model configurato. Quando si sceglie l'opzione Servizio Web, vengono visualizzati tutti i servizi configurati in tutti i modelli di dati del modulo (FDM) nell'istanza Experience Manager. Quando si sceglie un servizio Modello dati modulo, vengono visualizzati più campi in cui è possibile mappare gli oggetti modulo con i parametri di input e output per il servizio specificato.

Per ulteriori informazioni sulla configurazione dei servizi nel modello dati modulo, vedere Experience Manager Forms Integrazione dati.

Il tipo di regola Imposta proprietà consente di impostare il valore di una proprietà dell'oggetto specificato in base a un'azione condizione. È possibile impostare la proprietà su una delle seguenti opzioni:

  • visibile (booleano)
  • label.value (Stringa)
  • label.visible (booleano)
  • description (String)
  • abilitato (booleano)
  • readOnly (booleano)
  • obbligatorio (booleano)
  • screenReaderText (stringa)
  • valido (booleano)
  • errorMessage (stringa)
  • impostazione predefinita (numero, stringa, data)
  • enumNames (Stringa[])
  • chartType (String)

Ad esempio, consente di definire regole per visualizzare la casella di testo quando si fa clic su un pulsante. Per definire una regola è possibile utilizzare una funzione personalizzata, un oggetto modulo, una proprietà oggetto o un output di servizio.

Imposta proprietà

Per definire una regola basata su una funzione personalizzata, selezionare Output funzione dall'elenco a discesa e trascinare una funzione personalizzata dalla scheda Funzioni. Se l'azione della condizione viene soddisfatta, la casella di immissione testo diventa visibile.

Per definire una regola basata su un oggetto modulo, selezionare Oggetto modulo dall'elenco a discesa e trascinare un oggetto modulo dalla scheda Oggetti modulo. Se l’azione della condizione viene soddisfatta, la casella di immissione testo diventa visibile nel modulo adattivo.

Una regola Imposta proprietà basata su una proprietà oggetto consente di rendere visibile la casella di input di testo in un modulo adattivo basato su un’altra proprietà oggetto inclusa nel modulo adattivo.

La figura seguente illustra un esempio di attivazione dinamica della casella di controllo in base al fatto che una casella di testo viene nascosta o visualizzata in un modulo adattivo:

Proprietà oggetto

Cancella valore di Cancella il valore dell'oggetto specificato.

Imposta stato attivo Imposta lo stato attivo sull'oggetto specificato.

Invia modulo invia il modulo.

Reimposta Reimposta il modulo o l'oggetto specificato.

Convalida convalida il modulo o l'oggetto specificato.

Aggiungi istanza Aggiunge un'istanza del pannello o della riga di tabella ripetibile specificata.

Rimuovi istanza Rimuove un'istanza del pannello o della riga di tabella ripetibile specificata.

Output funzione Definisce una regola basata su funzioni predefinite o personalizzate.

Passa a Passa ad altre risorse Adaptive Forms, ad esempio immagini o frammenti di documenti, oppure a un URL esterno.

Evento di invio Attiva azioni o comportamenti specifici in base a condizioni o eventi predefiniti.

Imposta valore di

Il tipo di regola Imposta valore di consente di impostare il valore di un oggetto modulo a seconda che la condizione specificata sia soddisfatta o meno. Il valore può essere impostato sul valore di un altro oggetto, una stringa letterale, un valore derivato da un'espressione matematica o una funzione, un valore di una proprietà di un altro oggetto o l'output di un servizio del modello di dati modulo. Analogamente, è possibile verificare la presenza di una condizione su un componente, una stringa, una proprietà o valori derivati da una funzione o un'espressione matematica.

Il tipo di regola Imposta valore di non è disponibile per tutti gli oggetti modulo, ad esempio pannelli e pulsanti della barra degli strumenti. Una regola Set Value Of standard ha la seguente struttura:

Impostare il valore dell'oggetto A su:

(Stringa ABC) OPPURE
(proprietà dell'oggetto X dell'oggetto C) OPPURE
(valore da una funzione) OPPURE
(valore da un'espressione matematica) OPPURE
(valore di output di un servizio di modello dati);

Quando (facoltativo):

(Condizione 1 E Condizione 2 E Condizione 3) è VERO;

L'esempio seguente seleziona il valore di Question2 come True e imposta il valore di Result come correct.

Set-value-web-service

Esempio di regola Imposta valore tramite il servizio Modello dati modulo.

Mostra

Utilizzando il tipo di regola Mostra, è possibile scrivere una regola per mostrare o nascondere un oggetto modulo in base al soddisfacimento o meno di una condizione. Il tipo di regola Show attiva anche l'azione Nascondi nel caso in cui la condizione non sia soddisfatta o restituisca False.

Una regola Show tipica è strutturata come segue:

Show Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Hide Object A;

Nascondi

Analogamente al tipo di regola Mostra, è possibile utilizzare il tipo di regola Nascondi per mostrare o nascondere un oggetto modulo in base al soddisfacimento o meno di una condizione. Il tipo di regola Nascondi attiva anche l'azione Mostra se la condizione non è soddisfatta o restituisce False.

Una tipica regola Nascondi è strutturata come segue:

Hide Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Show Object A;

Abilita

Il tipo Abilita regola consente di abilitare o disabilitare un oggetto modulo a seconda che una condizione sia soddisfatta o meno. Il tipo Abilita regola attiva anche l'azione Disabilita nel caso in cui la condizione non sia soddisfatta o si ripresenti False.

Una tipica regola di attivazione è strutturata come segue:

Enable Object A;

When:

(Condition 1 AND Condition 2 AND Condition 3) is TRUE;

Else:

Disable Object A;

Disabilitare

Analogamente al tipo di regola Abilita, il tipo Disabilita regola consente di abilitare o disabilitare un oggetto modulo a seconda che una condizione sia soddisfatta o meno. Il tipo di regola Disable attiva anche l'azione Enable nel caso in cui la condizione non sia soddisfatta o restituisca False.

Una regola di Disattivazione tipica è strutturata come segue:

Disable Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Else:

Enable Object A;

Convalida

Il tipo di regola Convalida convalida il valore in un campo utilizzando un'espressione. È ad esempio possibile scrivere un'espressione per verificare che la casella di testo per specificare un nome non contenga caratteri o numeri speciali.

Una regola di convalida tipica è strutturata come segue:

Validate Object A;

Using:

(Expression 1 AND Expression 2 AND Expression 3) is TRUE;

NOTA
Se il valore specificato non è conforme alla regola di convalida, è possibile visualizzare un messaggio di convalida per l'utente. È possibile specificare il messaggio nel campo Messaggio di convalida dello script nelle proprietà del componente nella barra laterale.

Convalida script

Spostati tra i pannelli

Il tipo di regola Naviga tra i pannelli consente di spostare lo stato attivo tra pannelli diversi in un modulo. Ad esempio, puoi creare un’espressione per spostare lo stato attivo sul pannello successivo.

Una tipica regola di navigazione tra i pannelli per spostare lo stato attivo sul pannello successivo è strutturata come segue:

Navigate among the panels

Shift focus to the next item Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Analogamente, puoi scrivere Navigare tra i pannelli regola per spostare lo stato attivo sul pannello precedente:

Navigate among the panels

Shift focus to the previous item Object A;

When:

(Condition 1 OR Condition 2 OR Condition 3) is TRUE;

Per ulteriori dettagli su come creare una regola per navigare in un pannello, fai clic qui.