Utilizzare il modello dati del modulo use-form-data-model
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 quanto segue:
Un modello di dati modulo è un’estensione dello schema JSON che può essere utilizzata per:
- Creazione di moduli adattivi e frammenti
- Creare comunicazioni interattive e blocchi predefiniti quali frammenti di testo, elenco e condizione
- Anteprima di comunicazioni interattive con dati di esempio
- Precompilazione di moduli adattivi e comunicazioni interattive
- Scrivere di nuovo i dati del modulo adattivo inviati nelle origini dati
- Richiamare i servizi utilizzando le regole del modulo adattivo
Creazione di moduli adattivi e frammenti create-af
Puoi creare moduli adattivi e frammenti di modulo adattivi basato su un modello 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:
-
Nella scheda Modello modulo della schermata Aggiungi proprietà, selezionare Modello dati modulo in Seleziona da elenco a discesa.
-
Tocca per espandere Seleziona modello dati modulo. Sono elencati tutti i modelli di dati modulo disponibili.
Seleziona un modello dati da.
-
(Solo frammenti di modulo adattivi) È possibile creare un frammento di modulo adattivo basato su un solo oggetto modello dati all’interno di un modello dati modulo. Espandi Definizioni dei modelli di dati del modulo a discesa. Elenca tutti gli oggetti del modello dati nel modello dati del modulo specificato. Selezionare un oggetto modello dati dall’elenco.
Una volta creato il modulo adattivo o il frammento di modulo adattivo basato su un modello dati del modulo, gli oggetti del modello dati del modulo vengono visualizzati nella Oggetti del modello dati della scheda del browser Contenuto nell’editor di moduli adattivi.
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.
Creare comunicazioni interattive create-ic
È 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 .
Scheda Generale della finestra di dialogo Crea comunicazione interattiva
Per ulteriori informazioni, consulta:
Creare una comunicazione interattiva
Testo nelle comunicazioni interattive
Condizioni delle comunicazioni interattive
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 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:
- Nell'istanza AEM autore, passa a Forms > Forms e documenti.
- Seleziona una comunicazione interattiva e tocca Anteprima nella barra degli strumenti da selezionare Canale web, Canale di stampa oppure Entrambi i canali per visualizzare in anteprima la comunicazione interattiva.
- Nell’anteprima [canale] di dialogo, Dati di prova del modello dati del modulo è selezionato e tocca Anteprima.
Si apre la comunicazione interattiva con dati di esempio precompilati.
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 prefill
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 modulo per un modulo adattivo, apri le proprietà del contenitore di modulo adattivo e seleziona Servizio di precompilazione modello dati modulo dal Servizio di precompilazione a discesa nel pannello a soffietto Base. Quindi, salva le proprietà.
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à.
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 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 Azione di invio del modello dati modulo, disponibile solo per i moduli adattivi basati su un modello dati del 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 il modello dati del modulo dal menu a discesa Invia azione sotto il pannello a soffietto Invio. Quindi, sfoglia e seleziona un oggetto modello dati dal Nome dell’oggetto modello dati da inviare a discesa. Salva le proprietà.
All’invio del modulo, i dati per l’oggetto modello dati configurato vengono scritti nella rispettiva origine 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:
-
Aggiungere un oggetto modello dati che include una proprietà binaria al modello dati del modulo.
-
Nel modulo adattivo, trascina File allegato dal browser Componenti al modulo adattivo.
-
Tocca per selezionare il componente aggiunto e tocca
-
Nel campo Riferimento binding , tocca
Tocca
-
Nella sezione Invio delle proprietà del contenitore di moduli adattivi, abilita Invia allegati 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 invoke-services
In un modulo adattivo basato su un modello di dati del modulo, è possibile creare regole per richiamare servizi configurati nel modello dati del modulo. La Richiamare i servizi in una regola sono elencati tutti i servizi disponibili nel modello dati del modulo e consentono di selezionare i campi di input e output per il servizio. È inoltre possibile utilizzare Imposta valore tipo di regola 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 l'ID dipendente come input e i valori restituiti sono compilati nei corrispondenti campi ID dipendente, Cognome, Nome e Genere del modulo.
Inoltre, puoi utilizzare la guidelib.dataIntegrationUtils.executeOperation API per scrivere un JavaScript nell'editor di codice per l'editor di regole. Per informazioni dettagliate sull’API, consulta API per richiamare il servizio del modello dati del modulo.