!--a11y-->
インスタンスリンクの評価と更新 
インスタンスリンクは、オブジェクトタイプ、オブジェクトキー、イベントの特定の組み合わせに対するレシーバインスタンスの割当を記述します。このリンクは、レシーバインスタンス自体により提供された汎用モジュールを使用して定義されます。
インスタンスリンクは、常にイベントレシーバの実行時に定義されます。

イベントが SAP Business Workflow で ( 開始イベントまたは終了イベントとして、または待機ステップに ) 使用される場合、ワークフローシステムが必要なリンクテーブルを定義します。
インスタンスリンクは、ワークアイテムがイベントを待って待機しているときに定義されます。これは、次のワークアイテムタイプにあてはまります。
- 対話ワークアイテム ( タイプ W) およびバックグラウンドワークアイテム ( タイプ B) 非同期オブジェクトメソッドが実行される場合は、常にイベントを待って待機する必要があります。
- 待機ステップワークアイテム ( タイプ E)
- ワークキューワークアイテム ( タイプ A)
技術的な観点から見ると、インスタンスリンクは、特定のオブジェクトから派生するイベントだけに応答するタイプリンクの拡張版です。そのオブジェクトは、オブジェクトキーを使用してインスタンスリンクで指定されます。
インスタンスリンクで、レシーバインスタンスの一意の ID ( レシーバ ID) が指定されます。このレシーバ ID は、イベントマネージャによってイベントパラメータコンテナに書き込まれ、レシーバ汎用モジュールが呼び出されると、イベントレシーバに転送されます。
インスタンスリンクの一般部分は、レシーバタイプとしてエントリWORKITEM または EVENTITEM を使用するタイプリンクと同じです。このタイプのタイプリンク 1 つに対して複数のインスタンスリンクが存在する場合があります。このタイプのタイプリンクを持つイベントが発生すると、イベントマネージャは次のステップを実行します。
...
1. インスタンスリンクのオブジェクトタイプ、オブジェクトキー、イベントが生成されたイベントのイベントパラメータと一致しているかどうかがチェックされます。
一致している場合は、レシーバインスタンスのID ( レシーバ ID) が、インスタンスリンクからイベントコンテナへ入力されます。
2. チェック汎用モジュールが一般部分に入力されている場合、チェック汎用モジュールが呼び出されます。実行結果に例外が含まれる場合は、リンクは実行されません。
3. 一般部分で指定されたレシーバ汎用モジュールは、パラメータ イベント、レシーバタイプ、イベントコンテナと同時に呼び出されます。
4. インスタンスリンクが生成された場合は、削除されます。関連一般部分 ( 関連タイプリンク) は、他のインスタンスリンクによっても使用されるので、そのまま残ります。

リンク論理では、実際のレシーバインスタンスは、開始オブジェクトが確認されていないイベントを待って待機することはできません。インスタンスリンクでは、開始オブジェクトのキーも必ず認識されていることが必要です。
この問題は、ワークアイテムで非同期メソッドによりオブジェクトが登録され、これがイベントによってワークフローシステムにレポートされたときに発生します。実際のレシーバインスタンスとしてのワークアイテムが待機するイベントの開始オブジェクトは、ワークアイテムに対してインスタンスリンクが定義された時点ではまだ明らかになっていません。
このような場合、ワークフローシステムは自動的にワークフローリクエスタを利用して、未知のオブジェクトとワークアイテム間の関係を登録します。ただし、イベントはステータス変更、変更文書、または汎用モジュール SWE_EVENT_CREATE_FOR_UPD_TASK によって生成する必要があります。追加情報については、汎用モジュール呼出によるイベント生成を参照してください。
インスタンスリンクデータは、2 つの部分に分けて表示されます。2 つの部分とは一般部分および特定部分で、一般部分にはイベントに関する情報およびイベント発生への応答が含まれます。一般部分は、特定のレシーバタイプを持つタイプリンクと同じです。特定部分には、イベントを生成したオブジェクトに関する情報が含まれます。
インスタンスリンクが削除されても、一般部分は削除されません。
一般部分は、同じレシーバタイプを持ち、同じイベントを待って待機するインスタンスリンクすべてに適用されます。一般部分には、次のデータが記録されています。
キ オブジェクトタイプとイベント ID

オブジェクトタイプとイベントは、ビジネスオブジェクトリポジトリで定義されていなければなりません。
キ レシーバタイプ
WORKITEM ( 終了イベント向け) または EVENTITEM ( 待機ステップ向け)
SWW_WI_COMP_EVENT_RECEIVE ( 終了イベント向け) または SWW_EI_EVENT_RECEIVE ( 待機ステップ向け)
チェック汎用モジュールの指定は任意です。他の項目の追加情報については、タイプリンクの評価と更新を参照してください。
各インスタンスリンクには、次のデータがあります。
キ オブジェクトタイプとイベント ID
キ レシーバタイプ

この情報は、関連する一般部分と同じです。
キ オブジェクトキー
イベントを生成するオブジェクトの連結キー
キ レシーバ ID
レシーバのID またはインスタンスビジネスワークフローインスタンスリンクでは、イベントを待って待機するワークアイテムのワークアイテムID になります。

ワークフロー定義における待機ステップとアクティビティの終了イベントに必要なインスタンスリンクは、ワークフローシステムに 自動的に入力されます。これらのエントリは、変更しないでください。
入力されているインスタンスリンクを照会することが、障害対応やエラー分析に役立つ場合があります。この情報は、2 つの部分に分けて表示されます。ビュー " インスタンスリンク" が呼び出されると、既存のインスタンスリンクの一般部分すべてが表示されます。これにより、インスタンスリンクが存在するオブジェクトタイプとイベントの組み合わせの概要を見ることができます。インスタンスリンクに固有のデータを参照するには、行を選択してノード オブジェクトデータを開きます。
独自開発の一部としてイベント管理機能を使用する場合は、インスタンスリンクを定義する必要があります。
インスタンスリンクは、次の汎用モジュールを使用して更新することができます。
キ SWE_EVENT_REC_INST_ENTER
この汎用モジュールのパラメータを用いて、インスタンスリンクを新たに挿入することができます。
キ SWE_EVENT_REC_INST_DELETE
この汎用モジュールを使用して、インスタンスリンクを削除することができます。
キ SWE_EVENT_REC_INST_DELETE_ID
この汎用モジュールを使用して、レシーバに対する全インスタンスリンクを削除することができます。
新たに登録するインスタンスリンクが必要なくなった場合は、必ず削除してください。
また、インスタンスリンクの関連のある一般部分 ( タイプリンクエントリ) も削除します。この一般部分のインスタンスリンクが ( この他に) ないことを確認してください。
インスタンスリンクを表示、更新するには、 ツール → ビジネスワークフロー → 開発 → 管理 → イベントマネージャ → インスタンスリンク を選択します。