Show Menu
ARGOMENTI×

Tutorial: Create form data model

Questa esercitazione è un passaggio della serie Create your first Interactive Communication (Creazione della prima serie di comunicazioni interattive). Si consiglia di seguire le serie in sequenza cronologica per comprendere, eseguire e dimostrare l'uso completo dell'esercitazione.

Informazioni sull'esercitazione

Il modulo di integrazione dei dati di AEM Forms consente di creare un modello di dati del modulo da origini dati back-end diverse, quali profilo utente AEM, servizi Web RESTful, servizi Web basati su SOAP, servizi OData e database relazionali. È possibile configurare oggetti e servizi del modello dati in un modello dati del modulo e associarlo a un modulo adattivo. I campi modulo adattivi 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, consultate Integrazione dei dati di AEM Forms.
Questa esercitazione illustra i passaggi necessari per preparare, creare, configurare e associare un modello dati del modulo a una comunicazione interattiva. Al termine di questa esercitazione, potrete:
Il modello dati del modulo è simile al seguente:
A. Origini dati configurate B. Schemi origine dati C. Servizi disponibili D. Oggetti del modello dati E. Servizi configurati

Prerequisiti

Prima di iniziare, accertatevi di disporre dei seguenti elementi:

Passaggio 1: Configurare il database

