DocumentazioneAEM 6.5Guida utente

Tutorial: creare un modello di dati modulo

Last update: Mon Dec 02 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Experience Manager 6.5
  • Argomenti:
  • Modello dati modulo

Creato per:

  • Amministratore
  • Utente
  • Sviluppatore

04-create-form-data-model-main

Questo tutorial è un passaggio della serie Creare il primo modulo adattivo. Adobe consiglia di seguire la serie in sequenza cronologica per comprendere, eseguire e dimostrare il caso di utilizzo completo dell’esercitazione.

Informazioni sull’esercitazione

Il modulo di integrazione dei dati Forms dell'AEM consente di creare un modello di dati modulo da diverse origini dati back-end, ad esempio il profilo utente dell'AEM, i servizi Web RESTful, i servizi Web basati su SOAP, i servizi OData e i database relazionali. È possibile configurare oggetti e servizi del modello dati in un modello dati del modulo e associarlo a un modulo adattivo. I campi del modulo adattivo sono associati alle proprietà dell’oggetto modello dati. I servizi consentono di precompilare il modulo adattivo e riscrivere i dati del modulo inviato nell’oggetto modello dati.

Per ulteriori informazioni sull'integrazione dei dati del modulo e sul modello dati del modulo, vedere Integrazione dati di AEM Forms.

Questo tutorial illustra i passaggi necessari per preparare, creare, configurare e associare un modello di dati modulo a un modulo adattivo. Al termine di questa esercitazione, sarai in grado di:

  • Configura database MySQL come origine dati
  • Crea modello dati modulo tramite database MySQL
  • Configura modello dati modulo
  • Test modello dati modulo

Il modello dati del modulo sarà simile al seguente:

form-data-model_l

A. Origini dati configurate B. Schemi origine dati C. Servizi disponibili D. Oggetti modello dati E. Servizi configurati

Prerequisiti

Prima di iniziare, assicurati di disporre dei seguenti elementi:

  • MySQL database con dati di esempio come indicato nella sezione Prerequisiti di Crea il tuo primo modulo adattivo
  • Bundle OSGi per il driver JDBC MySQL come spiegato in Bundling del driver di database JDBC
  • Modulo adattivo come spiegato nel primo tutorial Creare un modulo adattivo

Passaggio 1: configurare il database MySQL come origine dati

È possibile configurare diversi tipi di origini dati per creare un modello dati del modulo. Per questa esercitazione, configurare il database MySQL configurato e popolato con dati di esempio. Per informazioni sulle altre origini dati supportate e su come configurarle, vedere Integrazione dei dati di AEM Forms.

Per configurare il database MySQL, eseguire le operazioni seguenti:

  1. Installa il driver JDBC per MySQL il database come bundle OSGi:

    1. Scarica MySQL JDBC Driver OSGi Bundle da http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.html.

    2. Accedere all'istanza dell'autore Forms dell'AEM come amministratore e passare ai bundle della console Web dell'AEM. URL predefinito: https://localhost:4502/system/console/bundles.

    3. Selezionare Installa/Aggiorna. Viene visualizzata la finestra di dialogo Carica/Installa bundle.

    4. Selezionare Scegli file per sfogliare e selezionare il bundle OSGi del driver JDBC MySQL. Selezionare Avvia bundle e Aggiorna pacchetti, quindi selezionare Installa o aggiorna. Assicurati che il Oracle Corporation’s driver JDBC per MySQL sia attivo. Il driver è installato.

  2. Configurare MySQL il database come origine dati:

    1. Vai a AEM console Web all'indirizzo https://localhost:4502/system/console/configMgr.

    2. Individua la configurazione Apache Sling Connection Pooled DataSource . Selezionare questa opzione per aprire la configurazione in modalità di modifica.

    3. Nella finestra di dialogo di configurazione, specifica i dettagli seguenti:

      • Nome origine dati: È possibile specificare qualsiasi nome. Specificare ad esempio WeRetailMySQL.
      • Nome proprietà servizio DataSource: specificare il nome della proprietà del servizio contenente il nome DataSource. Viene specificato durante la registrazione dell’istanza dell’origine dati come servizio OSGi. datasource.name.
      • Classe driver JDBC: specificare il nome della classe Java™ del driver JDBC. Per il database MySQL, specificare com.mysql.jdbc.Driver.
      • URI connessione JDBC: specifica il URL di connessione del database. Per MySQL il database in esecuzione su porta 3306 e lo schema weretail, il URL è: jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      NOTE
      Quando il MySQL database è protetto da un firewall, il nome host del database non è un DNS pubblico. L'indirizzo IP del database deve essere aggiunto nel file /etc/hosts del computer host AEM.
      • Nome utente: Nome utente del database. È necessario per consentire al driver JDBC di stabilire una connessione con il database.
      • Password: Password del database. È necessario per abilitare il driver JDBC per stabilire una connessione con il database.
      NOTE
      AEM Forms non supporta l'autenticazione NT per MySQL. Vai alla console Web all AEM indirizzo https://localhost:4502/system/console/configMgr e ricerca "Apache Sling Connection Pooled Datasource". Per la proprietà "JDBC connection URI", imposta il valore di "integratedSecurity" su False e utilizza il nome utente e il password creati per la connessione al MySQL database.
      • Test in prestito: attiva l'opzione Test su prestito .

      • Test on Return: consente di abilitare l'opzione Test on Return.

      • Query di convalida: Specificare una query SQL SELECT per convalidare le connessioni dal pool. La query deve restituire almeno una riga. selezionare * da customerdetails.

      • Isolamento transazione: impostare il valore su READ_COMMitted.

        Lascia altre proprietà con valori predefiniti e seleziona Salva.

        Viene creata una configurazione simile alla seguente.

        configurazione origine dati database relazionale

