文档AEM 6.4Forms 指南

Forms JEE工作流 |处理用户数据 forms-jee-workflows-handling-user-data

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Admin
CAUTION
AEM 6.4已结束扩展支持，本文档将不再更新。 有关更多详细信息，请参阅 技术支助期. 查找支持的版本 此处.

AEM Forms JEE工作流提供了用于设计、创建和管理业务流程的工具。 工作流进程由一系列按指定顺序执行的步骤组成。 每个步骤都执行特定操作，如将任务分配给用户或发送电子邮件。 流程可以与资产、用户帐户和服务进行交互，并且可以使用以下任一方法触发：

  • 从AEM Forms Workspace启动流程
  • 使用SOAP或RESTful服务
  • 提交自适应表单
  • 使用监视文件夹
  • 使用电子邮件

有关创建AEM Forms JEE工作流流程的更多信息，请参阅 Workbench帮助.

用户数据和数据存储 user-data-and-data-stores

当触发某个进程并且该进程继续运行时，该进程会捕获有关该进程参与者的数据、参与者在与该进程关联的表单中输入的数据以及添加到表单的附件。 数据存储在AEM Forms JEE服务器数据库中，如果配置，某些数据（如附件）将存储在全局文档存储(GDS)目录中。 GDS目录可以在共享文件系统或数据库上配置。

访问和删除用户数据 access-and-delete-user-data

在触发进程时，将生成唯一的进程实例ID和长时间调用ID，并将其与进程实例关联。 您可以基于长时间调用ID访问和删除进程实例的数据。 您可以使用提交其任务的进程启动器或进程参与者的用户名推断进程实例的长期调用ID。

但是，在以下情况下，您无法识别启动器的进程实例ID:

  • 通过监视文件夹触发的进程:如果进程由监视的文件夹触发，则无法使用其启动器来识别该进程实例。 在这种情况下，用户信息在存储的数据中进行编码。
  • 从发布AEM实例启动的进程:从AEM发布实例触发的所有进程实例不会捕获有关启动器的信息。 但是，用户数据可以以与进程关联的形式捕获，该形式存储在工作流变量中。
  • 通过电子邮件启动的流程:发件人的电子邮件ID将作为属性捕获到 tb_job_instance 数据库表，不能直接查询。

在已知工作流启动器或参与者时标识进程实例ID initiator-participant

执行以下步骤以标识工作流启动器或参与者的流程实例ID:

  1. 在AEM Forms服务器数据库中执行以下命令，以从 edcprincipalentity 数据库表。

    code language-sql 
    select id from edcprincipalentity where canonicalname='user_ID'

    查询会返回指定的的主体ID user_ID.

  2. (对于工作流启动器)执行以下命令，从 tb_task 数据库表。

    code language-sql 
    select * from tb_task where start_task = 1 and create_user_id= 'initiator_principal_id'

    查询返回由指定的 initiator_ principal_id. 任务分为两种类型：

    • 已完成的任务:这些任务已提交，并会在 process_instance_id 字段。 请注意已提交任务的所有进程实例ID，并继续执行步骤。
    • 已启动但未完成的任务:这些任务已启动但尚未提交。 的值 process_instance_id 这些任务的字段为 0 （零）。 在这种情况下，请注意相应的任务ID，并参阅 处理孤立任务.

  3. (对于工作流参与者)执行以下命令，从 tb_assignment 数据库表。

    code language-sql 
    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'

    查询会返回与参与者关联的所有进程的实例ID，包括参与者未提交任何任务的进程。

    请注意已提交任务的所有进程实例ID，并继续执行步骤。

    对于孤立任务或任务，其中 process_instance_id 为0（零），记下相应的任务ID并参阅 处理孤立任务.

  4. 按照 根据流程实例ID从工作流实例中清除用户数据 用于删除已标识进程实例ID的用户数据的部分。

在原始变量中存储用户数据时标识进程实例ID primitive

可以设计工作流，以便在变量中捕获用户数据，该变量将作为Blob存储在数据库中。 在这种情况下，仅当用户数据存储在以下基元类型变量之一中时，才能查询用户数据：

  • 字符串:直接包含用户ID或作为子字符串包含，并可使用SQL查询。
  • 数值:直接包含用户ID。
  • XML:将用户ID作为子字符串包含在数据库中作为文本列存储的文本中，并且可以像字符串一样查询。

