Skapa formulärdatamodell create-form-data-model

Version
Artikellänk
AEM 6.5
Klicka här
AEM as a Cloud Service
Den här artikeln

Dataintegrering

Experience Manager Forms dataintegrering ger ett intuitivt användargränssnitt för att skapa och arbeta med formulärdatamodeller. En formulärdatamodell bygger på datakällor för datautbyte, men du kan skapa en formulärdatamodell med eller utan en datakälla. Det finns två sätt att skapa en utifrån datamodell beroende på om du har konfigurerat datakällor:

  • Använda förkonfigurerade datakällor: Om du har konfigurerat datakällor enligt beskrivningen i Konfigurera datakällorkan du markera dem när du skapar en formulärdatamodell. Den hämtar alla datamodellsobjekt, egenskaper och tjänster från de valda datakällorna som är tillgängliga för användning i formulärdatamodellen.

  • Utan datakällor: Om du inte har konfigurerat datakällor för formulärdatamodellen kan du fortfarande skapa den utan datakällor. Du kan använda formulärdatamodellen för att skapa adaptiv Forms och testa dem med exempeldata. När datakällor är tillgängliga kan du binda formulärdatamodellen till datakällor, som automatiskt återspeglas i tillhörande adaptiva Forms.

NOTE
Du måste vara medlem i båda fdm-author och formuläranvändare grupper för att kunna skapa och arbeta med formulärdatamodell. Kontakta Experience Manager administratör för att bli medlem i grupperna.

Skapa formulärdatamodell data-sources

Kontrollera att du har konfigurerat de datakällor som du vill använda i formulärdatamodellen enligt beskrivningen i Konfigurera datakällor. Så här skapar du en formulärdatamodell som baseras på konfigurerade datakällor:

  1. I Experience Manager författarinstans, navigera till Forms > Data Integrations.

  2. Välj Create > Form Data Model.

  3. I dialogrutan Skapa formulärdatamodell:

    • Ange ett namn för formulärdatamodellen.
    • (Valfritt) Ange rubrik, beskrivning och taggar för formulärdatamodellen.
    • (Valfritt och endast tillämpligt om datakällor har konfigurerats) Markera kryssruteikonen bredvid Data Source Configuration och välj den konfigurationsnod där molntjänster för de datakällor som du vill använda finns. Den begränsar listan med datakällor som är tillgängliga för val på nästa sida till de som är tillgängliga i den valda konfigurationsnoden. Men om Experience Manager datakällor för användarprofiler listas som standard. Om du inte väljer en konfigurationsnod visas datakällor från alla konfigurationsnoder.
  4. Välj Next.

  5. (Gäller endast om datakällor har konfigurerats) Select Datasource visas tillgängliga datakällor, om det finns några. Välj de datakällor som du vill använda i formulärdatamodellen.

  6. Välj Create och i bekräftelsedialogrutan väljer Open för att öppna formulärdatamodellredigeraren.

    Låt oss granska de olika komponenterna i användargränssnittet för formulärdatamodellsredigeraren.

    En formulärdatamodell med tre datakällor - en RESTful-tjänst, Experience Manager användarprofil och RDBMS

    S. Data Sources Visar datakällor i en formulärdatamodell. Expandera en datakälla om du vill visa dess datamodellsobjekt och -tjänster.

    B. Refresh Data Source Definitions Hämtar alla ändringar i datakälldefinitioner från konfigurerade datakällor och uppdaterar dem på fliken Datakällor i formulärdatamodellens redigerare.

    C. Model Innehållsområde där tillagda datamodellsobjekt visas.

    D. Services Innehållsområde där tillagda datakällåtgärder eller -tjänster visas.

    E. Toolbar Verktyg för att arbeta med formulärdatamodell. I verktygsfältet visas fler alternativ beroende på vilket objekt som är markerat i formulärdatamodellen.

    F. Add Selected Lägger till markerade datamodellsobjekt och tjänster i formulärdatamodellen.

Mer information om redigeraren för formulärdatamodellen och hur du kan arbeta med den för att redigera och konfigurera formulärdatamodellen finns i Arbeta med formulärdatamodell.

Uppdatera datakällor update

Gör följande för att lägga till eller uppdatera datakällor till en befintlig formulärdatamodell.

  1. Gå till Forms > Data Integrations väljer du den formulärdatamodell i vilken du vill lägga till eller uppdatera datakällor och väljer Properties.

  2. Gå till egenskaperna för formulärdatamodellen Update Source -fliken.

    I Update Source tab:

    • Välj bläddringsikonen i dialogrutan Context-Aware Configuration och välj en konfigurationsnod där molnkonfigurationen för den datakälla som du vill lägga till finns. Om du inte väljer en nod finns molnkonfigurationer endast i global noden visas när du väljer Add Sources.

    • Välj om du vill lägga till en ny datakälla Add Sources och välj datakällor att lägga till i formulärdatamodellen. Alla datakällor konfigurerade i global och den valda konfigurationsnoden (om sådan finns) visas.

    • Om du vill ersätta en befintlig datakälla med en annan datakälla av samma typ väljer du Edit -ikonen för datakällan och välj i listan över tillgängliga datakällor.

    • Om du vill ta bort en befintlig datakälla väljer du Delete -ikon för datakällan. Ikonen Ta bort är inaktiverad om ett datamodellsobjekt i datakällan läggs till i formulärdatamodellen.

      fdm-properties

  3. Välj Save & Close för att spara uppdateringarna.