Passaggio 2: creare il modello dati del modulo

AEM Forms fornisce un'interfaccia utente intuitiva per creare un modello dati modulo da origini dati configurate. È possibile utilizzare più origini dati in un modello dati del modulo. Per questo caso d'uso, è possibile utilizzare l'origine dati MySQL configurata.

Per creare il modello dati del modulo, effettua le seguenti operazioni:

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

  2. Seleziona Crea > Modello dati modulo.

  3. Nella finestra di dialogo Crea modello dati modulo, specifica un nome per il modello dati del modulo. Ad esempio, dettagli-fatturazione-spedizione-cliente. Seleziona Avanti.

  4. Nella schermata Seleziona origine dati sono elencate tutte le origini dati configurate. Selezionare l'origine dati WeRetailMySQL e selezionare Crea.

    selezione origine dati

Il modello dati del modulo customer-shipping-billing-details è stato creato.

Passaggio 3: configurare il modello dati del modulo

La configurazione del modello dati del modulo prevede:

  • aggiunta di servizi e oggetti modello dati
  • configurazione dei servizi di lettura e scrittura per gli oggetti modello dati

Per configurare il modello dati del modulo, eseguire le operazioni seguenti:

  1. Nell'istanza di authoring AEM, passa a Forms > Integrazioni dati. URL predefinito: https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

  2. Il modello dati del modulo customer-shipping-billing-details creato in precedenza è elencato qui. Apri in modalità di modifica.

    L'origine dati selezionata WeRetailMySQL è configurata nel modello dati del modulo.

    default-fdm

  3. Espandere la struttura dell'origine dati WeRailMySQL. Seleziona i seguenti oggetti e servizi del modello dati dallo schema weretail > customerdetails in modo da poter formare il modello dati:

    • Oggetti modello dati:

      • id
      • nome
      • shippingAddress
      • città
      • stato
      • zipcode
    • Servizi:

      • ottenere
      • aggiorna

    Selezionare Aggiungi selezionati per aggiungere gli oggetti e i servizi del modello dati selezionati al modello dati del modulo.

    Schema WeRetail

    NOTE
    I servizi predefiniti di recupero, aggiornamento e inserimento per le origini dati JDBC vengono forniti con il modello dati del modulo pronto all’uso.
  4. Configurare i servizi di lettura e scrittura per l'oggetto modello dati.

    1. Selezionare l'oggetto modello dati customerdetails e selezionare Modifica proprietà.

    2. Seleziona get dal menu a discesa Servizio di lettura. L'argomento id, che rappresenta la chiave primaria nell'oggetto modello dati customerdetails, viene aggiunto automaticamente. Seleziona aem_6_3_edit e configura l'argomento come segue.

      valore predefinito per lettura

    3. Analogamente, selezionare update come servizio di scrittura. L'oggetto customerdetails viene aggiunto automaticamente come argomento. L’argomento viene configurato come segue.

      write-default

      Aggiungi e configura l'argomento id come segue.

      id-arg

    4. Selezionare Fine per salvare le proprietà dell'oggetto modello dati. Selezionare quindi Salva per salvare il modello dati modulo.

      I servizi get e update vengono aggiunti come servizi predefiniti per l'oggetto modello dati.

      oggetto-modello-dati

  5. Vai alla scheda Servizi e configura i servizi get e update.

    1. Selezionare il servizio get e selezionare Modifica proprietà. Viene visualizzata la finestra di dialogo delle proprietà.

    2. Nella finestra di dialogo Proprietà Modifica, specifica quanto segue:

      • Titolo: specifica il titolo del servizio. Ad esempio: Recupera indirizzo di spedizione.

      • Descrizione: specificare la descrizione contenente il funzionamento dettagliato del servizio. Ad esempio:

        Questo servizio recupera l'indirizzo di spedizione e altri dettagli del cliente dal database MySQL

      • Oggetto modello di output: selezionare uno schema contenente i dati del cliente. Ad esempio:

        schema customerdetail

      • Array restituito: disabilitare l'opzione Array restituito.

      • Argomenti: Selezionare l'argomento denominato ID.

      Seleziona Fine. Il servizio per il recupero dei dettagli del cliente dal database MySQL è configurato.

      recupero indirizzo-spedizione

    3. Seleziona il servizio update e seleziona Modifica proprietà. Viene visualizzata la finestra di dialogo delle proprietà.

    4. Specificare quanto segue nella finestra di dialogo Modifica proprietà:

      • Titolo: specifica il titolo del servizio. Ad esempio, Aggiorna Indirizzo di spedizione.

      • Descrizione: specificare la descrizione contenente il funzionamento dettagliato del servizio. Ad esempio:

        Questo servizio aggiorna l'indirizzo di spedizione e i campi correlati nel database MySQL

      • Oggetto modello di input: selezionare uno schema contenente i dati del cliente. Ad esempio:

        schema customerdetail

      • Tipo di output: selezionare BOOLEAN.

      • Argomenti: selezionare il nome argomento ID e customerdetails.

      Seleziona Fine. Il servizio update per l'aggiornamento dei dettagli del cliente nel database MySQL è configurato.

      indirizzo-spedizione-aggiornamento

