Dokumentation AEM as a Cloud Service Användarhandbok

Skapa formulärdatamodell (FDM)

Senast uppdaterad: 5 maj 2025

Gäller:
Experience Manager as a Cloud Service

Skapat för:

Nybörjare
Mellanliggande
Användare
Utvecklare

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

Dataintegrering

Dataintegrering för Experience Manager Forms ger ett intuitivt användargränssnitt för att skapa och arbeta med formulärdatamodeller. En formulärdatamodell (FDM) använder datakällor för datautbyte, men du kan skapa en formulärdatamodell (FDM) 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ällor kan du markera dem när du skapar en formulärdatamodell (FDM). 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 (FDM).
Utan datakällor: Om du inte har konfigurerat datakällor för formulärdatamodellen (FDM) kan du fortfarande skapa den utan datakällor. Du kan använda formulärdatamodellen (FDM) för att skapa adaptiv Forms och testa dem med exempeldata. När datakällor är tillgängliga kan du binda formulärdatamodellen (FDM) till datakällor, som automatiskt återspeglas i den associerade adaptiva Forms.

NOTE

Du måste vara medlem i båda grupperna fdm-author och forms-user för att kunna skapa och arbeta med formulärdatamodell (FDM). Kontakta Experience Manager-administratören om du vill bli medlem i grupperna.

Skapa formulärdatamodell (FDM)

Kontrollera att du har konfigurerat de datakällor som du vill använda i formulärdatamodellen (FDM) enligt beskrivningen i Konfigurera datakällor. Så här skapar du en FDM (Form Data Model) baserad på konfigurerade datakällor:

Navigera till Forms > Data Integrations i Experience Manager-författarinstansen.
Välj Create > Form Data Model.
I dialogrutan Skapa formulärdatamodell:
- Ange ett namn för formulärdatamodellen (FDM).
- (Valfritt) Ange rubrik, beskrivning och taggar för formulärdatamodellen (FDM).
- (Valfritt och endast tillämpligt om datakällor har konfigurerats) Markera kryssruteikonen bredvid fältet Data Source Configuration och välj konfigurationsnoden 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. Alla datakällor för användarprofilen i Experience Manager listas som standard. Om du inte väljer en konfigurationsnod visas datakällor från alla konfigurationsnoder.
Välj Next.
(Gäller endast om datakällor har konfigurerats) Skärmen Select Datasource visar eventuella tillgängliga datakällor. Välj de datakällor som du vill använda i formulärdatamodellen.
Välj Create och välj Open i bekräftelsedialogrutan för att öppna redigeraren för formulärdatamodellen.

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

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 (FDM). I verktygsfältet visas fler alternativ beroende på det valda objektet i formulärdatamodellen (FDM).

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

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

Uppdatera datakällor

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

Gå till Forms > Data Integrations, markera den formulärdatamodell (FDM) i vilken du vill lägga till eller uppdatera datakällor och välj Properties.
Gå till fliken Update Source i egenskaperna för formulärdatamodellen.

På fliken Update Source:
- Välj bläddringsikonen i fältet 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 visas molnkonfigurationer som bara finns i noden global när du väljer Add Sources.
- Om du vill lägga till en ny datakälla väljer du Add Sources och markerar de datakällor som ska läggas till i formulärdatamodellen (FDM). Alla datakällor som har konfigurerats i global och den valda konfigurationsnoden (om det finns någon) visas.
- Om du vill ersätta en befintlig datakälla med en annan datakälla av samma typ, väljer du ikonen Edit för datakällan och väljer i listan över tillgängliga datakällor.
- Om du vill ta bort en befintlig datakälla väljer du ikonen Delete för datakällan. Ikonen Ta bort är inaktiverad om ett datamodellsobjekt i datakällan läggs till i formulärdatamodellen (FDM).
Välj Save & Close om du vill spara uppdateringarna.

NOTE

När du har lagt till nya datakällor eller uppdaterat befintliga datakällor i en formulärdatamodell (FDM) måste du uppdatera bindningsreferenserna, beroende på vad som är lämpligt, i Adaptive Forms som använder den uppdaterade formulärdatamodellen (FDM).

Kontextmedvetna konfigurationer för specifika körningslägen

Form Data Model (FDM) använder Sling-kontextmedvetna konfigurationer för att stödja olika datakällparametrar för att ansluta till datakällor för olika Experience Manager-körningslägen.

När Form Data Model (FDM) 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 molnkonfigurationen Form Data Model (FDM) 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.

Så här aktiverar du distributionsspecifika molnkonfigurationer i Form Data Model (FDM):

Skapa molnkonfiguration på den lokala utvecklingsinstansen. Detaljerade steg finns i Konfigurera datakällor.
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-lagringskonfigurationen.
2. Skapa och hämta paket. Mer information finns i paketåtgärder.
Integrera molnkonfigurationen i Experience Manager-arkitekturprojektet.
1. Zippa upp det hämtade paketet.
2. Kopiera mappen jcr_root och placera den i mappen ui.content > src > main > content.
3. Uppdatera ui.content > src > main > content > META-INF > vault > filter.xml för att innehålla filtret /conf/{foldername}/settings/cloudconfigs/fdm. Mer information finns i ui.content-modulen i 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.
Skapa en kontextmedveten konfiguration för Apache Sling. Så här skapar du OSGi-konfigurationen:
1. Konfigurera OSGi-konfigurationsfiler i Experience Manager Archetype-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 Konfigurera OSGi för Adobe Experience Manager.
2. Ange konfigurationsjson för OSGI. Så här använder du Åsidosättningsprovider för kontextmedveten konfiguration för Apache Sling:
  1. På den lokala utvecklingsinstansen /system/console/configMgr vä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. Exempel: cloudconfigs/fdm/{configName}/url="newURL".
    Du kan lägga till flera åsidosättningar genom att välja +.
  5. Välj Save.
  6. Följ stegen i Generera OSGi-konfigurationer med AEM SDK Quickstart för att få OSGi Configuration JSON.
  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 hjälp av molnhanterings-API:t och senare kan refereras i OSGi-konfigurationen.
    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
  Adobe Managed Service-användare kan kryptera de hemliga värdena med krypteringsstöd för mer information, se krypteringsstöd för konfigurationsegenskaper och placera krypterad text i värdet efter att kontextmedvetna konfigurationer är tillgängliga i Service Pack 6.5.13.0.
Uppdatera datakälldefinitionerna med alternativet att uppdatera datakälldefinitionerna i redigeraren för formulärdatamodell för att uppdatera FDM-cachen via FDM-gränssnittet och få den senaste konfigurationen.

Nästa steg

Nu har du en formulärdatamodell (FDM) med datakällor tillagda. Därefter kan du redigera FDM (Form Data Model) 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