Configuración de un entorno de desarrollo local y un proyecto de desarrollo inicial

Al configurar y configurar un ​ Adobe Experience Manager Forms como ​ Cloud Service , configure entornos de desarrollo, ensayo y producción en la nube. Además, también puede configurar un entorno de desarrollo local.

Puede utilizar el entorno de desarrollo local para realizar las siguientes acciones sin iniciar sesión en el entorno de desarrollo de la nube:

Después de que un formulario adaptable o recursos relacionados estén listos en la instancia de desarrollo local o una aplicación para generar [Comunicaciones del cliente] está listo, puede exportar la aplicación Formulario adaptable o Comunicaciones del cliente desde el entorno de desarrollo local a un entorno de Cloud Service para realizar más pruebas o desplazarse a entornos de producción.

También puede desarrollar y probar código personalizado como componentes personalizados y servicio de relleno previo en el entorno de desarrollo local. Cuando el código personalizado esté listo y probado, puede utilizar el repositorio Git del entorno de desarrollo de Cloud Service para implementar el código personalizado.

Para configurar un nuevo entorno de desarrollo local y utilizarlo para desarrollar actividades, realice las siguientes acciones en el orden indicado:

Requisitos previos

Se necesita el siguiente software para configurar un entorno de desarrollo local. Descargue estos elementos antes de comenzar a configurar el entorno de desarrollo local:

Software Descripción Vínculos de descarga
SDK de Adobe Experience Manager as a Cloud Service SDK incluye Adobe Experience Manager Herramientas de QuickStart y Dispatcher Descargue el SDK más reciente de Distribución de software
Archivo de funciones de Adobe Experience Manager Forms (complemento de AEM Forms) Herramientas para crear, aplicar estilo y optimizar Forms adaptable y otras funciones de Adobe Experience Manager Forms Descargar desde Distribución de software
(Opcional) Contenido de referencia de Adobe Experience Manager Forms Herramientas para crear, aplicar estilo y optimizar Forms adaptable y otras funciones de Adobe Experience Manager Forms Descargar desde Distribución de software
(Opcional) Adobe Experience Manager Forms Designer Herramientas para crear, aplicar estilo y optimizar Forms adaptable y otras funciones de Adobe Experience Manager Forms Descargar desde Distribución de software

Descargue la última versión de software de Distribución de software

Para descargar la última versión del SDK de Adobe Experience Manager as a Cloud Service, el archivo de funciones de Experience Manager Forms (complemento de AEM Forms), los recursos de referencia de formularios o Forms Designer desde Distribución de software:

  1. Iniciar sesión en https://experience.adobe.com/#/downloads con su Adobe ID

    NOTA

    La organización de Adobe debe estar aprovisionada para AEM as a Cloud Service para descargar el SDK as a Cloud Service de AEM.

  2. Vaya a la AEM as a Cloud Service pestaña .

  3. Ordene por fecha publicada en orden descendente.

  4. Haga clic en el SDK de Adobe Experience Manager as a Cloud Service más reciente, el archivo de funciones de Experience Manager Forms (complemento de AEM Forms), los recursos de referencia de formularios o Forms Designer.

  5. Revisar y aceptar el EULA. Toque . Descargar botón.

Configuración de herramientas de desarrollo para AEM Proyectos

El proyecto de Adobe Experience Manager Forms es una base de código personalizado. Contiene código, configuraciones y contenido que se implementa mediante Cloud Manager en Adobe Experience Manager as a Cloud Service. La variable Tipo de archivo Maven del proyecto AEM proporciona la estructura de base para el proyecto.

Configure las siguientes herramientas de desarrollo para usar con su Adobe Experience Manager proyecto de desarrollo:

Para obtener instrucciones detalladas sobre la configuración de las herramientas de desarrollo mencionadas anteriormente, consulte Configuración de herramientas de desarrollo.

Configuración del entorno de Experience Manager local para el desarrollo

El SDK de Cloud Service proporciona un archivo de inicio rápido. Ejecuta una versión local de Experience Manager. Puede ejecutar las instancias Autor o Publicar localmente.

