Utilizzare il modello di dati del modulo

Experience Manager Forms l’integrazione dei dati consente di utilizzare diverse origini dati di back-end per creare un modello dati modulo da utilizzare come schema in vari Forms adattivi flussi di lavoro. Richiede la configurazione delle origini dati e la creazione di un modello dati modulo basato su oggetti e servizi del modello dati disponibili nelle origini dati. Per ulteriori informazioni, consulta:

• Experience Manager Forms Integrazione dei dati
• Configurare origini dati
• Crea modello dati modulo
• Utilizzare il modello dati del modulo

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

• Creazione di Forms e frammenti adattivi
• Anteprima con dati di esempio
• utilizzo del servizio Modello dati modulo
• Riscrivere i dati del modulo adattivo inviati nelle origini dati
• Richiama servizi tramite regole modulo adattivo

Creazione di Forms e frammenti adattivi

Puoi creare Forms adattivo e frammenti di moduli adattivi basato su un modello dati 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à, seleziona Modello dati modulo nel Seleziona da elenco a discesa.

   

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

   Seleziona un dal modello dati.

   

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

   

   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 in Origini dati del browser Contenuto nell’editor di moduli adattivi.

   NOTA

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

   

   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.

Anteprima con dati di esempio

L’editor modello dati modulo consente di generare e modificare dati di esempio per gli oggetti modello dati nel modello dati modulo. Puoi utilizzare questi dati per visualizzare in anteprima e testare Forms adattivo. Prima di visualizzare l'anteprima dovete generare i dati di esempio come descritto in Utilizzare il modello dati del modulo.

Per visualizzare in anteprima un modulo adattivo con dati di esempio, apri il modulo adattivo in modalità di creazione e tocca Anteprima.

Precompilare utilizzando il servizio Modello dati modulo

Experience Manager Forms fornisce il servizio predefinito Modello dati modulo che puoi abilitare per Forms adattivo in base al modello dati del modulo. Il servizio di precompilazione interroga le origini dati per gli oggetti modello dati nel modulo adattivo di conseguenza, esegue la precompilazione dei dati durante il rendering del modulo o della comunicazione.

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

Scrivere i dati del modulo adattivo inviati nelle origini dati

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, Experience Manager Forms fornire Azione di invio modello dati modulo, disponibile solo come standard per Adaptive Forms basato su un modello di dati per moduli. 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 modulo dal menu a discesa Azione di invio nel pannello a soffietto Invio. Quindi, sfoglia e seleziona un oggetto modello dati dal menu 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 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 File allegato dal browser Componenti al modulo adattivo.

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

4. Nel campo Associa riferimento, tocca e passa alla selezione della proprietà binaria aggiunta nel modello dati del modulo. Configura altre proprietà, a seconda delle necessità.

   Tocca 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 Adaptive Forms utilizzando le regole

In un modulo adattivo basato su un modello di dati del modulo è possibile: creare regole per richiamare i servizi configurati nel modello dati del modulo. Il Richiama servizi L’operazione in una regola elenca tutti i servizi disponibili nel modello dati modulo e consente 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 come input l'ID dipendente e i valori restituiti vengono inseriti nei campi ID dipendente, Cognome, Nome e Genere corrispondenti nel modulo.

Inoltre, è possibile utilizzare guidelib.dataIntegrationUtils.executeOperation API per scrivere un JavaScript nell’editor di codice per l’editor di regole.

Richiama un modello di dati modulo utilizzando funzioni personalizzate

È possibile richiamare un modello di dati modulo dall’editor di regole utilizzando funzioni personalizzate. Per richiamare il modello dati del modulo, aggiungi un modello dati del modulo al inserisco nell'elenco Consentiti di. Per aggiungere un modello dati modulo a un elenco Consentiti:

1. Vai alla console web di Experience Manager all’indirizzo https://server:host/system/console/configMgr.
2. Individua Inserimento in whitelist a livello di modulo adattivo del modello dati del modulo per chiamata di servizio - Configuration Factory.
3. Clic per aggiungere la configurazione.
4. Aggiungi Schema percorso contenuto per specificare la posizione del Forms adattivo. Per impostazione predefinita, il valore è /content/forms/af/(.*) che include tutti i Forms adattivi. Puoi anche specificare il percorso per un modulo adattivo specifico.
5. Aggiungi Pattern percorso modello dati modulo per specificare il percorso del modello dati del modulo. Per impostazione predefinita, il valore è /content/dams/formsanddocuments-fdm/(.*) che include tutto il modello dati del modulo. È inoltre possibile specificare il percorso per un modello dati modulo specifico.
6. Salva le impostazioni.

La configurazione aggiunta viene salvata in Inserimento in whitelist a livello di modulo adattivo del modello dati del modulo per chiamata di servizio - Configuration Factory opzione.