Tutorial: creare un modello di dati modulo

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

   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.

     

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.

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.

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.