Aunque QuickStart proporciona una experiencia de desarrollo local, no todas las funciones están disponibles en Adobe Experience Manager as a Cloud Service. Por lo tanto, pruebe siempre las características y el código con Adobe Experience Manager Entorno de desarrollo as a Cloud Service antes de mover las funciones a fase o producción.

Para instalar y configurar el entorno de Experience Manager local, realice los siguientes pasos:

Agregue el archivo Forms a las instancias locales de Autor y Publicación y configure usuarios específicos de Forms

Realice los siguientes pasos en el orden indicado para agregar el archivo de Forms a instancias de Experience Manager y configurar usuarios específicos de formularios:

Instale el último archivo de funciones de complementos de Forms

El archivo de funciones as a Cloud Service de Adobe Experience Manager Forms proporciona herramientas para crear, diseñar y optimizar Forms adaptable en el entorno de desarrollo local. Instale el paquete para crear un formulario adaptable y utilice otras funciones de AEM Forms. Para instalar el paquete:

  1. Descargue y extraiga la última AEM Forms archive para su sistema operativo desde Distribución de software.

  2. Vaya al directorio crx-quickstart/install. Si la carpeta no existe, créela.

  3. Detenga la instancia de AEM, coloque la variable AEM Forms archivo de funciones de complementos, aem-forms-addon-<version>.far, en la carpeta de instalación y reinicie la instancia.

Configuración de usuarios y permisos

Cree usuarios como Desarrollador de formularios y Profesional de formularios y agregar estos usuarios a grupos de formularios predefinidos para proporcionarles los permisos necesarios. La tabla siguiente muestra todos los tipos de usuarios y grupos predefinidos para cada tipo de usuarios de formularios:

Tipo de usuario Grupo AEM
Profesional del formulario / forms-users (Usuarios de AEM Forms), template-authors, workflow-users, workflow-editorsy fdm-authors
Desarrollador de formularios forms-users (Usuarios de AEM Forms), template-authors, workflow-users, workflow-editorsy fdm-authors
Diseñador de experiencia de cliente o experiencia de usuario forms-users, template-authors
Administrador de AEM aem-administrators, fd-administrators
Usuario final Cuando un usuario debe iniciar sesión para ver y enviar un formulario adaptable, agregue estos usuarios a forms-users grupo.
Cuando no se requiera autenticación de usuario para acceder a Forms adaptable, no asigne ningún grupo a esos usuarios.

Configuración del entorno de desarrollo local para el documento de registro (DoR)

AEM Forms as a Cloud Services proporciona un entorno SDK basado en docker que facilita el desarrollo del documento de registro y el uso de otros microservicios. Le libera de la configuración manual de binarios y adaptaciones específicos de la plataforma. Para configurar el entorno:

  1. Instalar y configurar el acoplador:

    NOTA
    • Para Apple macOS, carpetas de lista de permitidos que contienen instancias locales de AEM Author.

    • Docker Desktop para Windows admite dos backends, Hyper-V
      (heredado) y WSL2 (moderno). El uso compartido de archivos se realiza automáticamente
      gestionado por Docker cuando se utiliza WSL2 (moderno). Tiene que
      configure explícitamente el uso compartido de archivos mientras utiliza Hyper-V (heredado).

  2. Cree una carpeta, por ejemplo aem-sdk, en paralelo a las instancias de autor y publicación. Por ejemplo, C:\aem-sdk.

  3. Extraiga el aem-forms-addon-<version>.zip\aem-forms-addon-native-<version>.zip archivo.

    formularios aem extraídos agregar en nativos

  4. Cree una variable de entorno AEM_HOME y elija la instalación local de AEM Author. Por ejemplo, C:\aem\author.

  5. Abra sdk.bat o sdk.sh para editarlo. Establezca AEM_HOME para que apunte a la instalación local de AEM Author. Por ejemplo, C:\aem\author.

  6. Abra el símbolo del sistema y vaya a la aem-forms-addon-native-<version> carpeta.

  7. Asegúrese de que la instancia local de AEM Author esté funcionando. Ejecute el siguiente comando para iniciar el SDK:

    • (en Microsoft® Windows) sdk.bat start
    • (en Linux® o Apple macOS) AEM_HOME=[local AEM Author installation] ./sdk.sh start
    NOTA

    Si ha definido la variable de entorno en el archivo sdk.sh , especificarla en la línea de comandos es opcional. La opción para definir la variable de entorno en la línea de comandos se proporciona para ejecutar el comando sin actualizar la secuencia de comandos shell.

    start-sdk-command

Ahora puede utilizar el entorno de desarrollo local para procesar el documento de registro. Para realizar pruebas, cargue un archivo XDP en su entorno y prográmelo. Por ejemplo, http://localhost:4502/libs/xfaforms/profiles/default.print.pdf?template=crx:///content/dam/formsanddocuments/cheque-request.xdp convierte el archivo XDP al documento PDF.

Configuración de un proyecto de desarrollo para Forms basado en el arquetipo de Experience Manager

Utilice este proyecto para crear Forms adaptable, implementar actualizaciones de configuración, superposiciones, crear componentes de formulario adaptable personalizados, probar y código personalizado en local Experience Manager Forms SDK. Después de realizar la prueba localmente, puede implementar el proyecto en Experience Manager Forms Entornos de producción y no producción as a Cloud Service. Al implementar el proyecto, también se implementan los siguientes recursos de AEM Forms:

Temas Plantillas Modelos de datos de formulario
Lienzo 3.0 Básico Microsoft® Dynamics 365
Tranquilo Vacío Salesforce
Urbane
Ultramarino
Beryl
NOTA

Configure AEM tipo de archivo versión 30 o posterior para obtener y utilizar los modelos de datos de formulario Microsoft® Dynamics 365 y Salesforce con AEM Forms as a Cloud Service.
Configure AEM tipo de archivo versión 32 o posterior para obtener y utilizar temas de Tranquil, Urbane y Ultramarine con AEM Forms as a Cloud Service.

Para configurar el proyecto:

  1. Clonar repositorio Git de Cloud Manager en la instancia de desarrollo local: El repositorio Git de Cloud Manager contiene un proyecto de AEM predeterminado. Se basa en Tipo de archivo AEM. Clona el repositorio Git de Cloud Manager mediante la administración de cuentas Git de autoservicio de la interfaz de usuario de Cloud Manager para llevar el proyecto a su entorno de desarrollo local. Para obtener más información sobre el acceso al repositorio, consulte Acceso a repositorios.

  2. Cree un Experience Manager Forms como [Cloud Service] proyecto: Cree un Experience Manager Forms como [Cloud Service] proyecto basado en AEM Tipo de archivo 32 o posterior. El arquetipo ayuda a los desarrolladores a empezar a desarrollarse fácilmente para AEM Forms as a Cloud Service. También incluye algunos temas de muestra y plantillas para ayudarle a empezar rápidamente.

    Abra el símbolo del sistema y ejecute el siguiente comando para crear un Experience Manager Forms proyecto as a Cloud Service.

    mvn -B archetype:generate -DarchetypeGroupId=com.adobe.aem -DarchetypeArtifactId=aem-project-archetype-DarchetypeVersion=32 -DaemVersion="cloud" -DappTitle="My Site" -DappId="mysite" -DgroupId="com.mysite" -DincludeFormsenrollment="y" -DincludeFormscommunications="y" -DincludeExamples="y"
    

    Cambie el appTitle, appIdy groupId en el comando anterior para reflejar su entorno.

    • Utilice la variable includeFormsenrollment=y para incluir configuraciones, temas, plantillas, componentes principales y dependencias específicos de Forms necesarios para crear Forms adaptable. Si utiliza Forms Portal, establezca la variable includeExamples=y . Agrega al proyecto los componentes principales de Forms Portal.

    • Utilice la variable includeFormscommunications=y incluye los componentes principales de Forms y las dependencias necesarias para incluir la funcionalidad de comunicaciones del cliente.

  3. Implemente el proyecto en el entorno de desarrollo local. Puede utilizar el siguiente comando para implementar en el entorno de desarrollo local

    mvn -PautoInstallPackage clean install

    Para obtener la lista completa de comandos, consulte Creación e instalación

  4. Implemente el código en su AEM Forms Entorno as a Cloud Service.

