Show Menu
TEMAS×

Configurar y configurar el sitio de referencia de We.Gov

Detalles del paquete de demostración

Requisitos previos de instalación

Este paquete se creó para AEM Forms 6.4 OSGI Author , se ha probado y, por tanto, se admite en las siguientes versiones de plataforma:
VERSIÓN DE AEM
VERSIÓN DEL PAQUETE DE AEM FORMS
ESTADO
6.4
5.0.86
Compatible
6.5
6.0.80
Compatible
Este paquete contiene la configuración de nube que admite las siguientes versiones de plataforma:
PROVEEDOR DE NUBE
VERSIÓN DE SERVICIO
ESTADO
Adobe Sign
API v5
Compatible
Microsoft Dynamics 365
1710 (9.1.0.3020)
Compatible
Consideraciones sobre la instalación del paquete:
  • Se espera que el paquete se instale en un servidor limpio, libre de otros paquetes de demostración o versiones de paquetes de demostración anteriores
  • Se espera que el paquete se instale en un servidor OSGI, que se ejecuta en modo Autor

¿Qué incluye este paquete?

El paquete de demostración de AEM Forms We.Gov ( we-gov-forms.pkg.all-<version>.zip ) viene como un paquete que incluye varios subpaquetes y servicios más. El paquete incluye los siguientes módulos:
  • we-gov-forms.pkg.all-<version>.zip : paquete de demostración completo
    • we-gov-forms.ui.apps-<version>.zip - Contiene todos los componentes, bibliotecas de clientes, usuarios de muestras, modelos de flujo de trabajo, etc.
      • we-gov-forms.core-<version>.jar : contiene todos los servicios OSGI, implementación de pasos personalizados del flujo de trabajo, etc.
      • core.wcm.components.all-2.0.4.zip : colección de componentes WCM de muestra
      • grid-aem.ui.apps-1.0-SNAPSHOT.zip - Paquete de diseño de cuadrícula de sitios AEM para el control de columnas de páginas Sitios
    • we-gov-forms.ui.content-<version>.zip : contiene todo el contenido, las páginas, las imágenes, los formularios, los recursos de comunicación interactivos, etc.
    • we-gov-forms.config.public-<version>.zip : contiene todos los nodos de configuración predeterminados, incluidas las configuraciones de nube de marcadores de posición, para ayudar a evitar problemas con el modelo de datos de formularios y el enlace de servicios.
Los recursos incluidos en este paquete incluyen:
  • Páginas de sitio de AEM con plantillas editables
  • Formularios adaptables de AEM Forms
  • Comunicaciones interactivas de AEM Forms (impresión y Canal web)
  • Documento de registro XDP de AEM Forms
  • Modelo de datos de AEM Forms MS Dynamics Forms
  • Integración de Adobe Sign
  • Modelo de flujo de trabajo de AEM
  • Imágenes de muestra de Recursos AEM

Opciones de configuración

Esta sección incluye detalles sobre las opciones de configuración. En este momento, esta sección está intencionalmente vacía.

Instalación del paquete de demostración

Esta sección contiene información sobre la instalación del paquete de demostración.

Desde paquete compartido

  1. Vaya a https://<aemserver>:<port>/crx/packageshare/
    O bien, en AEM, haga clic en Implementación y vaya al icono Uso compartido de paquetes.
  2. Inicie sesión con su Adobe ID.
  3. Busque el paquete we-gov-forms.pkg.all-<version> .
  4. Seleccione la opción "Descargar" y acepte los términos y condiciones.
  5. Una vez descargado, seleccione la opción "Descargado" para localizar el paquete en el Administrador de paquetes.
  6. Seleccione la opción "Instalar" para instalar el paquete.
  7. Permita que se complete el proceso de instalación.
  8. Vaya a https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled para asegurarse de que la instalación se realizó correctamente.

Desde un archivo ZIP local

  1. Descargue y localice el archivo we-gov-forms.pkg.all-<version>.zip .
  2. Vaya a https://<aemserver>:<puerto>/crx/packmgr/index.jsp .
  3. Seleccione la opción "Cargar paquete".
  4. Utilice el navegador de archivos para desplazarse hasta el archivo ZIP descargado y seleccionarlo.
  5. Haga clic en "Abrir" para cargar.
  6. Una vez cargado, seleccione la opción "Instalar" para instalar el paquete.
  7. Permita que se complete el proceso de instalación.
  8. Vaya a https://<aemserver>:<port>/content/we-gov/home.html?wcmmode=disabled para asegurarse de que la instalación se realizó correctamente.

Instalación de nuevas versiones de paquetes

Para instalar la nueva versión del paquete, siga los pasos definidos en 4.1 y 4.2. Es posible instalar una versión más reciente del paquete mientras ya hay otro paquete más antiguo instalado, pero se recomienda desinstalar primero la versión anterior del paquete. Para hacerlo, siga los pasos a continuación.
  1. Vaya a https://<aemserver>:<puerto>/crx/packmgr/index.jsp
  2. Busque el archivo we-gov-forms.pkg.all-<version>.zip anterior.
  3. Seleccione la opción "Más".
  4. En el menú desplegable, seleccione la opción "Desinstalar".
  5. En la confirmación, seleccione "Desinstalar" nuevamente y permita que se complete el proceso de desinstalación.

Configuración del paquete de demostración

Esta sección contiene detalles e instrucciones sobre la configuración posterior a la implementación del paquete de demostración antes de la presentación.

Configuración ficticia del usuario

  1. Vaya a https://<aemserver>:<puerto>/libs/granite/security/content/groupadmin.html
  2. Busque " workflow ".
  3. Seleccione el grupo "usuarios del flujo de trabajo" y haga clic en "Propiedades".
  4. Vaya a la ficha "Miembros".
  5. Escriba wegov en el campo "Seleccionar usuario o grupo".
  6. Seleccione en el menú desplegable "Usuarios del formulario We.Gov".
  7. Haga clic en "Guardar y cerrar" en la barra de menús.
  8. Repita los pasos del 2 al 7 buscando " análisis ", seleccionando el grupo "Administradores de Analytics" y agregando el grupo "Usuarios de formulario We.Gov" como miembro.
  9. Repita los pasos del 2 al 7 buscando "usuarios de formularios", seleccionando el grupo "usuarios de formularios" y agregando el grupo "Usuarios de formularios de We.Gov" como miembro.
  10. Repita los pasos del 2 al 7 buscando "usuarios de formularios", seleccionando el grupo "usuarios de formularios" y agregando esta vez el grupo "Usuarios de We.Gov" como miembro.

Configuración del servidor de correo electrónico

  1. Revisar la documentación de configuración Configurar notificación por correo electrónico
  2. Vaya a https://<aemserver>:<puerto>/system/console/configMgr
  3. Busque y haga clic en el servicio Day CQ Mail Service para configurarlo.
  4. Configure el servicio para conectarse al servidor SMTP de su elección:
    1. Nombre de host del servidor SMTP: e.g (smtp.gmail.com)
    2. Puerto del servidor: por ejemplo (465) para gmail usando SSL
    3. Usuario SMTP: demo@ <nombre_empresa>.com
    4. Dirección "De": aemformsdemo@adobe.com
  5. Haga clic en "Guardar" para guardar la configuración.

Configuración de AEM SSL

Esta sección contiene detalles sobre la configuración de SSL en la instancia de AEM para poder configurar la configuración de Adobe Sign Cloud.
Referencias:
Notas:
  1. Vaya a https://<aemserver>:<port>/aem/inbox donde podrá completar el proceso explicado en el vínculo de documentación de referencia anterior.
  2. El paquete we-gov-forms.pkg.all-<version>.zip incluye una clave SSL de muestra y un certificado al que se puede acceder extrayendo la carpeta we-gov-forms.pkg.all-<version>.zip/ssl que forma parte del paquete.
  3. Certificado SSL y detalles de clave:
    1. emitido a "CN=localhost"
    2. 10 años de validez
    3. valor de contraseña de "password"

Adobe Sign cloud configuration

Esta sección contiene detalles e instrucciones sobre la configuración de Adobe Sign Cloud.
Referencias:

Cloud configuration

  1. Revise los requisitos previos. Consulte Configuración SSL de AEM para obtener la configuración SSL necesaria.
  2. Ir a:
    https://<aemserver>:<puerto>/libs/adobesign/cloudservices/adobesign.html/conf/we-gov
    La dirección URL utilizada para acceder al servidor AEM debe coincidir con la URL configurada en el URI de redirección de OAuth de Adobe Sign para evitar problemas de configuración (por ejemplo, https://<aemserver>:<puerto>/mnt/overlay/adobesign/cloudservices/adobesign/properties.html )
  3. Seleccione la configuración "We.gov Adobe Sign".
  4. Haga clic en "Propiedades".
  5. Vaya a la ficha "Configuración".
  6. Escriba la dirección URL de oAuth, por ejemplo: https://secure.na1.echosign.com/public/oauth
  7. Proporcione el ID de cliente y el secreto de cliente configurados de la instancia de Adobe Sign configurada.
  8. Haga clic en "Conectar con Adobe Sign".
  9. Después de una conexión correcta, haga clic en "Guardar y cerrar" para completar la integración.

Configuración de nube de MS Dynamics

Esta sección contiene detalles e instrucciones sobre la configuración de MS Dynamics Cloud.
Referencias:

Servicio de nube MS Dynamics OData

  1. Ir a:
    https://<aemserver>:<puerto>/libs/fd/fdm/gui/components/admin/fdmcloudservice/fdm.html/conf/we-gov
    1. Asegúrese de que está accediendo al servidor utilizando la misma dirección URL de redireccionamiento configurada en el registro de la aplicación de MS Dynamics.
  2. Seleccione la configuración "Servicio de nube de OData de Microsoft Dynamics".
  3. Haga clic en "Propiedades".
  4. Vaya a la ficha "Ajustes de autenticación".
  5. Introduzca los siguientes detalles:
    1. Raíz del servicio: por ejemplo https://msdynamicsserver.api.crm3.dynamics.com/api/data/v9.1/
    2. Tipo de autenticación: OAuth 2.0
    3. Configuración de autenticación (consulte Configuración de nube de MS Dynamics para recopilar esta información):
      1. ID de cliente: también denominado ID de aplicación
      2. Secreto del cliente
      3. Actualizar URL del token: por ejemplo: https://login.windows.net/common/oauth2/token
      4. URL de Token de acceso, por ejemplo: https://login.windows.net/common/oauth2/token
      5. Ámbito de autorización: open
      6. Encabezado de autenticación: portador de autorización
    4. Haga clic en "Conectar a OAuth".
  6. Después de autenticarse correctamente, haga clic en "Guardar y cerrar" para completar la integración.

Configuración de la nube de MS Dynamics

Los pasos detallados en esta sección se incluyen para ayudarle a localizar el ID de cliente, el secreto de cliente y los detalles de la instancia de MS Dynamics Cloud.
  1. Vaya a https://portal.azure.com/ e inicie sesión.
  2. En el menú de la izquierda, seleccione "Todos los servicios".
  3. Busque o vaya a "Registro de la aplicación".
  4. Cree o seleccione un registro de aplicación existente.
  5. Copie el ID de aplicación que se va a usar como ID de cliente de OAuth en la configuración de nube de AEM
  6. Haga clic en "Configuración" o "Manifiesto" para configurar las direcciones URL de respuesta.
    1. Esta URL debe coincidir con la URL utilizada para acceder al servidor AEM al configurar el servicio OData.
  7. En la vista Configuración, haga clic en "Teclas" para crear una nueva clave de vista (se utiliza como Secreto del cliente en AEM).
    1. Asegúrese de guardar una copia de la clave, ya que no podrá realizar la vista posteriormente en Azure o AEM.
  8. Para localizar la URL del recurso o la URL raíz del servicio, vaya al panel de instancia de MS Dynamics.
  9. En la barra de navegación superior, haga clic en "Ventas" o en su propio tipo de instancia y en "Seleccionar configuración".
  10. Haga clic en "Personalizaciones" y "Recursos para desarrolladores" cerca de la parte inferior derecha.
  11. Allí encontrará la URL de la raíz del servicio: e.g
  12. Los detalles sobre la URL de actualización y Token de acceso están disponibles aquí:

Prueba del modelo de datos de formulario

Una vez completada la configuración de nube, es posible que desee probar el modelo de datos de formulario.
  1. Ir a
    https://<aemserver>:<puerto>/aem/forms.html/content/dam/formsanddocuments-fdm/we-gov
  2. Seleccione "We.gov Microsoft Dynamics CRM FDM" y "Properties".
  3. Vaya a la ficha "Actualizar origen".
  4. Asegúrese de que la "Configuración según el contexto" esté configurada en "/conf/we-gov" y que la fuente de datos configurada sea "ms-ddynamic-odata-cloud-service".
  5. Edite el modelo de datos de formulario.
    Asegúrese de hacer clic en Cancelar en lugar de en Guardar y cerrar para evitar problemas que requieran reinstalación.
  6. Pruebe los servicios para asegurarse de que se conectan correctamente a la fuente de datos configurada.
    Se ha informado de que se requería un reinicio de AEM Server para que la fuente de datos se enlazara correctamente al FDM.

Configuración del servicio en la nube de Adobe Analytics

Este paquete viene preconfigurado para conectarse a Adobe Analytics. Se proporcionan los pasos siguientes para permitir que se actualice esta configuración.
  1. Vaya a https://<aemserver>:<puerto>/libs/cq/core/content/tools/cloudservices.html
  2. Busque la sección Adobe Analytics y seleccione el vínculo "Mostrar configuraciones".
  3. Seleccione la configuración "We.Gov Adobe Analytics (Configuración de Analytics)".
  4. Haga clic en el botón "Editar" para actualizar la configuración de Adobe Analytics (deberá proporcionar el secreto compartido). Haga clic en "Conectar con Analytics" para conectarse y en "Aceptar" para completar.
  5. En la misma página, haga clic en "We.Gov Adobe Analytics Framework (Analytics Framework)" si desea actualizar las configuraciones de marco (consulte Habilitar la creación de AEM para habilitar la creación).

sistema de informes de Adobe Analytics

Vista sistema de informes de sitios de Adobe Analytics

  1. Vaya a https://<aemserver>:<puerto>/sites.html/content
  2. Seleccione "AEM Forms We.Gov Site" para realizar la vista de las páginas del sitio.
  3. Seleccione una de las páginas del sitio (p. ej. Inicio) y elija "Analytics y recomendaciones".
  4. En esta página, verá información recuperada de Adobe Analytics que se refiere a la página Sitios de AEM (nota: por diseño, esta información se actualiza periódicamente desde Adobe Analytics y no se muestra en tiempo real).
  5. De nuevo en la página de vista de página (a la que se accede en el paso 3), también puede realizar la vista de la información de vista de página cambiando la configuración de visualización a elementos de vista en la "Vista de Lista".
  6. Busque el menú desplegable "Vista" y seleccione "Vista de Lista".
  7. En el mismo menú, seleccione "Configuración de Vista" y seleccione las columnas que desee mostrar en la sección "Análisis".
  8. Haga clic en "Actualizar" para que las nuevas columnas estén disponibles.

Vista sistema de informes de formularios de Adobe Analytics

  1. Ir a
    https://<aemserver>:<puerto>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
  2. Seleccione el formulario adaptable "Solicitud de inscripción para beneficios de salud" y seleccione la opción "Informe de Analytics".
  3. Espere a que se cargue la página y vista los datos del informe de Analytics.

Vista del sistema de informes de Adobe Analytics

De forma opcional, puede navegar directamente a Adobe Analytics para ver los datos de análisis.
  1. Inicie sesión con sus credenciales:
    1. Compañía: Demostración de AEM Forms
    2. Usuario: <disponible a petición>
    3. Contraseña: <disponible a petición>
  2. Seleccione el "Sitio de referencia de We.Gov" en los grupos de informes.
  3. Seleccione uno de los informes disponibles para mostrar los datos de análisis de ese informe.

Personalizaciones del paquete de demostración

Esta sección incluye instrucciones sobre la personalización de la demostración.

Habilitar la creación de AEM

Este paquete de demostración incluye un archivo de configuración de servicio OSGI que controla el comportamiento del servicio de filtro WCM en el servidor de destinatario Author. Esta configuración hace que el servidor funcione en modo de autor desactivado (equivalente a ?wcmmode=disabled) para permitir la demostración. Para actualizar esta configuración y habilitar la creación, lleve a cabo los siguientes pasos:
  1. Vaya a https://<aemserver>:<puerto>/system/console/configMgr
  2. Busque y haga clic en el servicio Day CQ WCM Filter Service para configurarlo.
  3. Establezca el valor de "Modo ​WCM" en " Editar ".
  4. Haga clic en " Guardar " para aplicar la configuración.

Personalización de plantillas

Las plantillas editables se encuentran en la siguiente ubicación:
https://<aemserver>:<puerto>/libs/wcm/core/content/sites/templates.html/conf/we-gov
Estas plantillas incluyen las plantillas Sitio de AEM, Formulario adaptable y Comunicaciones interactivas, creadas y ensambladas con componentes que se pueden encontrar en:
https://<aemserver>:<puerto>/crx/de/index.jsp#/apps/we-gov/components

Style system

Este sitio también incluye bibliotecas cliente, una de las cuales importa Bootstrap 4 ( https://getbootstrap.com/ ). Esta biblioteca de cliente está disponible en
https://<aemserver>:<puerto>/crx/de/index.jsp#/apps/we-gov/clientlibs/clientlib-base/css/bootstrap
Las plantillas editables incluidas en este paquete también vienen preconfiguradas con directivas de plantilla/página que utilizan las clases CSS de Bootstrap 4 para paginación, estilo, etc. No se han agregado todas las clases a las directivas de plantilla, pero se puede agregar a las directivas cualquier clase que admita Bootstrap 4. Consulte la página de introducción para obtener una lista de las clases disponibles:
Las plantillas incluidas en este paquete también admiten el sistema de estilos:

Logotipos de plantilla

Los Recursos DAM del proyecto también incluyen logotipos e imágenes de We.Gov. Estos recursos están disponibles en:
https://<aemserver>:<puerto>/assets.html/content/dam/we-gov
Al editar las plantillas de página y formulario, puede elegir actualizar los logotipos de marca editando los componentes Navegación y Pie de página. Estos componentes oferta una marca y un cuadro de diálogo de logotipo configurables que pueden utilizarse para actualizar logotipos:
Consulte Edición del contenido de la página para obtener más información:

Personalización de páginas de sitios

Todas las páginas del sitio están disponibles en: https://<aemserver>:<puerto>/sites.html/content/we-gov
Estas páginas de sitio también utilizan el paquete de cuadrícula de AEM para controlar el diseño de algunos componentes.

Style system

Las páginas incluidas en este paquete también admiten el sistema de estilos:
También puede consultar el sistema de estilo de personalización de Plantillas para obtener documentación sobre los estilos admitidos.

Personalización de formularios adaptables

Todos los formularios adaptables están disponibles en:
https://<aemserver>:<puerto>/aem/forms.html/content/dam/formsanddocuments/adobe-gov-forms
Estos formularios pueden personalizarse para adaptarse a determinados casos de uso. Tenga en cuenta que ciertos campos y la lógica de envío no deben modificarse para garantizar que el formulario siga funcionando correctamente. Esto incluye:
Solicitud De Inscripción Para Beneficios De Salud:
  • contact_id - Campo oculto utilizado para recibir el ID de contacto de MS Dynamics durante el envío
  • Enviar: la lógica del botón Enviar requiere personalización para admitir rellamadas. La personalización está documentada, pero se requiere una secuencia de comandos grande para enviar el formulario mientras se realiza una operación POST y GET a MS Dynamics mediante el modelo de datos de formularios.
  • Panel raíz: Inicializar evento se utiliza para agregar un botón de MS Dynamics a la Bandeja de entrada de AEM de la manera menos intrusiva posible, ya que todos los componentes de la interfaz de usuario de Granite de la Bandeja de entrada de AEM no se pueden modificar.

Estilo de formulario adaptable

Los formularios adaptables también se pueden diseñar con el Editor de estilo o el editor de temas:

Personalización de flujos de trabajo

El formulario adaptable de inscripción se envía a un flujo de trabajo OSGI para su procesamiento. Este flujo de trabajo se encuentra en https://<aemserver>:<puerto>/conf/we-gov/settings/models/we-gov-process.html .
Debido a ciertas limitaciones, este flujo de trabajo contiene varias secuencias de comandos y pasos personalizados del proceso de flujo de trabajo OSGI. Estos pasos del flujo de trabajo se crearon como pasos genéricos y no se crearon con los cuadros de diálogo de configuración. En este momento, la configuración de los pasos del flujo de trabajo depende de los argumentos del proceso.
Todo el código Java de paso de flujo de trabajo está contenido en el paquete we-gov-forms.core-<version>.jar .

Consideraciones de demostración y problemas conocidos

Esta sección contiene información sobre las funciones de demostración y las decisiones de diseño que pueden requerir consideraciones especiales durante el proceso de demostración.

Consideraciones de demostración

  • Según AGRS-159, asegúrese de que el nombre (primero, medio y último) del contacto utilizado en el formulario adaptable de inscripción sea único.
  • El formulario adaptable de inscripción enviará el correo electrónico de Adobe Sign al correo electrónico especificado en el campo de correo electrónico del formulario. Esa dirección de correo electrónico no puede ser la misma dirección de correo electrónico que el correo electrónico utilizado para configurar la configuración de nube de Adobe Sign.
  • De forma predeterminada, el paquete de demostración incluye varias configuraciones de servicio OSGI para controlar el comportamiento general del servidor de destinatario que aloja la demostración. Esta configuración incluye una configuración del servicio de filtro WCM que, de forma predeterminada, hace que el servidor funcione en un modo de autor ​desactivado (equivalente a ?wcmmode=disabled). Consulte Activación de la creación de AEM para permitir la creación de páginas.

Problemas conocidos

  • (AGRS-120) El componente Navegación del sitio actualmente no admite páginas secundarias anidadas con una profundidad de más de 2 niveles.
  • (AGRS-159) El FDM de MS Dynamics actual debe realizar dos operaciones para, en primer lugar, enviar los datos del formulario adaptable de matriculación a Dynamics y, a continuación, recuperar el registro de usuario para recuperar el ID de contacto. En su estado actual, la recuperación del ID de contacto fallará si hay más de dos usuarios con el mismo nombre en Dynamics, lo que no permitirá que se envíe el formulario adaptable de matriculación.

Próximos pasos

Ahora todos están listos para explorar el sitio de referencia de We.Gov. Para obtener más información sobre el flujo de trabajo y los pasos del sitio de referencia de We.Gov, consulte Recorrido del sitio de referencia de We.Gov.