Os fluxos de trabalho do AEM Forms JEE fornecem ferramentas para projetar, criar e gerenciar processos comerciais. Um processo de workflow consiste em uma série de etapas executadas em uma ordem especificada. Cada etapa executa uma ação específica, como atribuir uma tarefa a um usuário ou enviar uma mensagem de email. Um processo pode interagir com ativos, contas de usuário e serviços e pode ser acionado por meio de qualquer um dos seguintes métodos:
Para obter mais informações sobre como criar o processo de workflow AEM Forms JEE, consulte Ajuda do Workbench.
Quando um processo é acionado e avança, ele captura dados sobre os participantes do processo, dados inseridos pelos participantes no formulário associado ao processo e anexos adicionados ao formulário. Os dados são armazenados no banco de dados do servidor AEM Forms JEE e, se configurados, alguns dados como anexos são armazenados no diretório Global Document Storage (GDS). O diretório GDS pode ser configurado em um sistema de arquivos compartilhado ou em um banco de dados.
Quando um processo é acionado, uma ID de instância de processo exclusiva e uma ID de invocação de longa duração são geradas e associadas à instância de processo. Você pode acessar e excluir dados de uma instância de processo com base na ID de invocação de longa duração. Você pode deduzir a ID de invocação de longa duração de uma instância do processo com o nome de usuário do iniciador do processo ou participantes do processo que enviaram suas tarefas.
No entanto, não é possível identificar a ID da instância do processo para um iniciador nos seguintes cenários:
tb_job_instance
tabela de banco de dados, que não pode ser consultada diretamente.Execute as seguintes etapas para identificar as IDs de instância do processo de um iniciador de fluxo de trabalho ou de um participante:
Execute o seguinte comando no banco de dados do servidor do AEM Forms para recuperar a ID principal do iniciador ou do participante do workflow edcprincipalentity
tabela de banco de dados.
select id from edcprincipalentity where canonicalname='user_ID'
A consulta retorna a ID principal para o user_ID
.
(Para iniciador de fluxo de trabalho) Execute o seguinte comando para recuperar todas as tarefas associadas à ID principal do iniciador da tb_task
tabela de banco de dados.
select * from tb_task where start_task = 1 and create_user_id= 'initiator_principal_id'
A consulta retorna tarefas iniciadas pelo initiator
_ principal_id
. As tarefas são de dois tipos:
process_instance_id
campo. Anote todas as IDs de instância do processo para tarefas enviadas e continue com as etapas.process_instance_id
para essas tarefas é 0 (zero). Nesse caso, tome nota das IDs de tarefa correspondentes e consulte Trabalhar com tarefas órfãs.(Para participantes de fluxo de trabalho) Execute o seguinte comando para recuperar as IDs da instância do processo associadas à ID principal do participante do processo para o iniciador do tb_assignment
tabela de banco de dados.
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'
O query retorna as IDs da instância para todos os processos associados ao participante, incluindo aqueles em que o participante não submeteu nenhuma tarefa.
Anote todas as IDs de instância do processo para tarefas enviadas e continue com as etapas.
Para tarefas órfãs ou tarefas em que process_instance_id
for 0 (zero), anote as IDs de tarefa correspondentes e veja Trabalhar com tarefas órfãs.
Siga as instruções em Limpar dados do usuário de instâncias de fluxo de trabalho com base nas IDs de instância do processo para excluir dados do usuário para IDs de instância do processo identificado.
Um workflow pode ser projetado de modo que os dados do usuário sejam capturados em uma variável que é armazenada como um blob no banco de dados. Nesses casos, você pode consultar os dados do usuário somente se estiverem armazenados em uma das seguintes variáveis primitivas:
Execute as etapas a seguir para determinar se um workflow que armazena dados em variáveis do tipo primitivo contém dados para o usuário:
Execute o seguinte comando de banco de dados:
select database_table from omd_object_type where name='pt_<app_name>/<workflow_name>'
O query retorna um nome de tabela em tb_<number>
para o aplicativo especificado ( app_name
) e fluxo de trabalho ( workflow_name
).
O valor da variável name
pode ser complexa se o fluxo de trabalho estiver aninhado em subpastas dentro do aplicativo. Certifique-se de especificar o caminho completo exato para o fluxo de trabalho, que pode ser obtido no omd_object_type
tabela de banco de dados.
Revise o tb_<number>
esquema da tabela. A tabela contém variáveis que armazenam dados do usuário para o workflow especificado. As variáveis na tabela correspondem às variáveis no fluxo de trabalho.
Identifique e anote a variável que corresponde à variável do fluxo de trabalho que contém a ID do usuário. Se a variável identificada for do tipo primitivo, é possível executar um query para determinar as instâncias de fluxo de trabalho associadas a uma ID de usuário.
Execute o seguinte comando de banco de dados. Nesse comando, a variável user_var
é a variável do tipo primitivo que contém a ID do usuário.
select process_instance_id from <tb_name> where <user_var>=<user_ID>
A consulta retorna todas as IDs de instância do processo associadas ao user_ID
.
Siga as instruções em Limpar dados do usuário de instâncias de fluxo de trabalho com base nas IDs de instância do processo para excluir dados do usuário para IDs de instância do processo identificado.
Agora que você identificou as IDs de instância do processo associadas a um usuário, faça o seguinte para excluir dados de usuário das respectivas instâncias de processo.
Execute o seguinte comando para recuperar a ID de invocação de longa duração e o status de uma instância de processo do tb_process_instance
tabela.
select long_lived_invocation_id, status from tb_process_instance where id='process_instance_id'
A consulta retorna o ID da invocação de longa duração e o status do especificado process_instance_id
.
Crie uma instância do público ProcessManager
cliente ( com.adobe.idp.workflow.client.ProcessManager
) usando um ServiceClientFactory
com as configurações de conexão corretas.
Para obter mais informações, consulte Referência da API Java para Gerenciador de processos de classe.
Verifique o status da instância do workflow. Se o status for diferente de 2 (COMPLETE) ou 4 (TERMINATED), termine a instância primeiro chamando o seguinte método:
ProcessManager.terminateProcess(<long_lived_invocation_id>)
.
Expurgue a instância do workflow chamando o seguinte método:
ProcessManager.purgeProcessInstance(<long_lived_invocation_id>)
O purgeProcessInstance
O método exclui completamente todos os dados da ID de invocação especificada do banco de dados do servidor AEM Forms e do GDS, se configurados.
Tarefas órfãs são as tarefas cujo processo contêiner foi iniciado, mas ainda não foi enviado. nesse caso, a variável process_instance_id
é 0 (zero). Portanto, não é possível rastrear os dados do usuário armazenados para tarefas órfãs usando IDs de instância de processo. No entanto, você pode rastreá-lo usando a ID da tarefa para uma tarefa órfã. Você pode identificar as IDs de tarefas do tb_task
para um usuário, conforme descrito em Identifique as IDs de instância do processo quando o iniciador ou o participante do fluxo de trabalho for conhecido.
Depois de ter as IDs da tarefa, faça o seguinte para limpar os arquivos e dados associados com uma tarefa órfã do GDS e do banco de dados.
Execute o seguinte comando no banco de dados do servidor do AEM Forms para recuperar IDs das IDs de tarefa identificadas.
select id from tb_form_data where task_id=<task_id>
O query retorna uma lista de IDs. Para cada ID ( fd_id
) retornado nos resultados, crie uma lista de sequências de caracteres da ID da sessão da seguinte maneira:
wfattach<task_id>
_wftask<fd_id>
_wftaskformid<fd_id>
Dependendo de seu GDS apontar para um sistema de arquivos ou um banco de dados, execute uma das seguintes etapas:
GDS no sistema de arquivos
No sistema de arquivos GDS:
_wfattach<task_id>
_wftask<fd_id>
_wftaskformid<fd_id>
Os arquivos com essas extensões são os arquivos de marcador. Eles são armazenados com nomes de arquivo no seguinte formato:
<file_name_guid>.session<session_id_string>
<file_name_guid>
do sistema de arquivos.GDS no banco de dados
Execute os seguintes comandos para cada ID de sessão:
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>
Execute os seguintes comandos para excluir dados para IDs de tarefa do banco de dados do servidor do 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>