Esercitazione: Crea modello dati modulo

04-create-form-data-model-main

Questa esercitazione è un passaggio della serie Crea il tuo 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 dei dati Forms 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 AEM Forms Data Integration.

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 B. Schemi origine dati C.Servizi disponibili D. Oggetti 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 AEM Forms Data Integration.

Per configurare il database MySQL, effettuate le seguenti operazioni:

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

    1. Accedete a AEM Forms Author Instance 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. Configurare il database MySQL come origine dati:

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

    2. Individuare la configurazione di Apache Sling Connection DataSource in pool. Toccate per aprire la configurazione in modalità di modifica.

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

      • Nome origine dati: è possibile specificare qualsiasi nome. Ad esempio, specificare 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 il database MySQL, specificare com.mysql.jdbc.Driver.

      • URI connessione JDBC: Specificate l’URL di connessione del database. Per il database MySQL in esecuzione sulla porta 3306 e la coda dello schema, 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.

      • Prova in prestito: attiva l’opzione Test su prestito.

      • Test su restituzione: abilita il test sulla restituzione.

      • Query di convalida: specificate 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.

        Lasciare altre proprietà con valori predefiniti e toccare Save.

        Viene creata una configurazione simile a quella riportata di seguito.

        relational-database-data-source-configuration

Passaggio 2: Crea modello dati modulo

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 dati MySQL configurata.

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

  1. Nell'istanza di AEM autore, passare a Forms > Integrazioni dati.

  2. Toccate Crea > Modello dati modulo.

  3. Nella finestra di dialogo Crea modello dati modulo, specificare un nome per il modello dati del modulo. Ad esempio, customer-shipping-fatturazione-details. Toccare Next.

  4. Nella schermata dell'origine dati selezionata sono elencate tutte le origini dati configurate. Selezionare l'origine dati WeRetailMySQL e toccare Create.

    data-source-selection

Viene creato il modello di dati del modulo customer-Shipping-Invoice-details.

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. Nell'istanza di AEM autore, andate a Forms > Integrazioni dati. L'URL predefinito è https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

  2. Il modello di dati del modulo customer-Shipping-Invoice-details creato in precedenza è elencato qui. 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 gli oggetti e i servizi del modello dati seguenti dallo schema weretail > custom details al modello dati del modulo:

    • 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 Edit Properties.

    2. Selezionare get 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, selezionare update come servizio di scrittura. L'oggetto customerdetails viene aggiunto automaticamente come argomento. L'argomento è configurato come segue.

      write-default

      Aggiungere e configurare l'argomento id come segue.

      id-arg

    4. Toccate Fine per salvare le proprietà dell'oggetto modello dati. Quindi, toccare Save 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. Andate alla scheda Services e configurate i servizi get e update.

    1. Selezionare il servizio get e toccare Edit Properties. 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. Esempio:

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

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

        schema dettaglio cliente

      • Restituisce array: Disattivate l’opzione Ritorno dall’elenco.

      • 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. Selezionare il servizio update e toccare Edit Properties. 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. 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. Esempio:

        schema dettaglio cliente

      • Tipo di output: Selezionare BOOLEAN.

      • Argomenti: Selezionate l’argomento denominato ​IDe i dettagli cliente.

      Toccate Chiudi. Il servizio update per aggiornare i dettagli del cliente nel database MySQL è 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.

Passaggio 4: Test del modello dati del modulo

È 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 Oggetto modello di prova.

  2. Nella finestra Test Model/Service, selezionare Leggi oggetto modello dal menu a discesa Seleziona modello/servizio.

  3. Nella sezione custom details, specificate un valore per l'argomento id presente nel database MySQL 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