Integrare un modulo adattivo con un database utilizzando il flusso di lavoro AEM submit-forms-to-database-using-forms-portal

Il servizio di automated forms conversion (AFCS) consente di convertire un modulo di PDF non interattivo, un modulo Acro o un modulo di PDF basato su XFA in un modulo adattivo. Quando si avvia il processo di conversione, è possibile generare un modulo adattivo con o senza associazioni di dati.

Se scegli di generare un modulo adattivo senza associazioni di dati, puoi integrare il modulo adattivo convertito con un modello di dati del modulo, uno schema XML o uno schema JSON dopo la conversione. Per il modello dati modulo, è necessario associare manualmente i campi del modulo adattivo al modello dati modulo. Tuttavia, se generi un modulo adattivo con associazioni di dati, il servizio di conversione associa automaticamente i moduli adattivi a uno schema JSON e crea un’associazione di dati tra i campi disponibili nel modulo adattivo e lo schema JSON. Puoi quindi integrare il modulo adattivo con un database a tua scelta, compilare i dati nel modulo e inviarlo al database. Analogamente, una volta completata l’integrazione con il database, è possibile configurare i campi nel modulo adattivo convertito per recuperare i valori dal database e precompilare i campi del modulo adattivo.

La figura seguente illustra diverse fasi dell’integrazione di un modulo adattivo convertito con un database:

Questo articolo descrive le istruzioni dettagliate per eseguire correttamente tutte queste fasi di integrazione.

Prerequisiti pre-requisites

Modulo adattivo di esempio sample-adaptive-form

Per eseguire il caso d’uso per integrare i moduli adattivi convertiti con un database utilizzando un flusso di lavoro AEM, scarica il seguente file PDF di esempio.

Puoi scaricare il modulo Contattaci di esempio utilizzando:

Ottieni file

Il file PDF funge da input per il servizio di Automated forms conversion (AFCS). Il servizio converte questo file in un modulo adattivo. Nell'immagine seguente viene illustrato il modulo Contattaci di esempio in formato PDF.

Installare il file mysql-connector-java-5.1.39-bin.jar install-mysql-connector-java-file

Per installare il file mysql-connector-java-5.1.39-bin.jar, su tutte le istanze di authoring e pubblicazione, effettua le seguenti operazioni:

Prepara dati per modello modulo prepare-data-for-form-model

L’integrazione dei dati di AEM Forms consente di configurare e connettersi a diverse origini dati. Dopo aver generato un modulo adattivo utilizzando il processo di conversione, puoi definire il modello del modulo in base a un modello di dati del modulo, XSD o uno schema JSON. È possibile utilizzare un database, Microsoft Dynamics o qualsiasi altro servizio di terze parti per creare un modello di dati modulo.

Questa esercitazione utilizza il database MySQL come origine per la creazione di un modello di dati modulo. Crea uno schema nel database e aggiungi la tabella contactus allo schema in base ai campi disponibili nel modulo adattivo.

È possibile utilizzare l'istruzione DDL seguente per creare la tabella contactus nel database.

CREATE TABLE `contactus` (
   `name` varchar(45) NOT NULL,
   `email` varchar(45) NOT NULL,
   `phonenumber` varchar(10) DEFAULT NULL,
   `issuedesc` varchar(1000) DEFAULT NULL,
   PRIMARY KEY (`email`)
 ) ENGINE=InnoDB DEFAULT CHARSET=utf8

Configurare la connessione tra l’istanza AEM e il database configure-connection-between-aem-instance-and-database

Per creare una connessione tra l'istanza AEM e il database MYSQL, effettuare le seguenti operazioni di configurazione:

Crea modello dati modulo create-form-data-model

Dopo aver configurato MYSQL come origine dati, eseguire i passaggi seguenti per creare un modello dati del modulo:

Puoi scaricare il modello dati del modulo di esempio utilizzando:

Ottieni file

Generare moduli adattivi con binding JSON generate-adaptive-forms-with-json-binding

Utilizza il servizio di Automated forms conversion per convertire il modulo Contattaci in un modulo adattivo con associazione dati. Assicurati di non selezionare la casella di controllo Generate adaptive form(s) without data bindings durante la generazione del modulo adattivo.

Selezionare il modulo Contattaci convertito disponibile nella cartella output in Forms & Documents e toccare Edit. Tocca Preview, immetti i valori nei campi del modulo adattivo e tocca Submit.

Accedi a crx-repository e passa a /content/forms/fp/admin/submit/data per visualizzare i valori inviati in formato JSON. Di seguito sono riportati i dati di esempio in formato JSON quando si invia il modulo adattivo Contattaci convertito:

{
  "afData": {
    "afUnboundData": {
      "data": {}
    },
    "afBoundData": {
      "data": {
        "name1": "Gloria",
        "email": "abc@xyz.com",
        "phone_number": "2346578965",
        "issue_description": "Test message"
      }
    },
    "afSubmissionInfo": {
      "computedMetaInfo": {},
      "stateOverrides": {},
      "signers": {},
      "afPath": "/content/dam/formsanddocuments/docs_conversion/output/sample_form_json",
      "afSubmissionTime": "20191204014007"
    }
  }
}

È necessario creare ora un modello di flusso di lavoro in grado di elaborare questi dati e inviarli al database MYSQL utilizzando il modello dati del modulo creato nelle sezioni precedenti.

Creare un modello di flusso di lavoro per elaborare i dati JSON create-workflow-model

Per creare un modello di flusso di lavoro per inviare i dati del modulo adattivo al database, effettua le seguenti operazioni:

Configurare l’invio di moduli adattivi configure-adaptive-form-submission

Per inviare il modulo adattivo al modello di flusso di lavoro creato nella sezione precedente, effettua le seguenti operazioni:

Configura il modulo adattivo per la precompilazione dei valori dal database

Esegui la procedura seguente per configurare il modulo adattivo per la precompilazione dei valori dal database MYSQL in base alla chiave primaria definita nella tabella (in questo caso, invia un messaggio e-mail):

Puoi scaricare il modulo adattivo convertito di esempio utilizzando:

Ottieni file