NOTE
När du har lagt till nya datakällor eller uppdaterat befintliga datakällor i en formulärdatamodell måste du uppdatera bindningsreferenserna, efter behov, i Adaptive Forms som använder den uppdaterade formulärdatamodellen.

Kontextmedvetna konfigurationer för specifika körningslägen runmode-specific-context-aware-config

Form Data Model använder Skicka kontextmedvetna konfigurationer som stöder olika datakällparametrar för att ansluta till datakällor för olika Experience Manager körningslägen.

När Form Data Model använder molnkonfigurationer för att lagra parametrar, som när de checkas in och distribueras via källkontroll (Cloud-Manager GIT-databas) skapar molnkonfiguration med samma parametrar för alla körningslägen (Utveckling, Scen och Produktion). I de fall där det finns behov av olika datauppsättningar för test- och produktionsmiljöer använder vi datakällparametrar (till exempel datakällans URL) för olika Experience Manager körningslägen.

För att uppnå detta måste du skapa en OSGi-konfiguration som innehåller parametrar för datakällans värde. Detta åsidosätter samma par från Form Data Model molnkonfiguration vid körning. Eftersom OSGi-konfigurationerna stöder dessa körningslägen som standard kan du åsidosätta en datakällparameter till olika värden baserat på körningsläge.

Aktivera distributionsspecifika molnkonfigurationer i Form Data Model:

  1. Skapa molnkonfiguration på den lokala utvecklingsinstansen. Detaljerade anvisningar finns i Konfigurera datakällor.

  2. Lagra molnkonfigurationen i filsystemet.

    1. Skapa paket med filter /conf/{foldername}/settings/cloudconfigs/fdm. Använd samma {foldername} som i steg 1. Och ersätt fdm med azurestorage för Azure-lagringskonfiguration.
    2. Skapa och hämta paket. Mer information finns i paketåtgärder.
  3. Integrera molnkonfiguration i Experience Manager Arketype-projekt.

    1. Zippa upp det hämtade paketet.
    2. Kopiera jcr_root och skicka den till ui.content > src > main > content.
    3. Uppdatera ui.content > src > main > content > META-INF > vault > filter.xml innehåller filter /conf/{foldername}/settings/cloudconfigs/fdm. Mer information finns i ui.content-modulen AEM Project Archetype. När detta arkivtypsprojekt distribueras via CM-pipeline installeras samma molnkonfiguration i alla miljöer (eller körningslägen). Om du vill ändra värdet för fält (t.ex. URL) för molnkonfigurationer baserat på miljö använder du OSGi-konfigurationen som beskrivs i följande steg.
  4. Skapa en kontextmedveten konfiguration för Apache Sling. Så här skapar du OSGi-konfigurationen:

    1. Konfigurera OSGi-konfigurationsfiler i Experience Manager Arketype-projekt.
      Skapa OSGi Factory Configuration-filer med PID org.apache.sling.caconfig.impl.override.OsgiConfigurationOverrideProvider. Skapa en fil med samma namn i varje körningslägesmapp där värdena måste ändras för varje körningsläge. Mer information finns i Konfigurerar OSGi för Adobe Experience Manager.

    2. Ställ in OSGI-konfigurationsjson. Så här använder du Åsidosättningsprovider för kontextmedveten konfiguration för Apache Sling:

      1. On local development instance /system/console/configMgrväljer du OSGi-fabrikskonfiguration med namnet Apache Sling Context-Aware Configuration Override Provider: OSGi configuration.
      2. Ange beskrivning.
      3. Välj enabled.
      4. Under overrides anger du fält som behöver ändras baserat på miljön vid sling override syntax. Mer information finns i Kontextmedveten konfiguration för Apache Sling - Åsidosätt. Till exempel: cloudconfigs/fdm/{configName}/url="newURL".
        Du kan lägga till flera åsidosättningar genom att välja +.
      5. Välj Save.
      6. Så här hämtar du OSGi Configuration JSON: Generera OSGi-konfigurationer med AEM SDK QuickStart.
      7. Placera JSON i OSGi Factory Configuration Files som skapades i föregående steg.
      8. Ändra värdet för newURL baserat på miljö (eller körläge).
      9. Om du vill ändra ett hemligt värde baserat på körningsläge kan du skapa en hemlig variabel med API för molnhantering och senare kan refereras i OSGi-konfiguration.
        När det här arketype-projektet distribueras via CM-pipeline, kommer åsidosättning att ge olika värden i olika miljöer (eller körningsläge).
      note note
      NOTE
      Adobe Managed Service användare kan kryptera de hemliga värdena med krypteringsstöd (mer information finns i krypteringsstöd för konfigurationsegenskaper och placera krypterad text i värdet efter Kontextmedvetna konfigurationer finns i Service Pack 6.5.13.0.
  5. Uppdatera datakällsdefinitionerna med alternativet att uppdatera datakällsdefinitionerna i Redigerare för formulärdatamodell för att uppdatera FDM-cachen via FDM-gränssnittet och få den senaste konfigurationen.

Nästa steg next-steps

Nu har du en formulärdatamodell med datakällor tillagda. Därefter kan du redigera formulärdatamodellen för att lägga till och konfigurera datamodellsobjekt och -tjänster, lägga till associationer mellan datamodellsobjekt, redigera egenskaper, lägga till anpassade datamodellsobjekt och egenskaper, generera exempeldata osv.

Mer information finns i Arbeta med formulärdatamodell.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab