Kontrollera och aktivera adaptiva Forms Core-komponenter enable-headless-adaptive-forms-on-aem-forms-cloud-service
Adaptiva Forms Core-komponenter och Headless Adaptive Forms är redan aktiverade för de flesta AEM Forms as a Cloud Service-kunder. På så sätt kan du skapa, publicera och leverera Core Components-baserade Adaptive Forms och Headless Forms med AEM Forms Cloud Service-instanser i flera kanaler.
Kontrollera om adaptiva Forms Core-komponenter är aktiverade check-if-enabled
Innan du följer några aktiveringssteg ska du kontrollera om adaptiva Forms Core-komponenter redan är aktiverade för din miljö:
För nya AEM Forms as a Cloud Service-program
När du skapar ett nytt AEM Forms as a Cloud Service-program är adaptiva Forms Core-komponenter och Headless Adaptive Forms redan aktiverade för din miljö.
För Cloud Service befintliga miljöer
Om din befintliga Cloud Service-miljö innehåller alternativet att skapa Core Components-baserade Adaptive Forms är adaptiva Forms Core-komponenter och Headless Adaptive Forms redan aktiverade för din miljö.
Verifiera genom att kontrollera din databas
Så här bekräftar du att adaptiva Forms Core-komponenter är aktiverade för din miljö:
-
Klona AEM Forms as a Cloud Service-arkivet.
-
Öppna
[AEM Repository Folder]/all/pom.xml
-filen för din AEM Forms Cloud Service Git-databas. -
Sök efter följande beroenden:
- core-forms-components-af-core
- core-forms-components-core
- core-forms-components-apps
- core-forms-components-af-apps
- core-forms-components-examples-apps
- core-forms-components-examples-content
Om det finns sådana beroenden aktiveras adaptiva Forms Core-komponenter för din miljö.
När manuell aktivering krävs when-manual-enablement-needed
Endast om du har ett äldre Forms as a Cloud Service-program där kärnkomponenter inte är aktiverade (bekräftas av kryssrutan ovan) måste du manuellt lägga till adaptiva Forms Core-komponentberoenden i din AEM as a Cloud Service-databas och distribuera databasen till dina Cloud Service-miljöer.
note warning |
---|
WARNING |
Följ bara de här stegen om verifieringskontrollen ovan bekräftar att adaptiva Forms Core-komponenter INTE är aktiverade för din miljö. |
Utför följande steg i listad ordning för att aktivera adaptiva Forms Core-komponenter och Headless Adaptive Forms för en AEM Forms as a Cloud Service-miljö:
1. Klona din AEM Forms as a Cloud Service Git-databas clone-git-repository
-
Logga in på Cloud Manager och välj organisation och program.
-
Gå till pipelines-kortet på sidan Programöversikt och klicka på knappen Åtkomstrepoinformation för att få tillgång till och hantera din Git-databas. Sidan innehåller följande information:
- URL till Cloud Manager Git-databasen.
- Autentiseringsuppgifter för Git-databasen (användarnamn och lösenord) Git-användarnamn.
Klicka på Generera lösenord för att visa eller generera lösenordet.
-
Öppna terminalen eller kommandotolken på den lokala datorn och kör följande kommando:
code language-shell git clone [Git Repository URL]
Ange inloggningsuppgifterna när du uppmanas att göra det. Databasen klonas till din lokala dator.
2. Lägg till adaptiva Forms Core-komponentberoenden i Git-databasen add-adaptive-forms-core-components-dependencies
-
Öppna Git-databasmappen i en kodredigerare för oformaterad text. Exempel: VS-kod.
-
Öppna filen
[AEM Repository Folder]\pom.xml
för redigering. -
Ersätt versioner av komponenterna
core.forms.components.version
,core.forms.components.af.version
ochcore.wcm.components.version
med versioner som anges i dokumentationen för kärnkomponenter. Om komponenten inte finns lägger du till dessa komponenter.code language-xml <!-- Replace the version with the latest released version at https://github.com/adobe/aem-core-forms-components/tags --> <properties> <core.wcm.components.version>2.22.10</core.wcm.components.version> <core.forms.components.version>2.0.18</core.forms.components.version> <core.forms.components.af.version>2.0.18</core.forms.components.af.version> </properties>
-
Lägg till följande beroenden i avsnittet Beroenden i filen
[AEM Repository Folder]\pom.xml
och spara filen.code language-xml <!-- WCM Core Component Examples Dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <version>${core.wcm.components.version}</version> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <version>${core.wcm.components.version}</version> <type>zip</type> </dependency> <!-- End of WCM Core Component Examples Dependencies --> <!-- Forms Core Component Dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <version>${core.forms.components.version}</version> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <version>${core.forms.components.version}</version> </dependency> <!-- End of AEM Forms Core Component Dependencies -->
-
Öppna filen
[AEM Repository Folder]/all/pom.xml
för redigering. Lägg till följande beroenden i avsnittet<embeddeds>
och spara filen.code language-xml <!-- WCM Core Component Examples Dependencies --> <!-- inside plugin config of filevault-package-maven-plugin --> <!-- embed wcm core components examples artifacts --> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <!-- embed forms core components artifacts --> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> <target>/apps/${appId}-vendor-packages/application/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded> <embedded> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> <target>/apps/${appId}-vendor-packages/content/install</target> </embedded>
note note NOTE Ersätt ${appId}
med ditt appId.Om du vill hitta din ${appId}
söker du efter termen[AEM Repository Folder]/all/pom.xml
i filen-packages/application/install
. Texten före termen-packages/application/install
är din${appId}
. Följande kod,myheadlessform
, är till exempel${appId}
.code language-none com.myheadlessform myheadlessform.ui.apps zip /apps/myheadlessform-packages/application install
-
Lägg till följande beroenden i
<dependencies>
-delen av filen[AEM Repository Folder]/all/pom.xml
och spara filen:code language-xml <!-- Other existing dependencies --> <!-- wcm core components examples dependencies --> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.config</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.cq</groupId> <artifactId>core.wcm.components.examples.ui.content</artifactId> <type>zip</type> </dependency> <!-- forms core components dependencies --> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-apps</artifactId> <type>zip</type> </dependency> <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-examples-content</artifactId> <type>zip</type> </dependency>
-
Öppna
[AEM Repository Folder]/ui.apps/pom.xml
för redigering. Lägg tillaf-core bundle
-beroendet och spara filen.code language-xml <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>
note note NOTE Kontrollera att följande adaptiva Forms Core Components-artefakter inte ingår i ditt projekt. <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-apps</artifactId>
</dependency>
och <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-core</artifactId>
</dependency>
-
Spara och stäng filen.
3. Skapa och distribuera den uppdaterade koden
Distribuera den uppdaterade koden till din lokala utveckling och Cloud Service-miljöer för att aktivera Core Components i båda miljöerna:
-
Skapa och distribuera uppdaterad kod i en lokal utvecklingsmiljö (AEM as a Cloud Service SDK)
-
Skapa och driftsätt uppdaterad kod i en AEM Forms as a Cloud Service-miljö
Skapa och distribuera uppdaterad kod i en lokal utvecklingsmiljö core-components-on-aem-forms-local-sdk
-
Öppna kommandotolken eller terminalen.
-
Navigera till rotkatalogen för Git-databasprojektet.
-
Kör följande kommando för att skapa paketet för din miljö:
code language-shell mvn clean install
När paketet har skapats finns det i [Git-databasmappen]\all\target[appid].all-[version].zip
-
Använd Package Manager för att distribuera [AEM Archetype-projektmappen]\all\target[appid].all-[version].zip-paketet på den lokala utvecklingsmiljön.
Skapa och driftsätt uppdaterad kod i en AEM Forms as a Cloud Service-miljö core-components-on-aem-forms-cs
-
Öppna terminalen eller kommandotolken.
-
Navigera till
[AEM Repository Folder]
och kör följande kommandon i den ordning som visascode language-shell git add pom.xml git add all/pom.xml git add ui.apps/pom.xml git commit -m "Added dependencies for Adaptive Forms Core Components" git push origin
-
Kör pipeline när filerna har implementerats i Git-databasen.
När pipeline-körningen har slutförts aktiveras adaptiva Forms Core-komponenter för motsvarande miljö. Dessutom har en adaptiv Forms-mall (Core Components) och Canvas 3.0-temat lagts till i din Forms as a Cloud Service-miljö, med alternativ för att anpassa och skapa Core Components-baserade Adaptive Forms.
Vanliga frågor faq
Vad är kärnkomponenter? core-components
Kärnkomponenterna är en uppsättning standardiserade WCM-komponenter (Web Content Management) för AEM som snabbar upp utvecklingstiden och minskar underhållskostnaderna för dina webbplatser.
Vilka funktioner finns det för att aktivera kärnkomponenter? core-components-capabilities
När de adaptiva Forms Core-komponenterna är aktiverade för din miljö läggs en tom Core Components-baserad Adaptive Form-mall och Canvas 3.0-tema till i din miljö. När du har aktiverat adaptiva Forms Core-komponenter för din miljö kan du:
- Skapa grundkomponenter baserade på adaptiv Forms.
- Skapa kärnkomponentbaserade adaptiva formulärmallar.
- Skapa anpassade teman för grundkomponentbaserade adaptiva formulärmallar.
- Servera Core Component-baserade adaptive Form-baserade JSON-representationer för kanaler som mobiler, webben, inbyggda appar och tjänster som kräver ett formulärs rubrikfria representation.
Hur vet jag om jag behöver aktivera adaptiva Forms Core-komponenter manuellt? manual-enablement-needed-faq
De flesta kunder har redan aktiverat adaptiva Forms Core-komponenter. Du behöver bara aktivera dem manuellt om:
- Du har ett äldre Forms as a Cloud Service-program som skapats innan Core Components inkluderades automatiskt
- Verifieringskontrollen i avsnittet Kontrollera om adaptiva Forms Core-komponenter är aktiverade bekräftar att nödvändiga beroenden saknas i din databas
Om du är osäker följer du verifieringsstegen i avsnittet Kontrollera om adaptiva Forms Core-komponenter är aktiverade ovan.
Varför kan inte kärnkomponentbaserade formulär återges i projekt?
Core Component-baserade formulär kan misslyckas med att återges på grund av en versionskonflikt mellan Forms Core Components-paketet och den version som ingår i projektets arketyp. Det här problemet inträffar oftast när den version som anges i projekttypen är lika med eller högre än den version som paketeras med Forms Core Components-paketet. Gör något av följande för att lösa problemet:
- Använd en lägre version av Forms Core Components-paketet i projektets arkityp.
- Ta bort Forms Core Components-beroendet från projekttypen eftersom den version som krävs redan ingår i AEM as a Cloud Service. Forms Core Components-paketet paketeras med AEM som ett molnbaserat SDK från och med version 2013, till exempel
AEM SDK v2025.3.20133.20250325T063357Z-250300
.