Utilizza il modello dati del modulo

L’integrazione dei dati di AEM Forms consente di utilizzare origini dati back-end diverse per creare un modello di dati modulo da utilizzare come schema in vari moduli adattivi e flussi di lavoro di comunicazione interattiva. Richiede la configurazione delle origini dati e la creazione del modello dati del modulo in base agli oggetti e ai servizi del modello dati disponibili nelle origini dati. Per ulteriori informazioni, consulta gli argomenti di seguito:

Un modello di dati modulo è un’estensione dello schema JSON che può essere utilizzata per:

Creazione di moduli adattivi e frammenti

È possibile creare moduli adattivi e frammenti di modulo adattivo in base a un modello di dati del modulo. Effettuare le seguenti operazioni per utilizzare un modello dati modulo durante la creazione di un modulo adattivo o di un frammento di modulo adattivo:

  1. Nella scheda Modello modulo della schermata Aggiungi proprietà, selezionare Modello dati modulo nell’elenco a discesa Seleziona da.

    create-af-1

  2. Tocca per espandere Seleziona modello dati modulo. Sono elencati tutti i modelli di dati modulo disponibili.

    Seleziona un modello dati da.

    create-af-2

  3. (Solo frammenti di modulo adattivo) È possibile creare un frammento di modulo adattivo basato su un solo oggetto modello dati all’interno di un modello dati modulo. Espandi il menu a discesa Definizioni del modello di dati del modulo . Elenca tutti gli oggetti del modello dati nel modello dati del modulo specificato. Selezionare un oggetto modello dati dall’elenco.

    create-af-3

Una volta creato il frammento di modulo adattivo o di modulo adattivo basato su un modello di dati del modulo, gli oggetti del modello di dati del modulo vengono visualizzati nella scheda Oggetti modello dati del browser Contenuto nell’editor di moduli adattivi.

NOTA

Per un frammento di modulo adattivo, nella scheda Oggetti modello dati viene visualizzato solo l’oggetto modello dati selezionato al momento della creazione e gli oggetti modello dati associati.

data-model-objects-tab

Per aggiungere campi modulo è possibile trascinare oggetti modello dati sul modulo adattivo o sul frammento. I campi modulo aggiunti mantengono le proprietà dei metadati e il binding con le proprietà dell’oggetto modello dati. Il binding assicura che i valori dei campi vengano aggiornati nelle origini dati corrispondenti all’invio del modulo e precompilati al momento del rendering del modulo.

Creazione di comunicazioni interattive

È possibile creare una comunicazione interattiva basata su un modello di dati modulo che è possibile utilizzare per precompilare la comunicazione interattiva con i dati provenienti da origini dati configurate. Inoltre, gli elementi di base di una comunicazione interattiva, come i frammenti di testo, elenco e condizione del documento, possono essere basati su un modello dati del modulo.

È possibile scegliere un modello dati modulo durante la creazione di una comunicazione interattiva o di un frammento di documento. L’immagine seguente mostra la scheda Generale della finestra di dialogo Crea comunicazione interattiva .

create-ic

Scheda Generale della finestra di dialogo Crea comunicazione interattiva

Per ulteriori informazioni, vedere:

Creare una comunicazione interattiva

Testo nelle comunicazioni interattive

Condizioni delle comunicazioni interattive

Elencare frammenti

Anteprima con dati di esempio

L’editor del modello dati modulo consente di generare e modificare dati di esempio per gli oggetti del modello dati nel modello dati del modulo. È possibile utilizzare questi dati per visualizzare in anteprima e testare le comunicazioni interattive e i moduli adattivi. È necessario generare i dati di esempio prima di visualizzare l'anteprima come descritto in Utilizzare il modello dati del modulo.

Per visualizzare in anteprima una comunicazione interattiva con dati del modello dati del modulo di esempio:

  1. Nell'istanza AEM autore, passa a Forms > Forms & Documents.
  2. Seleziona una comunicazione interattiva e tocca Anteprima nella barra degli strumenti per selezionare Canale web, Canale di stampa o Entrambi i canali per visualizzare in anteprima la comunicazione interattiva.
  3. Nella finestra di dialogo Anteprima [canale], accertati che sia selezionato Test dei dati del modulo e tocca Anteprima.

Si apre la comunicazione interattiva con dati di esempio precompilati.

anteprima web

