Usa modello dati modulo use-form-data-model

Versione
Collegamento articolo
AEM as a Cloud Service
Fai clic qui
AEM 6.5
Questo articolo

immagine protagonista

L’integrazione dei dati in AEM Forms consente di utilizzare diverse origini dati di back-end 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 di un modello dati modulo basato su oggetti e servizi modello dati disponibili nelle origini dati. Per ulteriori informazioni, consulta:

Un modello dati modulo è un’estensione dello schema JSON che puoi utilizzare per:

Creare frammenti e moduli adattivi create-af

Puoi creare moduli adattivi e frammenti di moduli adattivi in base a un modello di dati del modulo. Per utilizzare un modello di dati modulo durante la creazione di un modulo adattivo o di un frammento di modulo adattivo, effettua le seguenti operazioni:

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

    create-af-1-1

  2. Selezionare per espandere Seleziona modello dati modulo. Sono elencati tutti i modelli di dati dei moduli disponibili.

    Seleziona un dal modello dati.

    create-af-2-1

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

    create-af-3

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

NOTE
Per un frammento di modulo adattivo, nella scheda Oggetti modello dati vengono visualizzati solo l’oggetto modello dati selezionato al momento dell’authoring e i relativi oggetti modello dati associati.

data-model-objects-tab

Per aggiungere campi modulo, puoi trascinare gli oggetti modello dati nel modulo adattivo o nel frammento. I campi modulo aggiunti mantengono le proprietà dei metadati e l’associazione con le proprietà dell’oggetto modello dati. L’associazione assicura che i valori dei campi vengano aggiornati nelle origini dati corrispondenti all’invio del modulo e precompilati al momento del rendering del modulo.

Creare comunicazioni interattive create-ic

Puoi creare una comunicazione interattiva basata su un modello di dati del modulo che puoi utilizzare per precompilare la comunicazione interattiva con i dati provenienti da origini dati configurate. Inoltre, i blocchi predefiniti di una comunicazione interattiva, come i frammenti di testo, elenco e documento condizione, possono essere basati su un modello di dati del modulo.

Puoi scegliere un modello di 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, consulta:

Creare una comunicazione interattiva

Testo nelle comunicazioni interattive

Condizioni nelle comunicazioni interattive

Frammenti di elenco

Anteprima con dati di esempio preview-ic

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

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

  1. Nell'istanza dell'autore AEM, passa a Forms > Forms & Documents.
  2. Seleziona una comunicazione interattiva e seleziona Anteprima nella barra degli strumenti per selezionare Canale Web, Canale di stampa o Entrambi i canali per visualizzare l'anteprima della comunicazione interattiva.
  3. Nella finestra di dialogo Anteprima [canale], accertati che sia selezionato Dati di prova del modello dati modulo e seleziona Anteprima.

La comunicazione interattiva si apre 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 creazione e seleziona Anteprima.

Precompilare utilizzando il servizio del modello di dati del modulo prefill

AEM Forms fornisce il servizio di precompilazione del modello dati dei moduli preconfigurato che puoi abilitare per i moduli adattivi e le comunicazioni interattive basate sul modello dati del modulo. Il servizio di precompilazione interroga le origini dati per gli oggetti modello dati nel modulo adattivo e nella comunicazione interattiva e, di conseguenza, esegue la precompilazione dei dati durante il rendering del modulo o della comunicazione.

Per abilitare il servizio di precompilazione del modello dati del modulo per un modulo adattivo, apri le proprietà del contenitore del modulo adattivo e seleziona Servizio di precompilazione del modello dati del modulo dall'elenco 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, puoi selezionare Servizio di precompilazione del modello dati modulo nel menu a discesa Servizio di precompilazione durante la creazione 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 write-af

Quando un utente invia un modulo basato su un modello dati del modulo, è possibile configurare il modulo in modo che scriva 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 Modello dati modulo, disponibile come standard solo per i moduli adattivi basati su un modello dati modulo. Scrive i dati inviati per un oggetto modello dati nella relativa origine dati.

Per configurare l'azione di invio Modello dati modulo, apri le proprietà Contenitore modulo adattivo e seleziona Invia utilizzando Modello dati modulo dal menu a discesa Azione di invio 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.

invio dati

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

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

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

  3. Seleziona per selezionare il componente aggiunto e seleziona icona_impostazioni per aprire il browser Proprietà del componente.

  4. Nel campo Riferimento binding, selezionare foldersearch_18 e passare alla selezione della proprietà binaria aggiunta nel modello dati del modulo. Configura altre proprietà, a seconda delle necessità.

    Seleziona pulsante di controllo per salvare le proprietà. Il campo allegato è ora associato alla proprietà binaria del modello dati del modulo.

  5. Nella sezione Invio delle proprietà Contenitore modulo adattivo, abilita Invia allegati modulo. Invia l’allegato nel campo della proprietà binaria all’origine dati al momento dell’invio del modulo.

Richiama servizi in moduli adattivi tramite regole invoke-services

In un modulo adattivo basato su un modello dati modulo, puoi creare regole per richiamare i servizi configurati nel modello dati modulo. L'operazione Richiama servizi in una regola elenca tutti i servizi disponibili nel modello di 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 modello dati modulo e impostare il valore di un campo sull'output restituito dal servizio.

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

invoke-service

È inoltre possibile utilizzare l'API guidelib.dataIntegrationUtils.executeOperation per scrivere un JavaScript nell'editor di codice per l'editor di regole. Per i dettagli API, vedere API per richiamare il servizio modello dati modulo.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2