Set di moduli in AEM Forms form-set-in-aem-forms

Panoramica overview

Ai clienti viene spesso richiesto di inviare più moduli per richiedere un servizio o un benefit. Comporta la ricerca di tutti i moduli pertinenti; e compilarli, inviarli e tenerli traccia separatamente. Inoltre, devono compilare i dettagli comuni più volte tra i moduli. L’intero processo diventa ingombrante e soggetto a errori se comporta un numero elevato di moduli. La funzione set di moduli di AEM Forms consente di semplificare l’esperienza utente in tali scenari.

Un set di moduli è una raccolta di moduli di HTML5 raggruppati e presentati agli utenti finali come un unico set di moduli. Quando gli utenti finali iniziano a compilare un set di moduli, passano facilmente da un modulo all’altro. Alla fine, è possibile inviare tutti i moduli con un solo clic.

AEM Forms offre agli autori dei moduli un’interfaccia utente intuitiva per creare, configurare e gestire i set di moduli. In qualità di autore, è possibile ordinare i moduli in una sequenza specifica che gli utenti finali dovranno seguire. Inoltre, è possibile applicare condizioni o espressioni di idoneità su singoli moduli per controllarne la visibilità in base agli input dell’utente. Ad esempio, è possibile configurare la maschera dei dettagli del coniuge in modo che venga visualizzata solo quando lo stato del matrimonio è impostato su Sposato.

È inoltre possibile configurare campi comuni in diversi moduli per condividere binding dei dati comuni. In presenza di binding dei dati appropriati, gli utenti finali devono compilare le informazioni comuni solo una volta che i moduli successivi saranno compilati automaticamente.

I set di moduli sono supportati anche nell’app AEM Forms e consentono alla forza lavoro sul campo di impostare un modulo offline, di visitare i clienti, di inserire dati e di eseguire la sincronizzazione in un secondo momento con il server AEM Forms per inviare i dati dei moduli ai processi aziendali.

Creazione e gestione del set di moduli creating-and-managing-form-set

È possibile associare diversi XDP o modelli di modulo creati con Designer a un set di moduli. I set di moduli possono quindi essere utilizzati per eseguire il rendering selettivo degli XDP in base ai valori immessi dagli utenti nei moduli iniziali e nei relativi profili.

Utilizzo Interfaccia utente di AEM Forms per gestire tutti i moduli, i set di moduli e le relative risorse.

Creare un set di moduli create-a-form-set

Per creare un set di moduli, procedere come segue:

Gestione di un set di moduli managing-a-form-set

Una volta creato un set di moduli, è possibile eseguire le azioni seguenti su tale set di moduli:

Modificare un set di moduli edit-a-form-set

Per modificare un set di moduli, effettuare le seguenti operazioni:

Set di moduli in Process Management form-set-in-process-management

Dopo aver creato un set di moduli utilizzando l’interfaccia utente di Gestione AEM Forms, è possibile utilizzare il set di moduli in un’attività Punto iniziale o Assegna attività tramite Workbench.

Utilizzo del set di moduli in Task o Start point using-form-set-in-task-or-start-point

Espressioni di idoneità eligibility-expressions

Le espressioni di idoneità in un set di moduli vengono utilizzate per definire e controllare in modo dinamico i moduli visualizzati dall’utente. Ad esempio, per visualizzare un modulo specifico solo se l’utente appartiene a un particolare gruppo di età. Specificare e modificare un'espressione di idoneità utilizzando Forms Manager.

Un'espressione di idoneità può essere qualsiasi istruzione JavaScript valida che restituisce un valore booleano. L’ultima istruzione nello snippet di codice JavaScript viene trattata come un valore booleano che determina l’idoneità del modulo in base all’elaborazione nelle altre righe (righe precedenti) dello snippet di codice JavaScript. Se il valore dell’espressione è true, il modulo può essere visualizzato all’utente. Tali moduli sono noti come moduli idonei.

Oltre alle funzioni JavaScript standard, il set di moduli espone anche l’API fs.valueOf che fornisce l’accesso al valore di un campo di un modulo in un set di moduli. Utilizzare questa API per accedere al valore di un campo modulo in un set di moduli. La sintassi API è fs.valueOf (formUid, fieldSOM), dove:

Esempi examples

Utilizzo valido dell’API:

fs.valueOf("form1", "xfa.form.form1.subform1.field1")

Utilizzo dell'API non valido:

var formUid = "form1";
 var fieldSOM = “xfa.form.form1.subform1.field1"; fs.valueOf(formUid, fieldSOM);

XML di precompilazione per il set di moduli prefill-xml-for-form-set

Il set di moduli è una raccolta di più moduli di HTML5 con schemi comuni o diversi. Il set di moduli supporta la precompilazione dei campi modulo tramite un file XML. È possibile associare un file XML a un set di moduli in modo che, quando si apre un modulo nel set di moduli, alcuni campi del modulo vengano prepolulati.

Il file XML di precompilazione viene specificato utilizzando il parametro dataRef dell’URL del set di moduli. Il parametro dataRef specifica il percorso assoluto del file XML di dati unito al set di moduli.

Ad esempio, nel set di moduli sono presenti tre moduli (modulo1, modulo2 e modulo3) con la seguente struttura:

form1

o in un altro campo
form1field

form2

o in un altro campo
form2field

form3

o in un altro campo
form3field

