Esercitazione: Crea modello dati modulo tutorial-create-form-data-model
Questa esercitazione è un passaggio nel Creare il primo modulo adattivo serie. Si consiglia di seguire la serie in sequenza cronologica per comprendere, eseguire e illustrare il caso d’uso completo dell’esercitazione.
Informazioni sull’esercitazione about-the-tutorial
Il modulo di integrazione dei dati di AEM Forms consente di creare un modello di dati del modulo da diverse origini di dati di backend, come AEM profilo utente, servizi web RESTful, servizi web basati su SOAP, servizi OData e database relazionali. È possibile configurare oggetti modello dati e servizi in un modello dati modulo e associarlo a un modulo adattivo. I campi modulo adattivo 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, consulta Integrazione dei dati di AEM Forms.
Questa esercitazione descrive i passaggi necessari per preparare, creare, configurare e associare un modello di dati modulo a un modulo adattivo. Al termine di questa esercitazione, potrai:
Il modello dati del modulo avrà un aspetto simile al seguente:
A. Origini dati configurate B. Schemi di origine dati C. Servizi disponibili D. Oggetti del modello dati E. Servizi configurati
Prerequisiti prerequisites
Prima di iniziare, assicurati di disporre dei seguenti elementi:
- Database MySQL con dati di esempio come indicato nella sezione Prerequisiti di Creare il primo modulo adattivo
- Bundle OSGi per il driver JDBC MySQL come spiegato in Bundling del driver di database JDBC
- Modulo adattivo come descritto nella prima esercitazione Creare un modulo adattivo
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, configureremo il database MySQL configurato e popolato con dati di esempio. Per informazioni su altre origini dati supportate e su come configurarle, consulta Integrazione dei dati di AEM Forms.
Per configurare il database MySQL eseguire le operazioni seguenti:
-
Installa il driver JDBC per il database MySQL come bundle OSGi:
-
Accedi all’istanza di authoring di AEM Forms come amministratore e vai AEM bundle della console web. L’URL predefinito è http://localhost:4502/system/console/bundles.
-
Tocca Installazione/aggiornamento. Un Caricare/installare i bundle viene visualizzata la finestra di dialogo .
-
Tocca Scegli file per sfogliare e selezionare il bundle OSGi del driver JDBC MySQL. Seleziona Avvia bundle e Aggiorna pacchetti, e tocca Installa o aggiorna. Verificare che il driver JDBC di Oracle Corporation per MySQL sia attivo. Il driver è installato.
-
-
Configura il database MySQL come origine dati:
-
Vai AEM console Web all'indirizzo http://localhost:4502/system/console/configMgr.
-
Individua Origine dati in pool di connessione Apache Sling configurazione. Tocca per aprire la configurazione in modalità di modifica.
-
Nella finestra di dialogo di configurazione, specifica i seguenti dettagli:
- Nome origine dati: Puoi specificare un nome qualsiasi. Ad esempio, specifica WeRetailMySQL.
- Nome della proprietà del servizio DataSource: Specifica 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 del driver JDBC: Specifica il nome della classe Java del driver JDBC. Per il database MySQL, specificare com.mysql.jdbc.Driver.
- URI di connessione JDBC: Specifica l'URL di connessione del database. Per il database MySQL in esecuzione sulla porta 3306 e lo schema weretail, l'URL è:
jdbc:mysql://[server]:3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8 - Nome utente: Nome utente del database. È necessario per abilitare il driver JDBC per stabilire una connessione con il database.
- Password: Password del database. È necessario per abilitare il driver JDBC per stabilire una connessione con il database.
- Prova su prestito: Abilita la Test su credito opzione .
- Test al ritorno: Abilita la Test al ritorno opzione .
- 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: Imposta il valore su READ_COMMTED.
Lascia altre proprietà con impostazione predefinita values e toccare Salva.
Viene creata una configurazione simile a quella riportata di seguito.
-
Passaggio 2: Crea modello dati 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 modulo. Per il nostro caso di utilizzo, utilizzeremo l'origine dati MySQL configurata.
Per creare un modello dati modulo, procedere come segue:
-
In AEM’istanza di authoring, passa a Forms > Integrazione dei dati s.
-
Tocca Crea > Modello dati modulo.
-
Nella finestra di dialogo Crea modello dati modulo , specifica un name per il modello dati del modulo. Ad esempio: customer-shipping-billing-details. Tocca Successivo.
-
Nella schermata Seleziona origine dati sono elencate tutte le origini dati configurate. Seleziona WeRetailMySQL origine dati e tocca Crea.
La customer-shipping-billing-details viene creato il modello dati del modulo.
Passaggio 3: Configurare il modello dati del modulo config-fdm
La configurazione del modello dati del modulo comporta:
- aggiunta di oggetti e servizi del modello dati
- configurazione dei servizi di lettura e scrittura per gli oggetti del modello dati
Per configurare il modello dati del modulo, effettuare le seguenti operazioni:
-
Nell'istanza AEM autore, passa a Forms > Integrazioni dati. L’URL predefinito è http://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.
-
La customer-shipping-billing-details il modello dati del modulo creato in precedenza è elencato qui. Aprirlo in modalità di modifica.
Origine dati selezionata WeRetailMySQL è configurato nel modello dati del modulo.
-
Espandere la struttura di origine dati WeRailMySQL. Selezionare i seguenti oggetti e servizi del modello dati da weretail > dettagli cliente schema per il modello dati del modulo:
-
Oggetti del modello dati:
- id
- name
- shippingAddress
- città
- stadio
- zipcode
-
Servizi:
- get
- aggiorna
Tocca Aggiungi selezionati per aggiungere oggetti e servizi del modello dati selezionati al modello dati del modulo.
note note NOTE I servizi get, update e insert predefiniti per le origini dati JDBC vengono forniti con il modello dati del modulo . -
-
Configurare i servizi di lettura e scrittura per l'oggetto modello dati.
-
Seleziona la dettagli cliente oggetto modello dati e tocca Modifica proprietà.
-
Seleziona get dal menu a discesa Read Service . La id argomento, che è la chiave primaria nell'oggetto modello dati customerdetails viene aggiunto automaticamente. Tocca
-
Analogamente, seleziona update come servizio di scrittura. La dettagli cliente viene aggiunto automaticamente come argomento. L’argomento viene configurato come segue.
Aggiungi e configura le id argomento come segue.
-
Tocca Fine per salvare le proprietà dell'oggetto modello dati. Quindi, tocca Salva per salvare il modello dati del modulo.
La get e update i servizi vengono aggiunti come servizi predefiniti per l’oggetto modello dati.
-
-
Vai a Servizi scheda e configurazione get e update servizi.
-
Seleziona la get servizio e rubinetto Modifica proprietà. Viene visualizzata la finestra di dialogo delle proprietà.
-
Nella finestra di dialogo Modifica proprietà , specifica quanto segue:
-
Titolo: Specifica il titolo del servizio. Ad esempio: Recupera indirizzo di spedizione.
-
Descrizione: Specifica 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 lo schema contenente i dati del cliente. Ad esempio:
schema di dettaglio del cliente
-
Matrice di ritorno: Disattiva la Matrice di ritorno opzione .
-
Argomenti: Seleziona argomento denominato ID.
Tocca Fine. Il servizio per recuperare i dettagli del cliente dal database MySQL è configurato.
-
-
Seleziona la update servizio e rubinetto Modifica proprietà. Viene visualizzata la finestra di dialogo delle proprietà.
-
Nella finestra di dialogo Modifica proprietà , specifica quanto segue:
-
Titolo: Specifica il titolo del servizio. Ad esempio, Aggiorna indirizzo di spedizione.
-
Descrizione: Specifica 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 lo schema contenente i dati del cliente. Ad esempio:
schema di dettaglio del cliente
-
Tipo di uscita: Seleziona BOOLEANO.
-
Argomenti: Seleziona argomento denominato ID e dettagli cliente.
Tocca Fine. La update è configurato il servizio per aggiornare i dettagli del cliente nel database MySQL.
-
-
L’oggetto del modello dati e i servizi inclusi nel modello dati del modulo sono configurati. È ora possibile verificare il modello dati del modulo.
Passaggio 4: Test del modello dati del modulo test-fdm
È possibile verificare l’oggetto e i servizi del modello dati per verificare che il modello dati del modulo sia configurato correttamente.
Per eseguire il test, procedi come segue:
-
Vai a Modello seleziona la scheda dettagli cliente oggetto modello dati e tocca Oggetto modello di test.
-
In Modello/Servizio di prova finestra, seleziona Oggetto modello lettura dal Seleziona modello/servizio a discesa.
-
In dettagli cliente specifica un valore per id argomento presente nel database MySQL configurato e toccare Test.
I dettagli del cliente associati all’ID specificato vengono recuperati e visualizzati nella Uscita come illustrato di seguito.
-
Analogamente, è possibile verificare 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.
Ora, se esegui nuovamente il test del servizio modello letto per l’id 7107215, recupererà e visualizzerà i dettagli aggiornati del cliente come mostrato di seguito.
