Självstudiekurs: Skapa formulärdatamodell tutorial-create-form-data-model

04-skapa-formulär-data-modell-main

Den här självstudiekursen är ett steg i Skapa ditt första adaptiva formulär serie. Adobe rekommenderar att du följer serien i kronologisk ordning för att förstå, utföra och demonstrera det fullständiga självstudiekursen.

Om självstudiekursen about-the-tutorial

AEM Forms Med dataintegreringsmodulen kan du skapa en formulärdatamodell från olika backend-datakällor som AEM användarprofil, RESTful web services, SOAP-baserade webbtjänster, OData services och relationsdatabaser. Du kan konfigurera datamodellsobjekt och datatjänster i en formulärdatamodell och koppla den till ett anpassat formulär. Anpassningsbara formulärfält är bundna till objektegenskaper för datamodell. Med tjänsterna kan du förifylla det adaptiva formuläret och skriva skickade formulärdata tillbaka till datamodellobjektet.

Mer information om integration av formulärdata och formulärdatamodell finns i AEM Forms dataintegrering.

I den här självstudiekursen får du hjälp med att förbereda, skapa, konfigurera och associera en formulärdatamodell med ett adaptivt formulär. I slutet av den här självstudiekursen kan du:

Formulärdatamodellen ser ut ungefär så här:

form-data-model_l

S. Konfigurerade datakällor B. Datakällscheman C. Tillgängliga tjänster D. Datamodellsobjekt E. Konfigurerade tjänster

Förutsättningar prerequisites

Kontrollera att du har följande innan du börjar:

Steg 1: Konfigurera MySQL-databasen som datakälla config-database

Du kan konfigurera olika typer av datakällor för att skapa en formulärdatamodell. I den här självstudiekursen konfigurerar du MySQL-databasen som du har konfigurerat och fyllt i med exempeldata. Mer information om andra datakällor som stöds och hur du konfigurerar dem finns i AEM Forms dataintegrering.

Gör följande för att konfigurera MySQL databas:

  1. Installera JDBC-drivrutin för MySQL databas som ett OSGi-paket:

    1. Ladda ned MySQL JDBC Driver OSGi Bundle från http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.html.

    2. Logga in på AEM Author-instansen som administratör och gå till AEM Forms webbkonsolpaket. Standard-URL:en är https://localhost:4502/system/console/bundles.

    3. Välj Install/Update. En Upload / Install Bundles dialogruta visas.

    4. Välj Choose File för att bläddra och välja MySQL JDBC driver OSGi bundle. Välj Start Bundle och Refresh Packages och markera Install or Update. Se till att Oracle Corporation’s JDBC Driver för MySQL är aktivt. Drivrutinen är installerad.

  2. Konfigurera MySQL databas som en datakälla:

    1. Gå till AEM webbkonsol på https://localhost:4502/system/console/configMgr.

    2. Sök Poolad datakälla för Apache Sling-anslutning konfiguration. Välj det här alternativet om du vill öppna konfigurationen i redigeringsläge.

    3. Ange följande information i konfigurationsdialogrutan:

      • Datakällans namn: Du kan ange vilket namn som helst. Ange till exempel WeRetailMySQL.
      • Egenskapsnamn för DataSource-tjänst: Ange namnet på den tjänsteegenskap som innehåller namnet på datakällan. Den anges när datakällinstansen registreras som OSGi-tjänst. Till exempel: datakälla.namn.
      • JDBC-drivrutinsklass: Ange Java™-klassnamn för JDBC-drivrutinen. För MySQL databas anger du com.mysql.jdbc.Driver.
      • URI för JDBC-anslutning: Ange anslutnings-URL för databasen. För MySQL databas som körs på port 3306 och schema weretailär URL jdbc:mysql://'server':3306/weretail?autoReconnect=true&useUnicode=true&characterEncoding=utf-8
      note note
      NOTE
      När MySQL databasen ligger bakom en brandvägg och databasens värdnamn är inte en publik DNS. IP-adressen för databasen måste läggas till i filen /etc/hosts på AEM.
      • Användarnamn: Databasens användarnamn. Det krävs för att JDBC-drivrutinen ska kunna upprätta en anslutning till databasen.
      • Lösenord: Lösenord för databasen. Det krävs för att JDBC-drivrutinen ska kunna upprätta en anslutning till databasen.
      note note
      NOTE
      AEM Forms stöder inte NT Authentication för MySQL. Gå till AEM webbkonsol på https://localhost:4502/system/console/configMgr och söka efter "Apache Sling Connection Pooled Datasource". Ange värdet för IntegratedSecurity som False för egenskapen JDBC-anslutningsadress (URI) och använd det användarnamn och lösenord som skapas för att ansluta med MySQL databas.
      • Test on Borgo: Aktivera Test on Borrow alternativ.

      • Test vid retur: Aktivera Test on Return alternativ.

      • Valideringsfråga: Ange en SELECT-fråga (SQL) för att validera anslutningar från poolen. Frågan måste returnera minst en rad. Till exempel: välj * från kundinformation.

      • Transaktionsisolering: Ange värdet till READ_COMMTED.

        Lämna övriga egenskaper som standard values och markera Save.

        En konfiguration som liknar följande skapas.

        relational-database-data-source-configuration

Steg 2: Skapa formulärdatamodell create-fdm

AEM Forms har ett intuitivt användargränssnitt för att skapa en formulärdatamodell från konfigurerade datakällor. Du kan använda flera datakällor i en formulärdatamodell. I det här användningsfallet kan du använda den konfigurerade MySQL datakällan.

