DocumentazioneAEMGuida utente

[AEM Forms]{class="badge positive" title="Si applica ad AEM Forms)."}

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

Ultimo aggiornamento: 25 settembre 2026
  • Si applica a:
  • Experience Manager as a Cloud Service

Creato per:

  • Beginner
  • Intermediate
  • User
  • Developer
Versione
Collegamento articolo
AEM 6.5
Fai clic qui
AEM as a Cloud Service
Questo articolo

Integrazione dei dati

Un Modello dati modulo (FDM) in Experience Manager Forms definisce la struttura e lo scambio dei dati tra moduli e sistemi back-end. 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 dati modulo (FDM) si basa su origini dati per lo scambio di dati. È tuttavia possibile creare un modello dati modulo (FDM) con o senza un’origine dati. Questa flessibilità consente di iniziare a progettare e testare i moduli anche prima che sia disponibile la connettività back-end, per poi associare le origini dati in un secondo momento senza ricostruire il modello.

Esistono due approcci per creare un modello dati modulo (FDM), 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). Selezionando le origini dati configurate, tutti gli oggetti, le proprietà e i servizi del modello dati delle origini dati selezionate saranno disponibili per l’utilizzo nel modello dati modulo (FDM). Questo approccio è ideale quando gli endpoint di integrazione sono già stabiliti e si desidera che FDM rifletta lo schema live, le operazioni e i servizi di tali sistemi.

  • Senza origini dati: se non sono state configurate le origini dati per il modello dati modulo (FDM), è comunque possibile creare il modello dati modulo (FDM) senza origini dati. Puoi utilizzare il modello dati modulo (FDM) per creare Forms adattivo e testarlo utilizzando dati di esempio. Quando le origini dati diventano disponibili, è possibile associare il modello dati del modulo (FDM) alle origini dati. Tale associazione si propaga automaticamente al Forms adattivo associato, in modo che i moduli creati in base a dati di esempio continuino a funzionare dopo l’aggiunta di una reale connettività back-end.

NOTE
Prerequisito: Per creare e utilizzare un modello dati modulo (FDM) è necessario essere membri dei gruppi fdm-author e forms-user. Senza l’appartenenza a entrambi i gruppi, le funzionalità di authoring FDM non sono disponibili. Contatta l'amministratore Experience Manager per diventare membro dei gruppi fdm-author e forms-user.

Crea modello dati modulo (FDM) data-sources

Prima di creare un modello dati modulo, verificare di aver configurato le origini dati che si intende utilizzare nel modello dati modulo come descritto in Configurare le origini dati. Un modello di dati modulo (FDM) fornisce un livello unificato che connette Adobe Experience Manager Forms a una o più origini dati configurate, consentendo di associare i campi modulo ai dati di back-end e richiamare i servizi dell’origine 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 un titolo, una descrizione e i 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. Di conseguenza, l’elenco delle origini dati disponibili per la selezione nella pagina successiva è limitato 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. Selezionare le origini dati da utilizzare nel modello dati del modulo.

  6. Seleziona Crea, quindi nella finestra di dialogo di conferma seleziona Apri per aprire l’editor modello dati modulo.

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

    L’interfaccia utente dell’editor modello dati modulo include i seguenti componenti:

    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 eventuali modifiche nelle definizioni delle origini dati dalle origini dati configurate e le aggiorna nella scheda Origini dati dell’editor modello dati modulo. In questo modo il modello riflette lo stato corrente delle origini dati connesse.

    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 del 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 un modello dati modulo, vedere Utilizzare il modello dati modulo.

Aggiornare le origini dati update

Seguire la procedura seguente per aggiungere, sostituire o eliminare origini dati in un modello dati modulo (FDM) esistente in Adobe Experience Manager Forms. Mantenendo aggiornate le origini dati, Forms adattivo basato sul modello continua a leggere e scrivere nei sistemi corretti.

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

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

    Nella scheda Aggiorna Source è possibile selezionare un contesto di configurazione e quindi aggiungere, sostituire o eliminare origini dati:

    • Selezionare un contesto di configurazione: 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. Questo determina quali configurazioni cloud sono visibili. Se non si seleziona un nodo, le configurazioni cloud che risiedono solo nel nodo global vengono elencate quando si seleziona Aggiungi origini.

    • Aggiungi una nuova origine dati: Seleziona Aggiungi origini e seleziona le origini dati da aggiungere al Modello dati modulo (FDM). Vengono visualizzate tutte le origini dati configurate in global e nel nodo di configurazione selezionato, se presente. In questo modo le origini dati selezionate vengono aggiunte in modo che i relativi oggetti modello dati siano disponibili per l’associazione nel modello.

    • Sostituire un’origine dati esistente: 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. La sostituzione con un’origine dello stesso tipo mantiene la struttura del modello di dati esistente in modo che le associazioni dipendenti rimangano valide.
      fdm-properties

    • Elimina un’origine dati esistente: Per eliminare un’origine dati esistente, selezionare l’icona Elimina per l’origine dati. L’icona Elimina è disabilitata perché un oggetto modello dati da tale origine dati è già aggiunto e in uso nel Modello dati modulo (FDM), impedendo la rimozione delle dipendenze a cui si fa ancora riferimento.

  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 modulo (FDM), aggiornare i riferimenti di associazione, come appropriato, nel Forms adattivo che utilizza il Modello dati modulo (FDM) aggiornato. In questo modo i campi continuano a essere mappati correttamente e i dati del modulo vengono letti e scritti nelle origini previste.

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