执行以下步骤以确定在基元类型变量中存储数据的工作流是否包含用户的数据：

  1. 执行以下数据库命令：

    code language-sql 
    select database_table from omd_object_type where name='pt_<app_name>/<workflow_name>'

    查询在 tb_<number> 指定应用程序的格式( app_name)和工作流( workflow_name)。

    note note
    NOTE
    的值 name 如果工作流嵌套在应用程序内的子文件夹中，则属性可能会非常复杂。 确保指定工作流的确切完整路径，您可以从 omd_object_type 数据库表。

  2. 查看 tb_<number> 表模式。 该表包含用于存储指定工作流的用户数据的变量。 表中的变量与工作流中的变量相对应。

    识别并记下与包含用户ID的工作流变量对应的变量。 如果标识的变量是基元类型，则可以运行查询以确定与用户ID关联的工作流实例。

  3. 执行以下数据库命令。 在此命令中， user_var 是包含用户ID的基元类型变量。

    code language-sql 
    select process_instance_id from <tb_name> where <user_var>=<user_ID>

    查询会返回与指定的 user_ID.

  4. 按照 根据流程实例ID从工作流实例中清除用户数据 用于删除已标识进程实例ID的用户数据的部分。

根据流程实例ID从工作流实例中清除用户数据 purge

现在，您已识别与用户关联的进程实例ID，请执行以下操作以从相应的进程实例中删除用户数据。

  1. 执行以下命令，以从 tb_process_instance 表。

    code language-sql 
    select long_lived_invocation_id, status from tb_process_instance where id='process_instance_id'

    查询会返回指定的长期调用ID和状态 process_instance_id.

  2. 创建公共实例 ProcessManager 客户端( com.adobe.idp.workflow.client.ProcessManager)使用 ServiceClientFactory 实例。

    有关更多信息，请参阅的Java API参考 类ProcessManager.

  3. 检查工作流实例的状态。 如果状态不是2(COMPLETE)或4(TERMINATED)，请首先通过调用以下方法来终止实例：

    ProcessManager.terminateProcess(<long_lived_invocation_id>)。

  4. 通过调用以下方法清除工作流实例：

    ProcessManager.purgeProcessInstance(<long_lived_invocation_id>)

    的 purgeProcessInstance 方法会从AEM Forms服务器数据库和GDS中完全删除指定调用ID的所有数据（如果已配置）。

处理孤立任务 orphan

孤立任务是指其包含进程已启动但尚未提交的任务。 在本例中， process_instance_id is 0 （零）。 因此，您无法使用进程实例ID跟踪为孤立任务存储的用户数据。 但是，您可以使用孤立任务的任务ID跟踪该任务。 您可以从 tb_task 用户的表，如 在已知工作流启动器或参与者时标识进程实例ID.

获得任务ID后，请执行以下操作，以从GDS和数据库中清除具有孤立任务的关联文件和数据。

  1. 在AEM Forms服务器数据库上执行以下命令以检索已标识任务ID的ID。

    code language-sql 
    select id from tb_form_data where task_id=<task_id>

    查询会返回ID列表。 对于每个ID( fd_id)，创建会话ID字符串列表，如下所示：

    • _ wfattach<task_id>
    • _wftask<fd_id>
    • _wftaskformid<fd_id>

  2. 根据GDS是指向文件系统还是数据库，执行以下步骤之一：

    1. 文件系统中的GDS

      在GDS文件系统中：

      1. 搜索具有以下会话ID字符串的文件作为其扩展名：

      • _wfattach<task_id>

      • _wftask<fd_id>

      • _wftaskformid<fd_id>

        具有这些扩展名的文件是标记文件。 文件名采用以下格式进行存储：

        <file_name_guid>.session<session_id_string>

      1. 删除文件名完全为 <file_name_guid> 文件系统中。

    2. 数据库中的GDS

      对每个会话ID执行以下命令：

      code language-sql 
      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>

  3. 执行以下命令，从AEM Forms服务器数据库中删除任务ID的数据：

    code language-sql 
    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>
recommendation-more-help
a6ebf046-2b8b-4543-bd46-42a0d77792da