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

Os workflows de AEM centrados na Forms permitem automatizar os processos comerciais centrados na Forms. Os workflows consistem em uma série de etapas que são executadas em uma ordem especificada no modelo de fluxo de trabalho 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
• Enviar um aplicativo do aplicativo AEM Forms
• Enviar um formulário adaptável
• Uso de uma pasta assistida
• Enviar uma comunicação interativa ou uma carta

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

Os dados do usuário e os armazenamentos de dados

Quando um fluxo de trabalho é acionado, uma carga é gerada automaticamente para a instância do fluxo de trabalho. 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 do fluxo de trabalho. Além disso, os rascunhos e os dados históricos de uma instância de fluxo de trabalho também são armazenados no repositório AEM.

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

Acessar e excluir dados do usuário

Você pode acessar e excluir dados do usuário de uma instância do fluxo de trabalho no repositório. Para isso, é necessário saber a ID da instância da instância do fluxo de trabalho associada ao usuário. Você pode encontrar a ID de instância de uma instância do 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:

• Fluxo de trabalho acionado por meio de uma pasta assistida: Uma instância de fluxo de trabalho não pode ser identificada usando seu iniciador se o fluxo de trabalho for acionado por uma pasta assistida. 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 letras 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 do fluxo de trabalho, execute as seguintes etapas:

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

   Selecione SQL2 no menu suspenso Type.

2. Dependendo das informações disponíveis, execute um dos seguintes query:

   • Execute o seguinte caso o iniciador do fluxo de trabalho seja conhecido:

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

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

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

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

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

   

3. Vá para um caminho de instância de fluxo de trabalho retornado pelo 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 os dados armazenados na carga.

   

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

   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 pelo query na etapa 2.

Excluir dados do usuário

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

1. Siga as instruções em Acesse os 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 para instâncias de fluxo de trabalho
   • Caminhos para rascunhos e histórico das instâncias de fluxo de trabalho

2. Execute esta etapa para instâncias de fluxo de trabalho em EXECUÇÃO, SUSPENDER ou ESTÁDIO estado:

   1. Vá para https://[server]:[port]/aem/start.html e faça logon com as 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 de uma instância de fluxo de trabalho 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 de 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 ao servidor.

Você também pode 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
• Remoção de nós e propriedades
• Referência da API