Forms JEE工作流程 |處理用戶資料

AEM Forms JEE工作流程提供設計、建立和管理業務流程的工具。 工作流進程由一系列按指定順序執行的步驟組成。 每個步驟都會執行特定動作,例如指派任務給使用者或傳送電子郵件訊息。 程式可與資產、使用者帳戶和服務互動,並可使用下列任一方法觸發:

  • 從AEM Forms Workspace啟動程式
  • 使用SOAP或RESTful服務
  • 提交最適化表單
  • 使用監看資料夾
  • 使用電子郵件

如需建立AEM Forms JEE工作流程程式的詳細資訊,請參閱 Workbench說明.

使用者資料和資料儲存

當進程被觸發並隨著進行,它將捕獲有關進程參與者的資料、參與者在與進程關聯的表單中輸入的資料以及添加到表單的附件。 資料會儲存在AEM Forms JEE伺服器資料庫中,若已設定,某些資料(例如附件)會儲存在全域檔案儲存(GDS)目錄中。 GDS目錄可在共用檔案系統或資料庫上配置。

存取和刪除使用者資料

觸發進程時,將生成唯一的進程實例ID和長期調用ID,並與進程實例關聯。 您可以根據長期調用ID訪問和刪除進程實例的資料。 您可以推斷已提交其任務的進程啟動器或進程參與者的用戶名的進程實例的長期調用ID。

但是,在以下情況下,您無法標識啟動器的進程實例ID:

  • 透過已監看資料夾觸發的程式:如果進程是由監視的資料夾觸發,則無法使用其啟動器來標識進程實例。 在這種情況下,用戶資訊被編碼在儲存的資料中。
  • 從發佈AEM例項啟動的程式:從AEM發佈例項觸發的所有程式例項不會擷取啟動器的相關資訊。 但是,用戶資料可以以與流程相關聯的形式捕獲,該過程儲存在工作流變數中。
  • 通過電子郵件啟動的流程:傳送者的電子郵件ID會擷取為 tb_job_instance 資料庫表,無法直接查詢。

在已知工作流啟動器或參與者時標識進程實例ID

執行以下步驟來標識工作流啟動器或參與者的進程實例ID:

  1. 在AEM Forms伺服器資料庫中執行以下命令,以從 edcprincipalentity 資料庫表。

    select id from edcprincipalentity where canonicalname='user_ID'
    

    查詢會傳回指定之 user_ID.

  2. (工作流啟動器)執行以下命令,從 tb_task 資料庫表。

    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. (對於工作流參與者)執行以下命令,從中檢索與啟動器的進程參與者的主體ID關聯的進程實例ID tb_assignment 資料庫表。

    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

可以設計工作流,以便用戶資料被捕獲到變數中,該變數儲存為資料庫中的blob。 在這種情況下,只有當使用者資料儲存在下列原始類型變數之一時,才可以查詢該資料:

  • 字串:直接包含用戶ID或作為子字串,並可使用SQL查詢。
  • 數值:直接包含使用者ID。
  • XML:在儲存為資料庫中文本列的文本內,將用戶ID作為子字串,可以像字串一樣查詢。

執行下列步驟以確定以基元類型變數儲存資料的工作流程是否包含使用者的資料:

  1. 執行以下資料庫命令:

    select database_table from omd_object_type where name='pt_<app_name>/<workflow_name>'
    

    查詢會在 tb_<number> 指定應用程式的格式( app_name)和工作流程( workflow_name)。

    注意

    的值 name 如果工作流程巢狀內嵌在應用程式內的子資料夾中,屬性可能會很複雜。 請確定您指定確切的工作流程完整路徑,以便從 omd_object_type 資料庫表。

  2. 檢閱 tb_<number> 表架構。 該表包含用於儲存指定工作流的用戶資料的變數。 表格中的變數對應至工作流程中的變數。

    識別並記下與包含使用者ID的工作流程變數相對應的變數。 如果識別的變數為基元類型,您可以執行查詢以判斷與使用者ID相關聯的工作流程例項。

  3. 執行以下資料庫命令。 在此命令中, user_var 是包含使用者ID的基元類型變數。

    select process_instance_id from <tb_name> where <user_var>=<user_ID>
    

    查詢會傳回與指定 user_ID.

  4. 遵循 根據流程實例ID從工作流實例中清除用戶資料 區段,刪除已識別之程式例項ID的使用者資料。

根據流程實例ID從工作流實例中清除用戶資料

現在您已識別與使用者相關聯的處理例項ID,請執行下列動作,從個別的處理例項刪除使用者資料。

  1. 執行以下命令,從 tb_process_instance 表格。

    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的所有資料。

使用孤立任務

孤立任務是指其包含進程已啟動但尚未提交的任務。 在本例中, process_instance_id is 0 (零)。 因此,您不能使用進程實例ID跟蹤為孤立任務儲存的用戶資料。 但是,您可以使用孤立任務的任務ID來跟蹤它。 您可以從 tb_task 用戶表,如 在已知工作流啟動器或參與者時標識進程實例ID.

擁有任務ID後,請執行以下操作,從GDS和資料庫中清除具有孤立任務的關聯檔案和資料。

  1. 在AEM Forms伺服器資料庫上執行以下命令,以檢索所標識任務ID的ID。

    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執行以下命令:

      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的資料:

    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>
    

本頁內容