Gör så här för att skapa en formulärdatamodell:

  1. I AEM författarinstans går du till Forms > Data Integrations.

  2. Välj Create > Form Data Model.

  3. I dialogrutan Skapa formulärdatamodell anger du name för formulärdatamodellen. Till exempel: kundleveransfaktureringsinformation. Välj Next.

  4. På skärmen Välj datakälla visas alla konfigurerade datakällor. Välj WeRetailMySQL datakälla och markera Create.

    datakälla-val

The kundleveransfaktureringsinformation formulärdatamodellen skapas.

Steg 3: Konfigurera formulärdatamodell config-fdm

I konfigurationen av formulärdatamodellen ingår:

  • lägga till datamodellobjekt och datatjänster
  • konfigurera läs- och skrivtjänster för datamodellobjekt

Gör följande för att konfigurera formulärdatamodellen:

  1. Navigera AEM författarinstansen till Forms > Data Integrations. Standardwebbadressen är https://localhost:4502/aem/forms.html/content/dam/formsanddocuments-fdm.

  2. The kundleveransfaktureringsinformation formulärdatamodellen som du skapade tidigare visas här. Öppna den i redigeringsläge.

    Den valda datakällan WeRetailMySQL har konfigurerats i formulärdatamodellen.

    default-fdm

  3. Expandera trädet för datakällan WeRailMySQL. Välj följande datamodellsobjekt och -tjänster från weretail > kundinformation schema så att du kan skapa datamodell:

    • Datamodellsobjekt:

      • id
      • name
      • shippingAddress
      • stad
      • läge
      • Postnummer
    • Tjänster:

      • uppdatera

    Välj Lägg till markerade om du vill lägga till markerade datamodellsobjekt och tjänster i formulärdatamodellen.

    WeRetail Schema

    note note
    NOTE
    Standardtjänsterna för hämtning, uppdatering och infogning av JDBC-datakällor levereras med formulärdatamodell direkt.
  4. Konfigurera läs- och skrivtjänster för datamodellobjektet.

    1. Välj kundinformation datamodellsobjekt och markera Edit Properties.

    2. Välj get från listrutan Lästjänst. The id -argument, som är primärnyckeln i datamodellobjektet för kundinformation, läggs till automatiskt. Välj aem_6_3_edit och konfigurera argumentet enligt följande.

      read-default

    3. På samma sätt kan du markera update som skrivtjänst. The kundinformation -objektet läggs automatiskt till som ett argument. Argumentet är konfigurerat enligt följande.

      write-default

      Lägg till och konfigurera id argumentet enligt följande.

      id-arg

    4. Välj Done om du vill spara datamodellens objektegenskaper. Välj Save sedan för att spara formulärdatamodellen.

      Tjänsterna get och update läggs till som standardtjänster för datamodellsobjektet.

      data-modell-objekt

  5. Gå till Services och konfigurera get och update tjänster.

    1. Välj get service och välj Edit Properties. Dialogrutan Egenskaper öppnas.

    2. Ange följande i dialogrutan Redigera egenskaper:

      • Titel: Ange tjänstens titel. Exempel: Hämta leveransadress.

      • Beskrivning: Ange en beskrivning som innehåller detaljerad funktionalitet för tjänsten. Till exempel:

        Den här tjänsten hämtar leveransadressen och annan kundinformation från MySQL databas

      • Objekt för utdatamodell: Välj schema som innehåller kunddata. Till exempel:

        kundinformationsschema

      • Returnera matris: Inaktivera Returnera matris alternativ.

      • Argument: Välj argument med namnet ID.

      Välj Done. Tjänsten för att hämta kundinformation från MySQL-databasen har konfigurerats.

      leveransadress-hämtning

    3. Välj update service och välj Edit Properties. Dialogrutan Egenskaper öppnas.

    4. Ange följande i dialogrutan Edit Properties dialog:

      • Titel: Ange tjänstens titel. Exempel: Uppdatera leveransadress.

      • Beskrivning: Ange en beskrivning som innehåller detaljerad funktionalitet för tjänsten. Till exempel:

        Den här tjänsten uppdaterar leveransadress och relaterade fält i MySQL-databasen

      • Indatamodellsobjekt: Välj schema som innehåller kunddata. Till exempel:

        kundinformationsschema

      • Utdatatyp: Välj BOOLEAN.

      • Argument: Välj argumentnamn ID och kundinformation.

      Välj Done. The update tjänst för att uppdatera kundinformation i MySQL databasen är konfigurerad.

      leveransadress-uppdatering

Datamodellsobjektet och -tjänsterna i formulärdatamodellen har konfigurerats. Nu kan du testa formulärdatamodellen.

Steg 4: Testa formulärdatamodell test-fdm

Du kan testa datamodellsobjektet och datatjänsterna för att verifiera att formulärdatamodellen är korrekt konfigurerad.

Gör följande för att köra testet:

  1. Gå till Model väljer du kundinformation datamodellsobjekt, och markera Test Model Object.

  2. I Test Model/Service fönster, markera Read model object från Select Model/Service nedrullningsbar meny.

  3. I kundinformation anger du ett värde för id argument i den konfigurerade MySQL databas och markera Test.

    Kundinformationen som är kopplad till det angivna ID:t hämtas och visas i Output som visas nedan.

    test-read-model

  4. På samma sätt kan du testa Write-modellobjektet och tjänsterna.

    I följande exempel uppdaterar uppdateringstjänsten adressinformationen för ID 7102715 i databasen.

    test-write-model

    Om du testar läsmodelltjänsten igen för ID 7107215 hämtas och visas den uppdaterade kundinformationen enligt nedan.

    läsuppdaterad

NOTE
Du kan skapa och använda SharePoint List-konfigurationen med hjälp av formulärdatamodellen i ett adaptivt formulär för att spara data eller skapa ett postdokument i en SharePoint-lista. Se Ansluta ett anpassat formulär till Microsoft® SharePoint List, för detaljerade steg.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2