Comprobación y activación de los componentes principales de Forms adaptable enable-headless-adaptive-forms-on-aem-forms-cloud-service
Los componentes principales de Forms adaptable y Forms adaptable sin encabezado ya están habilitados para la mayoría de los clientes de AEM Forms as a Cloud Service. Esto le permite crear, publicar y ofrecer Forms adaptable y Forms sin encabezado basados en componentes principales mediante las instancias de Cloud Service de AEM Forms en varios canales.
Comprobar si los componentes principales de Forms adaptable están habilitados check-if-enabled
Antes de seguir los pasos de habilitación, compruebe si los componentes principales de Forms adaptable ya están habilitados para su entorno:
Para nuevos programas de AEM Forms as a Cloud Service
Al crear un nuevo programa de AEM Forms as a Cloud Service, los componentes principales de Forms adaptable y el Forms adaptable sin encabezado ya están habilitados para su entorno.
Para entornos de Cloud Service existentes
Si su entorno de Cloud Service existente proporciona la opción de crear Forms adaptable basado en componentes principales, los componentes principales de Forms adaptable y Forms adaptable sin encabezado ya están habilitados para su entorno.
Verifique comprobando su repositorio
Para confirmar que los componentes principales de Forms adaptable están habilitados para su entorno:
-
Clone su repositorio de AEM Forms as a Cloud Service.
-
Abra el archivo
[AEM Repository Folder]/all/pom.xml
del repositorio de Git del Cloud Service de AEM Forms. -
Busque las siguientes dependencias:
- 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
Si existen estas dependencias, los componentes principales de Forms adaptable se habilitan para su entorno.
Cuando se necesita la activación manual when-manual-enablement-needed
Solo si tiene un programa Forms as a Cloud Service antiguo en el que los componentes principales no están activados (confirmado por la comprobación anterior), debe añadir manualmente las dependencias de los componentes principales de Forms adaptables al repositorio de AEM as a Cloud Service e implementar el repositorio en los entornos de Cloud Service.
note warning |
---|
WARNING |
Solo siga estos pasos si la comprobación de verificación anterior confirma que los componentes principales de Forms adaptable NO están habilitados para su entorno. |
Realice los siguientes pasos, en el orden indicado, para habilitar los componentes principales de Forms adaptable y Forms adaptable sin encabezado para un entorno de as a Cloud Service de AEM Forms:
1. Clone su repositorio de Git de AEM Forms as a Cloud Service clone-git-repository
-
Inicie sesión en Cloud Manager y seleccione su organización y programa.
-
Vaya a la tarjeta Canalizaciones de la página Información general del programa y haga clic en el botón Acceder a la info del repositorio para acceder y administrar su repositorio de Git. La página incluye la siguiente información:
- La dirección URL del repositorio de Git de Cloud Manager.
- Credenciales del nombre de usuario del repositorio de Git (nombre de usuario y contraseña).
Haga clic en Generar contraseña para ver o generar la contraseña.
-
Abra el terminal o el símbolo de comando en el equipo local de su ordenador y ejecute el siguiente comando:
code language-shell git clone [Git Repository URL]
Cuando se le solicite, proporcione las credenciales. El repositorio se clona en su ordenador local.
2. Añadir dependencias de componentes principales de formularios adaptables al repositorio de Git add-adaptive-forms-core-components-dependencies
-
Abra la carpeta del repositorio de Git en un editor de código de texto sin formato. Por ejemplo, VS Code.
-
Abra el archivo
[AEM Repository Folder]\pom.xml
para editarlo. -
Reemplazar versiones de
core.forms.components.version
,core.forms.components.af.version
ycore.wcm.components.version
componentes con versiones especificadas en documentación de componentes principales. Si el componente no existe, añada estos componentes.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>
-
En la sección de dependencias del archivo
[AEM Repository Folder]\pom.xml
, agregue las siguientes dependencias y guarde el archivo.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 -->
-
Abra el archivo
[AEM Repository Folder]/all/pom.xml
para editarlo. Agregue las siguientes dependencias en la sección<embeddeds>
y guarde el archivo.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 Reemplace ${appId}
con su appId.Para encontrar su ${appId}
, en el archivo[AEM Repository Folder]/all/pom.xml
, busque el término-packages/application/install
. El texto antes del término-packages/application/install
es su${appId}
. Por ejemplo, el siguiente código,myheadlessform
es${appId}
.code language-none com.myheadlessform myheadlessform.ui.apps zip /apps/myheadlessform-packages/application install
-
En la
<dependencies>
sección del archivo[AEM Repository Folder]/all/pom.xml
, agregue las siguientes dependencias y guarde el archivo: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>
-
Abra
[AEM Repository Folder]/ui.apps/pom.xml
para editarlo. Añada la dependenciaaf-core bundle
y guarde el archivo.code language-xml <dependency> <groupId>com.adobe.aem</groupId> <artifactId>core-forms-components-af-core</artifactId> </dependency>
note note NOTE Asegúrese de que los siguientes artefactos de componentes principales de formularios adaptables no estén incluidos en el proyecto. <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-apps</artifactId>
</dependency>
y <dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>core-forms-components-core</artifactId>
</dependency>
-
Guarde y cierre el archivo.
3. Genere e implemente el código actualizado
Implemente el código actualizado en sus entornos de desarrollo local y de Cloud Service para habilitar los componentes principales en ambos entornos:
Genere e implemente el código actualizado en un entorno de desarrollo local core-components-on-aem-forms-local-sdk
-
Abra el símbolo de comando o el terminal.
-
Vaya al directorio raíz del proyecto del repositorio de Git.
-
Ejecute el siguiente comando para generar el paquete para su entorno:
code language-shell mvn clean install
Una vez que el paquete se haya creado correctamente, puede encontrarlo en la [Carpeta del repositorio de Git]\all\target[appid].all-[version].zip
-
Utilice el Administrador de paquetes para implementar la [Carpeta de proyecto arquetipo AEM]\all\target[appid].all-[version]paquete .zip en el entorno de desarrollo local.
Genere e implemente el código actualizado en un entorno as a Cloud Service de AEM Forms core-components-on-aem-forms-cs
-
Abra el terminal o el símbolo del comando.
-
Navegue hasta su
[AEM Repository Folder]
y ejecute los siguientes comandos en el orden indicadocode 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
-
Una vez que los archivos se hayan confirmado en el repositorio de Git, Ejecute la canalización.
Una vez que la ejecución de la canalización se haya realizado correctamente, los componentes principales de formularios adaptables se habilitan para el entorno correspondiente. Además, se añade una plantilla de formularios adaptables (componentes principales) y una temática de Canvas 3.0 al entorno as a Cloud Service de formularios, lo que le proporciona opciones para personalizar y crear componentes principales basados en formularios adaptables.
Preguntas frecuentes faq
¿Qué son los componentes principales? core-components
Los componentes principales son un conjunto de componentes estandarizados de la administración de contenido web (WCM) para AEM con el objetivo de acelerar el tiempo de desarrollo y reducir el coste de mantenimiento de sus sitios web.
¿Qué capacidades completas se añaden al habilitar los componentes principales? core-components-capabilities
Cuando los componentes principales de formularios adaptables se habilitan para su entorno, se agrega a este una plantilla de formulario adaptable basada en componentes principales en blanco y una temática de Lienzo 3.0. Tras habilitar los componentes principales de formularios adaptables para su entorno, puede:
- Crear componentes principales basados en formularios adaptables.
- Crear componentes principales basados en plantillas de formulario adaptable.
- Crear temáticas personalizadas para componentes principales basadas en plantillas de formulario adaptable.
- Proporcione representaciones JSON de un formulario adaptable basado en componentes principales a canales como mobile, web, apps nativas y servicios que requieren la representación sin encabezado de un formulario.
¿Cómo sé si necesito habilitar manualmente los componentes principales de Forms adaptable? manual-enablement-needed-faq
La mayoría de los clientes ya tienen habilitados los componentes principales de Forms adaptable. Solo es necesario activarlos manualmente en los casos siguientes:
- Tiene un programa as a Cloud Service de Forms anterior creado antes de que los componentes principales se incluyeran automáticamente
- La comprobación de verificación en la sección Comprobar si los componentes principales de Forms adaptables están habilitados confirma que faltan las dependencias requeridas en el repositorio
Si no está seguro, siga los pasos de verificación en la sección Comprobar si los componentes principales de Forms adaptables están habilitados anterior.
¿Por qué los formularios basados en componentes principales no se pueden representar en el proyecto?
Es posible que los formularios basados en componentes principales no se puedan representar debido a una discrepancia de versiones entre el paquete de componentes principales de Forms y la versión incluida en el arquetipo de proyecto. Este problema suele ocurrir cuando la versión especificada en el arquetipo del proyecto es igual o superior a la versión empaquetada con el paquete de componentes principales de Forms. Para resolver este problema, realice una de las siguientes acciones:
- Utilice una versión inferior del paquete de componentes principales de Forms en el arquetipo del proyecto.
- Elimine la dependencia de los componentes principales de Forms del arquetipo del proyecto, ya que la versión requerida ya está incluida con AEM as a Cloud Service. El paquete de componentes principales de Forms está empaquetado con el SDK de AEM as a Cloud a partir de la versión 20133, por ejemplo,
AEM SDK v2025.3.20133.20250325T063357Z-250300
.