Ogni modulo dispone di un campo denominato comune denominato "field" e di un campo denominato in modo univoco denominato "form field".

È possibile precompilare il set di moduli utilizzando un XML con la seguente struttura:

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <field>common field value</field>
 <form1field>value1</form1field>
 <form2field>value2</form2field>
 <form3field>value3</form3field>
</formSetRootTag>

Lo snippet XML di cui sopra mostra che l’XML di precompilazione per il set di moduli è un’unione dei frammenti XML di precompilazione dei singoli moduli. Se alcuni campi nei diversi moduli presentano una gerarchia/uno schema di dati simili l’uno all’altro, i campi vengono precompilati con gli stessi valori. In questo esempio, tutti e tre i moduli sono precompilati con lo stesso valore per il campo comune "field". Questo è un modo semplice per trasferire i dati da un modulo all’altro. È inoltre possibile eseguire il binding dei campi con lo stesso schema o riferimento dati. Se si desidera separare i dati del set di moduli in base allo schema dei moduli. Questo può essere ottenuto specificando l'attributo "data root" del modulo durante la creazione del set di moduli (il valore predefinito è "/", che viene mappato sul tag principale del set di moduli).

Nell'esempio precedente, se si specificano le radici dati: Per i tre moduli, rispettivamente "/form1", "/form2" e "/form3", è necessario utilizzare un XML di precompilazione della seguente struttura:

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <form1>
  <field>field value1</field>
  <form1field>value1</form1field>
 </form1>
 <form2>
  <field>field value2</field>
  <form2field>value2</form2field>
 </form2>
 <form3>
  <field>field value3</field>
  <form3field>value3</form3field>
 </form3>
</formSetRootTag>

In un set di moduli, l’XML ha definito uno schema XML con la seguente sintassi:

<formset>
 <fs_data>
  <xdp:xdp xmlns:xdp="https://ns.adobe.com/xdp/">
  <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
   <xfa:data>
   <rootElement>
    ... data ....
   </rootElement>
   </xfa:data>
  </xfa:datasets>
  </xdp:xdp>
 </fs_data>
 <fs_draft>
  ... private data...
 </fs_draft>
</formset>

Descrizione degli elementi XML di precompilazione prefill-xml-elements-description

Regole di sintassi per la creazione di un file XML di precompilazione:

FORMSET formset

parent elements:

null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: fs_data

L'elemento principale del set di moduli XML. È consigliabile non utilizzare questa parola come nome del rootSubform di qualsiasi modulo del set di moduli.

FS_DATA fs-data

parent elements:

formset

cardinalità: [1]

submitXML: P

prefillXML: O

children: xdp:xdp/rootElement

La sottostruttura indica i dati dei moduli nel set di moduli. L’elemento è facoltativo nel file XML di precompilazione solo se l’elemento del set di moduli non è presente

XDP:XDP xdp-xdp

parent elements: fs_data/null

cardinality: [0,1]

submitXML: O

prefillXML: O

children: xfa:datasets

Questo tag indica l'inizio del modulo XML di HTML5. Questo viene aggiunto nel file XML di invio se è presente nel file XML di precompilazione o se non è presente alcun XML di precompilazione. Questo tag può essere rimosso dal file XML di precompilazione.

XFA:SET DI DATI xfa-datasets

parent elements: xdp:xdp

cardinality: [1]

submitXML: O

prefillXML: O

children: xfa:data

XFA:DATI xfa-data

parent elements: xfa:datasets

cardinality: [1]

submitXML: O

prefillXML: O

children: rootElement

ROOTELEMENT rootelement

parent elements: xfa:datasets/fs_data/null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: controlled by the Forms in Form set

Il nome rootElement è solo un segnaposto. Il nome effettivo viene preso dai moduli utilizzati nel set di moduli. La sottostruttura che inizia con rootElement contiene i dati dei campi e dei sottomoduli all’interno di Forms nel set di moduli. Esistono diversi fattori che determinano la struttura dell'elemento radice e dei relativi elementi secondari.

In XML di precompilazione, questo tag è facoltativo, ma se manca, l'intero XML viene ignorato.

NOME DEL TAG ELEMENTO PRINCIPALE

Nel caso in cui vi sia un elemento principale nell'XML di precompilazione, il nome di tale elemento viene preso anche nell'XML di invio. Nei casi in cui non è presente un xml di precompilazione, il nome dell'elemento radice è il nome del sottomodulo principale del primo modulo del set di moduli con una proprietà dataRoot impostata su "/". Se non esiste una forma simile, il nome rootElement è fs_dummy_root, che è una parola chiave riservata.

Set di moduli nell’app AEM Forms formset-in-workspace-app

L’app AEM Forms consente ai lavoratori sul campo di sincronizzare i propri dispositivi mobili con un server AEM Forms e di lavorare sulle attività. L'applicazione funziona anche quando il dispositivo è offline, salvando i dati localmente sul dispositivo. Utilizzando le funzioni di annotazione, ad esempio le fotografie, i dipendenti sul campo possono fornire informazioni precise da integrare nei processi aziendali.

Per ulteriori informazioni sull’app AEM Forms, vedi app AEM Forms.

Limitazioni note: pattern non completamente supportati nel set di moduli known-limitations-patterns-not-fully-supported-in-form-set

I seguenti pattern di dati non sono completamente supportati nel set di moduli: