Habilitación de formularios adaptables sin encabezado en AEM 6.5 Forms enable-headless-adaptive-forms-on-aem-65-forms
Para habilitar Formularios adaptables sin encabezado en el entorno de AEM 6.5 Forms configure un proyecto basado en el arquetipo 41 o posterior de AEM e impleméntelo en todas las instancias de autor y publicación.
Al implementar el proyecto basado en el arquetipo 41 o posterior en las instancias de AEM 6.5 Forms, puede tener la posibilidad de crear formularios adaptables basados en componentes principales. Estos formularios se representan en formato JSON y se utilizan como formularios adaptables con encabezado y sin encabezado, lo que permite una mayor flexibilidad y personalización en una amplia gama de canales, incluidas aplicaciones móviles, web y nativas.
Requisitos previos prerequisites
Antes de habilitar formularios adaptables sin encabezado en el entorno de AEM 6.5 Forms,
-
Actualizar al Service Pack 16 de AEM 6.5 Forms (6.5.16.0) o posterior.
-
Instalar la última versión de Apache Maven.
-
Instale un editor de texto sin formato. Por ejemplo, Microsoft Visual Studio Code.
Crear e implementar el último proyecto basado en el arquetipo de AEM
Para crear un proyecto basado en el arquetipo de AEM 41 o posterior e implementarlo en todas las instancias de autor y publicación:
-
Inicie sesión en el equipo, aloje y ejecute la instancia de AEM 6.5 Forms como administrador.
-
Abra el símbolo de comando o el terminal.
-
Ejecute el siguiente comando para crear un proyecto basado en el arquetipo 41 de AEM:
- Microsoft Windows
code language-shell mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate ^ -D archetypeGroupId=com.adobe.aem ^ -D archetypeArtifactId=aem-project-archetype ^ -D archetypeVersion=41 ^ -D appTitle="My Form" ^ -D appId="myform" ^ -D groupId="com.myform" ^ -D includeFormsenrollment="y" ^ -D aemVersion="6.5.15"
- Linux o Apple macOS
code language-shell mvn -B org.apache.maven.plugins:maven-archetype-plugin:3.2.1:generate \ -D archetypeGroupId=com.adobe.aem \ -D archetypeArtifactId=aem-project-archetype \ -D archetypeVersion=41 \ -D appTitle="My Form" \ -D appId="myform" \ -D groupId="com.myform" \ -D includeFormsenrollment="y" \ -D aemVersion="6.5.15"
Cuando ejecute el comando anterior, asegúrese de tener en cuenta los siguientes puntos:
-
Actualice el comando para reflejar los valores específicos de su entorno, incluidos appTitle, appId y groupId. Además, establezca los valores de includeFormsenrollment en 'y'. Si utiliza el Portal de Forms, establezca la opción includeExamples=y para que incluya los componentes principales del Portal de Forms en el proyecto.
-
No cambie “aemVersion” de 6.5.15.0 por nada más.
-
(Solo para proyectos basados en la versión 41 del arquetipo) Una vez creado el proyecto de arquetipo de AEM, habilite las temáticas para formularios adaptables basados en componentes principales. Para habilitar las temáticas, haga lo siguiente:
-
Abra la [Carpeta de proyecto de arquetipo de AEM]/ui.apps/src/main/content/jcr_root/apps/appId/components/adaptiveForm/page/customheaderlibs.html para editarla:
-
Agregue el siguiente código en la línea 21:
code language-xml <sly data-sly-use.clientlib="core/wcm/components/commons/v1/templates/clientlib.html" data-sly-use.formstructparser="com.adobe.cq.forms.core.components.models.form.FormStructureParser" data-sly-test.themeClientLibRef="${formstructparser.themeClientLibRefFromFormContainer}"> <sly data-sly-test="${themeClientLibRef}" data-sly-call="${clientlib.css @ categories=themeClientLibRef}"/> </sly>
-
Guarde y cierre el archivo.
-
-
Actualizar el proyecto para que incluya la última versión de los componentes principales de Forms:
-
Abra la [Carpeta de proyecto de arquetipo de AEM]/pom.xml para editarla.
-
Establezca la versión de
core.forms.components.version
ycore.forms.components.af.version
a la versión Últimos componentes principales de Forms. -
Guarde y cierre el archivo.
-
-
Una vez que el proyecto de arquetipo de AEM se haya creado correctamente, cree el paquete de implementación para su entorno. Haga clic para generar el paquete:
-
Vaya al directorio raíz del proyecto del arquetipo de AEM.
-
Ejecute el siguiente comando para compilar el proyecto de arquetipo de AEM para su entorno:
code language-shell mvn clean install
Una vez que el proyecto de arquetipo de AEM se haya compilado correctamente, se generará un paquete de AEM. Puede encontrar el paquete en [Carpeta de proyecto de arquetipo de AEM]\all\target[appid].all-[versión].zip
-
-
Utilice el Administrador de paquetes para implementar la [Carpeta de proyecto de arquetipo de AEM]\all\target[appid].all-[versión].zip en el entorno de instancias de autor y publicación.
Los componentes principales están habilitados para su entorno. Se implementan una plantilla de formularios adaptables basados en componentes principales en blanco y una temática de Lienzo 3.0 que le permiten crear formularios adaptables basados en los componentes principales.
Preguntas frecuentes
¿Qué son los componentes principales?
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é funcionalidades completas se añaden al habilitar los componentes principales?
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.