DocumentaçãoAEM 6.5Guia do usuário

Fluxos de trabalho centrados no Forms no OSGi | Manuseio de dados do usuário forms-centric-workflows-on-osgi-handling-user-data

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Admin

Os fluxos de trabalho de AEM centrados na Forms permitem que você automatize processos de negócios reais centrados na Forms. Os fluxos de trabalho consistem em uma série de etapas 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 da Caixa de entrada AEM
  • Envio de uma solicitação de AEM Forms Aplicativo
  • Envio de um formulário adaptável
  • Uso de uma pasta monitorada
  • Enviar uma comunicação interativa ou uma carta

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

Dados do usuário e armazenamentos de dados user-data-and-data-stores

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

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

NOTE
É possível configurar locais diferentes para armazenar dados de carga, rascunho e histórico ao criar um fluxo de trabalho ou aplicativo. Para identificar os locais onde um fluxo de trabalho ou aplicativo armazenou dados, revise o fluxo de trabalho.
AEM 6.4 Forms
AEM 6.3 Forms
Fluxo de trabalho
instância
/var/workflow/instances/[server_id]/<date>/[workflow-instance]/
/etc/workflow/instances/[server_id]/[date]/[workflow-instance]/
Carga útil
/var/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
/etc/fd/dashboard/payload/[server_id]/[date]/
[payload-id]/
Rascunhos
/var/fd/dashboard/instances/[server_id]/
[date]/[workflow-instance]/draft/[workitem]/
/etc/fd/dashboard/instances/[server_id]/
[date]/[workflow-instance]/draft/[workitem]/
Histórico
/var/fd/dashboard/instances/[server_id]/
[date]/[workflow_instance]/history/
/etc/fd/dashboard/instances/[server_id]/
[date]/[workflow_instance]/history/

Acessar e excluir dados do usuário access-and-delete-user-data

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

No entanto, não é possível 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 monitorada: uma instância de fluxo de trabalho não poderá ser identificada com o iniciador se o fluxo de trabalho for acionado por uma pasta monitorada. Nesse caso, as informações do usuário são codificadas nos dados armazenados.
  • Fluxo de trabalho iniciado a partir da instância de publicação do 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 da instância de publicação do AEM. Nesses casos, o nome do usuário conectado não é capturado nos dados da instância do fluxo de trabalho.

Acessar dados do usuário access

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

  1. Na instância do autor do AEM, acesse https://'[server]:[port]'/crx/de e navegue até Ferramentas > Consulta.

    Selecionar SQL2 do Tipo menu suspenso.

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

    • Execute o seguinte se o iniciador do fluxo de trabalho for conhecido:

    SELECT &ast; 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 atual do workflow:

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

    A consulta 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, a consulta a seguir retorna o caminho de duas instâncias de fluxo de trabalho do /var/workflow/instances nó cujo iniciador do fluxo de trabalho é srose.

    workflow-instance

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

    status

  4. No nó da instância do fluxo de trabalho, navegue até data/payload/. A variável path A propriedade 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.

    payload-path

  5. Navegue até os locais dos rascunhos e do 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 - 5 para todas as instâncias de fluxo de trabalho retornadas pela consulta na etapa 2.

    note note
    NOTE
    AEM Forms O aplicativo também armazena dados no modo offline. É possível que os dados de uma instância de workflow sejam armazenados localmente em dispositivos individuais e sejam enviados para a Forms servidor quando o aplicativo é sincronizado com o servidor.

Excluir dados do usuário delete-user-data

Você deve ser um administrador do 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 tome nota do 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 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 no EM EXECUÇÃO, SUSPENSO ou OBSOLETO Status:

    1. Ir 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 instâncias de fluxo de trabalho relevantes para o usuário e selecione Encerrar para encerrar 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. Ir para CRXDE Lite console, navegue até o caminho da carga para uma instância de fluxo de trabalho e exclua o payload nó.

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

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

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

    note note
    NOTE
    A exclusão do nó da instância de fluxo de trabalho removerá a instância de 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. Identificar e excluir dados de rascunho e envio offline do AEM Forms caixa de saída de aplicativo 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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2