Habilitar los componentes principales de los formularios adaptables enable-headless-adaptive-forms-on-aem-forms-cloud-service
Al habilitar los componentes principales de los formularios adaptables en AEM Forms as a Cloud Service, puede empezar a crear, publicar y ofrecer en varios canales los componentes principales basados en formularios adaptables y sin encabezado mediante las instancias de Cloud Service de AEM Forms. Se necesita un entorno habilitado para los componentes principales de formularios adaptables para utilizar formularios adaptables sin encabezado.
Consideraciones
-
Cuando crea un nuevo programa as a Cloud Service de AEM Forms, los componentes principales de formularios adaptables y formularios adaptables sin encabezado ya están habilitados para su entorno.
-
Si tiene un programa as a Cloud Service de formularios anterior en el que los componentes principales estén sin habilitar, puede añadir dependencias de componentes principales de formularios adaptables a su repositorio de AEM as a Cloud Service e implementar el repositorio en los entornos de su Cloud Service para habilitar formularios adaptables sin encabezado.
-
Si su entorno de Cloud Service existente proporciona la opción crear formularios adaptables basados en componentes principales, los componentes principales de formularios adaptables y formularios adaptables sin encabezado ya están habilitados para su entorno. Estos pueden ofrecer formularios adaptables basados en componentes principales, como formularios sin encabezado para canales como móvil, web, aplicaciones nativas y servicios que requieren una representación sin encabezado de formularios adaptables.
Habilitar los componentes principales de formularios adaptables y formularios adaptables sin encabezado enable-headless-forms
Realice los siguientes pasos, en el orden indicado, para habilitar los componentes principales de formularios adaptables y formularios adaptables sin encabezado para un entorno 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 pulse 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).
Pulse 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.
¿Los componentes principales de formularios adaptables están habilitados para mi entorno? enable-components
Para comprobar que los componentes principales de Formularios adaptables están habilitados para su entorno:
-
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 dependencias, los componentes principales de Formularios adaptables se habilitan para su entorno.