IM-BPM for Accel Platform IM-BPM 仕様書 第18版 2024-04-01

履歴タイムライン(「履歴・コメント」エレメント)

IM-BloomMakerの「履歴・コメント」エレメントは、タイムライン形式で履歴の表示やコメントの投稿を行う機能です。
「履歴・コメント」エレメントにIM-BPM for Accel Platformのプロセスインスタンス・ケースインスタンスの履歴情報を表示することで、プロセス詳細画面・ケース詳細画面の履歴タイムラインをIM-BloomMakerのコンテンツ上で実現する方法について説明します。
本機能は、IM-BPM for Accel Platform 2020 Winter(Azalea)から利用可能です。

コラム

プロセス詳細画面の履歴タイムラインの詳細については、「プロセスインスタンスを確認する 」を参照してください。
ケース詳細画面の履歴タイムラインの詳細については、「ケースインスタンスを確認する 」を参照してください。

プロパティ値の説明

プロセスインスタンス・ケースインスタンスの履歴情報を「履歴・コメント」エレメントに表示する際にプロパティに設定すべき値について説明します。

コラム

「履歴・コメント」エレメントの詳細については、「履歴・コメントモジュールプログラミングガイド 」を参照してください。

application

「履歴・コメント」エレメントと連携するアプリケーションを指定するプロパティです。文字列にて指定します。
プロセスインスタンス・ケースインスタンスの履歴情報を表示するには、applicationプロパティに固定値 IM_BPMを指定します。

eventGroupKey

「履歴・コメント」エレメントに表示するイベントグループのデータを指定するプロパティです。オブジェクト型の形式にて指定します。
プロセスインスタンス・ケースインスタンスの履歴情報を表示するには、eventGroupKeyプロパティに以下の形式のオブジェクトを指定します。
プロパティ名 説明
functionType 固定値 PROCESS_INSTANCE_HISTORYを指定します。 文字列
processInstanceId 履歴データの表示対象のプロセスインスタンスのIDまたはケースインスタンスのIDを指定します。 文字列
{
    "functionType": "PROCESS_INSTANCE_HISTORY",
    "processInstanceId": "%プロセスインスタンスID%"
}

eventTypeIds

「履歴・コメント」エレメントに表示する履歴をイベントタイプにて絞り込むためのプロパティです。表示するイベントタイプのIDのリストを配列形式にて指定します。
プロセスインスタンスの履歴情報を表示するには、eventTypeIdsプロパティに以下の配列を指定します。
[
    "im_bpm_process_instance_activity_log",
    "im_journal_comment",
    "im_journal_attachment_delete"
]
ケースインスタンスの履歴情報を表示するには、eventTypeIdsプロパティに以下の配列を指定します。
[
    "im_bpm_case_instance_stage_log",
    "im_bpm_case_instance_activity_log",
    "im_bpm_case_instance_other_activity_log",
    "im_journal_comment",
    "im_journal_attachment_delete"
]

コラム

上記で指定している各イベントタイプIDの説明です。必要に応じてeventTypeIdsプロパティに指定する内容を変更してください。
  • eventTypeId im_bpm_process_instance_activity_log

    • プロセスインスタンスのアクティビティの履歴を表示するイベントタイプのIDです。
  • eventTypeId im_bpm_case_instance_stage_log

    • ケースインスタンスのステージの履歴を表示するイベントタイプのIDです。
  • eventTypeId im_bpm_case_instance_activity_log

    • ケースインスタンスのアクティビティの履歴を表示するイベントタイプのIDです。
  • eventTypeId im_bpm_case_instance_other_activity_log

    • ケースビューアに表示されないタイプのアクティビティ(メッセージキャッチイベントなど)の履歴を表示するイベントタイプのIDです。
    • 上記のイベントタイプは、ケース詳細画面の初期表示では非表示です。
  • eventTypeId im_journal_comment

    • コメント/添付ファイルのイベントタイプのIDです。
  • eventTypeId im_journal_attachment_delete

    • 添付ファイル削除のイベントタイプのIDです。

showEventCount

履歴件数の表示/非表示を制御するためのプロパティです。履歴件数を表示する場合に有効にしてください。
プロセスインスタンス・ケースインスタンスの履歴情報を表示するには、showEventCountプロパティを無効にしてください。

コラム

プロセスインスタンス・ケースインスタンスの履歴には画面上で非表示の履歴データが存在します。そのため、履歴件数と実際に画面に表示される履歴の件数が一致しないため、showEventCountプロパティを無効にし、履歴件数を表示しないことを推奨しています。

履歴タイムラインとの機能差異

プロセス詳細画面・ケース詳細画面の履歴タイムラインと履歴タイムライン(「履歴・コメント」エレメント)との主な機能差異について説明します。

プロセス詳細画面の履歴タイムラインとの機能差異

  • コールアクティビティ

    • 履歴タイムライン(「履歴・コメント」エレメント)では、プロセス詳細画面の履歴タイムラインで表示される以下のリンクを非表示にしています。

      • コールアクティビティのアクティビティ履歴から呼び出し先のプロセスインスタンスの詳細画面へのリンク
      • コールアクティビティによって呼び出されたプロセスインスタンスの呼び出し元のプロセスインスタンスの詳細画面へのリンク
  • コメント/添付ファイル機能

    • 履歴タイムライン(「履歴・コメント」エレメント)では、ユーザがタイムラインに対してコメントと添付ファイルを追加・更新・削除できる機能を提供しています。
    • プロセス詳細画面の履歴タイムラインでは、コメント/添付ファイル機能を利用できません。

ケース詳細画面の履歴タイムラインとの機能差異

  • コールアクティビティ

    • 履歴タイムライン(「履歴・コメント」エレメント)では、ケース詳細画面の履歴タイムラインで表示される以下のリンクを非表示にしています。

      • コールアクティビティのアクティビティ履歴から呼び出し先のケースインスタンスの詳細画面へのリンク
      • コールアクティビティによって呼び出されたケースインスタンスの呼び出し元のケースインスタンスの詳細画面へのリンク
  • 絞込み条件機能

    • ケース詳細画面の履歴タイムラインでは、絞込み条件機能を利用して表示する履歴のイベントタイプを絞り込めます。
    • 履歴タイムライン(「履歴・コメント」エレメント)では、絞込み条件機能を提供していません。そのため、絞込み条件機能が必要な場合は、IM-BloomMakerのコンテンツ上に実装してください。

コラム

履歴タイムライン(「履歴・コメント」エレメント)はアドオンの画面にて利用されるため、遷移先のプロセス詳細画面・ケース詳細画面についてもアドオンの画面となることが想定されます。そのため、製品標準のプロセス詳細画面・ケース詳細画面へのリンクを非表示にしています。

コラム

コメント/添付ファイル機能の詳細については、「履歴・コメントモジュールユーザ操作ガイド 」を参照してください。

コラム

絞込み条件の詳細については、「ケースインスタンスを確認する 」を参照してください。

権限

履歴タイムライン(「履歴・コメント」エレメント)を表示するには、 アカウントコンテキストのユーザが以下のどちらかの条件を満たすことが必要です。
  • IM-BPM管理者であること。
  • IM-BPMプロセス参照ユーザである、かつ、表示対象のプロセスインスタンスまたはケースインスタンスの関係者であること。