Configuración de las herramientas locales de Dispatcher

Dispatcher es un módulo de servidor web HTTP Apache que proporciona una capa de seguridad y rendimiento entre el nivel de CDN y AEM Publish. Dispatcher es una parte integral de la arquitectura del Experience Manager general y debe formar parte del entorno de desarrollo local.

Realice los siguientes pasos para configurar el Dispatcher local y luego agregarle reglas específicas de Forms:

Configuración de Dispatcher local

La variable Experience Manager El SDK as a Cloud Service incluye la versión de herramientas de Dispatcher recomendada, que facilita la configuración, validación y simulación de Dispatcher localmente. Las herramientas de Dispatcher están basadas en Docker y proporcionan herramientas de línea de comandos para transformar archivos de configuración de Apache HTTP Web Server y Dispatcher en un formato compatible e implementarlos en Dispatcher que se ejecuta en el contenedor de Docker.

El almacenamiento en caché en Dispatcher permite AEM Forms para rellenar previamente Forms adaptable en un cliente. Mejora la velocidad de procesamiento de los formularios rellenados previamente.

Para obtener instrucciones detalladas sobre la configuración de Dispatcher, consulte Configuración de las herramientas locales de Dispatcher

Agregar reglas específicas de Forms a Dispatcher

Realice los siguientes pasos para configurar la caché de Dispatcher para Experience Manager Forms as a Cloud Service:

  1. Abra el proyecto AEM y vaya a \src\conf.dispatcher.d\available_farms

  2. Cree una copia del default.farm archivo. Por ejemplo, forms.farm.

  3. Abra la forms.farm para editar y reemplazar el siguiente código:

    #/ignoreUrlParams {
    #/0001 { /glob "*" /type "deny" }
    #/0002 { /glob "q" /type "allow" }
    #}
    

    con

    /ignoreUrlParams {
    /0001 { /glob "*" /type "deny" }
    /0002 { /glob "dataRef" /type "allow" }
    }
    
  4. Guarde y cierre el archivo.

  5. Vaya a conf.d/enabled_farms y cree un vínculo simbólico al forms.farm archivo.

  6. Compile e implemente el proyecto en su AEM Forms Entorno as a Cloud Service.

Consideraciones sobre el almacenamiento en caché

  • El almacenamiento en caché de Dispatcher permite AEM Forms para rellenar previamente Forms adaptable en un cliente. Mejora la velocidad de procesamiento de los formularios rellenados previamente.
  • El almacenamiento en caché de las funciones de contenido seguro está deshabilitado de forma predeterminada. Para habilitar la función, puede realizar las instrucciones que se proporcionan en la Almacenamiento en caché de contenido seguro article
  • Dispatcher puede no invalidar algunos Forms adaptables y los Forms adaptables relacionados. Para resolver estos problemas, consulte AEM Forms Almacenamiento en caché en la sección resolución de problemas.
  • Almacenamiento en caché de Forms adaptable localizado:
    • Usar formato de URL http://host:port/content/forms/af/<afName>.<locale>.html para solicitar una versión localizada de un formulario adaptable en lugar de http://host:port/content/forms/af/afName.html?afAcceptLang=<locale>
    • La opción Configuración regional del explorador está desactivada de forma predeterminada. Para cambiar la configuración regional del navegador,
  • Cuando se usa el formato de URL http://host:port/content/forms/af/<adaptivefName>.htmly Utilizar configuración regional del explorador en el administrador de configuración está desactivado, se proporciona la versión no localizada del formulario adaptable. El idioma no localizado es el idioma utilizado al desarrollar el formulario adaptable. No se tiene en cuenta la configuración regional configurada para el explorador (configuración regional del explorador) y se proporciona una versión no localizada del formulario adaptable.
  • Cuando se usa el formato de URL http://host:port/content/forms/af/<adaptivefName>.html, y Utilizar configuración regional del explorador en el administrador de configuración está habilitado, se proporciona una versión localizada del formulario adaptable, si está disponible. El idioma del formulario adaptable localizado se basa en la configuración regional configurada para el explorador (configuración regional del explorador). Puede llevar a [almacenamiento en caché solo de la primera instancia de un formulario adaptable]. Para evitar que el problema se produzca en la instancia, consulte solo se almacena en caché la primera instancia de un formulario adaptable en la sección resolución de problemas.