Modello dati modulo (FDM) utilizza Configurazioni in base al contesto Sling per fornire parametri di origine dati diversi, abilitando connessioni a origini dati che variano in Experience Manager modalità di esecuzione. Questa funzionalità consente a un singolo endpoint di destinazione della distribuzione di eseguire endpoint distinti a seconda che venga eseguito in Sviluppo, Stadio o Produzione.

Quando Form Data Model (FDM) utilizza le configurazioni cloud per memorizzare i parametri, questi parametri, se archiviati e distribuiti tramite il controllo del codice sorgente (archivio GIT di Cloud-Manager), creano una singola configurazione cloud con parametri identici in tutte le modalità di esecuzione (Sviluppo, stage e Produzione). Quando il caso d’uso richiede set di dati diversi per ambienti di test e produzione, utilizzare i parametri dell’origine dati, ad esempio un URL dell’origine dati, specifici per ogni modalità di esecuzione di Experience Manager.

Per ottenere questo risultato, crea una configurazione OSGi contenente coppie parametro-valore dell’origine dati. In questo modo i valori OSGi hanno la precedenza e la stessa coppia viene ignorata dalla configurazione cloud Form Data Model (FDM) in fase di esecuzione. Poiché le configurazioni OSGi supportano queste modalità di esecuzione per impostazione predefinita, è possibile sovrascrivere un parametro di origine dati a un valore diverso in base alla modalità di esecuzione, consentendo a ogni ambiente di risolvere il proprio endpoint.

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 dell’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 di Cloud Manager (CM), la stessa configurazione cloud viene installata in tutti gli ambienti (o in tutte le 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.
      Creare i 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. In questo modo ogni modalità di esecuzione applica i propri valori di sostituzione. Per ulteriori dettagli, vedere Configurazione di OSGi per Adobe Experience Manager.

    2. Imposta il JSON di configurazione OSGi. Configura il provider di sostituzione della configurazione in base al contesto di Apache Sling in modo che i valori specifici dell’ambiente vengano applicati automaticamente durante l’implementazione. Per utilizzare il provider di override 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 sostituzione configurazione Apache Sling in base al contesto: configurazione OSGi.
      2. Fornisci una descrizione.
      3. Seleziona abilitato.
      4. In sostituzioni, fornisci i campi da modificare 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".
        Aggiungere più sostituzioni selezionando +.
      5. Seleziona Salva.
      6. Per ottenere il JSON di configurazione OSGi, segui i passaggi descritti in Generazione di configurazioni OSGi tramite AEM SDK Quickstart.
      7. Inserisci il JSON nei File di configurazione di fabbrica OSGi creati nel passaggio precedente.
      8. Modificare il valore di newURL nella configurazione di override nel valore di destinazione corretto per ogni ambiente (o modalità di esecuzione), in modo che ogni ambiente venga risolto nel proprio URL.
      9. Per modificare un valore segreto in base alla modalità di esecuzione, creare una variabile segreta utilizzando l’API Cloud Manager (CM) e farvi riferimento in seguito nella configurazione OSGi.
        Quando questo progetto di archetipo viene distribuito tramite la pipeline di Cloud Manager (CM), l’esclusione fornisce valori diversi in ambienti diversi (o modalità di esecuzione). Di conseguenza, un singolo codebase viene risolto in una configurazione specifica dell’ambiente in fase di esecuzione. In questo modo le istanze di sviluppo, staging e produzione ricevono ciascuna i valori URL e segreti corretti senza modifiche manuali al codice.
      note
      NOTE
      Adobe Managed Service utenti possono crittografare i valori segreti utilizzando il supporto di crittografia. Per informazioni dettagliate, vedere supporto della crittografia per le proprietà di configurazione e inserire il testo crittografato nel valore dopo la disponibilità delle configurazioni in base al contesto 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 del modello dati modulo (FDM) tramite l’interfaccia utente di FDM e ottenere la configurazione più recente. In questo modo la cache FDM riflette i nuovi valori di sostituzione applicati.

Passaggi successivi next-steps

È ora disponibile un Modello dati modulo (FDM) con origini dati aggiunte. Con le origini dati connesse, la fase successiva consiste nel perfezionare ed estendere il Modello dati modulo (FDM) in modo che rappresenti con precisione i dati che il modulo deve acquisire ed elaborare.

Modifica il modello dati modulo (FDM) per eseguire le attività seguenti:

  • Aggiungere e configurare oggetti e servizi del modello dati.
  • Aggiungi associazioni tra oggetti modello dati per definire la modalità di connessione dei dati correlati.
  • Modifica le proprietà degli oggetti modello dati esistenti.
  • Aggiungere oggetti e proprietà del modello dati personalizzato ai dati del modello non disponibili nelle origini dati connesse.
  • Genera dati di esempio per testare e visualizzare in anteprima il comportamento del modello dati del modulo.

Questi passaggi di configurazione consentono di adattare Form Data Model (FDM) ai requisiti aziendali specifici prima di associarlo a un modulo.

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

recommendation-more-help
experience-manager-cloud-service-help-main-toc