Los flujos de trabajo JEE de AEM Forms proporcionan herramientas para diseñar, crear y administrar procesos empresariales. Un proceso de flujo de trabajo consiste en una serie de pasos que se ejecutan en un orden especificado. Cada paso realiza una acción específica, como asignar una tarea a un usuario o enviar un mensaje de correo electrónico. Un proceso puede interactuar con recursos, cuentas de usuario y servicios, y se puede activar mediante cualquiera de los métodos siguientes:
Para obtener más información sobre la creación del proceso de flujo de trabajo JEE de AEM Forms, consulte Ayuda de Workbench.
Cuando se activa un proceso y a medida que avanza, captura datos sobre los participantes en el proceso, datos introducidos por los participantes en el formulario asociado al proceso y datos adjuntos agregados al formulario. Los datos se almacenan en la base de datos del servidor JEE de AEM Forms y, si se configuran, algunos datos, como los archivos adjuntos, se almacenan en el directorio Global Document Storage (GDS). El directorio GDS se puede configurar en un sistema de archivos compartido o en una base de datos.
Cuando se activa un proceso, se genera un ID de instancia de proceso único y un ID de invocación de larga duración que se asocian a la instancia de proceso. Puede acceder a los datos y eliminarlos para una instancia de proceso en función del ID de invocación de larga duración. Puede deducir el ID de invocación de larga duración de una instancia de proceso con el nombre de usuario del iniciador del proceso o los participantes en el proceso que han enviado sus tareas.
Sin embargo, no se puede identificar el ID de instancia de proceso para un iniciador en los siguientes casos:
tb_job_instance
base de datos, que no se puede consultar directamente.Realice los siguientes pasos para identificar los ID de instancia de proceso para un iniciador de flujo de trabajo o un participante:
Ejecute el siguiente comando en la base de datos del servidor de AEM Forms para recuperar el ID principal del iniciador o participante del flujo de trabajo de la tabla de la base de datos edcprincipalentity
.
select id from edcprincipalentity where canonicalname='user_ID'
La consulta devuelve el ID principal del user_ID
especificado.
(Para el iniciador de flujo de trabajo) Ejecute el siguiente comando para recuperar todas las tareas asociadas con el ID principal del iniciador desde la tabla de la base de datos tb_task
.
select * from tb_task where start_task = 1 and create_user_id= 'initiator_principal_id'
La consulta devuelve tareas iniciadas por el initiator
_ principal_id
especificado. Las tareas son de dos tipos:
process_instance_id
campo . Tome nota de todos los ID de instancia de proceso para las tareas enviadas y continúe con los pasos.process_instance_id
para estas tareas es 0 (cero). En este caso, tome nota de los ID de tarea correspondientes y consulte Trabajo con tareas huérfanas.(Para los participantes del flujo de trabajo) Ejecute el siguiente comando para recuperar los ID de instancia de proceso asociados al ID principal del participante del proceso para el iniciador desde la tabla de la base de datos tb_assignment
.
select distinct a.process_instance_id from tb_assignment a join tb_queue q on a.queue_id = q.id where q.workflow_user_id='participant_principal_id'
La consulta devuelve ID de instancia para todos los procesos asociados con el participante, incluidos aquellos en los que el participante no ha enviado ninguna tarea.
Tome nota de todos los ID de instancia de proceso para las tareas enviadas y continúe con los pasos.
Para tareas huérfanas o tareas en las que el process_instance_id
es 0 (cero), tome nota de los ID de tarea correspondientes y consulte Trabajo con tareas huérfanas.
Siga las instrucciones de la sección Purge user data from workflow instances based on process instance IDs para eliminar los datos de usuario para los ID de instancia de proceso identificados.
Se puede diseñar un flujo de trabajo de modo que los datos del usuario se capturen en una variable que se almacene como un blob en la base de datos. En estos casos, los datos de usuario solo se pueden consultar si están almacenados en una de las siguientes variables de tipo primitivo:
Realice los siguientes pasos para determinar si un flujo de trabajo que almacena datos en variables de tipo primitivo contiene datos para el usuario:
Ejecute el siguiente comando de base de datos:
select database_table from omd_object_type where name='pt_<app_name>/<workflow_name>'
La consulta devuelve un nombre de tabla en formato tb_<number>
para la aplicación especificada ( app_name
) y el flujo de trabajo ( workflow_name
).
El valor de la propiedad name
puede ser complejo si el flujo de trabajo está anidado en subcarpetas dentro de la aplicación. Asegúrese de especificar la ruta completa exacta al flujo de trabajo, que puede obtener de la tabla de la base de datos omd_object_type
.
Revise el esquema de tabla tb_<number>
. La tabla contiene variables que almacenan datos de usuario para el flujo de trabajo especificado. Las variables de la tabla corresponden a las variables del flujo de trabajo.
Identifique y tome nota de la variable que corresponde a la variable de flujo de trabajo que contiene el ID de usuario. Si la variable identificada es de tipo primitivo, puede ejecutar una consulta para determinar las instancias de flujo de trabajo asociadas a un ID de usuario.
Ejecute el siguiente comando de base de datos. En este comando, user_var
es la variable de tipo primitivo que contiene el ID de usuario.
select process_instance_id from <tb_name> where <user_var>=<user_ID>
La consulta devuelve todos los ID de instancia de proceso asociados con el user_ID
especificado.
Siga las instrucciones de la sección Purge user data from workflow instances based on process instance IDs para eliminar los datos de usuario para los ID de instancia de proceso identificados.
Ahora que ha identificado los ID de instancia de proceso asociados a un usuario, haga lo siguiente para eliminar los datos de usuario de las instancias de proceso correspondientes.
Ejecute el siguiente comando para recuperar el ID de invocación de larga duración y el estado de una instancia de proceso de la tabla tb_process_instance
.
select long_lived_invocation_id, status from tb_process_instance where id='process_instance_id'
La consulta devuelve el ID de invocación de larga duración y el estado del process_instance_id
especificado.
Cree una instancia del cliente público ProcessManager
( com.adobe.idp.workflow.client.ProcessManager
) utilizando una instancia ServiceClientFactory
con la configuración de conexión correcta.
Para obtener más información, consulte Referencia de API de Java para Class ProcessManager.
Compruebe el estado de la instancia de flujo de trabajo. Si el estado es distinto de 2 (COMPLETE) o 4 (TERMINATED), termine la instancia primero llamando al siguiente método:
ProcessManager.terminateProcess(<long_lived_invocation_id>)
.
Purgue la instancia del flujo de trabajo llamando al siguiente método:
ProcessManager.purgeProcessInstance(<long_lived_invocation_id>)
El método purgeProcessInstance
elimina por completo todos los datos del ID de invocación especificado de la base de datos del servidor de AEM Forms y GDS, si están configurados.
Las tareas huérfanas son las tareas cuyo proceso contiene se ha iniciado pero aún no se ha enviado. en este caso, process_instance_id
es 0 (cero). Por lo tanto, no se pueden rastrear los datos de usuario almacenados para tareas huérfanas mediante ID de instancias de proceso. Sin embargo, puede rastrearlo con el ID de la tarea para una tarea huérfana. Puede identificar los ID de tareas de la tabla tb_task
para un usuario, tal como se describe en Identificar ID de instancias de proceso cuando se conoce al iniciador o participante del flujo de trabajo.
Una vez que tenga los ID de la tarea, haga lo siguiente para depurar los archivos y datos asociados con una tarea huérfana de GDS y de la base de datos.
Ejecute el siguiente comando en la base de datos del servidor de AEM Forms para recuperar los ID de las tareas identificadas.
select id from tb_form_data where task_id=<task_id>
La consulta devuelve una lista de ID. Para cada ID ( fd_id
) devuelto en los resultados, cree una lista de cadenas de ID de sesión de la siguiente manera:
wfattach<task_id>
_wftask<fd_id>
_wftaskformid<fd_id>
Dependiendo de si el GDS apunta a un sistema de archivos o a una base de datos, realice uno de los siguientes pasos:
GDS en el sistema de archivos
En el sistema de archivos GDS:
_wfattach<task_id>
_wftask<fd_id>
_wftaskformid<fd_id>
Los archivos con estas extensiones son los archivos de marcador. Se almacenan con nombres de archivo en el siguiente formato:
<file_name_guid>.session<session_id_string>
<file_name_guid>
del sistema de archivos.GDS en la base de datos
Ejecute los siguientes comandos para cada ID de sesión:
delete from tb_dm_chunk where documentid in (select documentid from tb_dm_session_reference where sessionid=<session_id>)
delete from tb_dm_session_reference where sessionid=<session_id>
delete from tb_dm_deletion where sessionid=<session_id>
Ejecute los siguientes comandos para eliminar los datos de los ID de tareas de la base de datos del servidor de AEM Forms:
delete from tb_task_acl where task_id=<task_id>
delete from tb_task_attachment where task_id=<task_id>
delete from tb_form_data where task_id=<task_id>
delete from tb_assignment where task_id=<task_id>
delete from tb_task where id=<task_id>