Crea modello dati modulo (FDM) create-form-data-model

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

Integrazione dei dati

L'integrazione dei dati di Experience Manager Forms offre un'interfaccia utente intuitiva per la creazione e l'utilizzo dei modelli di dati dei moduli. Un modello di dati modulo (FDM) si basa su origini dati per lo scambio di dati; tuttavia, è possibile creare un modello di dati modulo (FDM) con o senza un'origine dati. Esistono due approcci per creare un modello dati da a seconda che siano state configurate o meno le origini dati:

  • Utilizzo di origini dati preconfigurate: se le origini dati sono state configurate come descritto in Configurazione di origini dati, è possibile selezionarle durante la creazione di un modello dati modulo (FDM). Raccoglie tutti gli oggetti, le proprietà e i servizi del modello dati dalle origini dati selezionate disponibili per l’utilizzo nel modello dati del modulo (FDM).

  • Senza origini dati: se non sono state configurate origini dati per il modello dati del modulo, è comunque possibile crearlo senza origini dati. È possibile utilizzare il modello di dati del modulo (FDM) per creare Forms adattivo e testarli utilizzando dati di esempio. Quando le origini dati sono disponibili, è possibile associare il modello dati del modulo (FDM) alle origini dati, che si riflette automaticamente nel Forms adattivo associato.

NOTE
Per poter creare e utilizzare il modello dati modulo (FDM) è necessario essere membri sia del gruppo fdm-author che del gruppo forms-user. Contatta l'amministratore Experience Manager per diventare membro dei gruppi.

Crea modello dati modulo (FDM) data-sources

Verificare di aver configurato le origini dati che si intende utilizzare nel modello dati del modulo come descritto in Configurare le origini dati. Per creare un modello dati modulo (FDM) basato su origini dati configurate, effettuare le seguenti operazioni:

  1. Nell'istanza di authoring Experience Manager, passa a Forms > Integrazioni dati.

  2. Selezionare Crea > Modello dati modulo.

  3. Nella finestra di dialogo Crea modello dati modulo:

    • Specificare un nome per il modello dati modulo (FDM).
    • (Facoltativo) Specificare titolo, descrizione e tag per il modello dati del modulo (FDM).
    • (Facoltativo e applicabile solo se le origini dati sono configurate) Selezionare l'icona di spunta accanto al campo Configurazione Source dati e selezionare il nodo di configurazione in cui risiedono i servizi cloud per le origini dati che si desidera utilizzare. Limita l’elenco delle origini dati disponibili per la selezione nella pagina successiva a quelle disponibili nel nodo di configurazione selezionato. Tuttavia, tutte le origini dati del profilo utente Experience Manager sono elencate per impostazione predefinita. Se non si seleziona un nodo di configurazione, vengono elencate le origini dati di tutti i nodi di configurazione.
  4. Seleziona Avanti.

  5. (Applicabile solo se le origini dati sono configurate) Nella schermata Seleziona origine dati sono elencate le origini dati disponibili, se presenti. Selezionare le origini dati da utilizzare nel modello dati del modulo.

  6. Seleziona Crea e nella finestra di dialogo di conferma seleziona Apri per aprire l'editor modello dati modulo.

    Esaminiamo i diversi componenti dell’interfaccia utente dell’editor del modello dati modulo.

    Un modello dati modulo con tre origini dati: un servizio RESTful, un profilo utente Experience Manager e un RDBMS

    A. Origini dati Elenca le origini dati in un modello dati modulo. Espandere un'origine dati per visualizzare i relativi servizi e oggetti modello dati.

    B. Aggiorna definizioni Source dati Recupera le modifiche apportate alle definizioni delle origini dati dalle origini dati configurate e le aggiorna nella scheda Origini dati dell'editor modello dati modulo.

    C. Modello Area contenuto in cui vengono visualizzati gli oggetti modello dati aggiunti.

    D. Servizi Area contenuto in cui vengono visualizzati operazioni o servizi dell'origine dati aggiunti.

    E. Barra degli strumenti Strumenti per l'utilizzo del modello dati modulo (FDM). La barra degli strumenti mostra più opzioni a seconda dell’oggetto selezionato nel modello dati del modulo (FDM).

    F. Aggiungi selezionati Aggiunge gli oggetti e i servizi del modello dati selezionati al modello dati del modulo.

