Fluxos de trabalho centrados na Forms no OSGi | Tratamento de dados do usuário

Os fluxos de trabalho de AEM centrados no Forms permitem automatizar processos de negócios centrados no Forms. Os workflows consistem em uma série de etapas executadas em uma ordem especificada no modelo de workflow associado. Cada etapa executa uma ação específica, como atribuir uma tarefa a um usuário ou enviar uma mensagem de email. Os workflows podem interagir com ativos no repositório, contas de usuário e serviços. Portanto, os workflows podem coordenar atividades complicadas que envolvem qualquer aspecto do Experience Manager.

Um fluxo de trabalho centrado em formulários pode ser acionado ou iniciado por meio de qualquer um dos seguintes métodos:

• Envio de um aplicativo AEM Caixa de entrada
• Envio de um aplicativo do aplicativo AEM Forms
• Envio de um formulário adaptável
• Uso de uma pasta assistida
• Envio de uma comunicação interativa ou uma carta

Para obter mais informações sobre fluxos de trabalho e recursos de AEM centrados no Forms, consulte Fluxo de trabalho centrado no Forms em OSGi.

Os dados e armazenamentos de dados do usuário

Quando um workflow é acionado, uma carga é gerada automaticamente para a instância do workflow. Cada instância do fluxo de trabalho recebe uma ID de instância exclusiva e uma ID de carga associada. A carga contém os locais do repositório para dados de usuário e formulário associados a uma instância de fluxo de trabalho. Além disso, rascunhos e dados históricos de uma instância de workflow também são armazenados no repositório AEM.

Os locais padrão do repositório onde reside a carga, os rascunhos e o histórico de uma instância de fluxo de trabalho são os seguintes:

Acessar e excluir dados do usuário

Você pode acessar e excluir dados do usuário de uma instância de workflow no repositório. Para isso, você deve saber a ID da instância da instância do fluxo de trabalho associada ao usuário. Você pode encontrar a ID da instância de uma instância de fluxo de trabalho usando o nome de usuário do usuário que iniciou a instância do fluxo de trabalho ou que é o destinatário atual da instância do fluxo de trabalho.

No entanto, você não pode identificar ou os resultados podem ser ambíguos ao identificar workflows associados a um iniciador nos seguintes cenários:

• O fluxo de trabalho é acionado por meio de uma pasta monitorada: Uma instância de workflow não pode ser identificada usando seu iniciador se o workflow for acionado por uma pasta monitorada. Nesse caso, as informações do usuário são codificadas nos dados armazenados.
• Fluxo de trabalho iniciado da instância de publicação AEM: Todas as instâncias de fluxo de trabalho são criadas usando um usuário de serviço quando formulários adaptáveis, comunicações interativas ou cartas são enviadas AEM instância de publicação. Nesses casos, o nome de usuário do usuário conectado não é capturado nos dados da instância do fluxo de trabalho.

Acessar dados do usuário

Para identificar e acessar os dados do usuário armazenados para uma instância de workflow, execute as seguintes etapas:

1. Em AEM instância do autor, vá para https://[server]:[port]/crx/de e navegue até Ferramentas > Consulta.

   Selecione SQL2 no menu suspenso Type.

2. Dependendo das informações disponíveis, execute uma das seguintes consultas:

   • Execute o seguinte se o iniciador do workflow for conhecido:

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

   • Execute o seguinte se o usuário cujos dados você está encontrando for o destinatário do fluxo de trabalho atual:

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

   A query retorna o local de todas as instâncias de fluxo de trabalho para o iniciador do fluxo de trabalho especificado ou o destinatário do fluxo de trabalho atual.

   Por exemplo, a consulta a seguir retorna dois caminhos de instâncias de fluxo de trabalho do nó /var/workflow/instances cujo iniciador do fluxo de trabalho é srose.

   

3. Vá para um caminho de instância de workflow retornado pela query. A propriedade status exibe o status atual da instância do fluxo de trabalho.

   

4. No nó da instância do fluxo de trabalho, navegue até data/payload/. A propriedade path armazena o caminho para a carga da instância do fluxo de trabalho. Você pode navegar até o caminho para acessar dados armazenados no payload.

   

5. Navegue até os locais para rascunhos e histórico da instância do workflow.

   Por exemplo:

   /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 as etapas 3 a 5 para todas as instâncias de fluxo de trabalho retornadas pela consulta na etapa 2.

Excluir dados do usuário

Você deve ser um administrador AEM para excluir dados do usuário das instâncias do fluxo de trabalho, executando as seguintes etapas:

1. Siga as instruções em Acessar dados do usuário e anote o seguinte:

   • Caminhos para instâncias de fluxo de trabalho associadas ao usuário
   • Status das instâncias de fluxo de trabalho
   • Caminhos para cargas das instâncias do fluxo de trabalho
   • Caminhos para rascunhos e histórico das instâncias do fluxo de trabalho

2. Execute esta etapa para instâncias de fluxo de trabalho em EXECUTANDO, SUSPENDIDO ou ESCALA status:

   1. Vá para https://[server]:[port]/aem/start.html e faça logon com credenciais de administrador.
   2. Navegue até Ferramentas > Fluxo de trabalho> Instâncias.
   3. Selecione as instâncias de fluxo de trabalho relevantes para o usuário e toque em Encerrar para encerrar as instâncias em execução.

   Para obter mais informações sobre como trabalhar com instâncias de fluxo de trabalho, consulte Administração de instâncias de fluxo de trabalho.

3. Vá para o console CRXDE Lite, navegue até o caminho de carga de uma instância de fluxo de trabalho e exclua o nó payload.

4. Navegue até o caminho de rascunhos de uma instância de fluxo de trabalho e exclua o nó draft.

5. Navegue até o caminho do histórico para uma instância de workflow e exclua o nó history.

6. Navegue até o caminho da instância do fluxo de trabalho para uma instância do fluxo de trabalho e exclua o nó [workflow-instance-ID] do fluxo de trabalho.

   OBSERVAÇÃO

   A exclusão do nó da instância do fluxo de trabalho removerá a instância do fluxo de trabalho para todos os participantes do fluxo de trabalho.

7. Repita as etapas 2 a 6 para todas as instâncias de fluxo de trabalho identificadas para um usuário.

8. Identifique e exclua dados de rascunho e envio offline da caixa de saída do aplicativo AEM Forms dos participantes do fluxo de trabalho para evitar qualquer envio para o servidor.

Também é possível usar APIs para acessar e remover nós e propriedades. Consulte os documentos a seguir para obter mais informações.

• Como acessar programaticamente o JCR AEM
• Remover nós e propriedades
• Referência da API