BizTalk Adapter for Oracle E-Business Suite のバインド プロパティについて確認する
Microsoft BizTalk Adapter for Oracle E-Business Suite には、いくつかのバインド プロパティが表示されます。 これらのプロパティを設定することで、アダプターの動作の一部を制御できます。 このセクションでは、Oracle E-Business アダプターのバインド プロパティについて説明します。 また、.NET プログラミングを使用するか、BizTalk Server物理ポート バインドにプロパティを設定してアクセスする方法についても説明します。
アダプターバインドのプロパティ
Oracle E-Business Suite は、基になる Oracle データベース上のアプリケーション レイヤーです。 一部のバインディング プロパティでは、Oracle E-Business Suite とのインターフェイス中にアダプターの動作が構成され、他のプロパティでは Oracle データベースとのインターフェイス中に動作が構成されます。 次の表は、カテゴリ別にグループ化されたすべての Oracle E-Business アダプター バインド プロパティを示しています。 カテゴリは、アダプター (またはバインド) を構成するために異なるアプリケーションによって表示されるダイアログ ボックスに各バインド プロパティが表示されるノードを参照します。
| Binding プロパティ | カテゴリ | 説明 | .NET 型 |
|---|---|---|---|
| ClientCredentialType | 全般 | Oracle E-Business Suite との接続を確立するときに指定する資格情報のセットを指定します。 指定できる値は Database と EBusiness です。 - [データベース] に設定されている場合、アダプター クライアントは、接続を確立するためのデータベース資格情報と、 OracleUserName および OraclePassword バインド プロパティの E-Business Suite 資格情報を指定する必要があります。 - EBusiness に設定されている場合、アダプター クライアントは、接続を確立するために E-Business Suite 資格情報を指定し、 OracleUserName および OraclePassword バインド プロパティのデータベース資格情報を指定する必要があります。 大事な：ClientCredentialType バインド プロパティが EBusiness に設定されている場合は、OracleUserName および OraclePassword バインド プロパティのデータベース ユーザー名とパスワードを指定する必要があります。 既定値は Database です。 |
enum (ClientCredential) |
| CloseTimeout | 全般 | WCF 接続の終了タイムアウト。 内部 WCF チャネルの閉じる操作が完了するまでに指定された時間間隔を示す期間値を指定します。 既定値は 1 分です。 サポートされていません。 | System.TimeSpan |
| EnableBizTalkCompatibilityMode | 全般 | アダプターが DataSet のスキーマを生成する方法を指定します。 DataSet のスキーマを正しく生成するには、これを True に 設定します。 BizTalk Serverのアダプターを使用する場合は、常に プロパティを True に設定する必要があります。 Visual Studio のアダプターを使用する場合は、常に プロパティを False に設定する必要があります。 |
bool (System.Boolean) |
| InboundOperationType | 全般 | ポーリングまたは通知の受信操作を実行するかどうかを指定します。 既定値は ポーリングです。 ポーリングの詳細については、「ポーリングを使用した受信呼び出しのサポート」を参照してください。 通知の詳細については、「Oracle Database アダプターを使用したデータベース変更通知の受信に関する考慮事項」を参照してください。 |
enum |
| 名前 | 全般 | WCF クライアント クラスを保持するためのアダプター サービス参照 Visual Studio プラグインの追加によって生成されたファイルの名前を返す読み取り専用の値。 アダプター サービス参照の追加プラグインは、 Name プロパティの値に "Client" を追加することで、ファイル名を形成します。 返される値は "OracleEBSBinding" です。この値の場合、生成されたファイルの名前は "OracleEBSBindingClient" になります。 | string |
| OpenTimeout | 全般 | WCF 接続オープン タイムアウト。 内部チャネルオープン操作が完了するまでに指定された時間間隔を示す期間値を指定します。 既定値は 1 分です。 大事な： Oracle E-Business アダプターは常に OpenTimeout を使用して、Oracle データベースへの接続を開いたときに接続オープン タイムアウトを設定します。 アダプターは、チャネルなどの通信オブジェクトを開いたときに渡されたタイムアウト (System.TimeSpan) パラメーターを無視します。 |
System.TimeSpan |
| ReceiveTimeout | 全般 | WCF メッセージはタイムアウトを受け取ります。 アダプターが受信メッセージを待機する最大時間間隔を示す期間値を指定します。 既定では 10 分です。 大事な： ポーリングなどの受信操作では、タイムアウトを可能な最大値 (24.20:31:23.6470000 (24 日間) に設定することをお勧めします。 BizTalk Serverでアダプターを使用する場合、タイムアウトを大きな値に設定しても、アダプターの機能には影響しません。 |
System.TimeSpan |
| SendTimeout | 全般 | WCF メッセージ送信タイムアウト。 内部チャネル送信操作が完了するまでに指定された時間間隔を示す期間値を指定します。 既定値は 5 分です。 | System.TimeSpan |
| UseAmbientTransaction | 全般 | Oracle E-Business アダプターが、呼び出し元によって提供されるトランザクション コンテキストを使用して操作を実行するかどうかを指定します。 既定値は true です。これは、クライアントがトランザクション コンテキストを提供していることを前提として、アダプターが常にトランザクション コンテキストで操作を実行することを意味します。 トランザクションに他のリソースが参加している場合、接続は System.Transaction に登録され、MSDTC トランザクションに昇格されます。 ただし、アダプターがトランザクション コンテキストで操作を実行したくない場合があります。 次に例を示します。 - Oracle データベースで単純な SELECT 操作を実行している間 (送信ポート上) - SELECT 操作を実行し、DELETE ステートメントまたは (受信ポートで) ストアド プロシージャを呼び出すことによって、テーブルに対する変更を含まないポーリング ステートメントを指定します。 これらの操作はどちらもデータベース テーブルを更新しないため、MSDTC トランザクションを使用するようにこれらの操作を昇格すると、パフォーマンスのオーバーヘッドが発生する可能性があります。 このようなシナリオでは、Oracle E-Business アダプターがトランザクション コンテキストで操作を実行しないように、バインド プロパティを false に設定できます。 メモ： トランザクション コンテキストで操作を実行しないのは、データベースに変更を加えない操作に対してのみお勧めします。 データベース内のデータを更新する操作の場合は、バインディング プロパティを true に設定することをお勧めします。そうしないと、受信操作と送信操作のどちらを実行しているかに応じて、メッセージの損失や重複メッセージが発生する可能性があります。 |
bool (System.Boolean) |
| DataFetchSize | バッファー管理 | プロパティ ODP.NET します。 1 つのサーバー ラウンドトリップで結果セットからフェッチ ODP.NET データの量をバイト単位で指定します。 既定値は 65536 です。 このプロパティは、パフォーマンスチューニングに使用されます。 | long (System.Int64) |
| InsertBatchSize | バッファー管理 | 複数のレコード挿入操作のバッチ サイズを指定します。 既定値は 20 です。 InsertBatchSize の値が 1 より大きい場合、Oracle E-Business アダプターは指定した数のレコードを 1 つの ODP.NET 呼び出しにバッチ処理します。 挿入操作のレコード数がバッチ サイズの倍数でない場合、最終的なバッチには、バッチ サイズの値よりも少ないレコードが含まれます。 たとえば、挿入メッセージに 10 個のレコードがあり、 InsertBatchSize が 1 に設定されている場合、アダプターは個々のレコードを読み取って Oracle データベースに書き込みます。 そのため、アダプターは Oracle データベースに対して 10 個の個別の操作を実行します。 同様に、挿入メッセージに 10 個のレコードがあり、 InsertBatchSize が 5 に設定されている場合、アダプターは一度に 5 つのレコードを Oracle データベースに読み書きするため、2 回の挿入操作のみを実行します。 InsertBatchSize に適切に選択された値を使用すると、複数のレコード挿入操作のアダプター パフォーマンスが大幅に向上します。 |
int (System.Int32) |
| LongDatatypeColumnSize | バッファー管理 | Oracle long データ型列の最大サイズをバイト単位で指定します。 このバインディング プロパティの最大値は 32512 です。 既定値は 0 です。 長いデータ型に対して操作を実行しない場合は、既定値を使用する必要があります。 次の場合は、このバインディング プロパティに適切な値を明示的に設定する必要があります。 - 長いデータ型のパラメーターを含むストアド プロシージャを実行します。 - 長いデータ型の列を含み、SELECT ステートメントに主キー列が含まれていないテーブルに対して Select 操作を実行する。 このバインディング プロパティの最大値を設定する場合は、値を -1 に設定します。 メモ： このバインディング プロパティは非推奨です。 |
INT |
| MaxOutputAssociativeArrayElements | バッファー管理 | 応答で連想配列を返す操作を実行するときにアダプターが作成するアソシエイト配列のサイズを指定します。 アダプターは、配列のサイズを ODP.NET に通信し、配列のサイズに応じてバッファーを作成します。 既定値は 32 です。 このバインディング プロパティは、PL/SQL テーブル型に関連する操作を実行する場合に便利です。 |
int (System.Int32) |
| MetadataPooling | バッファー管理 | プロパティ ODP.NET します。 ODP.NET が実行されたクエリのメタデータ情報をキャッシュするかどうかを指定します。 既定値は true で、メタデータ プールを有効にします。 この情報をキャッシュすると、パフォーマンスが向上します。ただし、基になる Oracle 成果物に対する変更が Oracle システムで発生した場合、このプールされたメタデータは同期されません。これにより、Oracle システムで実行された操作で予期しない例外が返される可能性があります。 このプロパティは、パフォーマンスチューニングに使用されます。 | bool (System.Boolean) |
| StatementCachePurge | バッファー管理 | プロパティ ODP.NET します。 接続が接続プールに返されるときに、接続に関連付けられている ODP.NET ステートメント キャッシュを消去するかどうかを指定します。 既定値は false で、ステートメント キャッシュの消去を無効にします。 このプロパティは、パフォーマンスチューニングに使用されます。 | bool (System.Boolean) |
| StatementCacheSize | バッファー管理 | プロパティ ODP.NET します。 各 ODP.NET 接続でキャッシュできるステートメントの最大数を指定します。 このプロパティを 0 以外の値に設定すると、接続のステートメント キャッシュが有効になります。 既定値は 10 です。 このプロパティは、パフォーマンスチューニングに使用されます。 | int (System.Int32) |
| OracleConnectionClientId | デバッグ | アダプターが Oracle に接続するために使用する接続のクライアント識別子 (ID) を指定します。 これは、Oracle サーバー側トレースを有効にしていて、特定のクライアント ID の操作を選択的にトレースする場合に便利です。 これにより、クライアント ID に基づいて Oracle サーバー トレースをフィルター処理して表示することもできます。 | String |
| EnablePerformanceCounters | 診断 | WCF LOB アダプター SDK パフォーマンス カウンターと Oracle E-Business アダプター LOB 待機時間パフォーマンス カウンターを有効にするかどうかを指定します。 既定値は False です。パフォーマンス カウンターは無効になっています。 LOB 待機時間パフォーマンス カウンターは、Oracle E-Business Suite への呼び出しに Oracle E-Business アダプターが費やした合計時間を測定します。 | bool (System.Boolean) |
| EnableSafeTyping | メタデータ | 安全な入力を有効または無効にします。 既定値は false です。安全な型指定が無効になっています。 この機能は、アダプターが特定の Oracle データ型を表示する方法を制御します。 安全な型指定の詳細については、「 基本的な Oracle データ型」を参照してください。 | bool (System.Boolean) |
| UseSchemaInNameSpace | メタデータ | スキーマ名 (SCOTT、HR など) を、基になるデータベース成果物の操作および関連する型の xml 名前空間に含めるかどうかを指定します。 既定値は True です。スキーマ名は 名前空間に含まれています。 名前空間にスキーム名を含めないという利点は、同じ名前のテーブル (EMP など) が 2 つの異なるスキーマにある場合、同じ XML を使用して、両方のテーブルで単純な SQL 操作 (挿入、更新、削除、選択) を実行できることです。 たとえば、 UseSchemaInNamespace プロパティが true の場合、SCOTT に対するこれらの操作の名前空間。EMP テーブルは です http://schemas.microsoft.com/OracleEBS/Tables/SCOTT/EMP。false の場合、名前空間は です http://schemas.microsoft.com/OracleEBS/Tables/EMP。大事な： メッセージ アクションは 、UseSchemaInNamesapce バインディング プロパティの影響を受けません。常にスキーマ名が含まれます。 大事な： メタデータの生成中に、このバインド プロパティを True に設定することを強くお勧めします。 このプロパティを false に設定した場合、Oracle スキーマ名 (SCOTT など) は、生成されたスキーマの XML 名前空間では使用できません。 そのため、2 つの異なる Oracle スキーマに同じ名前のテーブルが 2 つあり、同じ BizTalk プロジェクトに追加された場合、BizTalk プロジェクトのビルドと展開は失敗します。 このようなスキーマを同じ BizTalk プロジェクトに含める場合は、XML 名前空間に Oracle スキーマ名を含めるために、それらのスキーマを手動で編集する必要があります。 |
bool (System.Boolean) |
| MlsSettings | 多言語サポート | Oracle E-Business Suite インスタンスには、複数の言語パックをインストールできます。 そのため、アダプターが複数言語サポート (MLS) を持つ Oracle E-Business Suite インスタンスからメタデータを取得する場合、アダプターは、ログインしているユーザーが好むのと同じ言語設定で情報を提示する必要があります。 MlsSettings バインド プロパティを使用すると、アダプター クライアントは MLS 固有のオプションを指定できます。 このバインド プロパティは、デザイン時と実行時の両方で指定できます。 MlsSettings バインド プロパティは複雑なバインド プロパティであり、さらに多くのバインド プロパティが含まれています。 これらのバインド プロパティはすべて省略可能です。 アダプターは、次の方法でバインド プロパティを使用して MLS コンテキストを設定します。 - 値が指定されたバインディング プロパティの場合、アダプターはこれらの値を使用して MLS コンテキストを設定します。 - 値が指定されていないバインド プロパティの場合、アダプターは、アダプターがインストールされているのと同じコンピューター上の ODP.NET クライアントの MLS 設定を使用します。 次の表に、 MlsSettings バインド プロパティの一部であるバインド プロパティの一覧を示します。 これらのプロパティはすべて省略可能です。 カレンダー: カレンダー システムを指定します。 このバインディング プロパティは、ODP.NET クライアントのNLS_CALENDAR設定にマップされます。 比較: PL/SQL ブロックでの WHERE 句と比較の比較方法を指定します。 このバインド プロパティは、ODP.NET クライアントのNLS_COMP設定にマップされます。 通貨: L 数値書式要素の現地通貨記号として使用する文字列を指定します。 Oracle のさまざまな数値書式要素と書式モデルの詳細については、「」を参照してください https://go.microsoft.com/fwlink/?LinkId=135807。 このバインド プロパティは、ODP.NET クライアントのNLS_CURRENCY設定にマップされます。 DateFormat:日付を表示する形式を指定します。 このバインディング プロパティは、ODP.NET クライアントのNLS_DATE_FORMAT設定にマップされます。 DateLanguage: 日と月の名前の言語を指定します。 このバインディング プロパティは、ODP.NET クライアントのNLS_DATE_LANGUAGE設定にマップされます DualCurrency: U 数値書式要素のユーロなどの二重通貨記号を指定します。 Oracle のさまざまな数値書式要素と書式モデルの詳細については、「」を参照してください https://go.microsoft.com/fwlink/?LinkId=135807。 このバインディング プロパティは、ODP.NET クライアントのNLS_DUAL_CURRENCY設定にマップされます。 ISOCurrency:C 数値書式要素の国際通貨記号として使用する文字列を指定します。 Oracle のさまざまな数値書式要素と書式モデルの詳細については、「」を参照してください https://go.microsoft.com/fwlink/?LinkId=135807。 このバインディング プロパティは、ODP.NET クライアントのNLS_ISO_CURRENCY設定にマップされます。 言語: MLS コンテキストの一部として設定する言語を指定します。 このバインディング プロパティは、ODP.NET クライアントのNLS_LANGUAGE設定にマップされます。 大事な：OracleEBSResponsibilityName バインド プロパティの値は、Language バインディング プロパティに指定したのと同じ言語で指定する必要があります。 たとえば、 Language バインディング プロパティをスペイン語に設定した場合、 OracleEBSResponsibilityName バインド プロパティに指定する責任名もスペイン語である必要があります。 LengthSemantics: バイトまたは文字 (既定) の長さのセマンティクスを使用して CHAR 列とVARCHAR2列を作成できます。 このバインド プロパティは、ODP.NET クライアントのNLS_LENGTH_SEMANTICS設定にマップされます。 NCharConversionException: 暗黙的または明示的な文字型変換中にデータ損失がエラーを報告するかどうかを指定します。 既定値は Trueです。 このバインド プロパティは、ODP.NET クライアントのNLS_NCHAR_CONV_EXCP設定にマップされます。 NumericCharacters: 小数点文字とグループ区切り記号を指定します。 このバインド プロパティは、ODP.NET クライアントのNLS_NUMERIC_CHARACTERS設定にマップされます。 並べ替え: 文字データの並べ替えの種類を指定します。 このバインディング プロパティは、ODP.NET クライアントのNLS_SORT設定にマップされます。 Territory: 担当地域の日付と数値の書式の規則を指定します。 このバインディング プロパティは、ODP.NET クライアントのNLS_TERRITORY設定にマップされます。 TimeStampFormat: TimeStamp データ型の文字列形式を指定します。 このバインディング プロパティは、ODP.NET クライアントのNLS_TIMESTAMP_FORMAT設定にマップされます。 TimeStampTZFormat: TimeStampTZ データ型の文字列形式を指定します。 このバインド プロパティは、ODP.NET クライアントのNLS_TIMESTAMP_TZ_FORMAT設定にマップされます。 TimeZone: タイム ゾーンリージョン名を指定します。 このバインディング プロパティは、ODP.NET クライアントのTIME_ZONE設定にマップされます。 |
enum |
| NotificationPort | Notification | Oracle データベースからのデータベース変更通知をリッスンするために ODP.NET 開く必要があるポート番号を指定します。 既定値は -1 です。これは、ODP.NET が有効でランダムで未使用のポート番号を使用していることを示します。 大事な： Windows ファイアウォールが有効になっている場合、アダプター クライアントはデータベース変更通知を受け取りません。 また、Windows ファイアウォールをオフにして通知を受信することはお勧めしません。 そのため、クライアント側コンピューターのセキュリティを損なうことなく通知を受信するには、正の整数値をポート番号として指定し、そのポート番号を Windows ファイアウォールの例外リストに追加することをお勧めします。 このバインディング プロパティを既定値 -1 に設定した場合、ODP.NET はランダムなポートを使用し、アダプター クライアントは Windows ファイアウォールの例外リストに追加するポートを認識しません。 Windows ファイアウォールの例外の一覧にポートを追加する方法については、「」を参照してください https://go.microsoft.com/fwlink/?LinkID=196959。 注意： Oracle E-Business アダプターを使用して通知を受信するアプリケーション ドメインに複数のアプリケーションがある場合は、すべてのアプリケーションの NotificationPort バインド プロパティを同じポート番号に設定する必要があります。 これは、ODP.NET がアプリケーション ドメイン内の 1 つのポートでリッスンするリスナーを 1 つだけ作成するためです。 |
int (System.Int32) |
| NotificationStatement | Notification | Oracle データベースから通知を取得するために登録するために使用する SELECT ステートメントを指定します。 SELECT ステートメントの例を次に示します。SELECT TID,ACCOUNT,PROCESSED FROM SCOTT.ACCOUNTACTIVITY WHERE PROCESSED = ‘n’メモ： データベース オブジェクト名とスキーマ名を指定する必要があります。 たとえば、「 SCOTT.ACCOUNTACTIVITY 」のように入力します。アダプターは、指定された SELECT ステートメントの結果セットが変更された場合にのみ、Oracle データベースから通知メッセージを取得します。 |
string |
| NotifyOnListenerStart | Notification | アダプターがアダプター クライアントに通知メッセージを送信するかどうかを指定し、リスナーの起動時に受信場所が実行されていることを通知します。 既定値は True です。 | bool (System.Boolean) |
| ConnectionLifetime | Oracle 接続プール | プロパティ ODP.NET します。 接続の最大継続時間を秒単位で指定します。 既定値は 0 です。 このプロパティは、パフォーマンスチューニングに使用されます。 | int (System.Int32) |
| DecrPoolSize | Oracle 接続プール | プロパティ ODP.NET します。 確立された接続が過剰に使用されていない場合に閉じる接続の数を指定します。 既定値は 1 です。 これは、パフォーマンスチューニングに使用されます。 | int (System.Int32) |
| IncrPoolSize | Oracle 接続プール | プロパティ ODP.NET します。 新しい接続が要求され、ODP.NET 接続プールに使用可能な接続がない場合に作成される新しい接続の数を指定します。 既定値は 5 です。 このプロパティは、パフォーマンスチューニングに使用されます。 | int (System.Int32) |
| MaxPoolSize | Oracle 接続プール | プロパティ ODP.NET します。 ODP.NET 接続プール内の接続の最大数を指定します。 既定値は 100 です。 このプロパティは、パフォーマンスチューニングに使用されます。 大事な：MaxPoolSize は慎重に設定する必要があります。 この値が大きすぎると、ODP.NET から使用できる接続の数を使い果たしてしまう可能性があります。 |
int (System.Int32) |
| MinPoolSize | Oracle 接続プール | プロパティ ODP.NET します。 ODP.NET 接続プール内の接続の最小数を指定します。 既定値は 1 です。 このプロパティは、パフォーマンスチューニングに使用されます。 | int (System.Int32) |
| UseOracleConnectionPool | Oracle 接続プール | プロパティ ODP.NET します。 ODP.NET 接続プールを使用するかどうかを指定します。 既定値は true で、接続プールを有効にします。 Oracle E-Business アダプターは、ODP.NET 接続プールを使用して接続プールを実装します。 | bool (System.Boolean) |
| ApplicationShortName | OracleEBS | Oracle E-Business Suite アプリケーションの短い名前。 特定の PL/SQL API、およびデータベース テーブルまたはビューのアプリケーション コンテキストを設定するときに、アプリケーションの短い名前を指定する必要があります。 しかし、特定の PL/SQL API とデータベース テーブルまたはビューに対してのみアプリケーション コンテキストを設定する必要があるのはなぜですか? - Oracle データベースと Oracle E-Business Suite のアプリケーションの両方に関連付けられている PL/SQL API は、アダプター サービス アドインの使用またはアダプター サービス参照プラグインの追加を使用しているときに、デザイン時に [成果物ベースのビュー] ノードと [Schema-Based ビュー] ノードでも使用できます。 Oracle データベースに関連付けられている PL/SQL API の実行中に、このバインディング プロパティを設定する必要はありません。 ただし、Oracle E-Business Suite アプリケーションに関連付けられている PL/SQL API を実行するときは、このバインディング プロパティに有効な値を指定してアプリケーション コンテキストを設定する必要があります。 - カスタム Oracle E-Business Suite アプリケーションの場合、ユーザーはベース データベース テーブルをインターフェイス テーブルとして登録する場合と登録しない場合があります。 データベース テーブルがインターフェイス テーブルとして登録されていない場合は、アダプター サービス アドインの使用またはアダプター サービス参照の追加プラグインの使用時に、デザイン時に [データベース] ノードで使用できます。 ただし、これらのテーブルは Oracle E-Business アプリケーションに関連付けられているため、これらのテーブルに対する操作の場合は、アプリケーション コンテキストを設定する必要があります。 そのため、PL/SQL API、および Oracle E-Business Suite に属するデータベース テーブルまたはビューに対して任意の操作を実行するには、常にアプリケーションの短い名前を指定する必要があります。 大事な： PL/SQL API の実行中、または Oracle E-Business Suite アプリケーションに関連付けられているデータベース テーブルまたはビューに対して任意の操作を実行する場合は、次の操作も行う必要があります。 - ClientCredentialType バインド プロパティを EBusiness に設定します。 - Oracle E-Business Suite に接続する資格情報を指定するには、 OracleUserName、 OraclePassword バインド プロパティを設定します。 - OracleEBSResponsibilityName バインディング プロパティを適切な責任名に設定します。 これらのバインド プロパティを設定すると、PL/SQL API、またはデータベース テーブルまたはビューが Oracle E-Business Suite アプリケーションに関連付けられていることをアダプターに通知するため、 ApplicationShortName バインド プロパティが必須になります。 逆に、Oracle E-Business Suite アプリケーションに関連付けられている PL/SQL API、またはデータベース テーブルまたはビューに対する操作を実行していて、 ClientCredentialType、 OracleUserName、 OraclePassword、 OracleEBSResponsibilityName バインディング プロパティを適切に設定しない場合、アダプターは ApplicationShortName を無視します。が設定されていて、操作を実行している PL/SQL API またはデータベース テーブルが Oracle データベースに属していることを前提としています。 |
string |
| OracleEBSOrganizationId | OracleEBS | Oracle E-Business Suite アプリケーションが属するorganization ID を指定します。 このプロパティは省略可能であり、次の場合にのみ考慮されます。 - ClientCredentialType バインド プロパティが EBusiness に設定され、 - OracleUserName、 OraclePassword、 OracleEBSResponsibilityName のバインディング プロパティが適切に指定されています。 |
string |
| OracleEBSResponsibilityKey | OracleEBS | Oracle E-Business Suite ユーザーに関連付けられている責任キー。 責任名 (OracleEBSResponsibilityName バインディング プロパティ) とは異なり、責任キーは指定された言語に依存しません。 これは、MLS コンテキストの設定時に Language バインディング プロパティ で指定された値に応じて、異なる言語で責任キーを指定する必要がないことを意味します。 重要: - OracleEBSResponsibilityKey バインディング プロパティに指定された値は、 OracleEBSResponsibilityName バインディング プロパティに指定された値をオーバーライドします。 - 複数の言語でデータに対する操作を実行し、各言語で責任名を指定しない場合は、インターフェイス テーブルに対する操作の実行中、インターフェイス ビューから値を選択する、または同時実行プログラムまたは要求セットを実行するときに、このバインディング プロパティの値を指定する必要があります。 もちろん、英語のデータのみを操作している場合でも、このバインディング プロパティは常に使用できます。 |
string |
| OracleEBSResponsibilityName | OracleEBS | Oracle E-Business Suite ユーザーに関連付けられている責任の名前。 責任名は、指定された言語によって異なります。 これは、 Language バインディング プロパティの値を指定して MLS コンテキストを設定する場合、 OracleEBSResponsibilityName バインド プロパティの値を Language バインディング プロパティ に指定したのと同じ言語で指定する必要があることを意味します。 たとえば、 Language バインディング プロパティをスペイン語に設定した場合、 OracleEBSResponsibilityName バインド プロパティに指定する責任名もスペイン語である必要があります。 大事な： インターフェイス テーブルに対する操作の実行中、インターフェイス ビューから値を選択するとき、または同時実行プログラムを実行するときに、このバインド プロパティの値を指定する必要があります。 |
string |
| OraclePassword | OracleEBS | - ClientCredentialType バインド プロパティが Database に設定されている場合、このプロパティは Oracle データベース ユーザーのパスワードを指定します。 - ClientCredentialType バインド プロパティが EBusiness に設定されている場合、このプロパティは Oracle E-Business Suite ユーザーのパスワードを指定します。 Oracle E-Business アダプターは、Oracle E-Business Suite に接続するときに OraclePassword バインディング プロパティに入力した値の大文字と小文字は保持されません。 パスワードは、SQL*Plus の標準規則を使用して Oracle E-Business Suite に渡されます。 ただし、パスワードの大文字と小文字を保持する場合、または特殊文字を含むパスワードを入力する場合は、値を二重引用符で囲んで指定する必要があります。 重要: - インターフェイス テーブルに対する操作の実行中、インターフェイス ビューから値を選択する、同時実行プログラムを実行する、または Oracle E-Business Suite アプリケーションに関連付けられている PL/SQL API を実行する場合は、 ClientCredentialType バインド プロパティを EBusiness に設定し、Oracle E-Business Suite に接続するための有効なパスワードを指定する必要があります。 - OraclePassword バインド プロパティは、アダプター サービス BizTalk プロジェクト アドインまたはアダプター サービス参照 Visual Studio プラグインを使用した結果として生成されたバインド ファイル (XML ファイル) または app.config ファイルでは使用できません。 |
string |
| OracleUserName | OracleEBS | - ClientCredentialType バインド プロパティが Database に設定されている場合、このプロパティは Oracle データベースでの認証のユーザー名を指定します。 - ClientCredentialType バインディング プロパティが EBusiness に設定されている場合、このプロパティは Oracle E-Business Suite での認証のユーザー名を指定します。 Oracle E-Business アダプターは、Oracle E-Business Suite に接続するときに OracleUserName バインディング プロパティに入力した値の大文字と小文字は保持されません。 ユーザー名は、SQL*Plus の標準規則を使用して Oracle E-Business Suite に渡されます。 ただし、ユーザー名の大文字と小文字を保持する場合、または特殊文字を含むユーザー名を入力する場合は、値を二重引用符で囲んで指定する必要があります。 大事な： インターフェイス テーブルに対する操作の実行中、インターフェイス ビューから値を選択する、同時実行プログラムを実行する、または Oracle E-Business Suite アプリケーションに関連付けられている PL/SQL API を実行する場合は、 ClientCredentialType バインド プロパティを EBusiness に設定し、Oracle E-Business Suite に接続するための有効なユーザー名を指定する必要があります。 |
string |
| PolledDataAvailableStatement | ポーリング | 特定のテーブルのポーリングに使用できるデータがあるかどうかを判断するために実行される SELECT ステートメントを指定します。 指定したステートメントは、行と列で構成される結果セットを返す必要があります。 結果セットの最初のセルの値は、アダプターが PollingInput バインド プロパティに指定された値を実行するかどうかを示します。 結果の最初のセルに正の値が含まれている場合、アダプターはポーリング ステートメントを実行します。 たとえば、このバインディング プロパティの有効なステートメントは次のようになります。Select * from <table_name>ヒント： ポーリング対象のテーブルにデータがあるかどうかに関係なく、アダプターのポーリングを続行する場合は、このバインディング プロパティの値を として Select 1 FROM DUAL指定できます。メモ： このバインディング プロパティにはストアド プロシージャを指定しないでください。 また、このステートメントでは、基になる Oracle データベースを変更しないでください。 |
string |
| PollingAction | ポーリング | ポーリング操作のアクションを指定します。 アダプター サービス アドインを使用して、操作に対して生成したメタデータから、特定の操作のポーリング アクションを決定できます。 | string |
| PollingInput | ポーリング | ポーリング ステートメントを指定します。 ポーリング用の単純な SELECT ステートメントまたはストアド プロシージャを指定できます。 テーブルまたはビューをポーリングする場合は、このバインディング プロパティに SELECT ステートメントを指定する必要があります。 ストアド プロシージャを使用してポーリングする場合は、このバインド プロパティの要求メッセージ全体を指定する必要があります。 要求メッセージは、ストアド プロシージャを送信操作として呼び出すためにアダプターに送信するメッセージと同じである必要があります。 メモ： このバインディング プロパティに指定された SQL ステートメントまたはストアド プロシージャは、 PolledDataAvailableStatement バインド プロパティによって実行されたステートメントがデータを返す場合にのみ実行されます。 大事な： Oracle E-Business アダプターは、Oracle トランザクション内でポーリング ステートメントとポーリング後ステートメント (指定されている場合) を実行します。 PollingInput バインド プロパティで SELECT ステートメントを使用している場合は、SELECT ステートメントで FOR UPDATE 句を指定することをお勧めします。 これにより、選択したレコードがトランザクション中にロックされ、ポーリング後のステートメントで、選択したレコードに対して必要な更新を実行できるようになります。 |
string |
| PollingInterval | ポーリング | トランザクションポーリング間隔、つまり Oracle E-Business アダプターが Oracle データベースに対して PollingInput バインディング プロパティに指定したステートメントを実行する間隔を秒単位で指定します。 既定値は 30 です。 ポーリング間隔は、アダプターによって次の目的で使用されます。 - 連続するポーリング間の時間間隔。 この間隔は、ポーリングとポーリング後のクエリを実行するために使用されます。 これらのクエリが指定された期間内に実行された場合、アダプターは間隔の残りの時間スリープ状態になります。 - ポーリング トランザクションのタイムアウト値。 この値は、ポーリング ステートメントの実行時間、ポーリング後ステートメント (指定されている場合) の実行時間、およびトランザクションをコミットするためにクライアント アプリケーションから応答を受信する時間を含めるのに十分な大きさを設定する必要があります。 ポーリング間隔の有効期限が切れる前にクライアント アプリケーションが応答を送信すると、アダプターはトランザクションをコミットし、ポーリング間隔に達するまで待機して次のポーリングを実行します。 クライアント アプリケーションからエラーが返された場合、アダプターはトランザクションを終了します。 クライアント アプリケーションが応答を送信する前にポーリング間隔が切れると、トランザクションはタイムアウトします。 |
int (System.Int32) |
| PollWhileDataFound | ポーリング | ポーリング対象のテーブルでデータが使用可能な場合に、Oracle E-Business アダプターがポーリング間隔を無視し、Oracle データベースを継続的にポーリングするかどうかを指定します。 テーブルに使用可能なデータがない場合、アダプターは、指定されたポーリング間隔で SQL ステートメントを実行するように戻します。 既定値は falseです。 ポーリング間隔が 60 秒に設定され、 PolledDataAvailableStatement に指定された ステートメントによって、ポーリングに使用できるデータが返されるシナリオを考えてみましょう。 その後、アダプターは 、PollingInput バインディング プロパティに指定されたステートメントを実行します。 アダプターがステートメントを実行するのにわずか 10 秒かかると仮定すると、 PolledDataAvailableStatement をもう一度実行してからポーリング ステートメントを実行する前に、50 秒間待機する必要があります。 代わりに、パフォーマンスを最適化するために、 PollWhileDataFound バインド プロパティを true に設定して、アダプターが前のポーリング サイクルが終了するとすぐに次のポーリング サイクルの実行を開始できるようにします。 メモ： このバインディング プロパティは、テーブルとビューのポーリングとストアド プロシージャを使用したポーリングの両方に適用できます。 |
string |
| PostPollStatement | ポーリング | PollingInput バインディング プロパティで指定されたステートメントが実行された後に実行されるステートメント ブロックを指定します。 既定値は null です。ポーリング後のステートメントは実行されません。 ポーリング後ステートメントは、ポーリング トランザクション内で実行されます。 post-poll ステートメントの一般的な用途は次の 2 つあります。 - ポーリング ステートメントで返された行の列を更新して、処理済みであり、後続のポーリング クエリから除外する必要があることを示します。 - 処理されたレコードを別のテーブルに移動します。 大事な： ポーリング後ステートメントを指定した場合、ポーリング後のステートメントが完了するまでの間隔の有効期限が切れるまでに 、PollingInterval を十分な大きさに設定する必要があります。 ポーリング シナリオでバインド プロパティを使用する方法の詳細については、「ポーリング ベースのデータ変更通知の概要」を参照してください。 |
string |
| SkipNilNodes | 実行時の動作 | Oracle E-Business アダプターが、要求 XML で "nil" としてマークされているノードの値の挿入または更新をスキップするかどうかを指定します。 このバインド プロパティは、テーブル内のレコードの挿入または更新、およびストアド プロシージャの RECORD 型パラメーターに適用されます。 既定値は true です。これは、アダプターが 'nil' としてマークされているノードの値の渡しをスキップすることを意味します。 この場合、Oracle の既定値 (指定されている場合) は、"nil" としてマークされているノードに対して考慮されます。 false に設定 すると、アダプターはこれらのノードに対して null 値を明示的に渡します。 注: - 要求 XML に存在しないノードの場合、 SkipNilNodes バインディング プロパティの値に関係なく、アダプターは常に値の渡しをスキップします。 - RECORDS の PL/SQL テーブルの場合、 SkipNilNodes バインディング プロパティの値に関係なく、アダプターは常に"nil" としてマークされているか、要求 XML に存在しないノードに null 値を渡します。 次の例では、このバインディング プロパティに設定した値に基づくアダプター構成の違いについて説明します。 要求 XML は次のようになります。 <EMPNO>1000</EMPNO> <ENAME>John</ENAME> <SAL nil=’true’></SAL>SkipNilNodes が true に設定されている場合、アダプターは次のコマンドを実行します。 INSERT INTO EMP (EMPNO, ENAME) VALUES (1000, “John”);SkipNilNodes が false に設定されている場合、アダプターは次のクエリを実行します。 INSERT INTO EMP (EMPNO, ENAME, SAL) VALUES (1000, “John”, null);2 番目のステートメントでは、アダプターはパラメーター "SAL" の null 値を明示的に挿入します。 |
bool (System.Boolean) |
| GeneratedUserTypesAssemblyFilePath | UDT .NET 型の生成 – デザイン時 | メタデータで使用されるすべての UDT を含むメタデータの生成時に、アダプターが生成する DLL の名前とパスを指定します。 UDT を使用するパッケージ、ストアド プロシージャ、または関数のメタデータを生成する場合は、DLL 名を指定する必要があります。 UDT を持つテーブルとビューでは、DLL 名の指定は省略可能です。 生成された DLL は、実行可能ファイルと同じ場所に保存されます。 このバインド プロパティは、メタデータの生成中にのみ必要です。 注: - ファイル名は 1 つだけ指定する必要があります。 メタデータ内のすべての UDT に対して、アダプターは指定された名前の 1 つのファイルを生成します。 名前を指定しない場合、アダプターは GUID 名を持つ DLL を生成します。 - このバインディング プロパティは、WCF-OracleEBS の受信ポートまたは送信ポートの構成中にBizTalk Serverでは使用できません。 |
string |
| GeneratedUserTypesAssemblyKeyFilePath | UDT .NET 型の生成 – デザイン時 | 厳密に型指定されたアセンブリを作成するためにアダプターが使用するキー ファイルの名前とパスを指定します。 このバインド プロパティは省略可能であり、メタデータの生成中にのみ必要です。 メモ：このバインディング プロパティは、WCF-OracleEBS の受信ポートまたは送信ポートの構成中にBizTalk Serverでは使用できません。 |
string |
| UserAssembliesLoadPath | UDT .NET 型の生成 – 実行時 | メタデータの生成中にアダプターによって作成されるセミコロンで区切られた DLL の名前を指定します。 これらの DLL は、メタデータの生成中 に GeneratedUserTypesAssemblyFilePath バインディング プロパティに指定した場所に保存されます。 これらの DLL は、次の場所に手動でコピーする必要があります。 - BizTalk プロジェクトの場合: BTSNTSvc.exe と同じ場所に DLL をコピーします。 BizTalk Serverの場合、これは通常、インストール ドライブ>:\Program Files\Microsoft BizTalk Serverで<使用できます。 - .NET プロジェクトの場合: DLL を .NET プロジェクト フォルダー内の \bin\Development フォルダーにコピーします。 このバインディング プロパティは、Oracle E-Business Suite で操作を実行するためにメッセージの送受信中にのみ必要です。 |
string |
| AcceptCredentialsInUri | アダプター サービス アドインまたはアダプター サービス参照の追加プラグインによって表示されません。 | Oracle E-Business Suite 接続 URI にユーザー資格情報を含めることができるかどうかを指定します。 既定値は false で、接続 URI のユーザー資格情報が無効になります。 AcceptCredentialsInUri が false で、Oracle 接続 URI にユーザー資格情報が含まれている場合、Oracle E-Business アダプターは例外をスローします。 URI で資格情報を指定する必要がある場合は、 AcceptCredentialsInUri を true に設定できます。 詳細については、「 Oracle E-Business Suite 接続 URI を作成する」を参照してください。 | bool (System.Boolean) |
バインド プロパティを設定する方法
バインド プロパティは、Oracle E-Business Suite への接続を指定するときに設定できます。 次の場合にバインド プロパティを設定する方法については、以下を参照してください。
アダプター サービス BizTalk プロジェクト アドインまたは Add Adapter Service Reference Visual Studio プラグインを使用します。 リンクの説明をここに入力するを参照してください。
BizTalk Server ソリューションで送信ポートまたは受信ポート (場所) を構成する方法については、「Oracle E-Business Adapter への物理ポート バインドの手動構成」を参照してください。
プログラミング ソリューションで WCF チャネル モデルを使用する方法については、「 Visual Studio で Oracle E-Business Suite に接続する」を参照してください。
プログラミング ソリューションで WCF サービス モデルを使用する方法については、「 Visual Studio で Oracle E-Business Suite に接続する」を参照してください。
重要
アダプター サービス BizTalk プロジェクト アドインまたは Add Adapter Service Reference Visual Studio プラグインを使用しているときに、string 型のバインド プロパティの値を指定せず、既定値が null の場合、バインド プロパティはバインド ファイル (XML ファイル) または app.config ファイルでそれぞれ使用できません。 必要に応じて、バインド プロパティとその値をバインド ファイルまたは app.config ファイルに手動で追加する必要があります。
ただし、アダプター サービス BizTalk プロジェクト アドインまたはアダプター サービス参照 Visual Studio プラグインの使用中にこのバインド プロパティの値を指定した場合でも、 OraclePassword バインド プロパティはバインド ファイルまたは app.config ファイルでは使用できません。