Oracle EBS 12.2 Connector 2.3 リファレンス - Mule 4

Oracle E-Business Suite (EBS) 12.2 用 Anypoint Connector を使用すると、Oracle EBS にリアルタイムに接続して REST Web サービスを使用してクエリや更新を実行できます。

設定


デフォルト設定

Oracle EBS 12.2 操作のデフォルト設定。

パラメーター

名前 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定の接続種別。

x

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

接続種別

PL/SQL
パラメーター
名前 説明 デフォルト値 必須

Host (ホスト)

String (文字列)

Oracle EBS インスタンスのホスト名。

x

Port (ポート)

String (文字列)

Oracle HTTP Server がリスンするポート。

x

SSL enabled (SSL が有効)

Boolean (ブール)

SSL が Oracle EBS Web サービスと安全に通信できるようにします。

false

Username (ユーザー名)

String (文字列)

Oracle EBS REST サービスにアクセスするためのユーザー名。

x

Password (パスワード)

String (文字列)

Oracle EBS REST サービスにアクセスするためのパスワード。

x

REST Service Locator alias (REST サービスロケーターの別名)

String (文字列)

デプロイ時に内部名 ​oracle.apps.fnd.rep.ws.service.EbsRestLocator​ を持つ Web サービスに割り当てられる別名。

x

FND Web Sec alias (FND Web Sec 別名)

String (文字列)

デプロイ時に内部名 ​FND_WEB_SEC​ を持つ PL/SQL Web サービスに割り当てられる別名。

x

Responsibility name (職責名)

String (文字列)

Oracle EBS アプリケーションの職責情報。値として ​SYSTEM_ADMINISTRATOR​ などの responsibility_key を受け入れます。

Responsibility application name (職責アプリケーション名)

String (文字列)

職責アプリケーションの短縮名情報。値として FND などのアプリケーションの短縮名を受け入れます。

Security group name (セキュリティグループ名)

String (文字列)

値として STANDARD などのセキュリティグループキーを受け入れます。

NLS language (NLS 言語)

String (文字列)

AMERICAN などの言語設定を定義します。

Org. ID (組織 ID)

String (文字列)

指定された職責に割り当てられた事業単位の ID。これは、ユーザーが作業する唯一の組織です。

Proxy Config (プロキシ設定)

プロキシ接続 (必要な場合)。

TCP クライアントソケットのプロパティ

接続の TCP クライアントソケットのプロパティ。

TLS Context

TLS

セキュアな接続のための TLS コンテキスト。

Reconnection (再接続)

コネクタ操作で外部サーバーへの接続に失敗した場合に使用する再接続戦略を設定します。

JMS 設定

パラメーター

名前 説明 デフォルト値 必須

Name (名前)

String (文字列)

この設定の名前。コネクタはこの名前の設定を参照します。

x

Connection (接続)

この設定の接続種別。

x

Read Receive Timeout (読み取り受信タイムアウト)

Number (数値)

読み取りタイムアウト (ミリ秒)。

30000

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

接続種別

JMS
パラメーター
名前 説明 デフォルト値 必須

Username (ユーザー名)

String (文字列)

JMS 接続種別のユーザー名。

x

Password (パスワード)

String (文字列)

JMS 接続種別のパスワード。

x

Host (ホスト)

String (文字列)

接続種別のホスト名。

x

Port (ポート)

String (文字列)

接続種別のポート。

1521

Database SID (データベース SID)

String (文字列)

データベースシステム識別子 (SID)。

x

Reconnection (再接続)

コネクタ操作で外部サーバーへの接続に失敗した場合に使用する再接続戦略を設定します。

JMS URL
パラメーター
名前 説明 デフォルト値 必須

Username (ユーザー名)

String (文字列)

JMS URL 接続種別のユーザー名。

x

Password (パスワード)

String (文字列)

JMS URL 接続種別のパスワード。

x

URL

String (文字列)

接続種別の URL。

x

Reconnection (再接続)

コネクタ操作で外部サーバーへの接続に失敗した場合に使用する再接続戦略を設定します。

関連付けられたソース

操作

Invoke PL/SQL REST Service

<oracle-ebs122:invoke-pl-sql-rest-service>

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Input (入力)

Binary (バイナリ)

#[payload]

Streaming Strategy (ストリーミング戦略)

Mule によるストリームの処理方法を設定します。デフォルトでは、反復可能ストリームが使用されます。

PL/SQL

String (文字列)

PL/SQL 名。

x

Operation (操作)

String (文字列)

実行する操作。

x

Target Variable (対象変数)

String (文字列)

操作の出力を保存する変数の名前。

Target Value (対象値)

String (文字列)

操作の出力を評価する式。式の結果は ​[Target Variable (対象変数)]​ 項目に保存されます。

#[payload]

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

Binary (バイナリ)

次の設定の場合

スロー

  • ORACLE-EBS122:UNKNOWN

  • ORACLE-EBS122:BAD_REQUEST

  • ORACLE-EBS122:METADATA_ERROR

  • ORACLE-EBS122:RETRY_EXHAUSTED

  • ORACLE-EBS122:JMS

  • ORACLE-EBS122:CONNECTIVITY

  • ORACLE-EBS122:UNAUTHORIZED

  • ORACLE-EBS122:INTERNAL_SERVER_ERROR

  • ORACLE-EBS122:REQUEST_FAILED

  • ORACLE-EBS122:FORBIDDEN

  • ORACLE-EBS122:XML_PARSING

ソース

Business Events Source

<oracle-ebs122:business-events-source>

Business Events Source​ では受信イベントは絞り込まれません。ユーザーはソースに達したらイベントを絞り込む必要があります。
EBS に接続するためにコネクタで使用される、Oracle の Advanced Queuing API ライブラリの ​Consume​ 操作では、サブスクライバーテーブルの ​AQ$_WF_BPEL_QTAB_S​ 項目が上書きされる場合があります。​Business Events Source​ では ​Consume​ 操作が内部的にコールされます。

パラメーター

名前 説明 デフォルト値 必須

Configuration (設定)

String (文字列)

使用する設定の名前。

x

Durable Subscription (永続的サブスクリプション)

Boolean (ブール)

この値を ​true​ に設定すると、トピックの永続的なサブスクリプションが作成されます。

false

Subscription Name (サブスクリプション名)

String (文字列)

すでに EBS インスタンスに存在する永続的なサブスクリプションの名前。

muleBusinessEvents

Filter message criteria (メッセージの絞り込み条件)

String (文字列)

SQL のような条件に基づいてメッセージを絞り込みます。

Primary Node Only (プライマリノードのみ)

Boolean (ブール)

クラスターでの Mule インスタンスの実行時、このソースをプライマリノード上でのみ実行するかどうかを決定します。

Redelivery Policy (再配信ポリシー)

エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。

Reconnection Strategy (再接続戦略)

接続エラーが発生した場合の再試行戦略。

出力

Event (イベント)

Attributes Type (属性型)

Any (任意)

次の設定の場合

Proxy Parameter Group (プロキシパラメーターグループ)

項目 説明 デフォルト値 必須

Host (ホスト)

String (文字列)

種別のホスト。

Port (ポート)

Number (数値)

種別のポート。

Username (ユーザー名)

String (文字列)

種別のユーザー名。

Password (パスワード)

String (文字列)

種別のパスワード。

TCP Client Socket Parameter Group (TCP クライアントソケットのパラメーターグループ)

項目 説明 デフォルト値 必須

Send Buffer Size (送信バッファサイズ)

Number (数値)

Receive Buffer Size (受信バッファサイズ)

Number (数値)

Client Timeout (クライアントタイムアウト)

Number (数値)

Send Tcp No Delay (遅延なく TCP を送信)

Boolean (ブール)

true

Linger (延長)

Number (数値)

Keep Alive (キープアライブ)

Boolean (ブール)

false

Connection Timeout (接続タイムアウト)

Number (数値)

30000

TLS

Mule アプリケーションのセキュアな通信を提供するように TLS を設定します。

項目 説明 デフォルト値 必須

Enabled Protocols (有効化されたプロトコル)

String (文字列)

このコンテキストで有効化されたプロトコルのカンマ区切りリスト。

Enabled Cipher Suites (有効化された暗号化スイート)

String (文字列)

このコンテキストで有効化された暗号化スイートのカンマ区切りリスト。

Trust Store (トラストストア)

TLS トラストストアを設定します。

Key Store (キーストア)

TLS キーストアを設定します。

Revocation Check (取り消し確認)

証明書を検証する方法を設定します。

Truststore (トラストストア)

TLS 用のトラストストアを設定します。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

トラストストアへのパス。Mule では、可能であれば、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Password (パスワード)

String (文字列)

トラストストアを保護するために使用するパスワード。

Type (型)

String (文字列)

トラストストアの型。

Algorithm (アルゴリズム)

String (文字列)

トラストストアで使用する暗号化アルゴリズム。

Insecure (安全ではない)

Boolean (ブール)

true​ の場合、Mule では証明書の検証の実行を停止します。これを ​true​ に設定すると、接続が攻撃に対して脆弱になる可能性があります。

Keystore (キーストア)

TLS プロトコル用のキーストアを設定します。生成したキーストアには、非公開キーと公開証明書が格納されます。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

キーストアへのパス。Mule では、可能であれば、現在のクラスパスとファイルシステムへの相対的なパスを解決します。

Type (型)

String (文字列)

使用するキーストアの型。

Alias (別名)

String (文字列)

キーストアに複数の非公開キーが含まれている場合に使用するキーの別名。デフォルトでは、Mule はファイル内の最初のキーを使用します。

Key Password (キーパスワード)

String (文字列)

非公開キーを保護するために使用するパスワード。

Password (パスワード)

String (文字列)

キーストアを保護するために使用するパスワード。

Algorithm (アルゴリズム)

String (文字列)

キーストアで使用する暗号化アルゴリズム。

Standard Revocation Check (標準の取り消し確認)

TLS 証明書の標準取り消し確認を設定します。

項目 説明 デフォルト値 必須

Only End Entities (最後のエンティティのみ)

Boolean (ブール)

証明書チェーン内で確認する要素:

  • true

    証明書チェーンの最後の要素のみを確認します。

  • false

    証明書チェーンのすべての要素を確認します。

Prefer Crls (CRL を優先)

Boolean (ブール)

証明書の有効性を確認する方法:

  • true

    証明書失効リスト (CRL) で証明書の有効性を確認します。

  • false

    オンライン証明書状況プロトコル (OCSP) を使用して証明書の有効性を確認します。

No Fallback (代替なし)

Boolean (ブール)

証明書の有効性を確認するための第 2 の方法を使用するかどうか:

  • true

    [Prefer Crls (CRL を優先)]​ 項目で指定されていない方法を使用して証明書の有効性を確認します。

  • false

    証明書の有効性を確認するための第 2 の方法を使用しません。

Soft Fail (ソフトフェール)

Boolean (ブール)

取り消しサーバーに到達できない場合や取り消しサーバーが混雑している場合の処理:

  • true

    検証エラーを回避します。

  • false

    検証の失敗を許可します。

Custom OCSP Responder (カスタム OCSP レスポンダー)

証明書の取り消し確認のカスタム OCSP レスポンダーを設定します。

項目 説明 デフォルト値 必須

Url

String (文字列)

OCSP レスポンダーの URL。

Cert Alias (証明書の別名)

String (文字列)

OCSP 応答の署名証明書の別名。指定した場合、別名はトラストストアに存在する必要があります。

CRL File (CRL ファイル)

