Usa modello dati modulo (FDM) use-form-data-model

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

integrazione dati

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

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

Creazione di Forms e frammenti adattivi create-af

È possibile creare Forms adattivo e frammenti di moduli adattivi in base a un modello di dati del modulo (FDM). Per utilizzare un modello dati modulo (FDM) 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 dati modulo (FDM) 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 del modulo (FDM). Espandi il menu a discesa Definizioni modello dati modulo. Elenca tutti gli oggetti modello dati nel modello dati modulo (FDM) 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 (FDM), gli oggetti del modello di dati del modulo vengono visualizzati nella scheda Origini dati del browser Contenuto nell'editor del modulo adattivo.

    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 (FDM). È possibile utilizzare questi dati per visualizzare in anteprima e testare Forms adattivo. È necessario generare i dati di esempio prima di visualizzare l'anteprima 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 di precompilazione del modello dati del modulo preconfigurato che è possibile abilitare per Forms adattivo basato sul modello dati del modulo (FDM). Il servizio di precompilazione interroga le origini dati per gli oggetti modello dati nel modulo adattivo 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

Scrivere i dati del modulo adattivo inviati nelle origini dati write-af

Quando un utente invia un modulo basato su un modello dati modulo (FDM), è 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 fornisci Azione di invio modello dati modulo, disponibile come standard solo per Forms adattivo basato su un modello dati modulo (FDM). 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 il componente Contenitore guida del modulo adattivo.

  2. Fare clic sull'icona delle proprietà del Contenitore Guida TV Proprietà Guida . Viene visualizzata la finestra di dialogo Contenitore modulo adattivo (Adaptive Form Container).

  3. Fare clic sulla scheda Invio.

  4. Dall'elenco a discesa Azione invio, selezionare Invia utilizzando il modello dati modulo.

    Configurazione azione

  5. Specificare il modello dati da inviare.

  6. Fai clic su Fine

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

NOTE
AEM as a Cloud Service offre diverse azioni di invio pronte all’uso per la gestione degli invii di moduli. Ulteriori informazioni su queste opzioni sono disponibili nell'articolo Azione di invio modulo adattivo.

È 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 un oggetto modello dati che include una proprietà binaria al modello dati del modulo (FDM).

  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 (FDM). Configura altre proprietà, a seconda delle necessità.

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

  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 dati modulo è possibile 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 (FDM) 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.

Richiama un modello dati modulo (FDM) utilizzando funzioni personalizzate invoke-form-data-model-using-custom-functions

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

  1. Passa alla console Web 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. Fai clic sull'icona icona più per aggiungere la configurazione.
  4. Aggiungi Schema percorso contenuto per specificare il percorso 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 Modello dati modulo pattern per specificare il percorso del modello dati modulo (FDM). Per impostazione predefinita, il valore è /content/dams/formsanddocuments-fdm/(.*), che include tutto il modello dati del modulo (FDM). È inoltre possibile specificare il percorso per un modello di dati modulo (FDM) specifico.
  6. Salva le impostazioni.

La configurazione aggiunta viene salvata nell'inserimento nella whitelist a livello di modulo adattivo del modello dati del modulo per chiamata di servizio - Configuration Factory .

NOTE
Per richiamare un modello di dati modulo (FDM) dall’editor di regole utilizzando funzioni personalizzate tramite un progetto di archetipo AEM:
  1. Crea 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