Forms JEE ワークフロー | ユーザーデータの処理

最終更新日: 2023-11-01
  • 作成対象:
  • Admin

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 データベーステーブルの Opaque Blob 列にプロパティとして取得されます。

ワークフローの開始者または参加者が既知の場合のプロセスインスタンス ID の識別

ワークフロー開始者または参加者のプロセスインスタンス ID を識別できるように、次の手順を実行します。

  1. AEM Forms Server データベースで次のコマンドを実行して、 edcprincipalentity データベーステーブル。

    select id from edcprincipalentity where canonicalname='user_ID'
    

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

  2. ワークフローイニシエーターの場合)次のコマンドを実行して、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 をメモして、オーファンタスクの操作を参照してください。
  3. ワークフロー参加者の場合)次のコマンドを実行して、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 をメモして、オーファンタスクの操作を参照してください。

  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>'
    

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

    メモ

    の値 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 に関連付けられたすべてのプロセスインスタンス ID が返されます。

  4. 詳しくは、 プロセスインスタンス ID に基づいて、ワークフローインスタンスからユーザーデータをパージします 」セクションを使用して、識別されたプロセスインスタンス ID のユーザーデータを削除できます。

プロセスインスタンス ID に基づいて、ワークフローインスタンスからユーザーデータをパージします

ユーザーに関連付けられたプロセスインスタンス ID を識別したら、以下の手順を実行して、各プロセスインスタンスからユーザーデータを削除します。

  1. 次のコマンドを実行して、プロセスインスタンスの長時間有効な呼び出し ID とステータスを tb_process_instance 表。

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

    クエリを実行すると、指定された process_instance_id の永続的呼び出し 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>)

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

オーファンタスクの操作

オーファンタスクとは、プロセスが開始されたがまだ送信されていないタスクを指します。 この場合、 process_instance_id 次に該当 0 (ゼロ)を返します。 したがって、プロセスインスタンス ID を使用してオーファンタスク用に保存されたユーザーデータをトレースすることはできません。 ただし、オーファンタスクのタスク ID を使用してトレースできます。 ワークフローイニシエーターまたは参加者が分かっている場合のプロセスインスタンス ID の特定で説明されているように、ユーザーの tb_task テーブルからタスク ID を特定することができます。

タスク ID を取得したら、次の手順を実行して、GDS およびデータベースからオーファンタスクを含む関連ファイルとデータをパージします。

  1. AEM Forms Server データベースで次のコマンドを実行して、識別されたタスク 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 Server データベースからタスク 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>
    

このページ