コンテンツフレーム起動

機能の文書化  タイプリンクの評価と更新 文書を SAP ライブラリストラクチャに組み込む

使用

タイプリンクはオブジェクトタイプとイベントの特別な組み合わせへのレシーバ汎用モジュールとレシーバタイプの割当を示します。

特定のオブジェクトタイプのイベントにシステムが常に応答するように設定するには、タイプリンクの登録が必要です。タイプリンクは、イベントマネージャによって、実行時に評価されます。

タイプリンクの定義は、提供された汎用モジュールを使用してイベントレシーバが行います。

注記

イベントが SAP Business Workflow で ( 開始イベントまたは終了イベントとして、または待機ステップに ) 使用される場合、ワークフローシステムによって必要な入力が行われます。

たとえば、イベントをワークフローの開始イベントとして入力すると、以下のエントリが自動的に入力されます。

-         オブジェクトタイプとイベント ID

-         レシーバタイプとして開始されるワークフロー

-         レシーバ汎用モジュールとしての汎用モジュール SWW_WI_CREATE_VIA_EVENT

統合

移送およびクライアントコピー

変更が自動的に記録されるようにクライアントが ( テーブル T000 に) 設定されている場合、タイプリンクはクライアント依存となり、自動的にカスタマイジング移送依頼に書き込まれます。次に、有効化フラグを含めたすべてのエントリが移送されます。

クライアントコピーの場合、タイプリンクは対象クライアントにコピーされても、その対象クライアントでは常に無効であることを確認してください。

各タイプリンクの有効化フラグは、明示的に指定されている場合にのみ ( クラス A テーブルのコピーに対するパラメータオプション) 、クライアントコピーとともにコピーされます。

プロセスフロー

イベントマネージャは、生成されたイベントの ID を通知されると、有効なタイプリンクの評価を開始します。イベント処理を実行するには、生成されたイベントとその開始オブジェクトタイプ、または生成されたイベントと開始オブジェクトタイプのスーパータイプを、タイプリンクに入力する必要があります。

このグラフィックは添付のテキストに説明されています

イベントマネージャが生成されたイベントに対応するタイプリンクを見つけると、以下の処理が行われます。

...

       1.      レシーバタイプ汎用モジュールが入力されている場合、レシーバタイプを決定するために呼び出されます。

       2.      チェック汎用モジュールが入力されている場合、チェック汎用モジュールが呼び出されます。実行結果に例外が含まれる場合は、リンクは実行されません。

       3.      レシーバ汎用モジュールは、パラメータ イベント、レシーバタイプ、イベントコンテナと同時に呼び出されます。

汎用モジュール SWW_WI_CREATE_VIA_EVENT 内でエラーが発生した場合 ( タスクが見つからない、エラーがある、tRFC に問題があるなど) 、ワークフロー管理者にメールが送信されます。

機能

タイプリンクデータ

タイプリンクテーブルでは、以下の項目を利用することができます。

キ        オブジェクトタイプとイベント ID

注記

オブジェクトタイプとイベントは、ビジネスオブジェクトリポジトリで定義されていなければなりません。

キ        レシーバタイプ

キ        レシーバ汎用モジュール

キ        チェック汎用モジュール ( オプション)

キ        レシーバタイプ汎用モジュール ( オプション)

キ        区分: タイプリンク有効化

この区分が設定されている場合、タイプリンクはイベントマネージャによって評価されます。

キ        区分: イベントキュー有効化

イベントキュー有効の場合にのみ、この区分が評価されます。

この区分が設定されると、イベントキューを介してイベントレシーバが開始されます。この区分が設定されていないか、またはイベントキューが有効化されていない場合は、レシーバはただちに開始されます。

キ        エラーフィードバックの場合の動作

イベントキュー管理のタブページ基本データで更新した システム事前設定を、採用または修正することができます。

キ        レシーバステータス

イベントレシーバのステータスによって、レシーバの開始が決定されます。一般的に、レシーバを開始するには、レシーバリンクが有効でなければなりません。レシーバリンクのステータスによって、レシーバの開始に次のような影響があります。

キ        エラーなし

レシーバリンクのステータスがエラーなしの場合は、レシーバはシステムによって開始されます。レシーバは直接、またはイベントキューを介して開始されます。

キ        エラー

レシーバリンクのステータスがエラーの場合は、レシーバはすぐには開始されず、自動的にイベントキューに入れられます。そこで、エントリに エラーのため待機中ステータスが割り当てられます。このため、レシーバは開始されませんが、エラーが削除されると再びレシーバを開始することができるようになります。リンクにエラーがある場合でも、トリガされたイベントは消失しません。イベントレシーバは、タブページ不正なリンクを使用して再び開始することができます。

タイプリンクの更新

次の場合には、タイプリンクをマニュアルで定義、処理してください。

キ        ユーザ独自の開発の範囲内でイベントコントロールを使用する場合

キ        ワークフローシステムによって入力されたエントリを分析する場合

キ        後日、チェック汎用モジュールを追加する場合

キ        ワークフローによってはコントロールされないタイプリンクを有効にする場合

キ        特定のタイプリンクのイベントでイベントキューを使用する場合

SAP Business Workflow 内のタイプリンクの更新は、自動ではワークシステムによって実行されます。

タイプリンクは、次の汎用モジュールを使用して登録することができます。

SWE_EVENT_REC_TYPE_ENTER

タイプリンクの個々の項目の処理には、API も利用できます。

汎用モジュールの名称

説明

SWE_EVENT_REC_TYPE_CHECK_FB

イベントレシーバのチェック汎用モジュールの変更

SWE_EVENT_REC_TYPE_DISABLE

タイプリンクの無効化

SWE_EVENT_REC_TYPE_ENABLE

タイプリンクの有効化

SWE_EVENT_REC_TYPE_FB

レシーバ汎用モジュールの変更

SWE_EVENT_REC_TYPE_GET_FB

レシーバタイプ汎用モジュールの変更

SWE_EVENT_REC_TYPE_GLOBAL

グローバルイベントリンクの設定

SWE_EVENT_REC_TYPE_NOT_GLOBAL

グローバルイベントリンクの削除

SWE_EVENT_REC_TYPE_READ

タイプリンクの読込

次の汎用モジュールを使用して、タイプリンクを削除します。

SWE_EVENT_REC_TYPE_DELETE

注記

新たに登録するタイプリンクが必要なくなった場合は、必ず削除してください。

アクティビティ

タイプリンクを更新するには、 ツール → ビジネスワークフロー → 開発 → 管理 → イベントマネージャ → タイプリンク を選択します。

概要には、既存のタイプリンクがオブジェクトタイプ、イベント、レシーバタイプの詳細とともに表示されます。

タイプリンクを新たに追加するには、編集 → 新規エントリ を選択します。

タイプリンクを変更するには、ジャンプ → 詳細 を選択します。

 

 

コンテンツフレーム終了