ジャーナルフィールドフレームワーク

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：3分

    • ジャーナルフィールドフレームワーク (JFF) を使用すると、プロバイダーとコンシューマーの間で、コメントや作業メモなどのジャーナルタイプフィールドをリアルタイムで同期できます。

    JFFはまた、運用の透明性を高め、履歴コンテキストを保持し、透明性を高めるために更新が実際のユーザーに帰属することを検証します。

    コンシューマーインスタンスとプロバイダーインスタンス間のジャーナルタイプフィールドの同期は、互換性バージョン 2.2.x 以降で構成されたリモートタスク定義 (RTD) によって有効になります。

    JFF では、次のことができます。

    ジャーナルフィールドマッピング
    リモートタスク定義の受信フィールドと送信フィールド構成に基づいて、プロバイダーインスタンスとコンシューマーインスタンス間でジャーナルタイプフィールドをマッピングして同期します。
    たとえば、RTD を作成するときに、次のようなマッピングを作成できます。
    • 作業メモへのコメント
    • 作業メモからコメントへ
    RTD に基づいてリモートタスクが作成されると、これらのマッピングされたジャーナルフィールドがプロバイダーインスタンスとコンシューマーインスタンスの間で自動的に同期されます。その結果、コメントまたは作業メモが 1 つのインスタンスに投稿されると、接続されたインスタンスにも表示されます。

    コメント間のマッピングは、サービスエクスチェンジ バージョン 2.2.x からリモートタスク定義を作成するときに、受信と送信の両方のフィールド構成でデフォルトで作成されます。詳細については、「プロバイダー向け サービスエクスチェンジ でのリモートタスク定義の作成」を参照してください。

    ジャーナルフィールドマッピングのルール
    ジャーナルフィールドフレームワークは、次の形式 (ソースからターゲット) をサポートしています。
    • ジャーナルフィールド (ソース) からジャーナルフィールド (ターゲット)
    • ジャーナルフィールド (ソース) から非ジャーナルフィールド (ターゲット)
    ジャーナルフィールドフレームワークは、ジャーナルフィールド (ソース) からジャーナルフィールド (ターゲット) への非ジャーナルフィールド (ターゲット) のマッピングをサポートしていません。
    注:
    リモートタスク定義 (RTD) では、異なるマッピングで同じジャーナルソースフィールドを 2 回使用することはできません。たとえば、同じ RTD 内の作業メモから作業メモ、および作業メモからコメントは許可されません。
    実際のユーザーとしてジャーナルエントリを書き込む
    汎用の会社名ではなく、ユーザー ID を使用してジャーナルエントリを書き込みます。たとえば、ユーザー David のすべてのコメントは David (xyz company) と表示されます。
    履歴ジャーナルエントリを同期する
    リモートタスクのコンシューマーインスタンスとプロバイダーインスタンス間ですべての履歴ジャーナルエントリを同期します。

    リモートタスク定義 (RTD) のセットアップ中および RTD の有効化中に [ 既存のエントリを同期する (Sync pre-existing entries )] オプションが設定されている場合、リモートタスクが接続されると、タスクに作成されたすべてのジャーナルコメントがコンシューマーインスタンスとプロバイダーインスタンス間で同期されます。

    考慮事項

    ジャーナルの同期または履歴ジャーナルの同期は、次のシナリオでは機能しない可能性があります。

    • リモートタスクが削除され、後で同じ親タスクと RTD に対して新しいリモートタスクが作成された場合、ジャーナルフィールドの同期は機能しません。
    • 接続された RTD で [ 既存のエントリを同期する (Sync pre-existing entries )] オプションが有効になっている場合でも、リモートタスクが切断されて後で再接続された場合、履歴ジャーナルエントリの同期は停止し、再開されません。