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

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.

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.

     

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.

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.

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 e configura l'argomento come segue.

   

3. 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.

   

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.

   

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 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.

   

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.

   

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.