Flujos de trabajo centrados en Forms en OSGi | Gestión de datos de usuario

Los flujos de trabajo de AEM centrados en Forms le permiten automatizar procesos empresariales reales centrados en Forms. Los flujos de trabajo constan de una serie de pasos que se ejecutan en el orden especificado en el modelo de flujo de trabajo asociado. Cada paso realiza una acción específica, como asignar una tarea a un usuario o enviar un mensaje de correo electrónico. Los flujos de trabajo pueden interactuar con los recursos del repositorio, las cuentas de usuario y los servicios. Por lo tanto, los flujos de trabajo pueden coordinar actividades complejas que implican cualquiera de los aspectos de Experience Manager.

Un flujo de trabajo centrado en Forms se puede activar o iniciar mediante cualquiera de los siguientes métodos:

• El envío de una solicitud desde la bandeja de entrada AEM;
• El envío de una aplicación desde la aplicación AEM Forms;
• Enviar un formulario adaptable
• El uso de una carpeta inspeccionada;
• El envío de una comunicación interactiva o una carta.

Para obtener más información sobre los flujos de trabajo y las capacidades de AEM centrados en Forms, consulte Flujo de trabajo centrado en Forms de OSGi.

Almacenamiento de datos y datos de usuarios

Cuando se activa un flujo de trabajo, se genera automáticamente una carga útil en la instancia del flujo de trabajo. A cada instancia de flujo de trabajo se le asigna un ID de instancia único y un ID de carga útil asociado. La carga útil contiene las ubicaciones del repositorio para los datos de usuario y de formulario asociados a una instancia de flujo de trabajo. Además, los borradores y los datos históricos de una instancia de flujo de trabajo también se almacenan en el repositorio de AEM.

Las ubicaciones de repositorio predeterminadas donde se encuentran la carga útil, los borradores y el historial de una instancia de flujo de trabajo son las siguientes:

Acceder y eliminar datos de usuario

Puede acceder a los datos de usuario de una instancia de flujo de trabajo del repositorio y eliminarlos. Para ello, debe conocer el ID de instancia de la instancia de flujo de trabajo asociada al usuario. Puede encontrar el ID de instancia de una instancia de flujo de trabajo utilizando el nombre de usuario del usuario que inició la instancia de flujo de trabajo o que es el usuario asignado actual de la instancia de flujo de trabajo.

Sin embargo, no puede identificar flujos de trabajo asociados a un iniciador (o los resultados pueden ser ambiguos) en los siguientes casos:

• Flujos de trabajo activados a través de una carpeta inspeccionada: una instancia de flujo de trabajo no se puede identificar por su iniciador si el flujo de trabajo se activa mediante una carpeta inspeccionada. En este caso, la información del usuario se codifica en los datos almacenados.
• Flujos de trabajo iniciados desde una instancia de publicación de AEM: todas las instancias de flujo de trabajo se crean mediante un usuario de servicio cuando se envían formularios adaptables y comunicaciones o cartas interactivas desde una instancia de publicación de AEM. En estos casos, el nombre de usuario del usuario que ha iniciado sesión no se captura en los datos de la instancia de flujo de trabajo.

Acceder a los datos de usuario

Para identificar y acceder a los datos de usuario almacenados en una instancia de flujo de trabajo, realice los siguientes pasos:

1. En una instancia de autor de AEM, vaya a https://'[server]:[port]'/crx/de y después vaya a Herramientas > Consulta.

   Seleccione SQL2 en la lista desplegable Tipo.

2. En función de la información disponible, ejecute una de las siguientes consultas:

   • Ejecute lo siguiente si conoce el iniciador del flujo de trabajo:

   SELECT * FROM [cq:Workflow] AS s WHERE ISDESCENDANTNODE([path-to-workflow-instances]) and s.[initiator]='*initiator-ID*'

   • Ejecute lo siguiente si el usuario de los datos que busca es el usuario asignado del flujo de trabajo actual:

   SELECT * FROM [cq:WorkItem] AS s WHERE ISDESCENDANTNODE([path-to-workflow-instances]) and s.[assignee]='*assignee-id*'

   La consulta devuelve la ubicación de todas las instancias de flujo de trabajo del iniciador de flujo de trabajo especificado o el usuario asignado del flujo de trabajo actual.

   Por ejemplo, la siguiente consulta devuelve dos rutas de instancia de flujo de trabajo desde el nodo /var/workflow/instances cuyo iniciador de flujo de trabajo es srose.

   

