Questa esercitazione è un passaggio della serie Crea il tuo primo modulo adattivo . Si consiglia di seguire la serie in sequenza cronologica per comprendere, eseguire e illustrare il caso d’uso completo dell’esercitazione.
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, vedere 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 origine dati C. Servizi disponibili D. Oggetti modello dati E. Servizi configurati
Prima di iniziare, assicurati di disporre dei seguenti elementi:
È 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 Installa/Aggiorna. Viene visualizzata una finestra di dialogo Carica/Installa bundle.
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 la configurazione Apache Sling Connection Pooled DataSource. Tocca per aprire la configurazione in modalità di modifica.
Nella finestra di dialogo di configurazione, specifica i seguenti dettagli:
jdbc:mysql://[server]:3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
Lascia le altre proprietà con i valori predefiniti e tocca Salva.
Viene creata una configurazione simile a quella riportata di seguito.
AEM Forms fornisce un'interfaccia utente intuitiva per creare un modello di dati del modulo dalle 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:
Nell'istanza AEM autore, passa a Forms > Integrazione dei dati s.
Tocca Crea > Modello dati modulo.
Nella finestra di dialogo Crea modello dati modulo, specificare un nome per il modello dati del modulo. Ad esempio, customer-shipping-billing-details. Tocca Avanti.
Nella schermata Seleziona origine dati sono elencate tutte le origini dati configurate. Seleziona l'origine dati WeRetailMySQL e tocca Crea.
Viene creato il modello di dati del modulo customer-shipping-billing-details .
La configurazione del modello dati del modulo comporta:
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.
Il modello di dati del modulo customer-shipping-billing-details creato in precedenza è elencato qui. Aprirlo in modalità di modifica.
L'origine dati selezionata WeRetailMySQL è configurata nel modello dati del modulo.
Espandere la struttura di origine dati WeRailMySQL. Seleziona i seguenti oggetti e servizi del modello dati dallo schema weretail > customerdetails al modello dati del modulo:
Oggetti del modello dati:
Servizi:
Tocca Aggiungi selezionati per aggiungere oggetti e servizi del modello dati selezionati al modello dati del modulo.
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 l'oggetto modello dati customerdetails e tocca Modifica proprietà.
Seleziona get dal menu a discesa Read Service . L’argomento id, che è la chiave primaria nell’oggetto modello dati dettagli cliente, viene aggiunto automaticamente. Tocca e configura l’argomento come segue.
Allo stesso modo, seleziona 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.
Tocca Fine per salvare le proprietà dell'oggetto modello dati. Quindi, tocca Salva per salvare il modello dati del 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 .
Seleziona il servizio get e tocca 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. 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. Esempio:
schema di dettaglio del cliente
Matrice di ritorno: Disattiva l'opzione Return Array (Rendi).
Argomenti: Seleziona l'argomento denominato ID.
Toccate Chiudi. Il servizio per recuperare i dettagli del cliente dal database MySQL è configurato.
Seleziona il servizio update e tocca 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. 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. Esempio:
schema di dettaglio del cliente
Tipo di output: Selezionare BOOLEAN.
Argomenti: Seleziona l'argomento denominato IDe i dettagli cliente.
Toccate Chiudi. Il servizio update per aggiornare i dettagli del cliente nel database MySQL è configurato.
L’oggetto del modello dati e i servizi inclusi nel modello dati del modulo sono configurati. È ora possibile verificare il modello dati del modulo.
È 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 alla scheda Modello, seleziona l'oggetto modello dati customerdetails e tocca Oggetto modello di test.
Nella finestra Test Model / Service, selezionare Read model object dal menu a discesa Select Model / Service.
Nella sezione customerdetails, specifica un valore per l'argomento id presente nel database MySQL configurato e tocca Test.
I dettagli del cliente associati all’ID specificato vengono recuperati e visualizzati nella sezione Output come mostrato 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.