Allo stesso modo, per visualizzare in anteprima un modulo adattivo con dati di esempio, apri il modulo adattivo in modalità di authoring e tocca Anteprima.

Precompilazione tramite il servizio del modello dati del modulo

AEM Forms fornisce il servizio di precompilazione dei modelli di dati per moduli pronto all’uso che è possibile abilitare per i moduli adattivi e le comunicazioni interattive basate sul modello di dati del modulo. Il servizio di precompilazione esegue una query sulle origini dati per gli oggetti del modello dati nel modulo adattivo e nella comunicazione interattiva e quindi precompila i dati durante il rendering del modulo o della comunicazione.

Per abilitare il servizio di precompilazione del modello di dati del modulo per un modulo adattivo, apri le proprietà del contenitore di moduli adattivi e seleziona Servizio di precompilazione del modello di dati del modulo dal menu a discesa Servizio di precompilazione nel pannello a soffietto Base. Quindi, salva le proprietà.

servizio di precompilazione

Per configurare il servizio di precompilazione del modello dati modulo in una comunicazione interattiva, è possibile selezionare Servizio di precompilazione modello dati modulo dal menu a discesa Servizio di precompilazione durante la creazione del servizio o in un secondo momento, modificando le proprietà.

edit-ic-props

Finestra di dialogo Modifica proprietà per una comunicazione interattiva

Scrivere i dati del modulo adattivo inviati nelle origini dati

Quando un utente invia un modulo basato su un modello di dati modulo, è possibile configurare il modulo in modo da scrivere i dati inviati per un oggetto modello dati nelle relative origini dati. Per ottenere questo caso d’uso, AEM Forms fornisce l’azione di invio per il modello di dati modulo, disponibile come impostazione predefinita solo per i moduli adattivi basati su un modello di dati modulo. Scrive i dati inviati per un oggetto modello dati nella relativa origine dati.

Per configurare l’azione di invio Modello dati modulo, aprire le proprietà Contenitore modulo adattivo e selezionare Invia utilizzando Modello dati modulo dal menu a discesa Invia azione nel pannello a soffietto Invio. Quindi, sfoglia e seleziona un oggetto modello dati dal menu a discesa Nome dell'oggetto modello dati da inviare. Salva le proprietà.

All’invio del modulo, i dati per l’oggetto modello dati configurato vengono scritti nella rispettiva origine dati.

presentazione dei dati

È inoltre possibile inviare allegati modulo a un’origine dati utilizzando la proprietà dell’oggetto modello dati binario. Per inviare allegati a un’origine dati JDBC, effettua le seguenti operazioni:

  1. Aggiungere un oggetto modello dati che include una proprietà binaria al modello dati del modulo.

  2. Nel modulo adattivo, trascina il componente File allegato dal browser Componenti nel modulo adattivo.

  3. Tocca per selezionare il componente aggiunto e tocca settings_icon per aprire il browser Proprietà per il componente.

  4. Nel campo Riferimento binding toccare cartella search_18 e selezionare la proprietà binaria aggiunta nel modello dati del modulo. Configura altre proprietà, a seconda delle necessità.

    Tocca check-button per salvare le proprietà. Il campo allegato è ora associato alla proprietà binaria del modello dati del modulo.

  5. Nella sezione Invio delle proprietà del contenitore di moduli adattivi, abilita Invia allegati di modulo. Invia l’allegato nel campo della proprietà binaria all’origine dati all’invio del modulo.

Richiamare i servizi nei moduli adattivi utilizzando le regole

In un modulo adattivo basato su un modello di dati del modulo, è possibile creare regole per richiamare servizi configurati nel modello di dati del modulo. L'operazione Invoke Services in una regola elenca tutti i servizi disponibili nel modello dati del modulo e consente di selezionare i campi di input e output per il servizio. È inoltre possibile utilizzare il tipo di regola Imposta valore per richiamare un servizio del modello dati del modulo e impostare il valore di un campo sull'output restituito dal servizio.

Ad esempio, la regola seguente richiama un servizio get che utilizza l'ID dipendente come input e i valori restituiti sono compilati nei corrispondenti campi ID dipendente, Cognome, Nome e Genere del modulo.

invoke-service

Inoltre, puoi utilizzare l’ guidelib.dataIntegrationUtils.executeOperation API per scrivere un JavaScript nell’editor di codice per l’editor di regole. Per informazioni dettagliate sull'API, vedere API per richiamare il servizio del modello dati del modulo.

In questa pagina