Skapa formulärdatamodell (FDM) create-form-data-model
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.
Skapa formulärdatamodell (FDM) data-sources
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 update
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.
Kontextmedvetna konfigurationer för specifika körningslägen runmode-specific-context-aware-config
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.
- Skapa paket med filter
/conf/{foldername}/settings/cloudconfigs/fdm
. Använd samma{foldername}
som i steg 1. Och ersättfdm
medazurestorage
för Azure-lagringskonfigurationen. - Skapa och hämta paket. Mer information finns i paketåtgärder.
- Skapa paket med filter
-
Integrera molnkonfigurationen i Experience Manager-arkitekturprojektet.
- Zippa upp det hämtade paketet.
- Kopiera mappen
jcr_root
och placera den i mappenui.content
>src
>main
>content
. - 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 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:
-
Konfigurera OSGi-konfigurationsfiler i Experience Manager Archetype-projekt.
Skapa OSGi Factory Configuration-filer med PIDorg.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. -
Ange konfigurationsjson för OSGI. Så här använder du Åsidosättningsprovider för kontextmedveten konfiguration för Apache Sling:
- På den lokala utvecklingsinstansen
/system/console/configMgr
väljer du OSGi-fabrikskonfiguration med namnet Apache Sling Context-Aware Configuration Override Provider: OSGi configuration. - Ange beskrivning.
- Välj enabled.
- 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 +. - Välj Save.
- Följ stegen i Generera OSGi-konfigurationer med AEM SDK QuickStart för att hämta OSGi Configuration JSON.
- Placera JSON i OSGi Factory Configuration Files som skapades i föregående steg.
- Ändra värdet för
newURL
baserat på miljö (eller körläge). - 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 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 att kontextmedvetna konfigurationer är tillgängliga i Service Pack 6.5.13.0. - På den lokala utvecklingsinstansen
-
-
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 next-steps
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.