Integrera anpassningsbara blanketter med databaser med hjälp av AEM arbetsflöde submit-forms-to-database-using-forms-portal

Med tjänsten Automated forms conversion (AFCS) kan du konvertera ett icke-interaktivt PDF-formulär, ett Acro-formulär eller ett XFA-baserat PDF-formulär till en adaptiv form. När du startar konverteringsprocessen kan du generera ett anpassat formulär antingen med eller utan databindningar.

Om du väljer att generera ett adaptivt formulär utan databindningar kan du integrera det konverterade adaptiva formuläret med en formulärdatamodell, ett XML-schema eller ett JSON-schema efter konverteringen. För formulärdatamodellen måste du binda adaptiva formulärfält manuellt med formulärdatamodellen. Men om du genererar ett adaptivt formulär med databindningar associerar konverteringstjänsten automatiskt adaptiva formulär med ett JSON-schema och skapar en databindning mellan fälten som finns i det adaptiva formuläret och JSON-schemat. Sedan kan du integrera det anpassade formuläret med en valfri databas, fylla i data i formuläret och skicka det till databasen. När integreringen med databasen är klar kan du konfigurera fälten i det konverterade adaptiva formuläret så att de hämtar värden från databasen och fyller i adaptiva formulärfält i förväg.

I följande bild visas olika steg för att integrera ett konverterat adaptivt formulär med en databas:

I den här artikeln beskrivs de stegvisa instruktionerna för att köra alla dessa integrationssteg.

Krav pre-requisites

Exempel på anpassningsbart formulär sample-adaptive-form

Om du vill köra ett användningsexempel för att integrera konverterade adaptiva formulär med en databas med hjälp av ett AEM arbetsflöde hämtar du följande exempelfil i PDF.

Du kan hämta exempelformuläret Kontakta oss med:

Hämta fil

Filen PDF fungerar som indata till tjänsten Automated forms conversion (AFCS). Tjänsten konverterar den här filen till ett anpassat formulär. I följande bild visas det exempel på hur du kontaktar oss i PDF-format.

Installera filen mysql-connector-java-5.1.39-bin.jar install-mysql-connector-java-file

Utför följande steg på alla författare- och publiceringsinstanser för att installera filen mysql-connector-java-5.1.39-bin.jar:

Förbered data för formulärmodellen prepare-data-for-form-model

Med AEM Forms dataintegrering kan du konfigurera och ansluta till olika datakällor. När du har genererat ett anpassat formulär med konverteringsprocessen kan du definiera formulärmodellen baserat på en formulärdatamodell, XSD eller ett JSON-schema. Du kan använda en databas, Microsoft Dynamics eller någon annan tredjepartstjänst för att skapa en formulärdatamodell.

I den här självstudien används MySQL-databasen som källa för att skapa en formulärdatamodell. Skapa ett schema i databasen och lägg till tabellen contactus i schemat baserat på de fält som är tillgängliga i det adaptiva formuläret.

Du kan använda följande DDL-sats för att skapa tabellen contactus i databasen.

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

Konfigurera anslutning mellan AEM och databas configure-connection-between-aem-instance-and-database

Utför följande konfigurationssteg för att skapa en anslutning mellan AEM och MYSQL-databasen:

Skapa formulärdatamodell create-form-data-model

När du har konfigurerat MYSQL som datakälla skapar du en formulärdatamodell på följande sätt:

Du kan hämta exempelformulärdatamodellen med:

Hämta fil

Generera anpassningsbara formulär med JSON-bindning generate-adaptive-forms-with-json-binding

Använd tjänsten Automated forms conversion (AFCS) för att konvertera formuläret Kontakta oss till ett anpassningsbart formulär med databindning. Kontrollera att du inte markerar kryssrutan Generate adaptive form(s) without data bindings när du genererar det adaptiva formuläret.

Markera det konverterade Kontakta oss-formuläret som finns i mappen output i Forms & Documents och tryck på Edit. Tryck på Preview, ange värden i de adaptiva formulärfälten och tryck på Submit.

Logga in på crx-database och navigera till /content/forms/fp/admin/submit/data för att visa skickade värden i JSON-format. Följande är exempeldata i JSON-format när du skickar den konverterade adaptiva formen Kontakta oss:

{
  "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"
    }
  }
}

Du måste skapa en arbetsflödesmodell nu som kan bearbeta dessa data och skicka dem till MYSQL-databasen med den formulärdatamodell som du har skapat i de föregående avsnitten.

Skapa en arbetsflödesmodell för att bearbeta JSON-data create-workflow-model

Utför följande steg för att skapa en arbetsflödesmodell och skicka data i anpassade formulär till databasen:

Konfigurera adaptiv formuläröverföring configure-adaptive-form-submission

Utför följande steg för att skicka det adaptiva formuläret till arbetsflödesmodellen som du skapade i föregående avsnitt:

Konfigurera anpassningsbara formulär för förifyllningsvärden från databasen

Utför följande steg för att konfigurera adaptiva formulär till förifyllda värden från MYSQL-databasen baserat på den primärnyckel som definieras i tabellen (i det här fallet e-post):

Du kan hämta det konverterade adaptiva exempelformuläret med:

Hämta fil