Utilizzare il modello di dati del modulo use-form-data-model

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

integrazione dei dati

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:

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

Creazione di Forms e frammenti adattivi create-af

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.

    create-af-1-1

  2. Seleziona 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 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.

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

    note note
    NOTE
    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.

    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.

Anteprima con dati di esempio preview-ic

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 seleziona Anteprima.

Precompilare utilizzando il servizio Modello dati modulo prefill

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à.

preriempimento-servizio

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, 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:

  1. Apri il browser Contenuto e seleziona la Contenitore guida componente del modulo adattivo.

  2. Fai clic sulle proprietà Contenitore guida Proprietà guida icona. Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

  3. Fai clic su Invio scheda.

  4. Dalla sezione Azione di invio elenco a discesa, seleziona Invia utilizzando il modello dati modulo.

    Configurazione azione

  5. Specifica la Modello dati da inviare.

  6. Clic Fine

All’invio del modulo, i dati per l’oggetto modello dati configurato vengono scritti nella rispettiva origine dati. È inoltre possibile inviare un allegato del modulo all'origine dati utilizzando un modello dati modulo e un documento di record (DoR). Per informazioni sul modello dati del modulo, consulta AEM Forms Integrazione dei dati.

NOTE
AEM as a Cloud Service offre diverse azioni di invio pronte all’uso per la gestione delle richieste di moduli. Per ulteriori informazioni su queste opzioni, consulta Azione di invio modulo adattivo articolo.

È 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. Seleziona per selezionare il componente aggiunto e selezionare icona_impostazioni per aprire il browser Proprietà del componente.

  4. Nel campo Associa riferimento, seleziona foldersearch_18 e passa 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 Adaptive Forms utilizzando le regole invoke-services

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.

invoke-service

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 invoke-form-data-model-using-custom-functions

È 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 icona più 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.

NOTE
Per richiamare un modello di dati modulo dall’editor di regole utilizzando funzioni personalizzate tramite un progetto di archetipo AEM:
  1. Creare un file di configurazione.
  2. Imposta le proprietà di getContentPathPattern e getFormDataModelPathPattern.
  3. Distribuisci il progetto.

Articoli correlati

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab