対話仕様のプロパティー (SAP)

対話は 1 つの操作です。 対話仕様のプロパティーは、その操作が実行される方法を制御します。

アダプター接続ウィザードは、アダプターを構成するときに対話仕様のプロパティーを設定します。 一般に、これらのプロパティーを変更する必要はありません。 ただし、アウトバウンド操作用の一部のプロパティーを変更できます。 例えば、RetrieveAll 操作が完全な情報を戻さない場合、RetrieveAll 操作により戻されるディスカバリーの最大ヒット数を指定する対話仕様のプロパティーの値を増やすことができます。
以下の表では、設定可能な対話仕様のプロパティーをリストしています。
表 1. Adapter for SAP Software 用の対話仕様のプロパティー
プロパティー名 説明
カスタム取り出し関数名 SAP 表からデータを取り出すために QUERY インターフェースが SAP ソフトウェアに対して使用する、カスタム関数の名前。
関数名 特定の SAP インターフェース用の関数名。
BAPI 戻りのエラーを無視 BAPI 戻りのエラーを無視するかどうかを指定します。
ディスカバリーの最大ヒット数 RetrieveAll 操作中に戻す結果セットの最大数。
キュー名の選択 SAP サーバー 上のユーザー定義キューの名前。

カスタム取り出し関数名

SAP ソフトウェア用照会インターフェースの場合、このプロパティーはデータを SAP 表から取り出すために使用しなければならないカスタム関数の名前を指定します。

表 2. カスタム取り出し関数名の詳細
必須か いいえ
デフォルト デフォルト値なし
プロパティー・タイプ ストリング
使用法

このプロパティーは、SAP ソフトウェア用の QUERY インターフェースにのみ適用されます。

非 Unicode システムでは、SAP 表からデータを取り出すために使用するデフォルトの関数 (RFC_READ_TABLE) が例外を発生させることがあります。 この問題を回避するためには、SAP サーバー 上に別の関数を作成して、 構成の際に、アダプターがデータを取り出すためにはこのカスタム関数を使用しなければならないことを指定します。 このプロパティーは、カスタム関数の名前を指定します。

このプロパティーをアダプター接続ウィザード上に指定する前に、 SAP サーバー 上に関数を作成する必要があります。 SAP Note 758278 にリストされたステップに従って、 RFC_READ_TABLE のコピーを作成し、そのコピーをノートに従って変更します。

グローバル化対応 いいえ
Bidi サポート いいえ

関数名

functionName 対話仕様プロパティーは、操作を正しいインターフェースと関連付けることにより、対話を制御します。

表 3. 「関数名」の詳細
必須か はい
可能な値

True
False

デフォルト ヌル
プロパティー・タイプ ストリング
使用法
BAPI/RFC は、functionName 対話仕様プロパティーのために以下の値をサポートします。

WBIInteractionSpec.CREATE
WBIInteractionSpec.UPDATE
WBIInteractionSpec.RETRIEVE
WBIInteractionSpec.DELETE

BAPI 結果セットは、functionName 対話仕様プロパティーのために以下の値をサポートします。

WBIInteractionSpec.RETRIEVEALL

ALE アウトバウンド・インターフェースは以下の値をサポートします。

WBIInteractionSpec.EXECUTE

ALE インバウンド・インターフェースは、functionName 対話仕様プロパティーのために以下の値をサポートします。

WBIInteractionSpec.CREATE
WBIInteractionSpec.UPDATE
WBIInteractionSpec.RETRIEVE
WBIInteractionSpec.DELETE

SAP Software 用照会インターフェース (QISS) インターフェースは、 functionName 対話仕様プロパティーのために以下の値をサポートします。
  • WBIInteractionSpec.EXISTS

    例外 NotExistsException および QISSQueryFailedException をスローします。

  • WBIInteractionSpec.RETRIEVEALL

    例外 QISSQueryFailedException をスローします。

インバウンド処理用の拡張イベント処理インターフェースは、 functionName 対話仕様プロパティーのために以下の値をサポートします。

WBIInteractionSpec.CREATE
WBIInteractionSpec.UPDATE
WBIInteractionSpec.DELETE

アウトバウンド処理用の拡張イベント処理インターフェースは、 functionName 対話仕様プロパティーのために以下の値をサポートします。

WBIInteractionSpec.CREATE
WBIInteractionSpec.UPDATE
WBIInteractionSpec.RETRIEVE
WBIInteractionSpec.DELETE

グローバル化対応 いいえ
Bidi サポート いいえ

BAPI 戻りのエラーを無視

このプロパティーは、BAPI 戻り操作で指定されたエラーを無視するかどうかを示します。 戻り構造はデータまたはテーブルにすることができます。

表 4. 「BAPI 戻りのエラーを無視」の詳細
必須か いいえ
可能な値

True
False

デフォルト False
プロパティー・タイプ ブール
使用法 このプロパティーは、BAPI アウトバウンド同期 RFC 処理にのみ適用されます。

このプロパティーを True に設定すると、 Adapter for SAP Software は BAPI の実行後の BAPI RETURN 構造内のエラー・コードの検査を無視し、この構造をそのままユーザーに戻します。 RETURN 構造は各 BAPI に含まれており、BAPI 実行の状況が入れられています。

デフォルト値 False を受け入れると、Adapter for SAP Software は RETURN 構造を処理し、エラー・コードが見つかった場合は例外がスローされます。

グローバル化対応 いいえ
Bidi サポート いいえ

ディスカバリーの最大ヒット数

SAP Software 用照会インターフェースの場合、このプロパティーは結果セットの最大数を指定します。これは RetrieveAll 操作により表から取得される各行のデータを表します。

表 5. 「結果セット制限」の詳細
必須か はい
デフォルト 100
プロパティー・タイプ 整数
使用法 このプロパティーは、SAP ソフトウェア用の QUERY インターフェースにのみ適用されます。

SAP サーバー上の表でのヒット数が ResultSetLimit プロパティーの値を超える場合、アダプターはエラー MatchesExceededLimitException を戻します。 アダプターはこのプロパティーを使用して、メモリー不足の問題を回避できます。

グローバル化対応 いいえ
Bidi サポート いいえ

キュー名の選択

BAPI アウトバウンド処理では、非同期でキューに入れられた RFC が選択された場合、 このプロパティーは BAPI の送り先となる SAP サーバー 上のキューの名前を指定します。

表 6. キュー名の選択の詳細
必須か いいえ
デフォルト SAP サーバー 上に最初に定義されたキュー。 SAP サーバー 上に定義されたキューがない場合、 デフォルト値は存在しません。
プロパティー・タイプ ストリング
使用法 このプロパティーは、BAPI アウトバウンドの非同期でキューに入れられた RFC 処理にのみ適用されます。

BAPI 呼び出しを SAP サーバー 上のキューに送るとき、 キューの名前を指定する必要があります。 構成の際に、既存のキューをドロップダウン・リストから選択します。 SAP サーバー 上にキューが存在しない場合は、 キューの名前を入力できます。

グローバル化対応 いいえ
Bidi サポート いいえ
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
最終更新

        最終更新 : 2012-07-13 15:46:40


参照トピック参照トピック | バージョン 8.0.0.1 | rsap_interactionspec_props