L’oggetto modello dati e i servizi nel modello dati del modulo sono configurati. È ora possibile verificare il modello dati del modulo.

Passaggio 4: testare il modello di dati del modulo

È possibile eseguire il test dell'oggetto modello dati e dei servizi per verificare che il modello dati del modulo sia configurato correttamente.

Per eseguire il test, eseguire le operazioni seguenti:

  1. Vai alla scheda Modello, seleziona l'oggetto modello dati customerdetails e seleziona Oggetto modello di test.

  2. Nella finestra Modello di test/Servizio, selezionare Leggi oggetto modello dal menu a discesa Seleziona modello/Servizio.

  3. Nella sezione customerdetails, specifica un valore per l'argomento id esistente nel database MySQL configurato e seleziona Test.

    I dettagli del cliente associati all'ID specificato vengono recuperati e visualizzati nella sezione Output come mostrato di seguito.

    test-read-model

  4. Analogamente, è possibile testare l'oggetto e i servizi del modello Write.

    Nell’esempio seguente, il servizio di aggiornamento aggiorna correttamente i dettagli dell’indirizzo per l’ID 7102715 nel database.

    test-write-model

    Ora, se verifichi di nuovo la lettura del servizio modello per 7107215 ID, questo recupera e visualizza i dettagli del cliente aggiornati come mostrato di seguito.

    aggiornato

NOTE
Puoi creare e utilizzare la configurazione Elenco SharePoint utilizzando Modello dati modulo in un modulo adattivo, per salvare dati o documenti di record generati in un elenco SharePoint. Per ulteriori informazioni, vedere Collegare un modulo adattivo all'elenco di Microsoft® SharePoint.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2