証明書失効リスト (CRL) ファイルの場所を指定します。

項目 説明 デフォルト値 必須

Path (パス)

String (文字列)

CRL ファイルへのパス。

Reconnection (再接続)

操作の再接続戦略を設定します。

項目 説明 デフォルト値 必須

Fails Deployment (デプロイに失敗)

Boolean (ブール)

アプリケーションのデプロイ時に、関連する再接続戦略をすべて実行した後、接続テストに合格しない場合の処理:

  • true

    デプロイの失敗を許可します。

  • false

    接続テストの結果を無視します。

Reconnection Strategy (再接続戦略)

使用する再接続戦略。

Reconnect (再接続)

標準再接続戦略を設定し、再接続の頻度と、コネクタソースまたは操作で実行できる再接続の試行回数を指定します。

項目 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

再接続を試行する頻度 (ミリ秒)。

Count (数)

Number (数値)

Mule アプリケーションで実行できる再接続の試行回数。

Reconnect Forever (繰り返し再接続)

繰り返し再接続戦略を設定します。この戦略では、Mule アプリケーションが実行されている限り、コネクタ操作のソースまたは操作で、指定した頻度で再接続を試行します。

項目 説明 デフォルト値 必須

Frequency (頻度)

Number (数値)

Mule アプリケーションでリモートサービスまたは API への再接続を試行する頻度 (ミリ秒)。

Expiration Policy (有効期限ポリシー)

動的設定インスタンスがアイドル状態を続けられる最小時間を設定します。この時間が経過すると、Mule Runtime で期限切れに相当するとみなされます。

項目 説明 デフォルト値 必須

Max Idle Time (最大アイドル時間)

Number (数値)

有効期限の対象とみなされるまで、動的設定インスタンスがアイドル状態を維持できる最大時間のスカラー時間値。

Time Unit (時間単位)

Enumeration (列挙)。次のいずれかになります。

  • NANOSECONDS (ナノ秒)

  • MICROSECONDS (マイクロ秒)

  • MILLISECONDS (ミリ秒)

  • SECONDS (秒)

  • MINUTES (分)

  • HOURS (時間)

  • DAYS (日)

[Max Idle Time (最大アイドル時間)]​ 項目の時間単位。

Repeatable In Memory Stream (反復可能なメモリ内ストリーム)

メモリ内ストリーミング戦略を設定します。この戦略では、データがバッファサイズを超えた場合、要求は失敗します。ユースケースで最適なバッファサイズは、必ずパフォーマンステストを実施して決めてください。

項目 説明 デフォルト値 必須

Initial Buffer Size (初期バッファサイズ)

Number (数値)

メモリシステムに割り当てる初期メモリ量。ストリームデータがこの値を超える場合は、​[Buffer Size Increment (バッファサイズ増分)]​ の単位で ​[Max In Memory Size (最大メモリ内サイズ)]​ 値を上限としてバッファが拡張されます。

Buffer Size Increment (バッファサイズ増分)

Number (数値)

バッファサイズが初期サイズを超えた場合に、拡張する量。値を ​0​ またはそれ以下に設定すると、バッファは拡張されません。

Max Buffer Size (最大バッファサイズ)

Number (数値)

バッファの最大サイズ。バッファサイズがこの値を超える場合、​STREAM_MAXIMUM_SIZE_EXCEEDED​ エラーが発生します。​0​ 以下の値は無制限を意味します。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

[Initial Buffer Size (初期バッファサイズ)]​ 項目、​[Buffer Size Increment (バッファサイズ増分)]​ 項目、​[Buffer Unit (バッファ単位)]​ 項目の単位。

Repeatable File Store Stream (反復可能なファイルストアストリーム)

反復可能なファイルストアストリーミング戦略を設定します。この戦略では、ストリームコンテンツの一部がメモリ内に格納されます。ストリームのコンテンツが、設定されたバッファサイズよりも大きい場合、Mule はバッファの内容をディスクにバックアップしてからメモリをクリアします。

項目 説明 デフォルト値 必須

In Memory Size (メモリ内サイズ)

Number (数値)

ストリームのデータで使用できるメモリの最大量。メモリ量がこの値を超えると、コンテンツはディスクにバッファされます。パフォーマンスを最適化する方法は、次のとおりです。

  • バッファサイズを大きくすると、Mule がバッファをディスクに書き込む回数を減らせます。これによってパフォーマンスが高まりますが、より多くのメモリが必要になるため、アプリケーションが処理できる同時要求数が制限されます。

  • バッファサイズを小さくすると、メモリの負荷は低減しますが、応答時間が長くなります。

Buffer Unit (バッファ単位)

Enumeration (列挙)。次のいずれかになります。

  • BYTE (バイト)

  • KB

  • MB

  • GB

[In Memory Size (メモリ内サイズ)]​ 項目の単位。

Event (イベント)

項目 説明 デフォルト値 必須

Correlation Id (相関 ID)

String (文字列)

メッセージの相関 ID。相関 ID の値セットは項目キーとして使用されます。

エラーメッセージ

String (文字列)

イベントの処理時にエラーが発生したかどうかを判別します。

Error Stack (エラースタック)

String (文字列)

エラーのソースを特定します。

Error Subscription (エラーサブスクリプション)

Binary (バイナリ)

エラーがスローされたときに実行されていたサブスクリプション。

Event Data (イベントデータ)

String (文字列)

イベント内で何が発生したかを説明するデータ。

Event Key (イベントキー)

String (文字列)

イベントのインスタンスの一意の識別子。

Event Name (イベント名)

String (文字列)

イベントの名前。

From Agent (送信元エージェント)

イベントの送信元のエージェント。ローカルで発生したイベントでは最初に ​null​ に設定されます。

Parameter List (パラメーターリスト)

Object (オブジェクト)

パラメーターとその値のリスト。

Priority (優先度)

Number (数値)

メッセージをデキューするメッセージ受信者の優先度を示します。 1​ は高優先度に該当し、​99​ は低優先度に該当します。

Receive Date (受信日)

DateTime

メッセージがエージェントリスナーによってデキューされる日時を示します。

Send Date (送信日)

DateTime

メッセージをデキューできる日時を表します。

To Agent (送信先エージェント)

イベントの送信先のエージェント。

Agent (エージェント)

項目 説明 デフォルト値 必須

Name (名前)

String (文字列)

エージェントの名前。

システム

String (文字列)

エージェントが配置されているシステム。

Redelivery Policy (再配信ポリシー)

エラーを生成する要求を実行するための再配信ポリシーを設定します。再配信ポリシーは、フロー内のあらゆる提供元に追加できます。

項目 説明 デフォルト値 必須

Max Redelivery Count (最大再配信数)

Number (数値)

REDELIVERY_EXHAUSTED​ エラーが返されるまでに、配信された要求が処理に失敗できる最大回数。

Use Secure Hash (セキュアハッシュを使用)

Boolean (ブール)

true​ の場合、Mule では再配信されたメッセージの識別にセキュアハッシュアルゴリズムを使用します。

Message Digest Algorithm (メッセージダイジェストアルゴリズム)

String (文字列)

[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​true​ の場合に使用するセキュアハッシュアルゴリズム。メッセージのペイロードが Java オブジェクトの場合、Mule ではこの値が無視され、ペイロードの ​hashCode()​ が返した値が返されます。

Id Expression (ID 式)

String (文字列)

メッセージがいつ再配信されたのかを判断する 1 つ以上の式。このプロパティは、​[Use Secure Hash (セキュアハッシュを使用)]​ 項目が ​false​ の場合にのみ設定できます。

Object Store (オブジェクトストア)

Object Store (オブジェクトストア)

各メッセージの再配信カウンターが保存されるオブジェクトストアを設定します。