3. Vaya a una de las rutas de instancia de flujo de trabajo devueltas por la consulta. La propiedad status muestra el estado actual de la instancia de flujo de trabajo.

   

4. En el nodo de la instancia de flujo de trabajo, vaya a data/payload/. La propiedad path almacena la ruta de acceso a la carga útil de la instancia de flujo de trabajo. Puede ir a la ruta para acceder a los datos almacenados en la carga útil.

   

5. Vaya a las ubicaciones de los borradores y el historial de la instancia de flujo de trabajo.

   Por ejemplo:

   /var/fd/dashboard/instances/server0/2018-04-09/_var_workflow_instances_server0_2018-04-09_basicmodel_54/draft/

   /var/fd/dashboard/instances/server0/2018-04-09/_var_workflow_instances_server0_2018-04-09_basicmodel_54/history/

6. Repita los pasos 3-5 para todas las instancias de flujo de trabajo devueltas por la consulta del paso 2.

   NOTA

   La aplicación AEM Forms también almacena datos en el modo Sin conexión. Es posible que los datos de una instancia de flujo de trabajo se almacenen localmente en dispositivos individuales y se envíen al servidor de Forms cuando la aplicación se sincroniza con él.

Eliminar los datos de usuario

Es necesario ser administrador de AEM para eliminar los datos de usuario de las instancias de flujo de trabajo mediante los siguientes pasos:

1. Siga las instrucciones indicadas en Acceso a los datos de usuario y anote lo siguiente:

   • las rutas a las instancias de flujo de trabajo asociadas al usuario;
   • el estado de las instancias de flujo de trabajo;
   • las rutas a las cargas útiles de las instancias de flujo de trabajo;
   • las rutas a los borradores y el historial de las instancias de flujo de trabajo.

2. Siga este paso para las instancias de flujo de trabajo cuyo estado sea EN EJECUCIÓN, SUSPENDIDA u OBSOLETA:

   1. Vaya a https://'[server]:[port]'/aem/start.html e inicie sesión con las credenciales de administrador.

   2. Vaya a Herramientas > Flujo de trabajo > Instancias.

   3. Seleccione las instancias de flujo de trabajo relevantes para el usuario y seleccione Finalizar para finalizar instancias en ejecución.

      Para obtener más información sobre cómo trabajar con instancias de flujo de trabajo, consulte Administración de instancias de flujo de trabajo.

3. Vaya a la consola CRXDE Lite, vaya a la ruta de la carga útil de una instancia de flujo de trabajo y elimine el nodo payload.

4. Vaya a la ruta de los borradores de una instancia de flujo de trabajo y elimine el nodo draft.

5. Vaya a la ruta del historial de una instancia de flujo de trabajo y elimine el nodo history.

6. Vaya a la ruta de instancia de flujo de trabajo de una instancia de flujo de trabajo y elimine el nodo [workflow-instance-ID] del flujo de trabajo.

   NOTA

   Al quitar el nodo de la instancia de flujo de trabajo, se eliminará la instancia de flujo de trabajo para todos los participantes del flujo de trabajo.

7. Repita los pasos 2-6 para todas las instancias de flujo de trabajo identificadas de un usuario.

8. Identifique y elimine los datos de los borradores y de envío sin conexión de la bandeja de salida de la aplicación AEM Forms de los participantes del flujo de trabajo para evitar que se realice ningún envío al servidor.

También puede utilizar API para acceder a los nodos y las propiedades y quitarlos. Consulte los siguientes documentos para obtener más información.

• Cómo acceder mediante programación al JCR de AEM
• Eliminación de nodos y propiedades
• Referencia de la API