Forms JEE ワークフロー | ユーザーデータの処理 forms-jee-workflows-handling-user-data

AEM Forms サーバーデータベースで次のコマンドを実行して、edcprincipalentity データベーステーブルからワークフローイニシエーターまたは参加者のプリンシパル ID を取得します。

select id from edcprincipalentity where canonicalname='user_ID'

クエリを実行すると、指定された user_ID のプリンシパル ID が返されます。

（ワークフローイニシエーターの場合）次のコマンドを実行して、tb_task データベーステーブルからイニシエーターのプリンシパル ID に関連付けられたすべてのタスクを取得します。

select * from tb_task where start_task = 1 and create_user_id= 'initiator_principal_id'

クエリを実行すると、指定された initiator_principal_id により開始されたタスクが返されます。タスクには次の 2 つのタイプがあります。

• 完了したタスク：これらのタスクは既に送信されており、process_instance_id フィールドには英数字の値が表示されます。送信済みタスクのすべてのプロセスインスタンス ID をメモして、手順を続行します。
• 開始されたが完了していないタスク：これらのタスクは開始されていますが、まだ送信されていません。これらのタスクの process_instance_id フィールドの値は、0（ゼロ）になります。この場合、対応するタスク ID をメモして、オーファンタスクの操作を参照してください。

（ワークフロー参加者の場合）次のコマンドを実行して、tb_assignment データベーステーブルからイニシエーター用のプロセス参加者のプリンシパル ID に関連付けられたプロセスインスタンス ID を取得します。

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 をメモして、オーファンタスクの操作を参照してください。

プロセスインスタンス ID に基づいてワークフローインスタンスからユーザーデータを削除するの節の手順に従って、特定されたプロセスインスタンス ID のユーザーデータを削除します。

次のデータベースコマンドを実行します。

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

クエリを実行すると、指定されたアプリケーション（app_name）およびワークフロー（workflow_name）に tb_<number> 形式でテーブル名が返されます。

tb_<number> テーブルスキーマを確認します。テーブルには、指定されたワークフローのユーザーデータを格納する変数が含まれています。テーブルの変数はワークフローの変数に対応しています。

ユーザー ID を含むワークフロー変数に対応する変数を特定してメモしておきます。特定された変数がプリミティブ型の場合は、クエリを実行して、ユーザー ID に関連付けられたワークフローインスタンスを確認できます。

次のデータベースコマンドを実行します。このコマンドでは、user_var がユーザー ID を含むプリミティブ型の変数です。

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

クエリを実行すると、指定された user_ID に関連付けられたすべてのプロセスインスタンス ID が返されます。

プロセスインスタンス ID に基づいてワークフローインスタンスからユーザーデータを削除するセクションの手順に従って、特定されたプロセスインスタンス ID のユーザーデータを削除します。

次のコマンドを実行して、tb_process_instance テーブルからプロセスインスタンスの永続的呼び出し ID およびステータスを取得します。

select long_lived_invocation_id, status from tb_process_instance where id='process_instance_id'

クエリを実行すると、指定された process_instance_id の永続的呼び出し ID およびステータスが返されます。

パブリック ProcessManager クライアント（com.adobe.idp.workflow.client.ProcessManager）のインスタンスを、適切に接続設定された ServiceClientFactory インスタンスを使用して作成します。

詳しくは、Class ProcessManager の Java™ API リファレンスを参照してください。

ワークフローインスタンスのステータスを確認します。ステータスが 2（COMPLETE）または 4（TERMINATED）以外の場合、次のメソッドを呼び出して最初にインスタンスを停止します。

ProcessManager.terminateProcess(<long_lived_invocation_id>)。

次のメソッドを呼び出して、ワークフローインスタンスを削除します。

ProcessManager.purgeProcessInstance(<long_lived_invocation_id>)

purgeProcessInstance メソッドを使用すると、AEM Forms サーバーデータベースおよび GDS から、指定された呼び出し ID のすべてのデータが完全に削除されます（設定が行われている場合）。

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>

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>

次のコマンドを実行して、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>