Per ulteriori informazioni sull'editor del modello dati modulo e su come utilizzarlo per modificare e configurare il modello dati modulo, vedere Utilizzare il modello dati modulo.

Aggiornare le origini dati update

Per aggiungere o aggiornare origini dati a un modello dati modulo (FDM) esistente, eseguire le operazioni seguenti.

  1. Vai a Forms > Integrazioni dati, seleziona il modello dati del modulo (FDM) in cui desideri aggiungere o aggiornare le origini dati e seleziona Proprietà.

  2. Nelle proprietà del modello dati modulo, vai alla scheda Aggiorna Source.

    Nella scheda Aggiorna Source:

    • Selezionare l'icona Sfoglia nel campo Configurazione in base al contesto e selezionare un nodo di configurazione in cui risiede la configurazione cloud per l'origine dati che si desidera aggiungere. Se non si seleziona un nodo, le configurazioni cloud che risiedono solo nel nodo global vengono elencate quando si seleziona Aggiungi origini.

    • Per aggiungere una nuova origine dati, selezionare Aggiungi origini e selezionare le origini dati da aggiungere al modello dati del modulo (FDM). Vengono visualizzate tutte le origini dati configurate in global e l'eventuale nodo di configurazione selezionato.

    • Per sostituire un'origine dati esistente con un'altra origine dati dello stesso tipo, selezionare l'icona Modifica per l'origine dati e selezionarla dall'elenco delle origini dati disponibili.

    • Per eliminare un'origine dati esistente, selezionare l'icona Elimina per l'origine dati. L’icona Elimina è disabilitata se nell’origine dati viene aggiunto un oggetto modello dati nel modello dati del modulo (FDM).

      fdm-properties

  3. Seleziona Salva e chiudi per salvare gli aggiornamenti.

NOTE
Dopo aver aggiunto nuove origini dati o aggiornato le origini dati esistenti in un modello dati del modulo (FDM), assicurarsi di aggiornare i riferimenti di associazione, come appropriato, in Forms adattivo che utilizza il modello dati del modulo (FDM) aggiornato.

Configurazioni in base al contesto per modalità di esecuzione specifiche runmode-specific-context-aware-config

Form Data Model (FDM) utilizza configurazioni in base al contesto Sling per supportare diversi parametri dell'origine dati per la connessione con origini dati per diverse modalità di esecuzione di Experience Manager.

Quando Form Data Model (FDM) utilizza le configurazioni cloud per memorizzare i parametri, che quando vengono archiviati e distribuiti tramite il controllo del codice sorgente (archivio GIT di Cloud-Manager) crea la configurazione cloud con gli stessi parametri per tutte le modalità di esecuzione (Sviluppo, Stage e Produzione). Tuttavia, per i casi di utilizzo in cui è necessario disporre di set di dati diversi per ambienti di test e produzione, vengono utilizzati i parametri dell'origine dati (ad esempio, URL dell'origine dati) per diverse modalità di esecuzione di Experience Manager.

A questo scopo, devi creare una configurazione OSGi che contenga coppie parametri-valore dell’origine dati. Questa operazione sostituisce la stessa coppia dalla configurazione cloud di Form Data Model (FDM) in fase di esecuzione. Poiché le configurazioni OSGi supportano queste modalità di esecuzione per impostazione predefinita, puoi sostituire un parametro dell’origine dati con valori diversi in base alla modalità di esecuzione.

