Tutorial: Create form data model

04-create-form-data-model-main

Questa esercitazione è un passaggio della serie Crea il primo modulo adattivo. Si consiglia di seguire le serie in sequenza cronologica per comprendere, eseguire e dimostrare l'uso completo dell'esercitazione.

Informazioni sull'esercitazione

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

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

Questa esercitazione illustra i passaggi necessari per preparare, creare, configurare e associare un modello dati del modulo a un modulo adattivo. Al termine di questa esercitazione, potrete:

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 del modello dati E. Servizi configurati

Prerequisiti

Prima di iniziare, accertatevi di disporre dei seguenti elementi:

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, verrà configurato il database MySQL configurato e popolato con dati di esempio. Per informazioni su altre origini dati supportate e su come configurarle, vedere Integrazionedati di AEM Forms.

Per configurare il MySQL database, effettuate le seguenti operazioni:

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

    1. Accedete a AEM Istanza Forms autore come amministratore e andate AEM bundle della console Web. L’URL predefinito è https://localhost:4502/system/console/bundles.

    2. Toccate Installa/Aggiorna. Viene visualizzata una finestra di dialogo Carica/Installa pacchetti .

    3. Toccate Scegli file per sfogliare e selezionate il bundle OSGi del driver MySQL JDBC. Selezionate Avvia pacchetto e aggiorna pacchetti, quindi toccate Installa o Aggiorna. Assicurarsi che il driver Oracle Corporation’s JDBC per MySQL sia attivo. Il driver è installato.

  2. Configura MySQL database come origine dati:

    1. Passate AEM console Web all’indirizzo https://localhost:4502/system/console/configMgr.

    2. Individua la configurazione DataSource ​in pool di connessione Apache Sling. Toccate per aprire la configurazione in modalità di modifica.

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

      • Nome origine dati: Potete specificare qualsiasi nome. Ad esempio, specificate WeRetailMySQL.

      • Nome proprietà del 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. Ad esempio, datasource.name.

      • Classe driver JDBC: Specificate il nome della classe Java del driver JDBC. Per MySQL il database, specificate com.mysql.jdbc.Driver.

      • URI connessione JDBC: Specificate l’URL di connessione del database. Per MySQL il database in esecuzione sulla porta 3306 e sullo schema weretail, l’URL è: jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8

      • 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 consentire al driver JDBC di stabilire una connessione con il database.

      • Test sul credito: Abilitate l'opzione Prova in prestito .

      • Test al ritorno: Abilitate l'opzione Test on Return (Test su ritorno).

      • Query di convalida: Specificare una query SQL SELECT per convalidare le connessioni dal pool. La query deve restituire almeno una riga. Ad esempio, selezionare * dai dettagli del cliente.

      • Isolamento transazione: Impostare il valore su READ_COMMTED.

        Lasciate le altre proprietà con i valori predefiniti e toccate Salva.

        Viene creata una configurazione simile a quella riportata di seguito.

        relational-database-data-source-configuration

Step 2: Create form data model

AEM Forms fornisce un'interfaccia utente intuitiva per creare un modello dati del modulo da origini dati configurate. È possibile utilizzare più origini dati in un modello dati del modulo. Per il nostro caso di utilizzo, utilizzeremo l'origine MySQL dati configurata.

Per creare un modello dati modulo, effettuare le seguenti operazioni:

  1. NellAEMistanza di creazione, accedi a Forms > Integrazioni dati.

  2. Tap Create > Form Data Model.

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

  4. Nella schermata dell'origine dati selezionata sono elencate tutte le origini dati configurate. Selezionate l'origine dati WeRetailMySQL e toccate Crea.

    data-source-selection

Viene creato il modello di dati del modulo per la spedizione del cliente-dettagli di fatturazione.

Passaggio 3: Configurare il modello dati del modulo

La configurazione del modello dati del modulo comporta:

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

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

  1. NellAEMistanza di creazione, accedi a Forms > Integrazioni dati. L’URL predefinito è https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

  2. Il modello di dati del modulo per la spedizione dei clienti e la fatturazione creato in precedenza è elencato di seguito. Aprirlo in modalità di modifica.

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

    default-fdm

  3. Espandere la struttura di origine dati WeRailMySQL. Selezionare i seguenti oggetti modello dati e servizi da weretail > custom details schema a form data model:

    • Oggetti del modello dati:

      • id
      • name
      • spesaIndirizzo
      • città
      • stadio
      • zipcode
    • Servizi:

      • get
      • aggiorna

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

    Schema WeRetail

    Nota

    I servizi predefiniti get, update e insert per le origini dati JDBC vengono forniti out-of-the-box con il modello dati del modulo.

  4. Configurare i servizi di lettura e scrittura per l'oggetto modello dati.

    1. Selezionare l'oggetto modello dati custom details e toccare Modifica proprietà.

    2. Selezionate Ottieni dal menu a discesa Servizio di lettura. L'argomento id , che è la chiave primaria nell'oggetto del modello di dati dei dettagli del cliente, viene aggiunto automaticamente. Toccate aem_6_3_edit e configurate l'argomento come segue.

      read-default

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

      write-default

      Aggiungete e configurate l'argomento id come segue.

      id-arg

    4. Toccare Fine per salvare le proprietà dell'oggetto modello dati. Quindi, toccare Salva per salvare il modello dati del modulo.

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

      data-model-object

  5. Passate alla scheda Servizi e configurate i servizi get e update .

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

    2. Specificate quanto segue nella finestra di dialogo Modifica proprietà:

      • Titolo: Specificate 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 cliente dal MySQL database

      • Oggetto modello di output: Selezionare lo schema contenente i dati del cliente. Ad esempio:

        schema dettaglio cliente

      • Restituisce array: Disattivate l'opzione Return array (Restituisce array).

      • Argomenti: Selezionare l'argomento denominato ID.

      Toccate Chiudi. Il servizio per recuperare i dettagli del cliente dal database MySQL è configurato.

      ricerca dell'indirizzo di spedizione

    3. Selezionate il servizio di aggiornamento e toccate Modifica proprietà. Viene visualizzata la finestra di dialogo delle proprietà.

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

      • Titolo: Specificate 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 del modello di input: Selezionare lo schema contenente i dati del cliente. Ad esempio:

        schema dettaglio cliente

      • Tipo di output: Selezionare BOOLEAN.

      • Argomenti: Selezionate l’argomento denominato ID e i dettagli ​del cliente.

      Toccate Chiudi. Il servizio di aggiornamento per aggiornare i dettagli del cliente nel MySQL database è configurato.

      shiiping-address-update

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

Step 4: Test form data model

È possibile verificare l'oggetto del modello dati e i servizi per verificare che il modello dati del modulo sia configurato correttamente.

Per eseguire il test, effettuate le seguenti operazioni:

  1. Fare clic sulla scheda Modello , selezionare l'oggetto modello dati custom details e toccare Test Model Object.

  2. Nella finestra Modello/Servizio di prova, selezionare Oggetto modello Lettura dal menu a discesa Seleziona modello/servizio .

  3. Nella sezione Dettagli cliente, specificate un valore per l'argomento id presente nel MySQL database configurato e toccate 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 verificare l'oggetto e i servizi del modello di scrittura.

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

    test-write-model

    Ora, se si esegue nuovamente il test del servizio modello di lettura per l'ID 7107215, il servizio recupererà e visualizzerà i dettagli cliente aggiornati come mostrato di seguito.

    read-updated

In questa pagina