Un database è essenziale per creare una comunicazione interattiva. Questa esercitazione utilizza un database per visualizzare il modello dati del modulo e le funzionalità di persistenza delle comunicazioni interattive. Configurate un database contenente tabelle cliente, fatture e chiamate. L'immagine seguente illustra i dati di esempio per la tabella cliente:
Utilizzate la seguente istruzione DDL per creare la tabella cliente nel database.
CREATE TABLE `customer` (
   `mobilenum` int(11) NOT NULL,
   `name` varchar(45) NOT NULL,
   `address` varchar(45) NOT NULL,
   `alternatemobilenumber` int(11) DEFAULT NULL,
   `relationshipnumber` int(11) DEFAULT NULL,
   `customerplan` varchar(45) DEFAULT NULL,
   PRIMARY KEY (`mobilenum`),
   UNIQUE KEY `mobilenum_UNIQUE` (`mobilenum`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Utilizzare la seguente istruzione DDL per creare la tabella delle fatture nel database.
CREATE TABLE `bills` (
   `billplan` varchar(45) NOT NULL,
   `latepayment` decimal(4,2) NOT NULL,
   `monthlycharges` decimal(4,2) NOT NULL,
   `billdate` date NOT NULL,
   `billperiod` varchar(45) NOT NULL,
   `prevbal` decimal(4,2) NOT NULL,
   `callcharges` decimal(4,2) NOT NULL,
   `confcallcharges` decimal(4,2) NOT NULL,
   `smscharges` decimal(4,2) NOT NULL,
   `internetcharges` decimal(4,2) NOT NULL,
   `roamingnational` decimal(4,2) NOT NULL,
   `roamingintnl` decimal(4,2) NOT NULL,
   `vas` decimal(4,2) NOT NULL,
   `discounts` decimal(4,2) NOT NULL,
   `tax` decimal(4,2) NOT NULL,
   PRIMARY KEY (`billplan`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Utilizzate la seguente istruzione DDL per creare la tabella delle chiamate nel database.
CREATE TABLE `calls` (
   `mobilenum` int(11) DEFAULT NULL,
   `calldate` date DEFAULT NULL,
   `calltime` varchar(45) DEFAULT NULL,
   `callnumber` int(11) DEFAULT NULL,
   `callduration` varchar(45) DEFAULT NULL,
   `callcharges` decimal(4,2) DEFAULT NULL,
   `calltype` varchar(45) DEFAULT NULL
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

La tabella delle chiamate include i dettagli delle chiamate, come la data di chiamata, l'ora di chiamata, il numero di chiamata, la durata delle chiamate e le spese di chiamata. La tabella cliente è collegata alla tabella delle chiamate utilizzando il campo Numero mobile (mobilenum). Per ogni numero di cellulare elencato nella tabella del cliente , nella tabella delle chiamate sono presenti più record. Ad esempio, puoi recuperare i dettagli della chiamata per il numero mobile 1457892541 facendo riferimento alla tabella delle chiamate .
La tabella delle fatture include i dettagli delle fatture, ad esempio data di fatturazione, periodo di fatturazione, spese mensili e spese di chiamata. La tabella cliente è collegata alla tabella fatture utilizzando il campo Piano fatture. Nella tabella cliente è presente un piano associato a ciascun cliente. La tabella delle fatture include i dettagli dei prezzi per tutti i piani esistenti. Ad esempio, è possibile recuperare i dettagli del piano per Sarah dalla tabella cliente e utilizzare tali dettagli per recuperare i dettagli dei prezzi dalla tabella fatture .

Passaggio 2: Configurare il database MySQL come origine dati

È possibile configurare diversi tipi di origini dati per creare un modello dati del modulo. Per questa esercitazione, configurerete il database MySQL configurato e compilato con i dati di esempio. Per informazioni su altre origini dati supportate e su come configurarle, consulta Integrazione dati di AEM Forms.
Per configurare il database MySQL, effettuate le seguenti operazioni:
  1. Installare il driver JDBC per il database MySQL come bundle OSGi:
    1. Accedete ad AEM Forms Author Instance come amministratore e passate ai bundle della console Web di AEM. L’URL predefinito è https://localhost:4502/system/console/bundles .
    2. Toccate Installa/Aggiorna . Viene visualizzata una finestra di dialogo Carica/Installa pacchetti .
    3. Toccate Scegli file per sfogliare e selezionate il bundle OSGi del driver MySQL JDBC. Selezionate Avvia pacchetto e aggiorna pacchetti , quindi toccate Installa o Aggiorna . Assicurarsi che il driver JDBC di Oracle Corporation per MySQL sia attivo. Il driver è installato.
  2. Configurare il database MySQL come origine dati:
    1. Andate alla console Web di AEM all'indirizzo https://localhost:4502/system/console/configMgr .
    2. Individua la configurazione DataSource ​in pool di connessione Apache Sling. Toccate per aprire la configurazione in modalità di modifica.
    3. Nella finestra di dialogo di configurazione, specificate i seguenti dettagli:
      • Nome origine dati: Potete specificare qualsiasi nome. Ad esempio, specificare MySQL .
      • Nome proprietà del 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. Ad esempio, datasource.name .
      • Classe driver JDBC: Specificate il nome della classe Java del driver JDBC. Per il database MySQL, specificate com.mysql.jdbc.Driver .
      • URI connessione JDBC: Specificate l'URL di connessione del database. Per il database MySQL in esecuzione sulla porta 3306 e sullo schema teleca, l'URL è: jdbc:mysql://'server':3306/teleca?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      • 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 consentire al driver JDBC di stabilire una connessione con il database.
      • Test sul credito: Abilitate l'opzione Prova in prestito .
      • Test al ritorno: Abilitate l'opzione Test on Return (Test su ritorno).
      • Query di convalida: Specificare una query SQL SELECT per convalidare le connessioni dal pool. La query deve restituire almeno una riga. Ad esempio, selezionare * dal cliente .
      • Isolamento transazione: Impostare il valore su READ_COMMTED .
    Lasciate le altre proprietà con i valori predefiniti e toccate Salva .
    Viene creata una configurazione simile a quella riportata di seguito.

Step 3: Create form data model

AEM Forms offre un'interfaccia utente intuitiva per creare un modello di dati del modulo da origini dati configurate. È possibile utilizzare più origini dati in un modello dati del modulo. Per l'utilizzo in questa esercitazione, verrà utilizzato MySQL come origine dati.
Per creare un modello dati modulo, effettuare le seguenti operazioni:
  1. Nell’istanza di creazione di AEM, passa a Forms > Integrazioni ​dati.
  2. Tap Create > Form Data Model .
  3. Nella procedura guidata Crea modello dati modulo, specificare un nome per il modello dati del modulo. Ad esempio, FDM_Create_First_IC . Toccate Avanti .
  4. Nella schermata dell'origine dati selezionata sono elencate tutte le origini dati configurate. Selezionare l'origine dati MySQL e toccare Crea .
  5. Fate clic su Fine . Viene creato il modello di dati del modulo FDM_Create_First_IC .

Passaggio 4: Configurare il modello dati del modulo

La configurazione del modello dati del modulo include:

Aggiunta di oggetti e servizi del modello dati

  1. Nell’istanza di creazione di AEM, passa a Forms > Integrazioni ​dati. L’URL predefinito è https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm .
  2. Il modello di dati del modulo FDM_Create_First_IC creato in precedenza è elencato di seguito. Selezionatela e toccate Modifica .
    L'origine dati selezionata MySQL viene visualizzata nel riquadro Origini ​dati.
  3. Espandere la struttura dell'origine dati MySQL . Selezionare i seguenti oggetti modello dati e servizi dallo schema teleca :
    • Oggetti del modello dati:
      • bollette
      • call
      • cliente
    • Servizi:
      • get
      • aggiorna
    Toccare Aggiungi selezionato per aggiungere gli oggetti e i servizi del modello dati selezionati al modello dati del modulo.
    Le fatture, le chiamate e gli oggetti modello dati cliente vengono visualizzati nel riquadro a destra della scheda Modello . I servizi get e update sono visualizzati nella scheda Servizi .

Creazione di proprietà figlio calcolate per l'oggetto modello dati

Una proprietà calcolata è quella il cui valore viene calcolato in base a una regola o un'espressione. Utilizzando una regola, è possibile impostare il valore di una proprietà calcolata su una stringa letterale, un numero, il risultato di un'espressione matematica o il valore di un'altra proprietà nel modello dati del modulo.
In base al caso d'uso, creare la proprietà usagecharge figlio calcolata nell'oggetto modello dati distinte utilizzando la seguente espressione matematica:
  • tariffe di utilizzo = tariffe chiamate + tariffe chiamate conferenze + tariffe SMS + tariffe internet mobili + roaming nazionale + roaming internazionale + VAS (tutte queste proprietà esistono nell'oggetto modello dati fatture)Per ulteriori informazioni sulle tariffe di utilizzo della proprietà calcolata per i bambini, vedere Piano della comunicazione interattiva.
Per creare proprietà figlio calcolate per l'oggetto modello dati fatture, eseguire i passaggi seguenti:
  1. Selezionare la casella di controllo nella parte superiore dell'oggetto modello dati distinte per selezionarlo e toccare Crea proprietà figlia.
  2. Nel riquadro Crea proprietà figlio:
    1. Immettere usagecariche come nome della proprietà figlio.
    2. Abilita calcolato .
    3. Selezionare Mobile come tipo e toccare Fine per aggiungere la proprietà figlio all'oggetto modello dati distinte .
  3. Toccate Modifica regola per aprire l'Editor regole.
  4. Toccate Crea . Viene visualizzata la finestra Imposta regola valore .
  5. Dal menu a discesa Seleziona opzione, selezionate Espressione ​matematica.
  6. Nell'espressione matematica, selezionare, rispettivamente, callcharge e dolcallload come primo e secondo oggetto. Selezionare più come operatore. Toccate all'interno dell'espressione matematica e toccate Estendi espressione per aggiungere scharges , internetcarts , roamingnational , roamingintnl e vasoggetti all'espressione.
    L'immagine seguente rappresenta l'espressione matematica nell'editor di regole:
  7. Toccate Chiudi . La regola viene creata nell'Editor regole.
  8. Toccate Chiudi per chiudere la finestra Editor regole.

Aggiungere associazioni tra gli oggetti del modello dati

Una volta definiti gli oggetti del modello dati, è possibile creare associazioni tra di essi. L'associazione può essere uno a uno o uno a molti. Ad esempio, possono essere associati più dipendenti a un dipendente. Viene definita associazione uno-molti e rappresentata da 1:n sulla linea che collega gli oggetti del modello dati associati. Tuttavia, se un'associazione restituisce un nome univoco del dipendente per un dato ID dipendente, viene definita associazione uno-a-uno.
Quando si aggiungono oggetti del modello dati associati in un'origine dati a un modello dati del modulo, le relative associazioni vengono mantenute e visualizzate come collegate dalle linee freccia.
In base al caso di utilizzo, creare le seguenti associazioni tra gli oggetti del modello dati:
Association
Oggetti del modello dati
1:n
cliente:chiamate (più chiamate possono essere associate a un cliente in una fattura mensile)
1:1
cliente:fatture (una fattura è associata a un cliente per un mese specifico)
Per creare associazioni tra gli oggetti del modello dati, procedere come segue:
  1. Selezionare la casella di controllo nella parte superiore dell'oggetto modello dati cliente per selezionarlo e toccare Aggiungi associazione . Viene visualizzato il riquadro delle proprietà Aggiungi associazione .
  2. Nel riquadro Aggiungi associazione :
    • Specificate un titolo per l'associazione. È un campo facoltativo.
    • Selezionare Da uno a molti dall'elenco a discesa Tipo .
    • Seleziona le chiamate dall'elenco a discesa Oggetto ​modello.
    • Selezionate Ottieni dall’elenco a discesa Servizio .
    • Toccare Aggiungi per collegare l'oggetto modello dati cliente all'oggetto modello dati chiamate utilizzando una proprietà. In base al caso d'uso, l'oggetto modello dati delle chiamate deve essere collegato alla proprietà numero mobile nell'oggetto modello dati cliente. Viene visualizzata la finestra di dialogo Aggiungi argomento .
  3. Nella finestra di dialogo Aggiungi argomento :
    • Selezionate mobilenum dall’elenco a discesa Nome . La proprietà mobile number è una proprietà comune disponibile nel cliente e chiama gli oggetti del modello dati. Di conseguenza, viene utilizzato per creare un'associazione tra gli oggetti del modello dati cliente e chiama quelli del modello dati. Per ciascun numero mobile disponibile nell'oggetto modello dati cliente, nella tabella delle chiamate sono disponibili più record di chiamate.
    • Specificate un titolo e una descrizione facoltativi per l’argomento.
    • Selezionare il cliente dall'elenco a discesa Binding a.
    • Selezionare mobilenum dall'elenco a discesa Valore ​binding.
    • Toccate Aggiungi .
    La proprietà mobilenum viene visualizzata nella sezione Argomenti .
  4. Toccate Fine per creare un'associazione 1:n tra gli oggetti cliente e chiama gli oggetti modello dati.
    Dopo aver creato un'associazione tra gli oggetti modello dati cliente e chiama, creare un'associazione 1:1 tra gli oggetti modello dati cliente e distinta.
  5. Selezionare la casella di controllo nella parte superiore dell'oggetto modello dati cliente per selezionarlo e toccare Aggiungi associazione . Viene visualizzato il riquadro delle proprietà Aggiungi associazione .
  6. Nel riquadro Aggiungi associazione :
    • Specificate un titolo per l'associazione. È un campo facoltativo.
    • Selezionare Uno a Uno dall'elenco a discesa Tipo .
    • Selezionare fatture dall'elenco a discesa Oggetto ​modello.
    • Selezionate Ottieni dall’elenco a discesa Servizio . La proprietà billplan , che è la chiave primaria per la tabella delle fatture, è già disponibile nella sezione Argomenti . Gli oggetti delle distinte e del modello dati cliente sono collegati utilizzando rispettivamente le proprietà del piano fatturabile (fatture) e del piano cliente (cliente). Creare un binding tra queste proprietà per recuperare i dettagli del piano per qualsiasi cliente disponibile nel database MySQL.
    • Selezionare il cliente dall'elenco a discesa Binding a.
    • Selezionare customerplan dall'elenco a discesa Valore ​binding.
    • Toccate Fine per creare un binding tra le proprietà billplan e customerplan.
    Nell'immagine seguente sono illustrate le associazioni tra gli oggetti del modello dati e le proprietà utilizzate per creare associazioni tra di essi:

Modifica delle proprietà dell'oggetto modello dati

Dopo aver creato associazioni tra il cliente e altri oggetti del modello dati, modificare le proprietà del cliente per definire la proprietà in base alla quale i dati vengono recuperati dall'oggetto del modello dati. In base al caso di utilizzo, il numero mobile viene utilizzato come proprietà per recuperare i dati dall'oggetto modello dati cliente.
  1. Selezionare la casella di controllo nella parte superiore dell'oggetto modello dati cliente per selezionarlo e toccare Modifica proprietà . Viene visualizzato il riquadro Modifica proprietà .
  2. Specificare il cliente come oggetto modello di livello principale.
  3. Selezionare Ottieni dall'elenco a discesa Servizio di lettura.
  4. Nella sezione Argomenti :
    • Selezionare Richiedi attributo dall'elenco a discesa Binding a.
    • Specificare mobilenum come valore di binding.
  5. Selezionate Aggiorna dall'elenco a discesa Servizio scrittura .
  6. Nella sezione Argomenti :
    • Per la proprietà mobilenum , selezionare cliente dall'elenco a discesa Binding a.
    • Selezionare mobilenum dall'elenco a discesa Valore ​binding.
  7. Toccate Fine per salvare le proprietà.
  8. Selezionare la casella di controllo nella parte superiore dell'oggetto modello dati chiamate per selezionarlo e toccare Modifica proprietà . Viene visualizzato il riquadro Modifica proprietà .
  9. Disabilitare l'oggetto Modello di livello principale per le chiamate all'oggetto modello dati.
  10. Toccate Chiudi .
    Ripetere i passaggi da 8 a 10 per configurare le proprietà per l'oggetto modello dati distinte .

Configurare i servizi

  1. Passate alla scheda Servizi .
  2. Selezionate il servizio get e toccate Modifica proprietà . Viene visualizzato il riquadro Modifica proprietà .
  3. Nel riquadro Modifica proprietà :
    • Inserite un titolo e una descrizione facoltativi.
    • Selezionare il cliente dall'elenco a discesa Oggetto modello di output.
    • Toccate Fine per salvare le proprietà.
  4. Selezionate il servizio di aggiornamento e toccate Modifica proprietà . Viene visualizzato il riquadro Modifica proprietà .
  5. Nel riquadro Modifica proprietà :
    • Inserite un titolo e una descrizione facoltativi.
    • Selezionare il cliente dall'elenco a discesa Oggetto modello di input.
    • Toccate Chiudi .
    • Toccare Salva per salvare il modello dati del modulo.

Passaggio 5: Verifica modello dati modulo e servizi

È possibile verificare l'oggetto del modello dati e i servizi per verificare che il modello dati del modulo sia configurato correttamente.
Per eseguire il test, effettuate le seguenti operazioni:
  1. Fare clic sulla scheda Modello , selezionare l'oggetto modello dati cliente e toccare Oggetto modello test.
  2. Nella finestra Prova modello dati modulo, selezionare Leggi oggetto modello dall'elenco a discesa Seleziona modello/servizio .
  3. Nella sezione Input , specificate un valore per la proprietà mobilenum presente nel database MySQL configurato e toccate Test .
    I dettagli del cliente associati alla proprietà mobilenum specificata vengono recuperati e visualizzati nella sezione Output come illustrato di seguito. Chiudete la finestra di dialogo.
  4. Passate alla scheda Servizi .
  5. Selezionate il servizio get e toccate Servizio di prova.
  6. Nella sezione Input , specificate un valore per la proprietà mobilenum presente nel database MySQL configurato e toccate Test .
    I dettagli del cliente associati alla proprietà mobilenum specificata vengono recuperati e visualizzati nella sezione Output come illustrato di seguito. Chiudete la finestra di dialogo.

Modificare e salvare i dati di esempio

L'editor dei modelli di dati modulo consente di generare dati di esempio per tutte le proprietà degli oggetti del modello di dati, incluse le proprietà calcolate, in un modello di dati del modulo. Si tratta di un insieme di valori casuali conformi al tipo di dati configurato per ciascuna proprietà. È inoltre possibile modificare e salvare i dati, che vengono conservati anche se si rigenerano i dati di esempio.
Per generare, modificare e salvare dati di esempio, effettuate le seguenti operazioni:
  1. Nella pagina del modello dati del modulo, toccare Modifica dati di esempio. Genera e visualizza i dati di esempio nella finestra Modifica dati di esempio.
  2. Nella finestra Modifica dati di esempio, modificare i dati in base alle esigenze e toccare Salva . Chiudi la finestra.