Per abilitare le configurazioni cloud specifiche della distribuzione in Form Data Model (FDM):

  1. Crea la configurazione cloud nell’istanza di sviluppo locale. Per i passaggi dettagliati, vedi Come configurare le origini dati.

  2. Memorizza la configurazione cloud nel file system.

    1. Crea pacchetto con filtro /conf/{foldername}/settings/cloudconfigs/fdm. Utilizzare lo stesso {foldername} come nel passaggio 1. E sostituisci fdm con azurestorage per la configurazione di archiviazione Azure.
    2. Creare e scaricare il pacchetto. Per ulteriori dettagli, vedere azioni pacchetto.
  3. Integrare la configurazione cloud nel progetto Archetipo Experience Manager.

    1. Decomprimi il pacchetto scaricato.
    2. Copia la cartella jcr_root e inseriscila nella tua cartella ui.content > src > main > content.
    3. Aggiorna ui.content > src > main > content > META-INF > vault > filter.xml per contenere il filtro /conf/{foldername}/settings/cloudconfigs/fdm. Per informazioni dettagliate, vedere il modulo ui.content di Archetipo progetto AEM. Quando questo progetto di archetipo viene distribuito tramite la pipeline CM, la stessa configurazione cloud viene installata in tutti gli ambienti (o modalità di esecuzione). Per modificare il valore dei campi (come URL) delle configurazioni cloud basate sull’ambiente, utilizza la configurazione OSGi descritta nel passaggio seguente.
  4. Crea una configurazione in base al contesto di Apache Sling. Per creare la configurazione OSGi:

    1. Configura i file di configurazione OSGi nel progetto dell'archetipo Experience Manager.
      Crea file di configurazione di fabbrica OSGi con PID org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider. Creare un file con lo stesso nome in ogni cartella della modalità di esecuzione in cui è necessario modificare i valori per ogni modalità di esecuzione. Per ulteriori dettagli, vedere Configurazione di OSGi per Adobe Experience Manager.

    2. Imposta il codice JSON per la configurazione OSGI. Per Utilizzare Il Provider Di Sostituzione Della Configurazione In Base Al Contesto Di Apache Sling:

      1. Nell'istanza di sviluppo locale /system/console/configMgr, selezionare la configurazione OSGi di fabbrica con il nome Provider override configurazione Apache Sling in base al contesto: configurazione OSGi.
      2. Fornisci una descrizione.
      3. Seleziona abilitato.
      4. In sostituzioni, fornisci i campi che devono essere modificati in base all’ambiente nella sintassi di sostituzione Sling. Per ulteriori dettagli, vedere Configurazione Apache Sling in base al contesto - Ignora. Ad esempio, cloudconfigs/fdm/{configName}/url="newURL".
        È possibile aggiungere più sostituzioni selezionando +.
      5. Seleziona Salva.
      6. Per ottenere il codice JSON per la configurazione OSGi, segui i passaggi descritti in Generazione di configurazioni OSGi tramite Quickstart dell'SDK per AEM.
      7. Inserisci JSON nei file di configurazione di fabbrica OSGi creati nel passaggio precedente.
      8. Modificare il valore di newURL in base all'ambiente (o alla modalità di esecuzione).
      9. Per modificare il valore segreto in base alla modalità di esecuzione, è possibile creare la variabile segreta utilizzando l'API di Cloud Manager e fare riferimento a una versione successiva nella configurazione OSGi.
        Quando questo progetto di archetipo viene distribuito tramite pipeline CM, l’override fornirà valori diversi in ambienti diversi (o in modalità di esecuzione).
      note note
      NOTE
      Adobe Managed Service utenti possono crittografare i valori segreti utilizzando il supporto di crittografia (per informazioni dettagliate, vedere supporto di crittografia per le proprietà di configurazione e inserire testo crittografato nel valore dopo che le configurazioni in base al contesto sono disponibili nel service pack 6.5.13.0.
  5. Aggiornare le definizioni dell'origine dati utilizzando l'opzione per aggiornare le definizioni dell'origine dati nell'Editor modello dati modulo per aggiornare la cache FDM tramite l'interfaccia utente di FDM e ottenere la configurazione più recente.

Passaggi successivi next-steps

Ora disponi di un modello dati modulo (FDM) con origini dati aggiunte. È quindi possibile modificare il modello dati modulo (FDM) per aggiungere e configurare oggetti e servizi del modello dati, aggiungere associazioni tra oggetti del modello dati, modificare proprietà, aggiungere oggetti e proprietà del modello dati personalizzato, generare dati di esempio e così via.

Per ulteriori informazioni, vedere Utilizzare il modello dati del modulo.

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