Introduzione all’editor di regole nell’authoring WYSIWYG

Questa funzione è disponibile tramite il programma per i primi utilizzatori. Per richiedere l'accesso, invia un'e-mail con il nome dell'organizzazione GitHub e il nome dell'archivio dall'indirizzo ufficiale a aem-forms-ea@adobe.com . Ad esempio, se l’URL dell’archivio è https://github.com/adobe/abc, il nome dell’organizzazione è adobe e il nome dell’archivio è abc.

È possibile aggiungere il comportamento di un modulo dinamico utilizzando l’editor di regole, che consente di creare regole. Queste regole abilitano la visibilità dei campi condizionali, automatizzano i calcoli in base a quanto immesso dall’utente e migliorano l’esperienza utente complessiva. Semplificando il processo di compilazione dei moduli, l’editor di regole favorisce sia l’accuratezza che l’efficienza.

L’editor di regole offre un’interfaccia visiva intuitiva per la creazione e la gestione delle regole. Il suo approccio semplice e intuitivo lo rende accessibile a tutti, anche a chi non dispone di competenze tecniche approfondite, consentendo loro di implementare facilmente elementi di logica all’interno dei moduli.

Informazioni sulle regole

Le regole sono istruzioni che guidano l’utente in merito alle azioni da eseguire in condizioni specifiche.

Una regola segue in genere uno dei seguenti costrutti:

Ad esempio, nel caso di condizione che verifica se un utente ha immesso o meno un determinato valore in un campo, l’azione può consistere nel mostrare o nascondere un altro campo.

Per istruzioni dettagliate, consulta Aggiungere una regola condizionale.

Come si abilita l’estensione dell’editor di regole?

Nell’editor universale, l’estensione editor di regole non è attivata per impostazione predefinita. Per abilitare l’estensione editor regole, scrivi all’indirizzo aem-forms-ea@adobe.com dal tuo ID e-mail ufficiale.

Una volta che l’estensione dell’editor di regole sarà stata abilitata per il tuo ambiente, l’icona sarà visibile nell’angolo in alto a destra dell’editor.

Seleziona il componente modulo per il quale desideri scrivere una regola e fai clic sull’icona . Viene visualizzata l’interfaccia utente dell’editor di regole.

In questo articolo, form object e form component sono utilizzati in modo intercambiabile.

Ora puoi iniziare a scrivere regole o logica di business per il campo modulo selezionato utilizzando i tipi di regole disponibili nell’editor di regole.

Interfaccia utente dell’editor di regole

Quando fai clic sull’icona , si apre l’editor dell’editor di regole:

Tutte le regole esistenti su un componente modulo vengono elencate quando si seleziona il componente. Puoi visualizzare il titolo e un’anteprima del riepilogo delle regole nell’editor di regole. Inoltre, puoi modificare l’ordine delle regole, modificarle, abilitarle, disabilitarle o eliminarle.

Tipi di regole disponibili

L’editor di regole fornisce un insieme di tipi di regole predefinite che è possibile utilizzare per scrivere regole, come illustrato nella tabella seguente:

Esaminiamo ora come scrivere regole nell’editor di regole.

Scrivere regole

Per informazioni su come scrivere regole nell’editor di regole visivo, prendiamo in considerazione un semplice esempio di modulo di calcolo delle imposte:

Nel modulo descritto in precedenza, l’utente immette lo stipendio lordo. In base a questo input, viene visualizzato il campo condizionale e viene calcolata l’imposta dovuta.

Campi modulo:

Regola condizionale:

Regole di calcolo:

Per scrivere regole, esegui i seguenti passaggi:

1. Creare un modulo

Per creare un modulo nell’editor universale:

2. Aggiungere una regola condizionale per un campo modulo

Dopo aver creato il modulo, scrivi la prima regola per visualizzare il campo Additional Deduction solo se lo stipendio lordo supera i 50.000 dollari. Per aggiungere una regola condizionale:

3. Aggiungere regole di calcolo per i campi modulo

Scrivi quindi una regola per calcolare il Taxable Income, che è la differenza tra Gross Salary e Additional Deduction (se applicabile). Per aggiungere la regola di calcolo nel campo Reddito imponibile, esegui i seguenti passaggi:

4. Visualizzare l’anteprima di un modulo

Ora, quando visualizzi l’anteprima del modulo e immetti come Stipendio lordo 60,000, viene visualizzato il campo Detrazione aggiuntiva e vengono calcolati di conseguenza il Reddito imponibile e l’Imposta dovuta.

Oltre alle funzioni predefinite come Somma, Media elencate in Output funzioni, è possibile scrivere funzioni personalizzate per implementare logiche aziendali complesse.

Funzione personalizzata nell’editor di regole

I moduli di Edge Delivery Services supportano funzioni personalizzate che consentono agli utenti di definire funzioni JavaScript per l’implementazione di regole aziendali complesse. Le funzioni personalizzate estendono le funzionalità dei moduli facilitando la manipolazione e l’elaborazione dei dati immessi per soddisfare requisiti specifici.

Creare una funzione personalizzata

Per creare funzioni personalizzate, modifica il file ../[blocks]/form/functions.js. Il processo di creazione prevede in genere i seguenti passaggi:

In questo esempio vengono illustrate due funzioni personalizzate come getFullName e days:

/**
 * Get Full Name
 * @name getFullName Concats first name and last name
 * @param {string} firstname in Stringformat
 * @param {string} lastname in Stringformat
 * @return {string}
 */
function getFullName(firstname, lastname) {
  return `${firstname} ${lastname}`.trim();
}

/**
 * Calculate the number of days between two dates.
 * @param {*} endDate
 * @param {*} startDate
 * @name days Calculates the numebr of days between two dates
 * @returns {number} returns the number of days between two dates
 */
function days(endDate, startDate) {
  const start = typeof startDate === 'string' ? new Date(startDate) : startDate;
  const end = typeof endDate === 'string' ? new Date(endDate) : endDate;

  // return zero if dates are valid
  if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
    return 0;
  }

  const diffInMs = Math.abs(end.getTime() - start.getTime());
  return Math.floor(diffInMs / (1000 * 60 * 60 * 24));
}

// eslint-disable-next-line import/prefer-default-export
export { getFullName, days };

Utilizzare una funzione personalizzata nell’editor di regole

Per utilizzare la funzione personalizzata nell’editor di regole:

Informazioni aggiuntive

Questo articolo fornisce informazioni limitate sull’editor di regole disponibile nell’editor universale. Per ulteriori informazioni sull’editor di regole e sulle funzioni personalizzate, consulta i seguenti articoli:

Consulta anche