Tutorial: creare un modello di dati modulo
- Si applica a:
- Experience Manager 6.5
- Argomenti:
- Modello dati modulo
Creato per:
- Amministratore
- Utente
- Sviluppatore
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:
Il modello dati del modulo sarà simile al seguente:
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:
-
Installa il driver JDBC per MySQL il database come bundle OSGi:
-
Scarica MySQL JDBC Driver OSGi Bundle da
http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.html
. -
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.
-
Selezionare Installa/Aggiorna. Viene visualizzata la finestra di dialogo Carica/Installa bundle.
-
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.
-
-
Configurare MySQL il database come origine dati:
-
Vai a AEM console Web all'indirizzo https://localhost:4502/system/console/configMgr.
-
Individua la configurazione Apache Sling Connection Pooled DataSource . Selezionare questa opzione per aprire la configurazione in modalità di modifica.
-
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.
-
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:
-
Nell'istanza di authoring AEM, passa a Forms > Integrazioni dati.
-
Seleziona Crea > Modello dati modulo.
-
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.
-
Nella schermata Seleziona origine dati sono elencate tutte le origini dati configurate. Selezionare l'origine dati WeRetailMySQL e selezionare Crea.
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:
-
Nell'istanza di authoring AEM, passa a Forms > Integrazioni dati. URL predefinito: https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.
-
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.
-
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.
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. -
-
Configurare i servizi di lettura e scrittura per l'oggetto modello dati.
-
Selezionare l'oggetto modello dati customerdetails e selezionare Modifica proprietà.
-
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
-
Analogamente, selezionare update come servizio di scrittura. L'oggetto customerdetails viene aggiunto automaticamente come argomento. L’argomento viene configurato come segue.
Aggiungi e configura l'argomento id come segue.
-
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.
-
-
Vai alla scheda Servizi e configura i servizi get e update.
-
Selezionare il servizio get e selezionare Modifica proprietà. Viene visualizzata la finestra di dialogo delle proprietà.
-
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.
-
-
Seleziona il servizio update e seleziona Modifica proprietà. Viene visualizzata la finestra di dialogo delle proprietà.
-
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.
-
-
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:
-
Vai alla scheda Modello, seleziona l'oggetto modello dati customerdetails e seleziona Oggetto modello di test.
-
Nella finestra Modello di test/Servizio, selezionare Leggi oggetto modello dal menu a discesa Seleziona modello/Servizio.
-
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.
-
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.
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.