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

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

Den här självstudiekursen är ett steg i serien Create Your First Adaptive Form . 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

Med AEM Forms-dataintegreringsmodulen kan du skapa en formulärdatamodell från olika backend-datakällor som AEM användarprofil, RESTful-webbtjänster, SOAP webbtjänster, OData-tjänster 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 integrering 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

A. Konfigurerade datakällor B. Datakällscheman C. Tillgängliga tjänster D. Datamodellobjekt 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 din MySQL-databas:

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

    1. Hämta MySQL OSGi-paket med JDBC-drivrutin från http://www.java2s.com/ref/jar/download-orgosgiservicejdbc100jar-file.html.

    2. Logga in på AEM Forms Author-instansen som administratör och gå till AEM 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 om du vill bläddra och välja MySQL OSGi-paketet för JDBC-drivrutinen. Välj Start Bundle och Refresh Packages och välj Install or Update. Kontrollera att JDBC-drivrutinen Oracle Corporation’s för MySQL är aktiv. Drivrutinen är installerad.

  2. Konfigurera databasen MySQL som en datakälla:

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

    2. Leta reda på konfigurationen för Apache Sling Connection Pooled DataSource. Välj det här alternativet om du vill öppna konfigurationen i redigeringsläge.

    3. Ange följande information i konfigurationsdialogrutan:

      • Namn på datakälla: Du kan ange vilket namn som helst. Ange till exempel WeRetailMySQL.
      • Egenskapsnamn för DataSource-tjänsten: Ange namnet på den tjänsteegenskap som innehåller namnet på DataSource. 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.
      • JDBC-anslutnings-URI: Ange anslutnings-URL för databasen. För MySQL-databaser 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 databasen MySQL ligger bakom en brandvägg är databasvärdnamnet inte en publik DNS. Databasens IP-adress 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-autentisering för MySQL. Gå till AEM webbkonsol på https://localhost:4502/system/console/configMgr och sök efter Apache Sling Connection Pooled Datasource. För egenskapen JDBC-anslutning-URI anger du värdet för IntegratedSecurity som False och använder det skapade användarnamnet och lösenordet för att ansluta till databasen MySQL.
      • Testa vid köp: Aktivera alternativet Test on Borrow.

      • Testa vid retur: Aktivera alternativet Test on Return.

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

      • Transaktionsisolering: Ange värdet READ_COMMTED.

        Lämna övriga egenskaper med standardvärdena ochoch välj 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 ett namn för formulärdatamodellen. Exempel: kundleveransfaktureringsinformation. Välj Next.

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

    data-source-selection

Formulärdatamodellen Customer-shipping-billing-details har skapats.

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. Formulärdatamodellen Customer-shipping-billing-details 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 schemat werdetail > customer details så att du kan skapa en formulärdatamodell:

    • Datamodellsobjekt:

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

      • uppdatera

    Välj Lägg till markerad 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. Markera datamodellobjektet kundinformation och välj Edit Properties.

    2. Välj get i listrutan Lästjänst. Argumentet id, som är den primära nyckeln i datamodellobjektet för kundinformation, läggs till automatiskt. Välj aem_6_3_edit och konfigurera argumentet enligt följande.

      read-default

    3. Välj på liknande sätt update som skrivtjänst. Objektet customerdetails läggs automatiskt till som ett argument. Argumentet är konfigurerat enligt följande.

      write-default

      Lägg till och konfigurera argumentet id 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 fliken Services och konfigurera get- och update-tjänster.

    1. Välj tjänsten get 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 databasen MySQL

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

        kundinformationsschema

      • Returmatris: Inaktivera alternativet Retur-matris.

      • Argument: Välj argument med namnet ID.

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

      shiiping-address-retrieval

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

    4. Ange följande i dialogrutan Edit Properties:

      • 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

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

        kundinformationsschema

      • Utdatatyp: Välj BOOLEAN.

      • Argument: Välj argumentnamnet ID och kundinformation.

      Välj Done. Tjänsten update för att uppdatera kundinformation i databasen MySQL har konfigurerats.

      shiiping-address-update

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 fliken Model, markera datamodellobjektet customerdetails och välj Test Model Object.

  2. I fönstret Test Model/Service väljer du Read model object i listrutan Select Model/Service.

  3. I avsnittet kundinformation anger du ett värde för argumentet id som finns i den konfigurerade MySQL-databasen och väljer Test.

    Kundinformationen som är kopplad till det angivna ID:t hämtas och visas i avsnittet Output enligt 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. Mer information finns i Ansluta ett adaptivt formulär till Microsoft® SharePoint List.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2