Tutorial: creare un modello di dati modulo tutorial-create-form-data-model

04-create-form-data-model-main

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

Informazioni sull’esercitazione about-the-tutorial

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:

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 prerequisites

Prima di iniziare, assicurati di disporre dei seguenti elementi:

Passaggio 1: configurare il database MySQL come origine dati config-database

È 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 note
      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 note
      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 create-fdm

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 config-fdm

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 note
    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 Modifica Proprietà, 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 test-fdm

È 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