El entorno de desarrollo local está listo.

Actualice el entorno de desarrollo local

La actualización del SDK a una nueva versión requiere la sustitución de todo el entorno de desarrollo local, lo que provoca la pérdida de todo el código, la configuración y el contenido en los repositorios locales. Asegúrese de que cualquier código, configuración o contenido que no se deba destruir se comprometa de forma segura con Git o se exporta desde las instancias de Experience Manager locales como paquetes CRX.

Cómo evitar la pérdida de contenido al actualizar el SDK

La actualización del SDK crea de forma eficaz una nueva instancia de Autor y Publicación, que incluye un nuevo repositorio (Configurar AEM proyecto), lo que significa que se pierden los cambios realizados en un repositorio de SDK anterior. Para conocer estrategias viables que permitan mantener el contenido entre actualizaciones de SDK, consulte Cómo evitar la pérdida de contenido al actualizar el SDK de AEM

Realizar una copia de seguridad e importar contenido específico de Forms a un nuevo entorno de SDK

Para realizar una copia de seguridad y mover recursos del SDK existente a un nuevo entorno de SDK:

  • Cree una copia de seguridad del contenido existente.

  • Configure un nuevo entorno de SDK.

  • Importe la copia de seguridad en su nuevo entorno de SDK.

Crear una copia de seguridad del contenido existente

Haga una copia de seguridad de su Forms adaptable, plantillas, modelo de datos de formulario, tema, configuraciones y código personalizado. Puede realizar la siguiente acción para crear una copia de seguridad:

  1. Descargar Forms adaptable, temas y PDF forms.

  2. Exportar plantillas de formulario adaptable.

  3. Descargar modelos de datos de formulario

  4. Exporte plantillas editables, configuraciones de nube y modelos de flujo de trabajo. Para exportar todos los elementos mencionados anteriormente desde el SDK existente, cree un CRX-Package con los filtros siguientes:

    • /conf/ReferenceEditableTemplates
    • /conf/global/settings/cloudconfigs
    • /conf/global/settings/wcm
    • /var/workflow/models
    • /conf/global/settings/workflow
  5. Exporte configuraciones de correo electrónico, envíe y rellene previamente código de acciones desde su entorno de desarrollo local. Para exportar esta configuración y configuración, cree una copia de las siguientes carpetas y archivos en el entorno de desarrollo local:

    • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
    • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
    • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

Importe la copia de seguridad en su nuevo entorno de SDK

Importe Forms adaptable, plantillas, modelo de datos de formulario, tema, configuraciones y código personalizado a su nuevo entorno. Puede realizar la siguiente acción para importar la copia de seguridad:

  1. Importar Forms adaptable, temas y PDF forms a nuevos entornos de SDK.

  2. Importar plantillas de formulario adaptable al nuevo entorno del SDK.

  3. Cargar modelos de datos de formulario al nuevo entorno del SDK.

  4. Importe plantillas editables, configuraciones de nube y modelos de flujo de trabajo. Para importar todos los elementos mencionados anteriormente en su nuevo entorno de SDK, importe el CRX-Package que contenga estos elementos en su nuevo entorno de SDK.

  5. Importe configuraciones de correo electrónico, envíe y rellene previamente código de acciones desde su entorno de desarrollo local. Para importar estos ajustes y configuraciones, coloque los siguientes archivos del antiguo proyecto de tipo de archivo en el nuevo proyecto de tipo de archivo:

    • [Archetype Project in Cloud Service Git]/core/src/main/java/com/<program name>/core/service
    • [Archetype Project in Cloud Service Git] /core/src/main/java/com/<program name>/core/servlets/FileAttachmentServlet.java
    • [Archetype Project in Cloud Service Git]/ui.apps/src/main/content/jcr_root/apps/<program name>/config

El nuevo entorno ahora tiene formularios y recursos relacionados del entorno antiguo.

En esta página