Introduzione all’editor di regole per moduli adattivi basati su componenti core

Versione
Collegamento articolo
AEM as a Cloud Service (Componenti core)
Questo articolo
AEM as a Cloud Service (Componenti di base)
Fai clic qui
AEM 6.5
Fai clic qui

In un modulo adattivo basato su componenti core, la funzione dell’editor di regole consente sia agli utenti aziendali che agli sviluppatori di scrivere regole per gli oggetti del modulo adattivo. Queste regole definiscono le azioni da attivare sugli oggetti modulo in base a condizioni preimpostate, input dell'utente e azioni dell'utente sul modulo. Questa funzionalità 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 la scrittura di regole. Offre un editor visivo che soddisfa tutti gli utenti, consentendo loro di creare e gestire regole senza necessità di conoscenze tecniche approfondite. Questo approccio visivo consente agli utenti di comprendere e implementare più facilmente la logica desiderata all’interno dei moduli.

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
  • Convalidare il valore di un oggetto
  • Eseguire funzioni per calcolare il valore di un oggetto
  • Richiamare un modello dati del modulo (FDM) ed eseguire un’operazione
  • Impostare la proprietà di un oggetto

Gli utenti aggiunti al gruppo forms-power-users possono creare script e modificare quelli esistenti. Gli utenti del gruppo forms-users possono utilizzare gli script ma non crearli o modificarli.

Per un confronto dettagliato, consulta l'articolo Differenza tra l'editor di regole di Foundation e l'editor di regole dei componenti core.

Informazioni su una regola understanding-a-rule

Una regola è una combinazione di azioni e condizioni. Nell’editor delle regole, le azioni includono attività quali nascondere, mostrare, abilitare, disabilitare o calcolare il valore di un oggetto in un modulo. Le condizioni sono espressioni booleane che vengono valutate eseguendo controlli e operazioni sullo stato, sul valore o sulla proprietà di un oggetto modulo. Le azioni vengono eseguite in base al valore ( True o False) restituito valutando una condizione.

L’editor di regole fornisce un set di tipi di regole predefiniti, ad esempio Quando, Mostra, Nascondi, Abilita, Disabilita, Imposta valore di e Convalida, per facilitare la scrittura delle regole. Ogni tipo di regola ti consente di definire condizioni e azioni in una regola. Il documento spiega ulteriormente ogni tipo di regola nei dettagli.

Una regola segue in genere uno dei seguenti costrutti:

Condizione-Azione In questo costrutto, una regola definisce innanzitutto una condizione seguita da un'azione da attivare. Il costrutto è paragonabile all’istruzione if-then nei linguaggi di programmazione.

Nell'editor di regole, il tipo di regola When applica il costrutto condizione-azione.

Action-Condition In questo costrutto, una regola definisce innanzitutto un'azione da attivare seguita da condizioni per la valutazione. Un’altra variante di questo costrutto è action-condition-alternate action, che definisce anche un’azione alternativa da attivare se la condizione restituisce False.

I tipi di regola Mostra, Nascondi, Abilita, Disabilita, Imposta valore di e Convalida nell'editor di regole applicano il costrutto regola della condizione azione. Per impostazione predefinita, l'azione alternativa per Mostra è Nascondi e per Abilita è Disabilita e viceversa. Non è possibile modificare l'azione alternativa predefinita.

NOTE
I tipi di regole disponibili, incluse le condizioni e le azioni definite nell'editor di regole, dipendono anche dal tipo di oggetto modulo in base al quale si sta creando una regola. Nell'editor delle regole vengono visualizzati solo i tipi di regole e le 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 Convalida e Imposta valore di per un oggetto pannello.

Per ulteriori informazioni sui tipi di regole disponibili nell'editor di regole, vedere Tipi di regole disponibili nell'editor di regole.

Linee guida per la scelta di un costrutto regola guidelines-for-choosing-a-rule-construct

Sebbene sia possibile ottenere la maggior parte dei casi d’uso utilizzando qualsiasi costrutto di regola, di seguito sono riportate alcune linee guida per scegliere un costrutto rispetto a un altro. Per ulteriori informazioni sulle regole disponibili nell'editor di regole, vedere Tipi di regole disponibili nell'editor di regole.

  • Una regola tipica del pollice durante la creazione di una regola è pensarla nel contesto dell'oggetto su cui si sta scrivendo una regola. Si supponga di voler nascondere o visualizzare 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 sta scrivendo una regola nel campo B (l'oggetto su cui si sta valutando una condizione), utilizzare il costrutto condizione-azione o il tipo di regola When. Allo stesso modo, utilizza il costrutto action-condition o il tipo di regola Show o Hide 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, puoi valutare una condizione una sola volta e specificare più istruzioni di azione.

    Ad esempio, per nascondere i campi B, C e D in base alla condizione che verifica il valore specificato dall'utente nel campo A, scrivere una regola con il costrutto condizione-azione o il tipo di regola When nel campo A e specificare azioni per controllare la visibilità dei campi B, C e D. In caso contrario, sono necessarie tre regole separate per i campi B, C e D, in cui ogni regola controlla la condizione e mostra o nasconde il rispettivo campo. In questo esempio, è più efficiente scrivere il tipo di regola When su un oggetto anziché il tipo di regola Show o Hide su tre oggetti.

  • Per attivare un’azione in base a più condizioni, si consiglia di utilizzare un costrutto azione-condizione. Ad esempio, per mostrare e nascondere il campo A valutando le condizioni nei campi B, C e D, utilizzare il tipo di regola Mostra o Nascondi nel campo A.

  • Utilizza il costrutto condizione-azione o condizione azione se la regola contiene un’azione per una condizione.

  • Se una regola verifica la presenza di una condizione ed esegue immediatamente un'azione quando fornisce un valore in un campo o esce da un campo, si consiglia di scrivere una regola con un costrutto condizione-azione o il tipo di regola When nel campo in cui viene valutata la condizione.

  • La condizione nella regola When viene valutata quando un utente modifica il valore dell'oggetto su cui viene applicata la regola When. Tuttavia, se desideri che l’azione si attivi quando il valore cambia sul lato server, come per il prepopolamento del valore, è consigliabile scrivere una regola When che attivi l’azione quando il campo viene inizializzato.

  • Quando si scrivono regole per gli oggetti menu a discesa, pulsanti di scelta o caselle di controllo, le opzioni o i valori di tali oggetti modulo nel modulo vengono precompilati nell’editor di regole.

Per informazioni su come utilizzare l'interfaccia utente per scrivere e gestire regole in un editor di regole, consulta l'articolo Interfaccia utente dell'editor di regole per Forms adattivo basato su Componenti core.

Consulta anche

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab