このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索の URL を出力します。
このスクリプトでは、e-docs マニュアルに必要なバナーを出力します。
このスクリプトでは、e-docs マニュアルの検索に必要な Google 検索のパラメータを出力します。
Workshop for WebLogic 用 Oracle Service Bus プラグインの使用
アラート送り先
[
SNMP トラップ ] を指定すると、アラートは SNMP トラップとして送信され、サードパーティのエンタープライズ管理システム (EMS) で処理できます。
[
レポート ] を指定すると、アラートは Oracle Service Bus の [レポート] モジュールに送信され、カスタム レポート プロバイダを使用して取得できます。カスタム レポート プロバイダは、Oracle Service Bus でレポート API プロバイダを使用して開発できます。これにより、カスタム Java コードを使用して、サードパーティがアラートを受信および処理できます。
追加 ] をクリックします。以下を参照してください。
電子メールおよび JMS 受信者の追加
電子メール受信者の追加
電子メール受信者を
mailto:username@hostname の形式で入力します。
ユーザ名とホスト名の組み合わせをカンマ区切りリストの形式で入力すると、複数の電子メール受信者を指定できます。たとえば、
mailto:username@hostname
[,username_1@hostname_1]...[,username_n@hostname_n] のように入力します。
最初のメール受信者に限り、先頭に「
mailto:」というテキストを付ける必要があります。ただし、これはオプションで、省略した場合はコードによって追加されます。
送信電子メール用の SMTP サーバの名前を選択します。このフィールドは、次の [
メール セッション ] フィールドを選択する場合には必要ありません。この 2 つのフィールドは互いに排他的です。両方をコンフィグレーションするとエラーになります。
使用できるメール セッションを選択します。このフィールドは、前の [
SMTP サーバ ] フィールドを選択した場合には必要ありません。この 2 つのフィールドは互いに排他的です。両方をコンフィグレーションするとエラーになります。
アラート通知対象の送信者の名前を指定します。このフィールドは省略可能です。
有効な電子メール アドレスを指定します。[
送信元の名前 ] フィールドに値を指定した場合、このフィールドは必須です。
返信先の名前を指定します。このフィールドは省略可能です。
返信が送信される電子メール アドレスを指定します。[
返信先の名前 ] フィールドに値を指定した場合、このフィールドは必須です。
タイムアウトまでに接続がサーバからの応答を待つ秒数を入力します。デフォルト値は
0 です。
文字セット エンコーディングの値を入力します。デフォルトのエンコーディング値は、
iso-8859-1 です。
JMS 受信者の追加
JMS 送り先のURI を次の形式で入力します。
jms://host:port/factoryJndiName/destJndiName
文字セット エンコーディングの値を入力します。デフォルトのエンコーディング値は、
iso-8859-1 です。
サービスの種類 - 新しいサービスの作成 (ウィザードのみ)
サービス タイプでは、そのサービスで交換されるメッセージのタイプとパッケージが決定されます。作成するビジネス サービスの種類を選択します。
WSDL に基づいてビジネス サービスを作成する場合は、このオプションを選択します。その後、該当のパス (
myProject/myFolder/
myWSDL) で修飾された WSDL 名を入力します。または、[
参照 ] をクリックし、WSDL リソースを選択します。
[
(ポートまたはバインディング) ] - (WSDL で定義されている) ポートの名前を入力して、実際の転送アドレスを記述するか、または、(WSDL で定義されている) バインディングの名前を入力して、転送アドレスにマップします。上述の [
参照 ] を使用して WSDL を選択した場合は、[
WSDL 定義の選択 ] ダイアログに WSDL で定義されたポートまたはバインディングが一覧表示されます。このページでポートまたはバインディングを選択すると、選択した名前が [
(port or binding) ] フィールドに表示されます。
EJB 転送を使用するサービスを作成するには、このオプションを選択します。
コンテンツ タイプが異なるメッセージを交換するサービスを作成するには、このオプションを選択します。このようなメッセージ交換は、要求/応答または一方向にすることができます。HTTP 転送用の HTTPの「GET」オプション付きで使用された場合は、要求のない応答になる可能性があります。Web サービスとは異なり、要求と応答のコンテンツ タイプは同じでなくてもかまいません。
明示的に定義された具象インタフェースを持たない SOAP サービスを作成する場合は、このオプションを選択します。
ドロップダウン リストから [
SOAP 1.1 ] または [
SOAP 1.2 ] を選択し、使用する SOAP バージョンを指定します。
明示的に定義された具象インタフェースを持たない XML サービスを作成する場合は、このオプションを選択します。
HTTP GET に対応しているサービスの種類はは、メッセージング サービスと任意の XML サービスに限られます。
別のサービスに基づいてサービスを作成するには、以下のオプションのいずれかを選択します。
既存のビジネス サービスのクローンを作成する場合は、このオプションを選択します。
パス (
プロジェクト/フォルダ) とビジネス サービスの名前を入力するか、[
参照 ] をクリックしてサービスを選択します。
Oracle Service Bus では複数のサービスに同じ URI を設定できないため、クローン サービスの URI を変更する必要がある。
既存のプロキシ サービスに基づいてビジネス サービスを作成するには、このオプションを選択します。
パス (
プロジェクト/フォルダ) とプロキシ サービスの名前を入力するか、[
参照 ] をクリックしてサービスを選択します。
Oracle Service Bus では複数のサービスに同じ URI を設定できないため、クローン サービスの URI を変更する必要がある。
このオプションは、ビジネス サービスのサービスの種類を示します。特定のサービスの種類の、特定のプロパティのみ変更できます。
WSDL Web サービス - 同じ WSDL を基にして異なるポートまたはバインディングを入力 (または [参照 ] をクリックして選択) できます。異なる WSDL を指定することもできます。この場合、効率的に新しいサービスを作成できます。ただし、新しいサービスとしてコンフィグレーションする必要があります。 転送型付きのサービス - このオプションは変更できません。 メッセージング サービス - このオプションは変更できません。 任意の SOAP サービス - SOAP バージョン (SOAP 1.1 または SOAP 1.2) を変更できます。 任意の XML サービス - このオプションは変更できません。
注意 : メッセージング サービスの型を持つ電子メール、ファイル、FTP、または SFTP 転送ビジネス サービスは、一方向のメッセージのみ応答メッセージの種類 ] は [なし ] である必要があります。[なし ] 以外のオプションを選択すると、ファイル、FTP、または SFTP プロトコルを [転送コンフィグレーション] ページで使用できません。
なし ] - 要求メッセージがない場合 (HTTP GET など) は、このオプションを選択します。 バイナリ ] - メッセージのコンテンツ タイプが不明か、重要でない場合は、このオプションを選択します。 テキスト ] - メッセージをテキストのみに制限する場合は、このオプションを選択します。 MFL ] - メッセージが MFL 定義に準拠したバイナリ ドキュメントの場合は、このオプションを選択します。MFL ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。
注意 : 複数の MFL ファイルをサポートするには、コンテンツをバイナリまたはテキストとして定義し、メッセージ フローの MFL アクションを使用して XML に変換します。
XML ] - メッセージが XML ドキュメントの場合は、このオプションを選択します。XML ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。 (element or type) ] フィールドで) 宣言して、一部の型情報を指定します。
なし ] - 応答メッセージがない場合は、このオプションを選択します。 バイナリ ] - メッセージのコンテンツ タイプが不明か、重要でない場合は、このオプションを選択します。 テキスト ] - メッセージをテキストのみに制限する場合は、このオプションを選択します。 MFL ] - メッセージが MFL 定義に準拠したバイナリ ドキュメントの場合は、このオプションを選択します。MFL ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。
注意 : 複数の MFL ファイルをサポートするには、コンテンツをバイナリまたはテキストとして定義し、メッセージ フローの MFL アクションを使用して XML に変換します。
XML ] - メッセージが XML ドキュメントの場合は、このオプションを選択します。XML ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。 (element or type) ] フィールドで) 宣言して、一部の型情報を指定します。
サービス ポリシーが、サービスの基盤となる WSDL に関連付けられている場合は、このオプションを選択します。
サービスレベル ポリシー、操作レベル ポリシー (この場合、ポリシーは要求メッセージおよび応答メッセージの両方に適用される)、要求ポリシー、および応答ポリシーを直接追加するには、このオプションを選択します。
サービス ポリシーのコンフィグレーションの詳細については、『Oracle Service Bus セキュリティ ガイド』の「
Web サービスのメッセージレベルでのセキュリティのコンフィグレーション 」を参照してください。
WS-I 準拠の適用 ] チェックボックスを選択または選択解除します。このオプションが有効になるのは、SOAP 1.1 サービスの場合に限られます。
転送レベルのセキュリティのコンフィグレーション
リストから転送プロトコルを選択します。使用可能なプロトコルは、サービスの種類によって異なります。
WSDL Web サービス : bpel-10g、dsp、http、jca、jms、jpd、sb、ws 転送型付きのサービス : ejb、flow メッセージング サービス : email、file、ftp、http、jms、mq (使用可能な場合)、sftp、tuxedo 任意の SOAP サービス : dsp、http、jms、jpd、sb 任意の XML サービス : dsp、email、file、ftp、http、jms、jpd、mq (使用可能な場合)、sb、sftp、tuxedo
次のいずれかのロード バランシング アルゴリズムを選択します。
上記の [
プロトコル ] フィールドで選択した転送プロトコルに基づく形式でエンドポイント URL を入力します。形式は次のようになります。
bpel-10g - protocol://host[:port] [/protocol-path]/domain/process[/version[/partnerlink/role]] Oracle BPEL Process Manager ユーザーズ ガイド
dsp - t3://dsp-ip-address:port/dsp-app-name ejb - ejb:provider:jndiname provider は JNDI プロバイダ リソース名、JNDIname は EJB に対する JNDI サーバの JNDI 名です。
ejb::jndiname となります。
email - mailto:foo@bar.com file - file:///root-dir/dir1 ftp - ftp://hostname:port/directory http - http://host:port/someService HTTP エンドポイントと HTTPS エンドポイントの両方がサポートされます。
jca - jca://<resource_adapter_jndi> jms - jms://host:port[,host:port]*/factoryJndiName/destJndiName jms://host1:port,host2:port/QueueConnectionFactory/DestName
クラスタで : JMS URI にあるホスト名は、WebLogic Server にコンフィグレーションされているのでクラスタ サーバのホスト名と正確に一致する必要があります。
jpd - jpd:[<provider>]:<jpd_uri> provider (省略可能) は、WLI JNDI プロバイダ リソースに対応する JNDI プロバイダの名前です。省略した場合、ローカル サーバの JNDI プロバイダが使用されます。
<jpd uri> は、WLI サーバ上の JPD の相対 URL になります。たとえば、processes.Process.jpd が SampleApp Web プロジェクトにある場合、JPD の相対 URL は /SampleApp/processes/Process.jpd となります。
mq - mq://local-queue-name?conn=mq-connection-resource-ref local-queue-name は、ビジネス サービスがメッセージを読み取る MQ キューの名前です。
mq-connection-resource-ref は、MQ 接続リソースの名前とパス (プロジェクト/フォルダ) です。たとえば、default/my_MQconnection。
注意 : エンドポイント URI にはスペースは使用できないので、MQ 接続リソースまたはプロジェクト/フォルダを作成するときスペースを入れないでください。
MQ 転送ユーザーズ ガイド 』を参照してください。
sb - sb://<jndi_provider_name/>service_name jndi_provider_name (省略可能) は、Oracle Service Bus JNDI プロバイダ リソースの名前。省略すると、デフォルトのコンテキストが使用されます。
service_name は、ターゲット サービスであり、リモート プロキシ サービス URI に対応します。
sftp - sftp://hostname:port/directory tuxedo - tuxedo:resourcename/remotename tuxedo-queue:sendQSpace/sendQName[/[rcvQspace:]rvcQname][/failureQname]
resourcename は WTC インポート名に対応し、remotename はリモート Tuxedo ドメインによりエクスポートされたサービス名に対応します。resourcename は必須で remotename は省略可能です。
Tuxedo の相互運用性ソリューション 』を参照してください。
ws - http://host:port/someService
注意 : Oracle Service Bus では、同じビジネス サービス内でエンドポイント URI の重複はサポートされなくなりました。
[
追加 ] をクリックして、1 つまたは複数の URI を追加します。実行時に、[
ロード バランシング アルゴリズム ] フィールドで選択したロード バランシング アルゴリズムに基づいて URL が選択されます。
[
ロード バランシング アルゴリズム ] フィールドで [
ランダムな重みベース ] を選択した場合は、[
エンドポイント URI ] フィールドに重みを入力することもできます。デフォルト値は
1 です。
複数のエンドポイントを定義している場合に、[
ロード バランシング アルゴリズム ] フィールドで [
なし ] を選択すると、エンドポイントの順序が重要になります。
上向き 矢印と
下向き 矢印を使用して、エンドポイントの順序を変更することができます。
Oracle Service Bus では、同じビジネス サービス内でエンドポイント URI の重複はサポートされなくなりました。
発信要求を送信する際の配信の失敗に備えて、各 URL エンドポイントの再試行回数 (フェイルオーバー試行回数) を指定します。
たとえば、ビジネス サービスに URI (U1) を 1 つコンフィグレーションし、再試行回数を 3 に設定したとします。最初の試行で U1 が失敗すると、システムは U1 エンドポイントにさらに 3 回試行します。
ビジネス サービスに 2 つの URI (U1 と U2) をコンフィグレーションし、再試行回数を 3 に設定した場合は、最初の試行 (たとえば U1) が失敗すると、システムは次の URI (U2) を試行 (フェイルオーバー) します。また失敗すると、システムはさらに 2 回 (U1 と U2 を 1 回ずつ) 試行します。
リストのすべてのエンドポイント URI を繰り返すまでのシステムの休止を秒単位で指定します。
たとえば、ビジネス サービスに 2 つの URI (U1 と U2) をコンフィグレーションし、再試行回数を 2 で、再試行間隔を 5 秒に設定したとします。最初の試行 (U1) が失敗すると、システムはただちに U2 を試行します。U2 も失敗すると、5 秒後にもう一度 U1 を試行します。
発信要求を送信する際の配信の失敗に備えて、アプリケーション エラー (SOAP エラーなど) に基づいてエンドポイント URL を再試行するかどうかを指定します。
Oracle Service Bus では、次の転送を使用した XOP/MTOM がサポートされます。
[
使用可能 ] チェック ボックスを選択すると、ビジネス サービスで発信メッセージを MTOM/XOP 形式でエンコードできます。このオプションは、前のリリースのコンフィグレーションに基づくインポートされたビジネス サービスに対しては無効になります。
[XOP/MTOM サポート] が有効になっている場合は、$header および $body メッセージ コンテキスト変数のバイナリ データを処理する方法を次のオプションから選択します。
参照によるバイナリ データを含む ] : (デフォルト) 発信応答メッセージで、$body メッセージ コンテキスト変数の設定時に xop:Include 要素を ctx:binary-content 要素で置換します。 値によるバイナリ データを含む : 発信応答メッセージでの $body メッセージ コンテキスト変数の設定時に、xop:Include 要素を base64 エンコード テキスト バージョンの対応するバイナリ データに置き換えます。
[XOP/MTOM サポート] がビジネス サービスに対して有効になっている場合は、すべての発信メッセージが MTOM 形式である必要はありません。代わりに、この設定はビジネス サービスが MTOM ペイロードを処理できることを指定します。
Oracle Service Bus では MTOM と SwA の組み合わせがサポートされないため、Oracle Service Bus が発信要求をビジネス サービスにディスパッチしようとした場合、およびビジネス サービスで MTOM と XOP の両方が有効で、$attachments メッセージ コンテキスト変数が null でない場合は、システムによってランタイム エラーが発行されます。
Oracle Service Bus では、HTTP/S 転送を使用した MIME 添付ファイルのストリーミングがサポートされます。
[
添付ファイルのディスクへのページング ] チェック ボックスを選択すると、ビジネス サービスが発信応答メッセージ内の添付ファイルをストリーミングできます。
[XOP/MTOM サポート] を有効にした場合、[添付ファイル] オプションは、[XOP/MTOM サポート] で [
参照によるバイナリ データを含む ] オプションを選択した場合にのみ使用できます。添付ファイルを含むペイロードは RFC 822 に準拠している必要もあります。具体的には、インターネット ヘッダを含む行は、CRLF (復帰改行) で終了する必要があります。
作成するプロキシ サービスの種類を選択します。種類については以下で説明します。
WSDL に基づいてプロキシ サービスを作成する場合は、このオプションを選択します。その後、該当のパス (
myProject/myFolder/
myWSDLなど) で修飾された WSDL 名を入力します。または、[
参照 ] をクリックし、WSDL リソースを選択します。
(ポートまたはバインディング) - (WSDL で定義されている) ポートの名前を入力して、実際の転送アドレスを記述するか、または、(WSDL で定義されている) バインディングの名前を入力して、転送アドレスにマップします。[
参照 ] を使用して WSDL を選択すると、[
WSDL 定義の選択 ] ダイアログに、定義されているポートとバインディングが表示されます。
注意 : 操作に [SOAP 本体の種類] を使用する場合は、WSDL に同じ入力メッセージで 2 つの操作がないことを確認してください。[SOAP 本体の種類] 操作は、入力メッセージを調べてユニークに識別することはできません。
あるデータ タイプのメッセージを受信し、別のデータ タイプのメッセージで応答できるサービスを作成する場合は、このオプションを選択します。このようなメッセージ交換は、要求/応答または一方向にすることができます。
(HTTP GET をサポートしているサービス タイプは、[任意の XML サービス] と [メッセージング サービス] のみです。)
明示的に定義された具象インタフェースを持たない SOAP サービスを作成する場合は、このオプションを選択します。
ドロップダウン リストから [
SOAP 1.1 ] または [
SOAP 1.2 ] を選択し、使用する SOAP バージョンを指定します。
明示的に定義された具象インタフェースを持たない XML サービスを作成する場合は、このオプションを選択します。
(HTTP GET をサポートしているサービス タイプは、[任意の XML サービス] と [メッセージング サービス] のみです。)
別のサービスに基づいてサービスを作成するには、以下のオプションのいずれかを選択します。
注意 : プロキシ サービスが別のサービスから作成された場合、アラート ルールは以下のように管理されます。
選択したビジネス サービスにルーティングするルート ノードを備えたプロキシ サービスを作成する場合は、このオプションを選択します。転送タイプのビジネス サービスからプロキシ サービスを作成することはできません。DSP 転送ビジネス サービスからプロキシ サービスを作成した場合、プロキシ サービスでは DSP 転送を使用できないため、Oracle Service Bus は、プロキシ サービスの転送の種類を HTTP に切り替えます。プロキシ サービスの転送の種類を、その他の使用可能な転送に変更することができます。
パス (
プロジェクト/フォルダ) とビジネス サービスの名前を入力するか、[
参照 ] をクリックしてサービスを選択します。
既存のプロキシ サービスのクローンを作成する場合は、このオプションを選択します。パス (
プロジェクト/フォルダ) とビジネス サービスの名前を入力するか、[
参照 ] をクリックしてサービスを選択します。
Oracle Service Bus では複数のサービスに同じ URI を設定できないため、クローン サービスの URI を変更する必要がある。
このオプションはプロキシ サービスのサービスの種類を示します。特定のサービスの種類の、特定のプロパティのみ変更できます。
WSDL Web サービス - 同じ WSDL を基にして異なるポートまたはバインディングを入力 (または [参照 ] をクリックして選択) できます。異なる WSDL を指定することもできます。この場合、効率的に新しいサービスを作成できます。ただし、新しいサービスとしてコンフィグレーションする必要があります。 転送型付きのサービス - このオプションは変更できません。 メッセージング サービス - このオプションは変更できません。 任意の SOAP サービス - SOAP バージョン (SOAP 1.1 または SOAP 1.2) を変更できます。 任意の XML サービス - このオプションは変更できません。
soap-env:Envelope/soap-env:Header を使用します。 soap-env:Body を使用します。
declare namespace
サービスによって使用されるサービス キー プロバイダの名前です。
パス (
プロジェクト/フォルダ) とサービス キー プロバイダの名前を入力するか、[
参照 ] をクリックしてサービス キー プロバイダを選択します。
サービス キー プロバイダは、以下のような特定の場合にのみ必要となります。
Web サービス セキュリティ対応のプロキシ サービスを追加するには、WS-Policy が付加された WSDL (ポートまたはバインディング) からプロキシ サービスを作成する必要があります。
なし ] - サービスでカスタム認証を使用しない場合。 カスタム ユーザ名とパスワード ] - サービスで、Path 式によって指定されたカスタム名とパスワードを使用する場合。 カスタム トークン ] - サービスでカスタム トークンを使用する場合。
カスタム ユーザ名とパスワード - ユーザ名 XPath
XPath 式は、必要に応じて、メッセージ ヘッダまたはペイロードに対して評価されます。これにより、Oracle Service Bus がカスタム認証用のユーザ名を取得できます。
カスタム ユーザ名とパスワード - ユーザ パスワード XPath
XPath 式は、必要に応じて、メッセージ ヘッダまたはペイロードに対して評価されます。これにより、Oracle Service Bus がカスタム認証用のパスワード値を取得できます。
カスタム トークンの種類を入力します。WebLogic Server ID アサーション プロバイダ用にコンフィグレーションされたアクティブ トークン タイプのみを使用できます。
カスタム トークンのパスを指定する XPath 式です。Oracle Service Bus は、必要に応じて、メッセージ ヘッダまたはペイロードに対して [トークン XPath] 式を評価して、カスタム認証用のトークンを取得します。
式を作成または編集するには、
<XPath> (定義済みの場合は、式のフラグメント
) をクリックして、
XPath 式エディタ を表示します。
カスタム ユーザ名とパスワード - コンテキスト プロパティ
(オプション) 1 つまたは複数のコンテキスト プロパティを指定して、認証 ([カスタム ユーザ名とパスワード]) または ID アサーション ([カスタム トークン]) セキュリティ プロバイダに追加コンテキスト情報を渡します。
[コンテキスト プロパティ] は、WebLogic Security Framework に追加情報を渡して、セキュリティ プロバイダがコンテキスト情報を取得できるようにする手段 (
ContextHandler インタフェース) を提供します。詳細については、「
メッセージレベル認証用の追加のコンテキスト プロパティ 」を参照してください。
[
プロパティ名 ] をリテラル文字列で入力し、[
値セレクタ ] に有効な XPath 式を入力します。XPath 式にリテラル文字列を使用することも可能です。
XPath 式は、カスタム トークンまたはカスタム ユーザ名/パスワードで使用されているのと同じメッセージ部に対して評価されます。つまり、[
値セレクタ ] XPath 式は、SOAP ベースのプロキシ サービスの場合はヘッダに関して評価され、非 SOAP ベースのプロキシ サービスの場合はペイロードに関して評価されます。
XPath 式は、実行時に評価され、プロパティの値を生成します。ContextHandler は名前と値のリストであるため、セキュリティ プロバイダが検索対象の名前を認識している必要があります。そのため、セキュリティ プロバイダがこれらのユーザ定義プロパティのいずれかの値を要求した場合にのみ XPath 式は評価されます。
[
プロパティを追加 ] をクリックして、このコンテキスト プロパティを追加します。複数のコンテキスト プロパティを追加することができます。
注意 : メッセージング サービスの型を持つ電子メール、ファイル、FTP、または SFTP 転送プロキシ サービスは、一方向のメッセージのみ応答メッセージの種類 ] は [なし ] である必要があります。[なし ] 以外のオプションを選択すると、電子メール、ファイル、FTP、または SFTP プロトコルを [転送コンフィグレーション] ページで使用できません。
なし ] - 要求メッセージがない場合は、このオプションを選択します。 バイナリ ] - メッセージのコンテンツ タイプが不明か、重要でない場合は、このオプションを選択します。 テキスト ] - メッセージをテキストのみに制限する場合は、このオプションを選択します。 MFL ] - メッセージが MFL 定義に準拠したバイナリ ドキュメントの場合は、このオプションを選択します。MFL ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。
注意 : 複数の MFL ファイルをサポートするには、コンテンツをバイナリまたはテキストとして定義し、メッセージ フローの MFL アクションを使用して XML に変換します。
XML ] - メッセージが XML ドキュメントの場合は、このオプションを選択します。XML ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。 (element or type) ] フィールドで) 宣言して、一部の型情報を指定します。
なし ] - 応答メッセージがない場合は、このオプションを選択します。 バイナリ ] - メッセージのコンテンツ タイプが不明か、重要でない場合は、このオプションを選択します。 テキスト ] - メッセージをテキストのみに制限する場合は、このオプションを選択します。 MFL ] - メッセージが MFL 定義に準拠したバイナリ ドキュメントの場合は、このオプションを選択します。MFL ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。
注意 : 複数の MFL ファイルをサポートするには、コンテンツをバイナリまたはテキストとして定義し、メッセージ フローの MFL アクションを使用して XML に変換します。
XML ] - メッセージが XML ドキュメントの場合は、このオプションを選択します。XML ファイル名 (そのパスで修飾されている) を入力するか、または、[参照 ] をクリックして、ファイルを選択します。 (element or type) ] フィールドで) 宣言して、一部の型情報を指定します。
$operation は空になります。 Oracle Service Bus では、このようなメッセージをすべて拒否するのではなく、コンテキスト内の operation 変数を初期化せずに、メッセージの処理を続行します。
Web Services Interoperability Organization で定義された Basic Profile にサービスを準拠させるかどうかを指定する場合は、チェック ボックスを選択または選択解除します。このオプションが有効になるのは、SOAP 1.1 サービスの場合に限られます。
サービスを WS-I 準拠として指定すると、サービス間で送受信されるメッセージの確認が行われます。
プロキシの場合、プロキシが受信した要求メッセージの確認が行われます。呼び出されるサービス (つまり、プロキシがサービス コールアウト アクションまたはルート ノード経由で呼び出すサービス) の場合、それらのサービスから受信した応答メッセージの確認が行われます。呼び出されるサービスから受信したメッセージを確認するかどうかを決定するのは、呼び出されるサービス側の WS-I 準拠プロパティであり、プロキシ側ではありません。呼び出されるサービスで WS-I 準拠のテストを指定すると、メッセージ フローによって応答エラーの fault が生成されます。
以下のいずれか 1 つを選択し、必要に応じて追加の手順を実行します。
転送ヘッダ ] - ルックアップ値を含む転送ヘッダを定義する場合は、このアルゴリズムを選択します。次に、以下を実行します。
ヘッダ名 ] フィールドに、呼び出される操作を選択するときにキーとして使用される値を抽出する転送ヘッダを入力します。 操作のマッピング ] フィールドの下にある [値 ] フィールドに、各操作の値を指定します。この値が操作のキーとして使用されます。 SOAP アクション ヘッダ ] - このプロキシ サービスに関連付けられた WSDL から自動的に操作のマッピングが行われるように指定する場合は、このアルゴリズムを選択します。 WS-Addressing ] - ルックアップ値が SOAP メッセージの SOAP ヘッダ内の WS-Addressing Action タグに入るように指定するには、このアルゴリズムを選択します。その後で、[操作のマッピング ] フィールドにある [値 ] フィールドに、各操作の値を指定します。この値が操作のキーとして使用されます。 SOAP ヘッダ ] - SOAP ヘッダに対して評価される XPath 式を定義するには、このアルゴリズムを選択します。これにより、ルックアップ値を取得できるようになります。次に、以下を実行します。
XPath 式 ] フィールドに、呼び出される操作を選択するときにキーとして使用される値を抽出する XPath 式を指定します。 操作のマッピング ] フィールドにある [値 ] フィールドに、各操作の値を指定します。この値が操作のキーとして使用されます。 SOAP 本体のタイプ ] - WSDL 仕様で定義されたデフォルトのアルゴリズムです。受信する SOAP メッセージのタイプに基づいて呼び出す操作が計算されます。
ペイロードの種類 ] - WSDL ポートまたは WSDL バインディングに基づいた XML サービスでのみ使用できます。
このオプションは、[
選択アルゴリズム ] オプションが [
転送ヘッダ ] に設定されている場合にのみ使用できます。
呼び出される操作を選択するときにキーとして使用される値を抽出する転送ヘッダを入力します。
このオプションは、[
選択アルゴリズム ] オプションが [
SOAP ヘッダ ] に設定されている場合にのみ使用できます。
呼び出される操作を選択するときにキーとして使用される値を抽出する XPath 式を指定します。
このオプションは、[
選択アルゴリズム ] オプションが [
転送ヘッダ ]、[
WS-Addressing ]、または [
SOAP 本体の種類 ] に設定されている場合にのみ使用できます。
[
値 ] フィールドに、各操作の値を指定します。この値が操作のキーとして使用されます。
メッセージ コンテンツをメモリに格納せずにストリーミングする場合は、このオプションを選択します。
[
使用可能 ] チェック ボックスを選択し、次の項目を選択します。
メモリ バッファ ]) またはディスク ファイル ([ディスク バッファ ]) のいずれにバッファするか。 圧縮 ] を有効にするかどうか
詳細については、『Oracle Service Bus ユーザーズ ガイド』の「
body コンテンツのストリーミング 」を参照してください。
Oracle Service Bus では、次の転送を使用した XOP/MTOM がサポートされます。
[
使用可能 ] チェック ボックスを選択して、該当する場合にプロキシ サービスが MTOM/XOP 形式で着信メッセージをデコードおよび解析し、MTOM/XOP 形式を使用して応答を送信できるようにすることもできます。このオプションは、前のリリースのコンフィグレーションに基づくインポートされたプロキシ サービスに対しては無効になります。
[XOP/MTOM サポート] が有効になっている場合は、$header および $body メッセージ コンテキスト変数のバイナリ データを処理する方法を次のオプションから選択します。
参照によるバイナリ データを含む ] : (デフォルト) 着信要求メッセージで、$header および $body メッセージ コンテキスト変数の設定時に xop:Include 要素を ctx:binary-content 要素で置換します。 値によるバイナリ データを含む : 着信要求メッセージでの $header と $body の各メッセージ コンテキスト変数の設定時に、xop:Include 要素を base64 エンコード テキスト バージョンの対応するバイナリ データに置き換えます。
バイナリ データに直接アクセスする必要がある場合、たとえば Java コールアウトまたは Message Format Language (MFL) 転送にデータを渡す場合は、[値によるバイナリ データを含む] を使用します。
[値によるバイナリ データを含む] は次の場合に使用します。
[XOP/MTOM サポート] がプロキシ サービスに対して有効になっている場合は、すべての着信メッセージが MTOM 形式である必要はありません。代わりに、この設定では、MTOM 形式のメッセージが到着したときに、プロキシ サービスでそれを適宜処理する必要があることを指定します。
[XOP/MTOM サポート] が有効になっていないプロキシ サービスが MTOM 形式のメッセージを受信した場合、サービスはメッセージを拒否し、ランタイム エラーを発行することにも注意してください。
Oracle Service Bus では、次の転送を使用した MIME 添付ファイルのストリーミングがサポートされます。
[
添付ファイルのディスクへのページング ] チェック ボックスを選択すると、プロキシ サービスが MIME 添付ファイルをストリーミングできます。HTTP プロキシ サービスに対して有効になっている場合、オプションはプロキシ サービス着信要求メッセージに適用されます。
[XOP/MTOM サポート] を選択した場合、[添付ファイル] オプションは、[XOP/MTOM サポート] で [
参照によるバイナリ データを含む ] オプションを選択した場合にのみ使用できます。添付ファイルを含むペイロードは RFC 822 に準拠している必要もあります。具体的には、インターネット ヘッダを含む行は、CRLF (復帰改行) で終了する必要があります。
サービス ポリシーが、サービスの基盤となる WSDL に関連付けられている場合は、このオプションを選択します。
サービスレベル ポリシー、操作レベル ポリシー (この場合、ポリシーは要求メッセージおよび応答メッセージの両方に適用される)、要求ポリシー、および応答ポリシーを直接追加するには、このオプションを選択します。
セキュリティ ポリシーのコンフィグレーションの詳細については、『Oracle Service Bus セキュリティ ガイド』の「
Web サービスのメッセージレベルでのセキュリティのコンフィグレーション 」を参照してください。
$operation は空になります。 Oracle Service Bus では、このようなメッセージをすべて拒否するのではなく、コンテキスト内の operation 変数を初期化せずに、メッセージの処理を続行します。
Web Services Interoperability Organization で定義された Basic Profile にサービスを準拠させるかどうかを指定する場合は、このチェック ボックスを選択または選択解除します。
サービスを WS-I 準拠として指定すると、サービス間で送受信されるメッセージの確認が行われます。プロキシの場合、プロキシが受信した要求メッセージの確認が行われます。呼び出されるサービス (つまり、プロキシがサービス コールアウト アクションまたはルート ノード経由で呼び出すサービス) の場合、それらのサービスから受信した応答メッセージの確認が行われます。呼び出されるサービスから受信したメッセージを確認するかどうかを決定するのは、呼び出されるサービス側の WS-I 準拠プロパティであり、プロキシ側ではありません。呼び出されるサービスで WS-I 準拠のテストを指定すると、メッセージ フローによって応答エラーの fault が生成されます。
注意 : 着信転送レベルのセキュリティは、クライアント アプリケーションと Oracle Service Bus プロキシ サービスに適用されます。発信転送レベルのセキュリティは、Oracle Service Bus のプロキシ サービスとビジネス サービスの間の接続に適用されます。転送レベルのセキュリティに関する詳細については、『Oracle Service Bus セキュリティ ガイド』の「転送レベルのセキュリティのコンフィグレーション
リストから転送プロトコルを選択します。使用できるプロトコルは、作成しているサービスの種類によって異なります。
WSDL Web サービス : http、jca、jms、local、sb、ws メッセージング サービス : email、file、ftp、http、jms、local、mq (使用可能な場合)、sftp、tuxedo 任意の SOAP サービス : http、jms、local、sb 任意の XML サービス : email、file、ftp、http、jms、local、mq (使用可能な場合)、sb、sftp、tuxedo
上記の [
プロトコル ] フィールドで選択した転送プロトコルに基づいた形式で、エンドポイント URI を入力します。
email - mailfrom:mail-server-host:port file - file:///root-dir/dir1 ftp - ftp://hostname:port/directory http - / someName HTTP エンドポイントと HTTPS エンドポイントの両方がサポートされます。
jca - jca://<resource_adapter_jndi> jms - jms://host:port[,host:port]*/factoryJndiName/destJndiName
jms://host1:port,host2:port/QueueConnectionFactory/DestName
クラスタで : JMS URI にあるホスト名は、WebLogic Server にコンフィグレーションされているのでクラスタ サーバのホスト名と正確に一致する必要があります。
local
mq - mq://local-queue-name?conn=mq-connection-resource-ref local-queue-name は、プロキシ サービスがメッセージを読み取る MQ キューの名前です。
mq-connection-resource-ref は、MQ 接続リソースの名前およびパス (プロジェクト / フォルダ) です。たとえば、default/my_MQconnection。
注意 : エンドポイント URI にはスペースは使用できないので、MQ 接続リソースまたはプロジェクト/フォルダを作成するときスペースを入れないでください。
MQ 転送ユーザーズ ガイド 』を参照してください。
sb - service_name service_name は、プロキシ サービスのユニークな識別子です。デフォルトでは、この名前がプロキシ サービス名になります。
service_name には、(
RFC2396 で示されているように) URL で許可されている文字のみを含める必要があります。ただし、フォワード スラッシュ (/) またはコロン (:) を含めることはできません。
sftp - sftp://hostname:port/directory
tuxedo - servicename servicename はリモート Tuxedo ドメインが Tuxedo サービスとして識別する WTC Export に一致します。
注意 : 同一の URI を 2 つコンフィグレーションすると、そのサービス名がすでに存在していることを通知するエラーが表示されます。
ws - /contextPath contextPath は、HTTP 転送または WS 転送を使用するプロキシ サービスでユニークである必要があります。
転送からすべてのヘッダを取得する場合は [
はい ] を選択します。
定義された一連のヘッダを取得する場合は [
いいえ ] を選択します。[
いいえ ] を選択した場合は、[
ヘッダ ] フィールドに一連のヘッダを入力してから、[
追加 ] をクリックします。この手順は、ローカル転送には該当しません。
注意 : Oracle Service Bus は、セキュリティの脆弱性が生じるため、要求からパイプラインに HTTP Authorization ヘッダを渡しません。ユーザ名と暗号化されていないパスワードをログ ファイルに書き込むログ アクションを誤って作成するおそれがあります。パイプラインに HTTP Authorization ヘッダが必要なデザイン パターンの場合、以下の操作を行います。com.bea.wli.sb.transports.http.GetHttpAuthorizationHeaderAllowed を true に設定します。すべてのヘッダを取得 ] に [はい ] または [いいえ ] を選択し、認可を指定します。
[新しい Oracle Service Bus コンフィグレーション プロジェクト] ウィザード 」も参照してください。
削除 ] を選択します。 [Oracle Service Bus コンフィグレーション] ページ 」を参照してください。
[エクスポート ウィザード - サーバにエクスポート - リソースを選択] ページ をコンフィグレーションする際にデフォルトとして使用されます。
この Oracle Service Bus コンフィグレーションの名前を入力するか、デフォルトをそのまま使用します。
リソースを再インポートするが、既存のリソースの環境変数値は保存する場合はこのチェック ボックスを選択します。
このチェック ボックスは、セキュリティのコンフィグレーション (アクセス制御ポリシーを除く) と、サービスに直接バインドされる WS-Policy への参照を (WSDL へのバインドの代わりに) 保存する場合にオンにします。
このチェック ボックスは、サービス キー プロバイダの PKI 資格情報、サービス アカウントのユーザ名とパスワード、および SMTP サーバ、JNDI プロバイダ、UDDI レジストリのユーザ名とパスワード資格情報を保存する場合にオンにします。
このチェック ボックスは、衝突などによってアクティブ化に失敗したときにセッションを破棄する場合にオンにします。詳細については、『Oracle Service Bus Console の使い方』の「
セッションのアクティブ化 」を参照してください。
カスタマイズ
(.xml) ファイルを指定するか、[
参照 ] をクリックしてファイルを見つけ、[
開く ] クリックします。カスタマイズの詳細については、『Oracle Service Bus Console の使い方』の「
カスタマイズ ファイルの作成 」を参照してください。
キーストア
(.jks) ファイルを指定するか、[
参照 ] をクリックしてファイルを見つけ、[
開く ] クリックします。
キー ストアの設定は、サービス キー プロバイダをコンフィグレーションするときに使用されます。
キー ストアへのアクセスをセキュリティで保護するために使用するパスワードを入力します。
この Oracle Service Bus コンフィグレーションに関連付けられるサーバの名前です。選択対象のサーバが 1 台のみの場合は、この設定は自動的にコンフィグレーションされます。同じ Oracle Service Bus コンフィグレーションに複数のサーバが関連付けられている場合は、ドロップダウン リストを使用して、この Oracle Service Bus コンフィグレーションに関連付けるサーバを選択します。
サーバ設定は、サーバに接続することで転送にメリットがある場合 (たとえば、HTTP 転送でディスパッチ ポリシー設定をコンフィグレーションする場合) に、転送固有のコンフィグレーションでのみ使用されます。
プロジェクトのユニークな名前を入力します。詳細については、『Oracle Service Bus Console の使い方』の「
プロジェクトとフォルダの名前付け 」を参照してください。
[
デフォルトを使用 ] チェック ボックスを選択して、デフォルトの場所にプロジェクトを保管するか、[
参照 ] をクリックしてフォルダを選択します。
Oracle Service Bus コンフィグレーション
既存の Oracle Service Bus コンフィグレーションを選択するか、[
新規作成 ] をクリックして
[新しい Oracle Service Bus コンフィグレーション プロジェクト] ウィザード を開きます。このウィザードを使用して、新しいコンフィグレーションを作成できます。
MQ 接続 MQ 転送ユーザーズ ガイド
MQ キュー マネージャに接続するには、以下のいずれかのモードを選択します。
TCP モード - Oracle Service Bus と同じマシンに存在しないキュー マネージャに接続するには、TCP/IP を使用します。 バインディング モード - Oracle Service Bus と同じマシンに存在するキュー マネージャに接続するには、バインディング モードを使用します。
MQ キュー マネージャ リスナのポート番号を入力します。
接続先の MQ キュー マネージャの名前を入力します。
接続を確立するときに使用される CCSID (coded character set identifier) です。CCSID は、主に国際化をサポートする目的で使用されます。
キュー マネージャのサーバ接続チャネル名を入力します。
このチェック ボックスを選択すると、メッセージの送信に SSL が使用されます。[
双方向 SSL が必要 ] オプションが選択されていない場合、サーバサイドの SSL のみが有効になります
。
このオプションは、[
SSL が必要 ] チェック ボックスが選択されている場合にのみ使用できます。
SSL で使用される暗号スイート アルゴリズムを選択します。
暗号スイート アルゴリズムは、WebSphere MQ サーバと WebSphere MQ クライアントの間のメッセージ通信を暗号化および復号化する際に使用されます。そのため、SSL を使用して WebSphere MQ サーバと通信する場合は、暗号スイート アルゴリズムを指定する必要があります。
このオプションは、[
SSL が必要 ] チェック ボックスが選択されている場合にのみ使用できます。
このチェック ボックスを選択すると、クライアントサイドおよびサーバサイドの SSL 認証が両方とも有効になります。
[
双方向 SSL が必要 ] を選択した場合は、適切なキー ストアと信頼ストアの情報を取得するために、サービス プロバイダへの参照を提供する必要があります。
サービス キー プロバイダのパス (
プロジェクト/フォルダ) と名前を入力するか、[
参照 ] をクリックして、[
サービス キー プロバイダの選択 ] ページから選択します。
ユーザ名/パスワードによる認証に必要です。静的なサービス アカウントのパス (
プロジェクト/フォルダ) および名前を入力するか、[
参照 ] をクリックし、ブラウザからサービス アカウントを選択します。
WebSphere MQ のバージョンを選択します。
未使用の接続が破棄されるまでの時間間隔を秒単位で入力します。デフォルトは 1800 秒です。
接続が使用可能になるのを待つ時間は秒単位で最大待ち時間に入力します。この時間間隔内で接続が確立されない場合、Oracle Service Bus は例外を送出します。デフォルトは 3 秒です。
リソースのエクスポート 」を参照してください。
Oracle Service Bus コンフィグレーション
エクスポートする既存の Oracle Service Bus コンフィグレーションおよびリソースを選択します。
プロジェクトのエクスポートまたはリソースのエクスポートを選択します。
注意 : システム プロジェクトは、プロジェクト レベルでエクスポートできません。
注意 : プロジェクトをエクスポートした場合、プロジェクト全体の JAR ファイルをインポートしたときにリソースが削除されることがあります。詳細については、『Oracle Service Bus Console の使い方』の「リソースのインポート 」を参照してください。
リソース
のエクスポートを選択した場合は、このチェック ボックスをオンまたはオフにします。[
依存関係を含める ] オプションを使用すると、このリソースが参照している他のリソースをすべてエクスポートできます。
エクスポートする JAR ファイルの完全修飾名を入力するか、または、[
参照 ] をクリックして選択します。
作成または更新を選択します。リソースに対して行われる操作です。
リソース (プロジェクトではない) をエクスポートする場合に、関連するリソースをすべてエクスポートするときは、このチェック ボックスをオンにします。
エクスポートするリソースの環境変数値を保存する （上書きされないようにする） 場合は、このチェック ボックスをオンにします。
このチェック ボックスは、セキュリティのコンフィグレーション (アクセス制御ポリシーを除く) と、サービスに直接バインドされる WS-Policy への参照を (WSDL へのバインドの代わりに) 保存する場合にオンにします。
このチェック ボックスは、サービス キー プロバイダの PKI 資格情報、サービス アカウントのユーザ名とパスワード、および SMTP サーバ、JNDI プロバイダ、UDDI レジストリのユーザ名とパスワード資格情報を保存する場合にオンにします。
このチェック ボックスは、Oracle Service Bus Console でセッションを作成してアクティブ化する場合にオンにします。詳細については、『Oracle Service Bus Console の使い方』の「
セッションのアクティブ化 」を参照してください。
このチェック ボックスは、衝突などによってアクティブ化に失敗したときにセッションを破棄する場合にオンにします。
カスタマイズ ファイルを指定するか、[
参照 ] をクリックしてファイルを選択し、[
開く ] をクリックします。カスタマイズの詳細については、『Oracle Service Bus Console の使い方』の「
カスタマイズ ファイルの作成 」を参照してください。
Oracle Service Bus コンフィグレーション
エクスポートする既存の Oracle Service Bus コンフィグレーションおよびリソースを選択します。
プロジェクトのエクスポートまたはリソースのエクスポートを選択します。
ドロップダウン リストから、Oracle Service Bus 送り先サーバを選択します。
リソースのインポート 」を参照してください。
Oracle Service Bus コンフィグレーション
既存の Oracle Service Bus コンフィグレーションを選択するか、[
新規作成 ] をクリックして
[新しい Oracle Service Bus コンフィグレーション プロジェクト] ウィザード を開きます。このウィザードを使用して、新しいコンフィグレーションを作成できます。
他の Oracle Service Bus ドメインからあらかじめエクスポートした完全なプロジェクト JAR ファイル、またはリソース JAR ファイルを選択します。
リソースのインポート 」を参照してください。
リソースで実行される操作 (作成、更新、削除) を表示するには、プロジェクト フォルダを展開します。
リソースが削除されないようにするには、選択解除します。リソースの削除は、インポートする JAR がプロジェクト全体の JAR であり、インポートする JAR ファイルに存在しないプロジェクト リソースがインポート先システムに存在する場合にのみ行われます。
リソース JAR ファイルをインポートして、すべての関連リソースがインポートされたのを保証したい場合は、チェック ボックスを選択します。
データを暗号化するのに使用されたパスワードを入力します。
リソースを再インポートするが、既存のリソースの環境変数値は保存する場合はこのチェック·ボックスを選択します。
セキュリティのコンフィグレーション (アクセス制御ポリシーを除く) と、サービスに直接バインドされる WS-Policy への参照 (WSDL へのバインドの代わりに) を保持するには、チェック ボックスを選択します。
このチェック ボックスは、サービス キー プロバイダの PKI 資格情報、サービス アカウントのユーザ名とパスワード、および SMTP サーバ、JNDI プロバイダ、UDDI レジストリのユーザ名とパスワード資格情報を保存する場合にオンにします。
Zip ファイルからのリソースのロード
Oracle Service Bus コンフィグレーション
既存の Oracle Service Bus コンフィグレーションとインポート先 (プロジェクトまたはフォルダ) を選択します。
Zip ファイルの完全修飾名を入力するか、または、[
参照 ] をクリックして選択します。
Zip ファイルからのリソースのロード
作成または更新を選択します。リソースに対して行われる操作です。
URL からのリソースのロード
Oracle Service Bus コンフィグレーション
既存の Oracle Service Bus コンフィグレーションとインポート先 (プロジェクトまたはフォルダ) を選択します。
ファイルが置かれている場所のURL を入力します。
ローカル リソースを指定する場合は、そのパスで完全に修飾されたファイル名 (例 :
file:///c:/alsbresources/ForeachAction.jar) を用いて、
file プロトコルを使用できます。
URL からのリソースのロード
作成または更新を選択します。リソースに対して行われる操作です。
ファイルが置かれている場所のURL を入力します。
ローカル リソースを指定する場合は、そのパスで完全に修飾されたファイル名 (例 :
file:///c:/alsbresources/ForeachAction.jar) を用いて、
file プロトコルを使用できます。
[新しい JNDI プロバイダ リソース] ウィザード 」を参照してください。詳細については、『Oracle Service Bus Console の使い方』の「JNDI プロバイダの編集
JNDI プロバイダの追加
デフォルトの [
有効 ] オプションのままにしておくか、または [
無効 ] を選択します。
有効にすると、JNDI コンテキストおよび JNDI オブジェクトがローカルにキャッシュされ、オブジェクトのルックアップを行うときのパフォーマンスが向上します。JNDI キャッシュを有効にしておくことをお勧めします。
protocol://host:port の形式で JNDI プロバイダの URL を入力します。
http、https、t3、t3s、iiop、iiops などの任意のプロトコルを使用できます。
目的の JNDI プロバイダにアクセスするためにユーザ名およびパスワードが必要な場合、[
ユーザ名 ] フィールドにユーザ名を入力して、関連するパスワードを [
パスワード ] および [
パスワードの確認 ] フィールドに入力します。
これらのフィールドは省略可能です。JNDI ツリーが保護されている場合にのみ必要となります。
ユーザ名に関連付けられているパスワードを入力します。
[
パスワード ] フィールドに入力したものと同じパスワードを入力します。
プロキシ サーバの追加
[
パスワード ] フィールドに入力したものと同じパスワードを入力します。
プロキシ サーバ ホストのリスト。各プロキシ サーバ リソースに複数のプロキシ サーバをコンフィグレーションできます。これにより、Oracle Service Bus でロード バランシングを実行し、プロキシ サーバ リソースにフォールト トレランス機能を提供できます。
追加 ] をクリックして次の情報を指定して、リソースの新しいプロキシ サーバをコンフィグレーションします。 ホスト-ポート パラメータ ] を編集します。 削除 ] をクリックしてリソース コンフィグレーションからそのサーバを削除します。
メッセージ フロー エディタ へ項目をドラッグします。パレットに項目をドラッグすると、ドラッグしてきた項目をパレット内の位置にドロップできることを示す 1 つまたは複数のターゲット (
挿入 ]、[これに挿入 ]、または [これの後ろに挿入 ] サブメニューからノードやアクションを選択することにより、メッセージ フローにノードとアクションを追加することもできます。また、[エラー ハンドラの追加 ] コマンドを選択して、エラー ハンドラを追加することもできます。これらのサブメニューおよびコマンドは、コンテキストに依存します。つまり、メッセージ フローで選択されたコンテキストに項目を追加することが認められている場合にのみ表示されます。
ブランチ ノードを使用すると、可能ないくつかのパスのうちの 1 つに限定して処理を進ませることができます。
コンフィグレーションのプロパティについては、「
条件付きブランチ ノードのプロパティ 」を参照してください。
オペレーション ブランチ ノードでは、指定された操作に基づいてどのブランチに進むかが判断されます。
コンフィグレーションのプロパティについては、「
オペレーション ブランチ ノードのプロパティ 」を参照してください。
パイプライン ペア ノードは要求パイプラインと応答パイプラインから成ります。
コンフィグレーションのプロパティについては、「
パイプライン ペア ノードのプロパティ 」を参照してください。
ルート ノード アクションは、ルート ノードを通過する際のメッセージの処理を定義します。
コンフィグレーションのプロパティについては、「
ルート ノードのプロパティ 」を参照してください。
コンフィグレーションのプロパティについては、「
ステージ ノードのプロパティ 」を参照してください。
エラー ハンドラは、メッセージ フローでエラーを再送するロジックを提供します。
コンフィグレーションのプロパティについては、「
エラー ハンドラ ノードのプロパティ 」を参照してください。
動的ルーティング アクションは、XQuery リソースで入手できるルーティング情報に基づいて、メッセージのルートを割り当てます。
コンフィグレーションのプロパティについては、「
動的ルーティング アクションのプロパティ 」を参照してください。
ルーティング アクションは、メッセージのターゲット サービスを指定し、サービスにメッセージをルーティングする方法をコンフィグレーションします。
コンフィグレーションのプロパティについては、「
ルーティング アクションのプロパティ 」を参照してください。
ルーティング テーブル アクションは、切り替え式の条件表に含まれた一連のルートを割り当てます。単一の XQuery 式の結果に基づいて、異なるルートが選択されます。
コンフィグレーションのプロパティについては、「
ルーティング テーブル アクションのプロパティ 」を参照してください。
If-Then アクションは、XQuery 式のブール結果に基づいて、1 つまたは複数のアクションを条件付きで実行します。
コンフィグレーションのプロパティについては、「
If-Then アクションのプロパティ 」を参照してください。
動的パブリッシュ アクションは、XQuery 式で指定されたサービスにメッセージをパブリッシュします。
コンフィグレーションのプロパティについては、「
動的パブリッシュ アクションのプロパティ 」を参照してください。
パブリッシュ アクションは、静的に指定されたサービスにメッセージをパブリッシュします。
コンフィグレーションのプロパティについては、「
パブリッシュ アクションのプロパティ 」を参照してください。
パブリッシュ テーブル アクションは、ゼロまたはそれ以上の静的に指定されたサービスにメッセージをパブリッシュします。切り替え式の条件ロジックを使用して、どのサービスをパブリッシュに使用するか実行時に決定します。
コンフィグレーションのプロパティについては、「
パブリッシュ テーブル アクションのプロパティ 」を参照してください。
ルーティング オプション アクションは、発信要求の URI、サービスの品質、モード、再試行パラメータ、メッセージ優先度のプロパティの一部またはすべてを変更します。
コンフィグレーションのプロパティについては、「
ルーティング オプション アクションのプロパティ 」を参照してください。
サービス コールアウト アクションは、Oracle Service Bus に登録済みのプロキシ サービスまたはビジネス サービスの同期 (ブロック) コールアウトをコンフィグレーションします。
コンフィグレーションのプロパティについては、「
サービス コールアウト アクションのプロパティ 」を参照してください。
転送ヘッダ アクションは、メッセージの転送ヘッダの値を設定します。
コンフィグレーションのプロパティについては、「
転送ヘッダ アクションのプロパティ 」を参照してください。
For-Each アクションは、一連の値の反復処理およびアクションのブロックを実行します。
コンフィグレーションのプロパティについては、「
For-Each アクションのプロパティ 」を参照してください。
If Then アクションは、XQuery 式のブール結果に基づき、1 つまたは複数のアクションを条件付きで実行します。
コンフィグレーションのプロパティについては、「
If アクションと Else-If アクションのプロパティ 」を参照してください。
エラーを発生させるアクションは、指定したエラー コード (文字列) と説明を使用して例外を発生させます。
コンフィグレーションのプロパティについては、「
エラーを発生させるアクションのプロパティ 」を参照してください。
返信アクションは、呼び出し元に即時に返信されるように指定します。
コンフィグレーションのプロパティについては、「
返信アクションのプロパティ 」を参照してください。
スキップ アクションは、実行時に現在のステージの実行がスキップされて、処理がメッセージ フローの次のステージに進むように指定します。
コンフィグレーションのプロパティについては、「
スキップ アクションのプロパティ 」を参照してください。
再開アクションは、エラー ハンドラによってエラーが処理された後で、メッセージ フローを再開します。
コンフィグレーションのプロパティについては、「
再開アクションのプロパティ 」を参照してください。
割り当てアクションは、XQuery 式の結果をコンテキスト変数に割り当てます。
コンフィグレーションのプロパティについては、「
割り当てアクションのプロパティ 」を参照してください。
削除アクションは、コンテキスト変数や、XPath 式で指定されたノードのセットを削除します。
コンフィグレーションのプロパティについては、「
削除アクションのプロパティ 」を参照してください。
挿入アクションは、XPath 式で選択されたノードを基準に指定された位置に、XQuery 式の結果を挿入します。
コンフィグレーションのプロパティについては、「
挿入アクションのプロパティ 」を参照してください。
Java コールアウト アクションは、パイプラインから Java メソッドを呼び出します。
コンフィグレーションのプロパティについては、「
Java コールアウト アクションのプロパティ 」を参照してください。
MFL 変換アクションは、パイプラインで、ある非 XML から XML への変換、またはその逆の変換を行います。
コンフィグレーションのプロパティについては、「
MFL 変換アクションのプロパティ 」を参照してください。
名前変更アクションは、XPath 式で選択された要素の名前を、コンテンツを変更することなく変更します。
コンフィグレーションのプロパティについては、「
名前変更アクションのプロパティ 」を参照してください。
置換アクションは、XPath 式で指定されたノードまたはノードのコンテンツを置き換えます。
コンフィグレーションのプロパティについては、「
置換アクションのプロパティ 」を参照してください。
検証アクションは、XML スキーマ要素または WSDL リソースに照らして、XPath 式で選択した要素を検証します。
コンフィグレーションのプロパティについては、「
検証アクションのプロパティ 」を参照してください。
アラート アクションは、パイプラインのメッセージ コンテキストに基づいてアラート通知を送信します。
コンフィグレーションのプロパティについては、「
アラート アクションのプロパティ 」を参照してください。
ログ アクションは、ログに記録されるメッセージを構築します。
コンフィグレーションのプロパティについては、「
ログ アクションのプロパティ 」を参照してください。
レポート アクションは、プロキシ サービスに対してメッセージのレポートを有効にします。
コンフィグレーションのプロパティについては、「
レポート アクションのプロパティ 」を参照してください。
メッセージ フロー デザイン パレット 」から項目をエディタにドラッグします。エディタに項目をドラッグすると、ドラッグしてきた項目をパレット内の位置にドロップできることを示す 1 つまたは複数のターゲット (
挿入 ]、[これに挿入 ]、または [これの後ろに挿入 ] サブメニューからノードやアクションを選択することにより、メッセージ フローにノードとアクションを追加することもできます。また、[エラー ハンドラの追加 ] コマンドを選択して、エラー ハンドラを追加することもできます。これらのサブメニューおよびコマンドは、コンテキストに依存します。つまり、メッセージ フローで選択されたコンテキストに項目を追加することが認められている場合にのみ表示されます。
アラート送り先エディタ 」を参照してください。
メッセージ フロー エディタ で、アラート アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したアラート アクションをコンフィグレーションします。ページは以下のとおりです。
アラート メッセージに追加されるメッセージ コンテキストを指定する XQuery 式です。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
アラートの簡単な説明です。説明文は、電子メール通知の場合の件名になります。文字数を 80 文字以内に制限する必要があります。説明文が存在しない場合、「ALSB Alert」というあらかじめ定義された件名が代わりに使用されます。
このアラートの重大度レベルです。リストからレベルを選択します。
アラートの送り先です。送り先を指定するには、[
参照 ] をクリックして適切なリソースを選択します。
ヒント : 例外によりメッセージの処理が中断することを防ぐために、パイプライン アラートを生成する場合は、処理をグローバル エラー ハンドラに委ねるのではなく、このような例外をローカルに処理して格納するようにアラート アクションのエラー ハンドラを定義することをお勧めします。
メッセージ コンテキスト
メッセージ フロー エディタ で、割り当てアクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した割り当てアクションをコンフィグレーションします。ページは以下のとおりです。
次に説明する [
変数 ] フィールドで指定される変数に割り当てられるデータを作成する式です。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
上で説明した XQuery 式で作成した値を割り当てる変数です。
メッセージ コンテキスト
メッセージ フロー エディタ で、条件付きブランチ ノードをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した条件付きブランチ ノードをコンフィグレーションします。ページは以下のとおりです。
進むべきブランチを決定するために評価される条件を定義する XPath 式です。
XPath 式を作成または編集するには、
<XPath> (定義済みの場合は、XPath のフラグメント
) をクリックして、
XPath 式エディタ を表示します。
ブランチ ] アイコンをクリックします。このプロパティ ページを使用して、メッセージ フローで選択したブランチ ノードをコンフィグレーションします。このページには、次のオプションがあります。
ブランチのラベルです。メッセージ フロー エディタのブランチのラベルとして、このラベルが表示されます。
次のフィールドの値と共に使用する演算子をリストから選択し、ブランチの基盤となる条件を作成します。
前のフィールドの演算子と共に使用する値を入力し、条件を作成します。
メッセージ フロー エディタ で、削除アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した削除アクションをコンフィグレーションします。ページは以下のとおりです。
変数 ] を選択し、XPath 式を削除するには [XPath ] を削除します。
コンテキスト変数を削除するには、このオプション ボタンを選択します。削除するコンテキスト変数の名前を、横のテキスト フィールドに入力します。
XPath 式で選択されたすべてのノードを削除するには、このオプション ボタンを選択します。次に、以下を実行します。
<XPath> (定義済みの場合は、XPath のフラグメントXPath 式エディタ を表示します。 変数内 ] フィールドに、XPath 式で指定されたノードを含むコンテキスト変数を入力します。
メッセージ コンテキスト
メッセージ フロー エディタ で、動的パブリッシュ アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した動的パブリッシュ アクションをコンフィグレーションします。ページは以下のとおりです。
メッセージがパブリッシュされるサービスを定義する XQuery 式です。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
エディタで、XQuery 式を入力するか、以下と同様の結果となる XQuery リソースを選択します。
<ctx:route isProxy="false">
<ctx:service>project/folder/businessservicename</ctx:service>
<ctx:operation>foo</ctx:operation>
</ctx:route>
注意 : operation 要素は省略可能です。
メッセージ コンテキスト
メッセージ フロー エディタ で、動的ルーティング アクションをクリックし、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した動的ルーティング アクションをコンフィグレーションします。ページは以下のとおりです。
メッセージがたどるルートを定義する XQuery 式です。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
XQuery/XSLT 式エディタで、XQuery 式を入力します。結果は以下の様な内容になります。
<ctx:route>
<ctx:service isProxy='true'>{$service}</ctx:service>
<ctx:operation>{$operation}</ctx:operation>
</ctx:route>
注意 : プロキシ サービスが呼び出されている場合は、isProxy 属性を true に設定する必要があります。
メッセージ コンテキスト
ステージ ノードのプロパティ 」を参照してください。
メッセージ フロー エディタ で、For-Each アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した For-Each アクションをコンフィグレーションします。ページは以下のとおりです。
For-Each アクションが実行されるコンテンツの変数の名前を入力します。
[
For Each 変数 ] フィールドで指定された変数の格納側コンテキスト変数の構造内での場所を指定する XPath 式です。
XPath 式を作成または編集するには、
<XPath> (定義済みの場合は、XPath のフラグメント
) をクリックして、
XPath 式エディタ を表示します。
For-Each アクションが実行されるコンテンツの変数を含むコンテキスト変数です。
メッセージ コンテキスト
メッセージ フロー エディタ で、If-Then アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このページを使用して、If-Then アクションの全般的なプロパティを確認およびコンフィグレーションします。ページは以下のとおりです。
If 条件 ] アイコンをクリックするか、または Else-If 条件 アイコンをクリックして、そのプロパティをプロパティ ビューに表示します。このプロパティ ページを使用して、選択した条件をコンフィグレーションします。[If 条件のプロパティ] ページには、次のオプションがあります。
If アクションと Else-If アクションのプロパティ
フロー内の別のパスに従うかどうかを決めるテストの 1 つを含む、If アクションまたは If-Else アクションにある条件です。
条件を追加または編集するには、次の手順を実行します。
<条件> (定義済みの場合は条件のフラグメント条件エディタ を表示します。If-Then アクションで評価される条件を定義します。 デザイン パレット ] からドラッグします。
ルート ノードでは、ルーティング アクション、動的ルーティング アクション、またはルーティング テーブル アクションのみを選択できます。ただし、これらのアクションには、要求と応答のアクションを含めることができます。
条件の追加 ] をクリックします。上の If 条件で説明したように、この Else-If 条件にも 1 つまたは複数のアクションを追加します。ロジックに応じて、Else-If 条件を必要な数だけ追加します。
メッセージ コンテキスト
メッセージ フロー エディタ で、挿入アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した挿入アクションをコンフィグレーションします。ページは以下のとおりです。
XQuery 式を使用して、名前付き変数で指定した場所に挿入されるデータを作成します。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
XPath 式の結果を基準にした、挿入が実行される位置です。次のオプションがあります。
の前に ] - XPath 式で選択される各要素や属性の兄とします。 の後ろに ] - XPath 式で選択される各要素や属性の弟とします。 の最初の子として ] - XPath 式で指定される各要素の第 1 の子とします。XPath の結果が属性を返す場合はエラーが発生します。 の最後の子として ] - XPath 式で指定される各要素の最後の子とします。XPath が属性を返す場合はエラーが発生します。
有効なコンフィグレーションには、以下のコンフィグレーションが含まれます。
XPath 式を作成または編集するには、
<XPath> (定義済みの場合は、XPath のフラグメント
) をクリックして、
XPath 式エディタ を表示します。
上で定義した XPath 変数によって内容が評価されるコンテキスト変数です。テキスト フィールドに変数の名前を入力します。
メッセージ コンテキスト
メッセージ フロー エディタ で、Java コールアウト アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した Java コールアウト アクションをコンフィグレーションします。ページは以下のとおりです。
メッセージ フローから呼び出される外部 Java メソッドです。
[
参照 ] をクリックして、アーカイブされたリソースからクラスと静的メソッドを選択します。クラスとメソッドを選択すると、[
Java コールアウト プロパティ ] ページに表が表示されます。
[
名前 ] カラムには、すべてのメソッドの引数がリストされます。
[
アクション ] カラムの
<式> または式のフラグメントは
XQuery/XSLT 式エディタ にリンクされており、ここで引数に対する値を取得するための式を作成できます。
引数のデータ型は、次のいずれかである必要があります。
Java.lang.String int と java.lang.Integer など) java.lang.BigDecimal および java.lang.BigInteger (これらの型は、ラウンドオフ エラーやオーバーフローが許容されない財務関連の計算で使用されます) org.apache.xbeans.XmlObject のみ (型指定された XML Bean はなし) byte[] java.lang.String[] (入力のみ) XmlObject [ ] (入力のみ)
入力値の型が宣言されている入力引数の型と一致しない場合、Oracle Service Bus は入力値を入力引数の宣言された型に自動的に型キャストします。たとえば、入力引数の宣言された型が Java プリミティブ「
int」の場合、文字列値
"123" は整数
123 に変換されます。
結果が割り当てられる変数です。このフィールドに対するラベルは、結果のデータ型を示します。
結果がバイト配列 (唯一返される可能性のある配列) の場合は、バイナリ コンテンツの XML 要素が返されます。
オプションのサービス アカウントです。この Java メソッドにセキュリティ コンテキストが存在する場合に指定できます。
サービス アカウントを選択するには、[
参照 ] をクリックします。
固定およびマップされたサービス アカウントの場合、そのサービス アカウントのユーザ ID/パスワードはローカル システムと Java コールアウトに伝播されたセキュリティ コンテキストで認証されます。
パススルーの場合、セキュリティ コンテキストは Java コールアウトに伝播されます。(WS-Security で) 定義されている場合、このコンテキストは、メッセージ レベルのコンテキストになります。そうでない場合は、転送レベルのコンテキストになります。
メッセージ コンテキスト
メッセージ フロー エディタ で、ログ アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したログ アクションをコンフィグレーションします。ページは以下のとおりです。
コンテキスト変数の XQuery 式を通じてログに記録されるメッセージ コンテキストです。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
このログ アクションのメモです。これらのメモは、事前に定義された式の結果と一緒にログに記録されます。
ログ メッセージの重大度です。次のオプションがあります。
[
デバッグ ] - アプリケーションの開発中、アプリケーション内の下位レベルのアクティビティに関する詳細な説明を提供するメッセージの作成および使用が有用であることがあります。
[
情報 ] - 通常の処理をレポートするために使用する、低レベルの情報メッセージです。
[
警告 ] - 疑わしい処理やコンフィグレーションが実行されたが、通常の処理には影響を及ぼしません。
[
エラー ] - ユーザ エラーが発生しました。システムまたはアプリケーションでは、割り込みをせず、一部のサービスの停止のみでエラーに対処できます。
メッセージ コンテキスト
メッセージ フロー エディタ で、ノードまたはアクションをクリックし、プロパティ ビューにそのプロパティを表示します。多くのノードやアクションでは、プロパティ ページの 1 つとして [コメント] ページが （タブとして） 表示されます。このページを使用して、メッセージ フローで選択した項目についてのコメントをオプションとして追加できます。
メッセージ フロー エディタ で、ノードまたはアクションをクリックし、プロパティ ビューにそのプロパティを表示します。多くのノードやアクションでは、プロパティ ページの 1 つとして [ネームスペース] ページが （タブとして） 表示されます。このページを使用して、定義済みのネームスペースのリストを表示したり、新しいネームスペースを作成したりできます。
メッセージ フロー エディタ で、ノードまたはアクションをクリックし、プロパティ ビューにそのプロパティを表示します。多くのノードやアクションでは、プロパティ ページの 1 つとして [変数 ] ページが (タブとして) 表示されます。このページを使用して、事前定義されたコンテキスト変数およびユーザによって定義されたコンテキスト変数のリストを表示します。新しい変数を定義するには、[追加 ] をクリックします。
メッセージ コンテキスト
メッセージ フロー エディタ で、MFL 変換アクションをクリックし、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した MFL 変換アクションをコンフィグレーションします。ページは以下のとおりです。
必要に応じて、[
XML から非 XML へ ] または [
非 XML から XML へ ] を選択します。
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。このエディタでは、変数を指定できます。
この入力は、XML への変換の場合はテキストまたはバイナリ、XML 以外への変換の場合は XML でなければなりません。メッセージ コンテキストのバイナリ コンテンツは、バイナリ コンテンツ XML 要素によって表されます。入力がバイナリでなければならない場合、この XML は Xquery 式の結果となります。
静的な MFL リソースを使用して MFL 変換アクションを実行するには、このオプションを選択します。[
参照 ] をクリックしてリソースを選択します。
変換アクションを実行する MFLリソースを指定するには、このオプションを選択します。
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。このエディタでは、プロジェクト/フォルダ/MFL リソース名の形式で、アクションを実行する MFL リソースを指定できます。
この変換アクションの結果が割り当てられる変数の名前です。結果は、バイナリコンテンツの XML 要素になります。
メッセージ コンテキスト
<500) を指定し、これが単一の XPath 式 (たとえば、$body の /ns: PurchaseOrder/ns:totalCost) に対してメッセージ フローの降順に評価されます。最初に満たされた条件によって、進むべきブランチが決定されます。満たされる分岐条件がない場合は、デフォルトのブランチに進みます。ブランチ ノードでは、メッセージ フロー内にいくつかの子孫を持つことができます (デフォルトのブランチを含め各ブランチに 1 つずつ)。
メッセージ フロー エディタ でオペレーション ブランチ ノードをメッセージ フローに追加すると、以下に示すように、そのノードには WSDL で定義された最初の操作に基づく初期の条件付きブランチと、デフォルトのブランチが含まれます。
フロー ] プロパティ ページを表示するには、ノード自体 ([オペレーション ブランチ ノード] アイコン、またはアイコンに接続されている境界ボックス) をクリックします。このページではノードの名前と説明を指定できます。
メッセージ フロー エディタ で、パイプライン ペア ノードをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したパイプライン ペア ノードをコンフィグレーションします。次のオプションがあります。
メッセージ フロー エディタ で、パブリッシュ アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したパブリッシュ アクションをコンフィグレーションします。ページは以下のとおりです。
パブリッシュ アクションの対象サービスです。[
参照 ] をクリックし、リストからプロキシ サービスまたはビジネス サービスを選択します。
このオプションは、選択したサービスに操作が定義されている場合にのみ表示されます。
メッセージのパッケージとサービスへの送信方法をコンフィグレーションするために、[
要求アクション ] フィールドで [
アクションの追加 ] をクリックします。その後で、サービスと関連付けるアクションを選択します。複数のアクションを追加することも可能です。
このオプションを選択すると、発信操作が着信操作と同じになります。
このオプションは、選択したサービスに操作が定義されている場合にのみ表示されます。
メッセージ コンテキスト
メッセージ フロー エディタ のメッセージ フローにパブリッシュ テーブル アクションを追加する場合、次に示すように、パブリッシュ テーブル アクションにはパブリッシュ アクションへのパスを持つケース アクションの他に、デフォルトのパブリッシュ アクションへのパスを持つデフォルトのケース アクションが含まれます。[条件の追加 ] をクリックして、パブリッシュ テーブルに別の条件を追加します。
パブリッシュ テーブル ] アイコン、またはアイコンに接続されている境界ボックス) をクリックして、プロパティ ビューに [パブリッシュ テーブル
実行時にルーティングの決定を行う値を返す XQuery 式です。
XQuery 式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
メッセージ コンテキスト
リストから比較演算子を選択します。次に、パブリッシュ テーブル アクションに対して定義された XQuery 式から返される値が評価される値を入力します。
パブリッシュ アクションのプロパティ 」を参照してください。
メッセージ フロー エディタ で、エラーを発生させるアクションをクリックし、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したエラーを発生させるアクションをコンフィグレーションします。ページは以下のとおりです。
メッセージ コンテキスト
メッセージ フロー エディタ で、名前変更アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した名前変更アクションをコンフィグレーションします。ページは以下のとおりです。
名前を変更する (名前付き変数内の) データの指定に使用される XPath 式です。
XPath 式を作成または編集するには、
<XPath> (定義済みの場合は、XPath のフラグメント
) をクリックして、
XPath 式エディタ を表示します。
名前を変更する要素を保持しているコンテキスト変数です。
選択した要素の名前の変更に使用するローカル名です。
選択した要素の名前を変更するときに使用するネームスペースです。
メッセージ コンテキスト
メッセージ フロー エディタ で、置換アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した置換アクションをコンフィグレーションします。ページは以下のとおりです。
置換する (名前付き変数内の) データの指定に使用する XPath 式です。
XPath 式を作成または編集するには、
<XPath> (定義済みの場合は、XPath のフラグメント
) をクリックして、
XPath 式エディタ を表示します。
名前付き変数内で XPath によって指定されたデータを置換するデータの作成に使用する XQuery 式です。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
XQuery 式を編集したら、以下のいずれかのオプションを選択します。
ノード全体を置換 ] - 定義した XPath 式で選択したノードとそのすべてのコンテンツを置換するように指定します。 ノードのコンテンツを置換 ] - ノードは置換せず、そのコンテンツのみ置換するように指定します。
注意 : [ノード全体を置換 ] オプションを選択して XPath を「./*」に設定するよりも、[ノードのコンテンツを置換 ] オプションを選択して [XPath ] フィールドを空白にする方が効率的です。
メッセージ コンテキスト
メッセージ フロー エディタ で、返信アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した返信アクションをコンフィグレーションします。ページは以下のとおりです。
[
成功時 ] を選択すると、メッセージが成功した場合に応答します。[
失敗時 ] を選択すると、メッセージが失敗した場合に応答します。
メッセージ コンテキスト
メッセージ フロー エディタ で、レポート アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したレポート アクションをコンフィグレーションします。ページは以下のとおりです。
レポートされるデータの作成に使用する XQuery 式です。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
XQuery 式の編集が終了したら、[
キーの追加 ] をクリックして、メッセージ コンテキスト変数またはメッセージ ペイロードからキー識別子を抽出するために使用される 1 つまたは複数のキー値のペアを追加します (残りのメッセージは無視されます)。キーは、メッセージを識別する便利な手段となります。
キー名 : ] フィールドにキーの名前を入力します。 キー値 ] カラムの <XPath> をクリックして、XPath 式エディタ で XPath 式を作成します。 変数内 ] フィールドに、式が実行される変数の名前を入力します。
errorCode ./ctx:errorCode (変数 fault)
実行時にこのこのアクションが行われるたびに、データ ストリームを通じてメッセージが報告されます。以下の表は、レポート アクションが 2 回実行された後の結果を示しています。
MortgageBroker/ProxySvcs/loanGateway3
メッセージ コンテキスト
メッセージ フロー エディタ で、再開アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した再開アクションをコンフィグレーションします。ページは以下のとおりです。
メッセージ コンテキスト
メッセージ フロー エディタ で、ルート ノードをクリックして、プロパティ ビューにそのプロパティを表示します。プロパティ ページは、選択したルート ノードのコンフィグレーションに使用します。ページは以下のとおりです。
メッセージ コンテキスト
メッセージ フロー エディタ で、ルーティング アクションをクリックし、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したルーティング アクションをコンフィグレーションします。ページは以下のとおりです。
ルーティング アクションの対象サービスです。[
参照 ] をクリックし、リストからプロキシ サービスまたはビジネス サービスを選択します。
このオプションは、選択したサービスに操作が定義されている場合にのみ表示されます。
メッセージのパッケージとサービスへの送信方法をコンフィグレーションするために、[
要求アクション ] フィールドで [
アクションの追加 ] をクリックします。その後で、サービスと関連付けるアクションを選択します。複数のアクションを追加することも可能です。
このオプションを選択すると、発信操作が着信操作と同じになります。
このオプションは、選択したサービスに操作が定義されている場合にのみ表示されます。
メッセージ コンテキスト
メッセージ フロー エディタ で、ルーティング オプション アクションをクリックし、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したルーティング オプション アクションをコンフィグレーションします。ページは以下のとおりです。
ルーティング オプション ] ページには次のオプションがあります。
発信メッセージの URI を設定するには、このオプションを選択します。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
URI を返す式を入力します。これで呼び出されたサービスの URI がオーバーライドされます。
サービス品質の要素を設定するには、このオプションを選択します。
ドロップダウン リストから QoS オプションを選択します。これにより、デフォルトがオーバーライドされます。
モードを [要求] または [要求 - 応答] に設定するには、このオプションを選択します。
注意 : これは、通常、呼び出されたサービスのインタフェースに基づいて、自動的に設定されています。Any Soap または Any XML サービスなどでは、設定されていない場合もあります。
再試行間隔を設定するには、このオプションを選択します。
再試行間隔を秒数で指定します。これで呼び出されたサービスでコンフィグレーションされたデフォルトがオーバーライドされます。
再試行回数を設定するには、このオプションを選択します。
アクションを中断するまで再試行を行う回数を指定します。これで呼び出されたサービスでコンフィグレーションされたデフォルトがオーバーライドされます。
メッセージ優先度を設定するには、このオプションを選択します。
式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
メッセージ コンテキスト
メッセージ フロー エディタ で、メッセージ フローに対するルーティング テーブルのアクションを追加すると、ルーティング テーブル アクションには、以下に示すように、ルーティング アクションへのパスを持つケース アクションと、デフォルトのルーティング アクションへのパスを持つデフォルト ケース アクションが含まれます。[条件の追加 ] をクリックして、ルーティング テーブルに別の条件を追加します。
パブリッシュ テーブル ] アイコンまたはアイコンに接続されている境界ボックス) をクリックして、プロパティ ビューにパブリッシュ テーブル プロパティを表示します。
実行時にルーティングの決定を行う値を返す XQuery 式です。
XQuery 式を作成または編集するには、
<式> (定義済みの場合は式のフラグメント
) をクリックして、
XQuery/XSLT 式エディタ を表示します。
メッセージ コンテキスト
リストから比較演算子を選択します。次に、ルーティング テーブル アクションに対して定義された XQuery 式から返される値が評価される値を入力します。
ルーティング アクションのプロパティ 」を参照してください。
メッセージ フローでは、サービス コールアウト アクションを使用して、Oracle Service Bus に登録済みのプロキシ サービスまたはビジネス サービスの同期 (ブロック) コールアウトをコンフィグレーションします。
メッセージ フロー エディタ で、サービス コールアウト アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したサービス コールアウト アクションをコンフィグレーションします。ページは以下のとおりです。
サービス コールアウト アクションの対象サービスです。[
参照 ] をクリックし、リストからプロキシ サービスまたはビジネス サービスを選択します。
このオプションは、選択したサービスが WSDL ベースであり、サービスで呼び出すことができる操作がある場合にのみ表示されます。
次のいずれかのオプションを選択して、要求メッセージと応答メッセージのコンフィグレーション方法を指定します。
表
3-1 に、各種類のサービスで使用できるオプションを示します。
[SOAP 本体のコンフィグレーション] のオプション
[ペイロード パラメータのコンフィグレーション] オプションまたは
[ペイロード ドキュメントのコンフィグレーション] オプション
[SOAP 要求本体] および
これらのオプションをコンフィグレーションするには、次の手順を実行します。
SOAP 要求本体 ] フィールドに、コールアウト要求の SOAP 本体要素の XML を保持する変数の名前を入力します。 SOAP 応答本体 ] フィールドに、応答の SOAP 本体要素の XML がバインドされる変数の名前を入力します。
[SOAP 要求ヘッダ] および
これらのオプションをコンフィグレーションするには、次の手順を実行します。
これらのオプションをコンフィグレーションするには、次の手順を実行します。
要求パラメータ ] フィールドに、実行時に評価される、要求パラメータの値を指定する変数の名前を入力します。 <soap-env:Body>...</soap-env:Body> でラップしません。
$body (soap-env:Body ラッパが保持されます) ではなく、body/* (ラッパ soap-env:Body を削除します) という XPath ステートメントを使用して、その変数のコンテンツを定義します。
応答パラメータ ] フィールドに、実行時に応答を割り当てる変数の名前を入力します。
[要求ドキュメント] および
これらのオプションをコンフィグレーションするには、次の手順を実行します。
要求ドキュメント変数 ] フィールドに、要求ドキュメントを割り当てる変数の名前を入力します。
<soap-env:Body>...</soap-env:Body> でラップしません。
$body (soap-env:Body ラッパが保持されます) ではなく、body/* (ラッパ soap-env:Body を削除します) という XPath ステートメントを使用して、その変数のコンテンツを定義します。
ctx:binary-content 要素が必要です。 応答ドキュメント変数 ] フィールドに、実行時に応答ドキュメントを割り当てる変数の名前を入力します。
転送ヘッダ アクションのプロパティ 」を参照してください。
注意 : 指定する転送ヘッダに加え、その他のヘッダが Oracle Service Bus バインディング レイヤによって追加されます。
メッセージ コンテキスト
メッセージ フロー エディタ で、スキップ アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択したスキップ アクションをコンフィグレーションします。ページは以下のとおりです。
メッセージ コンテキスト
メッセージ フロー エディタ で、ステージ ノードをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページは、選択したステージ ノードのコンフィグレーションに使用します。ページは以下のとおりです。
メッセージ コンテキスト
メッセージ フロー エディタ で、転送ヘッダ アクションをクリックし、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した転送ヘッダ アクションをコンフィグレーションします。ページは以下のとおりです。
の転送ヘッダを設定 ] リストから、以下のいずれかを選択して、どのメッセージ コンテキストの場所を変更するかをランタイムに対して指定します。
発信要求 ] - 発信要求 (ルート、パブリッシュ、またはサービス コールアウト アクションでプロキシ サービスによって送信されるメッセージ) の転送ヘッダの値を設定するには、このオプションを選択します。これらのヘッダ要素は、メッセージ コンテキストの以下の場所にあります。 $outbound/ctx:transport/ctx:request/tp:headers
着信応答 ] - 着信応答 (プロキシ サービスがクライアントに返信する応答メッセージ) の転送ヘッダの値を設定するには、このオプションを選択します。これらのヘッダ要素は、メッセージ コンテキストの以下の場所にあります。 $inbound/ctx:transport/ctx:response/tp:headers
着信メッセージから発信メッセージへ、または発信メッセージから着信メッセージへ、すべてのヘッダをそのまま渡すには、このオプションを選択します。ソース ヘッダ セットのすべてのヘッダはターゲット ヘッダ セットにコピーされ、ターゲット ヘッダ セットの既存の値はすべて上書きされます。
[
ヘッダを追加 ] をクリックして、ヘッダを
ヘッダ テーブルに追加します。以下の手順に従って、各ヘッダをコンフィグレーションします。
このテーブルには、必要な数のヘッダを追加することができます。ランタイムでは、対応する XML の生成時に、ネームスペースを宣言し、適切な順序でヘッダ要素を配置するため、テーブルのヘッダの順序を指定する必要はありません。
名前 ] カラムのドロップダウン リストから、ヘッダ名を選択します。リストには、事前定義されたすべてのターゲット転送のヘッダ名が含まれています (たとえば、HTTP 転送の場合は Content-Type 、JMS 転送の場合は JMSCorrelationID など)。 その他 ] フィールドにヘッダ名を入力します。ヘッダ名がこのサービスの転送用に事前定義されたいずれかのヘッダでない場合、そのヘッダは転送仕様の定義のとおりユーザヘッダになります。
以下ののいずれかのオプションを選択して、ヘッダの値の設定方法を指定します。
ヘッダを式に設定
警告 : このアクションで指定できるすべてのヘッダの設定が実行時に使用されるわけではありません。
ヘッダを削除
着信要求からヘッダをコピー ] (発信要求の転送ヘッダを設定する場合)発信応答からヘッダをコピー ] (着信応答の転送ヘッダを設定する場合)
着信要求からヘッダをコピー ] を選択すると、ランタイムが $inbound の SOAPAction 要求ヘッダから値をコピーします。着信応答ヘッダの場合、コピーするヘッダのソースは、$outbound の応答ヘッダです。
ヘッダをコピー ] オプションが選択された場合、このオプションは無視され、このヘッダのターゲットではアクションが実行されません。
メッセージ コンテキスト
メッセージ フロー エディタ で、検証アクションをクリックして、プロパティ ビューにそのプロパティを表示します。このプロパティ ページを使用して、選択した検証アクションをコンフィグレーションします。ページは以下のとおりです。
XPath 式を作成または編集するには、
<XPath> (定義済みの場合は、XPath のフラグメント
) をクリックして、
XPath 式エディタ を表示します。
検証する要素を保持する変数の名前です。変数の名前を入力するか、コンテンツ支援が有効になっている場合は
〔Ctrl〕+〔Space〕 を押して、宣言済みの変数のリストを表示します。
XPath 式 (上で説明した [
XPath ] フィールド) によって選択された要素の検証の対象となる XML スキーマ要素または WSDL リソースです。
この検証の結果 (ブール結果) を保存する場合は、[
変数の保存 ] を選択し、結果を保存する変数の名前を入力します。
また、WSDL や XML スキーマ要素に照らした要素の検証が失敗したときにエラーを発生させる場合は、[
エラーを発生させる ] を選択します。
メッセージ コンテキスト
上へ ] および [下へ ] ボタンを使用して、参照される JAR の階層構造の順序 (優先順位) を変更します。詳細については、『Oracle Service Bus Console の使い方』の「JAR
プロジェクト名と、JAR リソースがあるとフォルダの名前 (該当する場合) です。このカラムには、現在のワークスペースで使用できるすべての JAR が表示されます。
参照される JAR リソースの名前とパスです。このカラムには、現在のコンフィグレーションで依存関係があるすべての JAR が表示されます。
[新しい SMTP サーバ リソース] ウィザード 」を参照してください。詳細については、『Oracle Service Bus Console の使い方』の「SMTP サーバの編集
SMTP サーバの追加
この SMTP サーバ リソースの説明を入力します。
SMTP サーバを参照する URL を入力します。このフィールドは必須です。
SMTP サーバのポート番号を入力します (デフォルト ポートは 25 です)。このフィールドは必須です。
目的の SMTP サーバにアクセスするためにユーザ名およびパスワードが必要な場合は、[ユーザ名] フィールドにユーザ名を入力して、関連するパスワードを [
パスワード ] および [
パスワードの確認 ] フィールドに入力します。
これらのフィールドは省略可能です。SMTP サーバが保護されている場合のみ必要となります。
ユーザ名に関連付けられているパスワードを入力します。
[
パスワード ] フィールドに入力したものと同じパスワードを入力します。
UDDI UDDI
サービスの検索とインポートで使用される照会 API エンドポイントの URL です。
http://host:port/APPLICATION_SERVER_CONTEXT/uddi/inquiry のフォーマットで照会 URL を入力します。
サービスのパブリッシュで使用されるパブリッシュ API エンドポイントの URL です。
http://host:port/APPLICATION_SERVER_CONTEXT/ uddi/publishing のフォーマットでパブリッシュ URL を入力します。
レジストリへのパブリッシュを行うために必要な認証トークンの取得に使用される、セキュリティ API エンドポイントの URL です。
http://host:port/APPLICATION_SERVER_CONTEXT/ uddi/security のフォーマットでセキュリティ URL を入力します。
レジストリの変更へのサブスクリプション、レジストリのサブスクリプションの作成、インポート サービスに変更がないかどうかのリスンのために使用される、サブスクリプション API エンドポイントの URL です。次のフォーマットでサブスクリプション URL を入力します。
http://host:port/APPLICATION_SERVER_CONTEXT/uddi/subscription
インストーラの
APPLICATION_SERVER_CONTEXT フィールドのデフォルト値は
registry です。
レジストリ コンソールにログインする際のユーザ名を入力します。
レジストリ コンソールにログインする際のパスワードを入力します。
コンフィグレーションされたレジストリへの接続を作成できることを検証するには、[
検証 ] をクリックします。
このボタンをクリックすると、現在のエディタの内容が階層ビューで表示されます。
このボタンをクリックすると、メッセージ フロー エディタの内容がグラフィカルなサムネイル ビューで表示されます。メッセージ フロー全体がエディタに収まりきらない場合は、エディタに表示されているフローの部分を示す青いマスクがアウトライン ビューに表示されます。フローの別の部分を表示するには、エディタに表示するフローの部分にマスクをドラッグします。
このペインには、使用できるすべての Oracle Service Bus リソース タイプが一覧表示されます。タイプを選択すると、そのタイプに関連付けられているファイル拡張子が表示されます。
このプロジェクト/フォルダの中のリソース、またはこのリソースに依存するこのプロジェクト、フォルダ、またはリソースに対して外部のリソースのリストです。
このプロジェクト/フォルダの中のリソース、またはこのリソースが依存するこのプロジェクト、フォルダ、またはリソースに対して外のリソースのリストです。
新しい (クローンとして作成する) プロジェクトの名前を入力します。
[
プロジェクトとして ] を選択すると、別のプロジェクト (他のプロジェクトのピア) として、プロジェクトのクローンが作成されます。
[
場所内のフォルダとして ] を選択すると、プロジェクト (およびその内容) が、プロジェクト内のフォルダに変換されます。このオプションを選択するときは、新しい場所も選択する必要があります。
参照 ] をクリックすると、コンテキストに適した使用可能なリソースがこのダイアログに表示されます。ダイアログの名前は、[WSDL の選択 ]、[MFL の選択 ]、[XML スキーマの選択 ] などのように、表示されるリソースのタイプによって異なります。ダイアログには、各リソースに含まれる項目の階層リストが表示されえう場合もあります。たとえば、[XML スキーマの選択 ] ダイアログには、スキーマで定義されている要素とタイプが一覧表示されます。[WSDL の選択 ] ダイアログには、WSDL で定義されているポートとバインディングが表示されます。
WSDL の選択 ] などでは [消費 ] ボタンをクリックすると、[サービス消費 ] ダイアログが開きます。このダイアログで、Oracle エンタープライズ リポジトリ、ファイル システム、UDDI、URI、ワークスペースなどのリソース タイプからサービスを消費できます。
サービス キー プロバイダ
暗号化キー ] の横にある [キー ] チェック ボックスをオンにします。 参照 ] をクリックして、現在のレルムの PKI 資格マッピングで使用中のキーストアからキー エリアスを表示します。
このサービス キー プロバイダをプロキシ サービスに関連付けると、Oracle Service Bus により X.509 証明書がプロキシ サービスの WSDL に組み込まれます。その後、プロキシ サービスはこの証明書を使用してエンドポイントに送信するメッセージを暗号化します。プロキシ サービスは、PKI 資格情報に含まれるプライベート キーを使用して、エンドポイントから返されるメッセージの暗号化を解除します。
デジタル署名キー ] の横にある [キー ] チェック ボックスをオンにします。 参照 ] をクリックして現在のレルムの PKI 資格マッピングで使用中のキーストアからキー エリアスを表示します。
SSL クライアント認証キー ] の横にある [キー ] チェック ボックスをオンにします。 参照 ] をクリックして現在のレルムの PKI 資格マッピングで使用中のキーストアからキー エリアスを表示します。
カスタム WS-Policy
新しい WS-policy リソースを配置するプロジェクトまたはフォルダの名前を入力または選択します。
サービス アカウント
リソースの種類をそのままにするか、または別の種類を選択します。
サービス アカウント
サービス アカウント
ユーザ名に関連付けられているパスワードを入力します。
[
パスワード ] フィールドに入力したものと同じパスワードを入力します。
サービス アカウント
[
リモート ユーザ名 ] および [
リモート パスワード ] フィールドに、発信要求で送信するユーザ名とパスワードを入力します。
(省略可能) リモート ユーザ テーブルで、他のリモート ユーザを追加します。
「承認された」クライアントをリモートのユーザ名およびパスワードにマップするには、[
ローカル ユーザ名 ] フィールドに、着信要求で認証されたクライアントを識別する名前を入力します。
このユーザを Oracle Service Bus Console の [セキュリティ コンフィグレーション] モジュールに追加していない場合は、このマッピングを実行時環境で使用する前にユーザを追加する。『Oracle Service Bus Console の使い方』の「
ユーザの追加 」を参照してください。
Oracle Service Bus では、存在しないローカル ユーザのマッピングを作成することができるが、このマッピングは認証されたユーザに一致しないため使用されない。
[
リモート ユーザ名 ] リストから、[
ローカル ユーザ名 ] フィールドで指定した認証ユーザに関する発信要求で送信するユーザ名を選択します。
匿名のクライアントをリモートのユーザ名にマップするには、
[
匿名要求のマッピング ] チェック ボックスを選択します。
[
リモート ユーザの選択 ] リストから、すべての匿名ユーザに関する発信要求で送信するユーザ名を選択します。
変数の構造での作業
式 ] テキスト フィールドに式を直接記述するか、[変数の構造] ページから変数をドラッグして [XQuery 関数] ページから XQuery 関数をドラッグできます。
テスト ] をクリックして、実行中のサーバで式をテストできます。または、[OK ] をクリックして、テストを行わずに式を挿入することもできます。
条件エディタ にのみ表示されます。
比較式 ] を選択します。または、単項式を作成するには [単項式 ] を選択します。 比較式 ] を選択した場合、以下の作業を行います。
オペランド ] フィールドに、値と比較するオペランドの名前を入力します。または、右側の [変数の構造 ] タブから [オペランド ] フィールドに項目をドラッグします。 値 ] フィールドにそのオペランドの比較対象の値を入力します。または、右側の [変数の構造 ] タブから [値 ] フィールドに項目をドラッグします。 演算子 ] リストから比較演算子を選択します。 単項式 ] を選択した場合、以下の作業を行います。
NOT ] チェック ボックスを選択または選択解除して、式を true として評価するか、true ではないとして評価するかを指定します。これにより、式を not() で囲む必要があるかどうかを指定することになります。 変数の構造 ] タブから項目をドラッグして式を作成します。
条件式 ] フィールドの式に追加するには、[追加 ] をクリックします。 条件式 ] フィールドでその文を選択してから、[更新 ] をクリックします。 テスト ] をクリックして実行中のサーバで式をテストするか、または [OK ] をクリックして条件をメッセージ フローに挿入します。 XQuery/XSLT 式エディタ 、XPath 式エディタ 、および条件エディタ に表示されます。
[変数の構造] ページ か [XQuery 関数] ページ から項目をドラッグします。
テスト ] クリックします。WebLogic Server は Oracle Service Bus と共にパッケージ化されています。そのため、Oracle Service Bus のインストールに含まれている組み込みサーバをテストの目的に使用できます。
XQuery/XSLT 式エディタ にのみ表示されます。
実行される XQuery リソースです。Oracle Service Bus に登録されている XQuery リソースを検索して開くには、[
参照 ] をクリックします。
リソースを選択すると、トランスフォーメーションの各入力パラメータが表示されます。各ラベルはパラメータ名に相当し、各テキスト ボックスはそのパラメータにマッピングされる XQuery 式を定義するためのものです。マッピングはパラメータごとに定義する必要があります。式を直接入力するか、または右側のパネルから変数および構造をドラッグします。
XQuery/XSLT 式エディタ にのみ表示されます。
XSLT リソース ] タブを使用して、XSLT トランスフォーメーションをコンフィグレーションし、プロキシ サービスのメッセージ フローで実行されるようにします。
実行する XSLT リソースです。Oracle Service Bus に登録されたリソースを検索して開くには、[
参照 ] をクリックします。
トランスフォーメーションに対する入力ドキュメントの XQuery 式です。たとえば、
$body です。
ラベルとそれに対応するテキスト ボックスがトランスフォーメーションの入力パラメータごとに表示されます。各ラベルはパラメータ名に相当し、各テキスト ボックスはそのパラメータにバインドされる XQuery 式を定義するためのものです。バインディングはパラメータごとに定義する必要があります。たとえば、XSL トランスフォーメーションに
one および
two という入力パラメータがある場合、[
変数名 ] フィールドには、[
one ] および [
two ] というラベルと、ラベルごとに XQuery 式を入力するテキスト ボックスが表示されます。
次の XQuery 式は、このフィールドの有効な入力例です。
注意 : 次の変数名はこのフィールドでは無効な入力となり、例外が発生します。
body
XQuery/XSLT 式エディタ にのみ表示されます。
事前登録された XQuery リソースの名前で、実行時に評価される動的 XQuery 式
XQuery リソース (リソースのフルネームを表す) のための構文は以下のとおりです。
Project/folder1/folder2/XQueryResourceName
クエリの形式のためのテンプレートとして機能するリソース (変数の番号と名前)。[
参照 ] をクリックし、既存の登録されているリソースを選択します。 テンプレートを選択した後、変数が [変数のバインド] 領域に表示されます。テンプレートはコンフィグレーションで保持されることはありません。代わりに、テンプレートは、クエリに変数を指定するのに役立つクイック スタートとして機能します。
トランスフォーメーションの入力パラメータ。[カスタム変数の追加] フィールドに変数名を入力して、[
追加 ] をクリックします。
カスタム変数を追加すると、それが [変数のバインド] 領域に表示されます。同様に、XQuery テンプレートを選択すると、 トランスフォーメーションの各入力パラメータが表示されます。各ラベルはパラメータ名に相当し、各テキスト ボックスはそのパラメータにマッピングされる XQuery 式を定義するためのものです。マッピングはパラメータごとに定義する必要があります。式を直接入力するか、または右側のパネルから変数および構造をドラッグします。
XQuery/XSLT 式エディタ 、XPath 式エディタ 、および条件エディタ に表示されます。
attachments、body、header、outbound、および inbound に加えて、ユーザ定義変数が含まれています。fault は、式のコンテキストが該当する場合に含まれます (つまり、エラー ハンドラ内に)。outbound 変数は、すべてのコンテキストで有効ではない場合も必ず表示されます。outbound が無効なコンテキストで使用されると、検証時に報告されます。
[式] ページ にドラッグして、現在の式に挿入することができます。項目は、XPath 式として挿入されます。
追加 ] をクリックして [新しい構造の追加] ダイアログ を開きます。
変数の構造での作業
XQuery/XSLT 式エディタ 、XPath 式エディタ 、および条件エディタ に表示されます。
追加 ] をクリックします。定義されたネームスペースはユーザ定義ネームスペースのリストに追加されます。ユーザ定義ネームスペースを変更するには、リストから対象のネームスペースを選択して [編集 ] をクリックします。
XQuery/XSLT 式エディタ 、XPath 式エディタ 、および条件エディタ に表示されます。
[式] ページ にドラッグして、現在の式に挿入することができます。関数を式に挿入するときは、指定の必要なパラメータの値にプレースホルダが使用されます。
式エディタ の [変数の構造] ページ で変数の構造ツリーに追加します。
$inbound、$outbound、および $fault に対して直接使用できます。ただし、この機能を使用して $attachments の XML 添付ファイル、$header のヘッダ、または $body のドキュメントと RPC パラメータに直接アクセスすることはできません。例外として、WSDL プロキシ サービスによって受信された要求メッセージの $body のドキュメントとパラメータには直接アクセスできます。
作成する変数の表示名です。この表示名を使用すると、実行時には影響を及ぼさず設計時に構造を認識できるように、構造に意味のある名前を付けることができます。
変数の構造での作業
XSL トランスフォーメーション
新しい XSL トランスフォーメーションを配置するプロジェクトまたはフォルダの名前を入力または選択します。
この新しい XSL トランスフォーメーションの名前を入力します。
サービスを呼び出す操作は、WSDL ベース、非転送型ビジネス サービス、WSDL ベースのプロキシ サービス、または分割-結合を呼び出します。
コンフィグレーションのプロパティについては、「
サービスを呼び出すのプロパティ 」を参照してください。
返信コントロールは、応答またはエラーを Oracle Service Bus メッセージ フローに返送します。
コンフィグレーションのプロパティについては、「
返信のプロパティ 」を参照してください。
For Each は、スコープ内でコンフィグレーションされているロジックを指定回数だけ実行します。
コンフィグレーションのプロパティについては、「
For-Each のプロパティ 」を参照してください。
If コントロールは、分割-結合内で条件動作を提供します。
コンフィグレーションのプロパティについては、「
If のプロパティ 」を参照してください。
パラレル コントロールは、固定数のコンフィグレーション済みパラレル ブランチを作成します。
コンフィグレーションのプロパティについては、「
パラレルのプロパティ 」を参照してください。
エラーを発生させるコントロールは、分割-結合の通常の処理を停止させるエラーを発生させます。
エラー ハンドラを使用せずにエラーが処理されると、分割-結合は終了し、Oracle Service Bus メッセージ フローにエラーが送信されます。
コンフィグレーションのプロパティについては、「
エラーを発生させるのプロパティ 」を参照してください。
Repeat Until のプロパティ 」を参照してください。
エラーを再発生させる操作は、エラー ハンドラ キャッチまたは CatchAll によって捕捉されたエラーを再発生することができます。
コンフィグレーションのプロパティについては、「
エラーを再発生させるのプロパティ 」を参照してください。
スコープは、それに含まれる操作の動きに影響を与えるコンテキストを作成します。
コンフィグレーションのプロパティについては、「
スコープのプロパティ 」を参照してください。
While によって、分割-結合で条件が false に評価されるまで操作を繰り返すことができます。各ループが始まる前に、条件が評価されます。
コンフィグレーションのプロパティについては、「
While のプロパティ 」を参照してください。
XQuery 式の結果を変数に割り当てることができます。
コンフィグレーションのプロパティについては、「
割り当て操作のプロパティ 」を参照してください。
XPath 式で指定された情報を、ソース ドキュメントから、対象のドキュメントにコピーできます。
コンフィグレーションのプロパティについては、「
コピーのプロパティ 」を参照してください。
XPath 式で指定されたノードのセットを削除できます。
コンフィグレーションのプロパティについては、「
削除のプロパティ 」を参照してください。
XPath 式で選択したノードを基準として特定された場所に XQuery 式の結果を挿入できます。
コンフィグレーションのプロパティについては、「
挿入のプロパティ 」を参照してください。
検証、トランスフォーメーション、およびロギングなどの Java で処理するカスタム アクションのための分割-結合から静的 Java メソッドを呼び出すことができます。
コンフィグレーションのプロパティについては、「
Java コールアウトのプロパティ 」を参照してください。
管理者が適切なアクションを行うことができるように、指定された重大度でデータを記録します。
コンフィグレーションのプロパティについては、「
ログのプロパティ 」を参照してください。
XPath 式で指定されたノードまたはノードのコンテンツを置き換えることができます。
コンフィグレーションのプロパティについては、「
置換のプロパティ 」を参照してください。
分割-結合で使用される WSDL インポートを表示します。
一覧から WSDL を選択し、右クリックして削除します。
分割-結合で使用されるスキーマ インポートを表示します。
一覧からスキーマを選択し、右クリックして削除します。
プロセス ノードを定義するファイルのラベルを入力します。
SOAP (1.1 または 1.2) エラーを格納する変数を定義します。呼び出された外部サービスから受信した SOAP エラーによりエラー ハンドラが実行された場合、受信した SOAP エラーはこの変数に格納されます。
ネームスペースおよび障害名を入力するには、[
障害の定義 ] をクリックします。
既存の WSDL、アプリケーションや標準の障害を選択することができます。
既存の障害を選択するには、[
障害の選択 ] をクリックします。
SOAP (1.1 または 1.2) エラーを格納する変数を定義します。呼び出された外部サービスから受信した SOAP エラーによりエラー ハンドラが実行された場合、受信した SOAP エラーはこの変数に格納されます。
[
参照 ] をクリックして、呼び出す操作を選択します。
サービス ファイルを開くために場所のパスをクリックします。
操作の入力メッセージ タイプとタイプが一致するメッセージ タイプ変数のリストです。
新しいメッセージ変数を定義するには、[
メッセージ変数を作成します ] を選択します。
注意 : 操作の入力メッセージ タイプとタイプが一致するメッセージ タイプ変数が存在しない場合は、必要なタイプを持つメッセージ タイプ変数を定義する必要があります。
操作の入力メッセージ タイプのネームスペースです。
操作の出力メッセージ タイプとタイプが一致するメッセージ タイプ変数のリストです。
新しいメッセージ変数を定義するには、[
メッセージ変数を作成します ] を選択します。
注意 : 操作の出力メッセージ タイプとタイプが一致するメッセージ タイプ変数が存在しない場合は、必要なタイプを持つメッセージ タイプ変数を定義する必要があります。
操作の出力メッセージ タイプのネームスペースです。
操作の出力メッセージ タイプとタイプが一致するメッセージ変数のリストです。
新しいメッセージ変数を定義するには、[
メッセージ変数を作成します ] を選択します。
注意 : 操作の出力メッセージ タイプとタイプが一致するメッセージ タイプ変数が存在しない場合は、必要なタイプを持つメッセージ タイプ変数を定義する必要があります。
操作の出力メッセージ タイプのネームスペースです。
障害の返信が、WSDL の操作で定義されているエラー メッセージか、または、明示的な SOAP エラー メッセージかを決定します。
WSDL の操作で定義されている障害のリストから障害名を選択します。
操作の出力メッセージ タイプとタイプが一致するメッセージ変数のリストです。
新しいメッセージ変数を定義するには、[
メッセージ変数を作成します ] を選択します。
注意 : 操作の出力メッセージ タイプとタイプが一致するメッセージ タイプ変数が存在しない場合は、必要なタイプを持つメッセージ タイプ変数を定義する必要があります。
操作の出力メッセージ タイプのネームスペースです。
エラー ハンドラで定義された SOAP エラー変数にある SOAP エラーを伝播します。
はい ] を選択すると、For Each のそれぞれの反復が並行して実行されます。 いいえ ] を選択すると、For Each のそれぞれの反復が順次実行されます。
ブランチの作成がいつ停止するかを示す省略可能な式。分割-結合にあるコンテキストに応じて、式は子の実行を回避するか、子の早期終了を強制します。
[参照] ボタンをクリックすると、式ビルダが起動します。
完了条件が満たされるかどうかを判断する際に正常に終了したブランチのみをカウントする場合、このオプションを選択します。
If と Else If のプロパティ 」を参照してください。
true または false に評価される XPath 1.0 式を定義します。条件が true に評価されると、関連する If または Else If ブランチが実行されます。
[参照] アイコンをクリックすると、式ビルダが起動されます。
WSDL に含まれていないカスタム、ローカルな障害を指定することができます。
障害のネームスペースおよび名前を指定するには、[障害] リンクをクリックします。
WSDL に指定されている既存の障害を選択することができます。
WSDL 障害を選択するには、[
障害の選択 ] リンクをクリックします。
true または false に評価される XPath 1.0 式を定義します。Repeat Until の操作は、条件が true に評価されるまでに実行します。
[参照] アイコンをクリックすると、式ビルダが起動されます。
関連トピック
スコープおよび変数
true または false に評価される XPath 1.0 式を定義します。条件が true に評価されると、関連付けられた操作が実行されます。
[参照] アイコンをクリックすると、式ビルダが起動されます。
変数に割り当てるデータを作成する際に使用する XQuery 式です。
式をクリックすると、XQuery エディタが起動します。
値をソースから送り先にコピーするときに使用する要素名 (ソースまたは送り先) を、決定することができます。
このオプションを選択しない場合、コピーした値を保持するために送り先に既存の要素名が使用されます。
このオプションを選択すると、コピーした値を保持するために送り先でソース要素名が使用されます。
たとえば、ソースにある <zipCode>80303</zipCode> から郵便番号の値をコピーしている場合、[ソース要素の選択] を選択すると、送り先に <zipCode> 要素を使用します。このオプションを選択しないと、郵便番号の値が <pinCode>80303</pinCode> などの既存の対象要素にコピーされます。
目的のタイプ (変数、式、リテラル、または XML フラグメント) を選択できるようにします。リテラルおよび XML フラグメントは、[From の選択] メニューでのみ使用できます。
変数の XPath を選択します。変数で単純なノードの選択が必要な場合は、このオプションを使用します。
変数ツリーを展開してノードを選択する場合、Xpath 1.0 式が自動的に生成されます。
変数からノードを選択するには、Xpath 1.0 式を作成します。変数からノードを選択するために、さらに複雑な Xpaths (述部を持つ場合がある) を必要とする場合、このオプションを使用します。
XPath 1.0 式ビルダを使用するには、
式 リンクをクリックします。
注意 : 入力した Xpath 1.0 式は、1 つの XML ノード/要素にのみコピーする必要があります。そうしなければ、実行時エラーが発生します。
タイプの選択 - リテラル (Select From のみ)
文字列を入力するには、[
リテラル ] リンクをクリックします。
タイプの選択 - XML フラグメント (Select From のみ)
ユーザによって入力される XML フラグメントです。
フラグメントを入力するには、[
XML フラグメント ] をクリックします。
注意 : プロキシ サービスのメッセージ フローの削除操作と異なり、分割-結合の削除操作は直接変数を削除することは許可されていません。
削除するノードを選択するための XPath 式です。
式エディタを起動するには、[
XPath ] リンクをクリックします。
この変数に対して XPath 式を実行し、削除するノードを選択します。
XQuery 1.0 式を使用して、変数で指定した場所に挿入されるデータを作成します。
式エディタを起動するには、[
式 ] リンクをクリックします。
XPath 1.0 式に対して実行される挿入操作を制御するために使用される場所。次のオプションがあります。
前の要素 : Xpath 1.0 式の結果で指定された要素の直前の要素に挿入します。 次の要素 : Xpath 1.0 式の結果で指定された要素の直後の要素に挿入します。 の最初の子として ] : XPath 1.0 式の結果で指定された要素の最初の子要素に挿入します。 の最後の子として ] : XPath 1.0 式の結果で指定された要素に属する最後の子要素に挿入します。
選択するノードを決定するための XPath です。
式エディタを起動するには、[
Xpath ] リンクをクリックします。
Java クラスを Oracle Service Bus プロジェクトにある JAR ファイルにパッケージ化できます。[
参照 ] をクリックして、最初に JAR を選択し、呼び出しメソッドを選択します。
Java コールアウト メソッドについて、以下のガイドラインに従います。
入力パラメータに対して次の Java 型のみがサポートされます。
メソッドの戻り値に対して次の Java 型のみがサポートされます。
XQuery 1.0 式は、データを static Java メソッドの入力パラメータにマップするために使用されます。式エディタを起動するには、[
式 ] リンクをクリックします。
Java メソッドの結果値を持つ変数を選択します。
Java コールアウトを実行する場合、適切なサブジェクトをスレッドに配置するためにサービス アカウントを使用できます。
サービス アカウントを選択するには、[
参照 ] をクリックします。
XQuery 1.0 式は、ログされるデータを選択するために使用されます。
式エディタを起動するには、[
式 ] リンクをクリックします。
必要に応じて、ログに関する注意を指定します。アノテーションは、式によって選択されたデータと共にログに記録されます。
ログに対して以下のいずれかの重大度レベルを選択します。
置換する (変数内の) データの指定に使用する XPath 1.0 式です。
式エディタを起動するには、[
XPath ] リンクをクリックします。
名前付き変数内で XPath によって指定されたデータを置換するデータの作成に使用する XQuery 1.0 式です。
式エディタを起動するには、[
式 ] リンクをクリックします。
ノードが置換されないことを指定します。置換されるのはコンテンツのみです。
操作の出力メッセージ タイプとタイプが一致するメッセージ変数のリストです。
新しいメッセージ変数を定義するには、[
新しい変数の作成 ] を選択します。
注意 : 操作の出力メッセージ タイプとタイプが一致するメッセージ タイプ変数が存在しない場合は、必要なタイプを持つメッセージ タイプ変数を定義する必要があります。
操作の出力メッセージ タイプのネームスペースです。
選択されている場合、組み込みタイプの変数のみが表示されます。
選択すると、現在の Oracle Service Bus コンフィグレーションにあるすべてのスキーマ タイプが表示されます。
[Show only applicable schema types/elements for this Split-Join] が選択されると、現在の分割-結合に直接適用できるスキーマ タイプのみが表示されます。これはデフォルトでオンになっています。
選択すると、メッセージ タイプのみが表示されます。
[Show only applicable schema types/elements for this Split-Join] が選択されると、現在の分割-結合に直接適用できるメッセージ タイプのみが表示されます。これはデフォルトでオンになっています。
WSDL メッセージ、XSD 要素、または XSD 型 (単純、複合、組み込み) のいずれかになります。
この分割-結合を格納しているフォルダの名前を入力するか、リストからフォルダを選択します。
この分割-結合を定義しているファイルの名前を入力します。
このボタンをクリックすると、現在の Oracle Service Bus コンフィグレーションの外部から WSDL をインポートし、インポートした WSDL を使用して操作を選択できます。
) が表示されます。項目をターゲット上にドラッグすると、ターゲットが強調表示 (
) され、そこに項目をドロップできることがわかります。
) が表示されます。項目をターゲット上にドラッグすると、ターゲットが強調表示 (
) が表示されます。項目をこのような円にドラッグすると、円が強調表示 (
