A Oracle JCAアダプタのプロパティ

Oracle JCAアダプタに適用可能なJCAとバインディング・プロパティを概観します。アダプタの構成中に特定のJCAアダプタに関する情報を利用します。

正規化されたメッセージは、プロパティとペイロードという2つの部分のみを持つように簡素化されています。Oracle BPEL Process ManagerとOracle Mediatorでは、様々なユーザー・インタフェース・サポート・レベルでヘッダーにアクセスし、操作して設定できます。たとえば、メッセージ・ヘッダーを介してファイル名を伝播することで、そのファイル名をソース・ディレクトリからターゲット・ディレクトリに保存できます。

Oracle JCAアダプタは、標準化メッセージ・プロパティを介してヘッダー情報を送信します(Oracle JCA Adapter for AQのペイロード・ヘッダーを除きます)。

バインディング・プロパティは、デプロイ済SOAコンポジット・アプリケーションに組み込まれているサービス・バインディング・コンポーネントおよび参照バインディング・コンポーネントに対するメッセージ・ヘッダー・プロパティです。

この付録の内容は次のとおりです。

詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のサービスおよび参照バインディング・コンポーネントの構成に関する項を参照してください。

A.1 Oracleファイル/FTPアダプタのプロパティ

ここでは、Oracleファイル/FTPアダプタに適用可能なプロパティを概観します。

すべてのOracle JCAアダプタに適用可能なプロパティについては、「Oracle JCAアダプタの汎用プロパティ」を参照してください。

表A-1 Oracleファイル/FTPアダプタのJCAプロパティ

プロパティ	説明
`Append`	このプロパティが`true`に設定されている場合、Oracleファイル/FTPアダプタはアウトバウンド側のファイルに追加します。このファイルが存在しない場合、新規ファイルが作成されます。ファイル名は、アウトバウンド操作用に`JCA`ファイルで指定するか、`jca.file.FileName`ヘッダーで指定できます。
`AsAttachment`	`true`に設定されている場合、インバウンド・ファイルは添付としてパブリッシュされます。
`BatchSize`	このプロパティ値は、バッチ・トランスフォーメーションのバッチ・サイズに設定します。
`CharacterSet`	添付のキャラクタ・セットを設定します。このパラメータはOracleファイル/FTPアダプタの内部では使用されず、Oracleファイル/FTPアダプタがパブリッシュする添付を処理するサード・パーティ・アプリケーションで使用されます。
`ChunkSize`	チャンク相互作用操作のチャンク・サイズに設定します。
`ConcurrentThreshold`	特定のアウトバウンド・シナリオで同時に実行可能な変換アクティビティの最大数。アウトバウンド操作中の変換ステップは、CPUの負荷が高くなり、他のアプリケーションやスレッドを停止させる可能性があるため、ガードする必要があります。最大値は`100`です。
`ContentType`	添付のMIMEタイプを設定します。このパラメータはOracleファイル/FTPアダプタの内部では使用されず、Oracleファイル/FTPアダプタがパブリッシュする添付を処理するサード・パーティ・アプリケーションで使用されます。
`DeleteFile`	`true`に設定されている場合、Oracleファイル/FTPアダプタはファイルを処理後に削除します。
`DirectorySeparator`	複数のディレクトリを選択した場合、生成されるJCAファイルではディレクトリのセパレータとしてセミコロン(`;`)が使用されます。ただし、他のセパレータへの変更も可能です。その場合は、生成されたJCAファイルに手動で`<property name="DirectorySeparator" value="選択したセパレータ"/>`を追加します。たとえば、セパレータとしてカンマ(`,`)を使用する場合は、まず物理ディレクトリ内でセパレータをカンマ(`,`)に変更してから、JCAファイルに`<property name="DirectorySeparator" value=","/>`を追加します。
`ElapsedTime`	このプロパティは、アウトバウンドのバッチ処理に使用されます。指定された時間が経過すると、発信ファイルが作成されます。パラメータ・タイプは`int`で必須ではありません。デフォルト値は`1`です。
`Encoding`	添付に使用するエンコーディングを設定します。このパラメータはOracleファイル/FTPアダプタの内部では使用されず、Oracleファイル/FTPアダプタがパブリッシュする添付を処理するサード・パーティ・アプリケーションで使用されます。
`ExcludeFiles`	このプロパティは、ポーリング中に除外するファイル・タイプのパターンを指定します。プロパティ・タイプは`String`で必須ではありません。
`FileName`	このパラメータを使用して、書込み操作中に静的な単一ファイル名を指定します。
`FileNamingConvention`	このプロパティは、アウトバウンドのWrite操作ファイルのネーミング規則に使用されます。
`FileSize`	このプロパティは、アウトバウンドのバッチ処理に使用されます。この発信ファイルは、ファイル・サイズの条件が満たされると作成されます。パラメータ・タイプは`int`で必須ではありません。デフォルト値は`1000`KBです。
`IncludeFiles`	このプロパティは、ポーリング中に取得するファイル・タイプのパターンを指定します。パラメータ・タイプは`String`で必須です。
`Lenient`	Lenientプロパティは、デプロイメントの検証とともに機能します。インバウンド・ディレクトリの読取りまたは書込みができない場合、アダプタは失敗をスローしてデプロイメントをロールバックします。ただし、Lenientを`true`に設定にすると、デプロイメントが継続されます。このプロパティのデフォルト値は`false`です。
`ListSorter`	このプロパティは、Oracleファイル/FTPアダプタがインバウンド内のファイルのソートに使用するソーターを指定します。このパラメータは次のように設定できます。ファイル名を変更タイムスタンプの昇順でソートするには、`oracle.tip.adapter.file.inbound.listing.TimestampSorterAscending`と設定します。ファイル名を変更タイムスタンプの降順でソートするには、`oracle.tip.adapter.file.inbound.listing.TimestampSorterDescending`と設定します。
`LogicalArchiveDirectory`	このプロパティは、正常に処理されたファイルをアーカイブする論理ディレクトリを指定します。プロパティ・タイプは`String`で必須ではありません。
`LogicalDirectory`	このパラメータは、ポーリングする論理入力ディレクトリを指定します。パラメータ・タイプは`String`です。
`MaxRaiseSize`	このプロパティは、Oracleファイル/FTPアダプタが各ポーリング・サイクルで処理用に発行するファイルの最大数を指定します。たとえば、インバウンド・ディレクトリに1000のファイルがあり、`MaxRaiseSize`が`100`に設定されていて、ポーリング頻度が1分の場合、Oracleファイル/FTPアダプタは毎分100ファイルを発行します。
`MinimumAge`	このパラメータは、取得するファイルの最短経過時間を指定します。この指定により、大きなファイルを処理用に取得する前に、入力ディレクトリに完全にコピーできるようになります。経過時間は最終更新時のタイムスタンプで決定されます。たとえば、ファイルの書込みに3分から4分かかることがわかっている場合は、ポーリング可能ファイルの最短経過時間を5分に設定します。入力ディレクトリでファイルが検出されても、更新時間から5分以内の場合、まだ書込みが実行されている可能性があるためファイルは取得されません。
`NumberMessages`	このプロパティは、アウトバウンドのバッチ処理に使用されます。この発信ファイルは、メッセージ数の条件が満たされると作成されます。パラメータ・タイプは`int`で必須ではありません。デフォルト値は`1`です。
`PhysicalArchiveDirectory`	このプロパティは、正常に処理されたファイルのアーカイブ場所を指定します。プロパティ・タイプは`String`で必須ではありません。
`PhysicalDirectory`	このプロパティは、ポーリングする1つ以上の物理入力ディレクトリを指定します。パラメータ・タイプは`String`です。ファイルが配置されるインバウンド・ディレクトリは必須です。物理ディレクトリまたは論理ディレクトリを指定する必要があります。
`PollingFrequency`	このパラメータは、特定の入力ディレクトリで新しいファイルをポーリングする頻度を指定します。パラメータ・タイプは`int`で必須です。デフォルト値は1分です。
`PublishSize`	このプロパティは、ファイルに複数のメッセージがあるかどうか、およびBPELプロセスに一度にパブリッシュするメッセージ数を特定します。パラメータ・タイプは`int`で必須ではありません。デフォルト値は`1`です。たとえば、あるファイルに11個のレコードがあり、このパラメータが2に設定されている場合、そのファイルでは一度に2レコードずつ処理され、最終レコードは6回目に処理されます。
`Recursive`	このプロパティが`true`に設定されている場合、アダプタはメイン入力ディレクトリの下にあるすべてのサブディレクトリを再帰的に処理できます。
`SequenceName`	アウトバウンドOracleファイル/FTPアダプタを高可用性に対応するよう構成している場合、使用されるOracleデータベースの順序名を指定します。
`SingleThreadModel`	値が`true`の場合、Oracleファイル/FTPアダプタのポーラーはファイルを同一スレッド内で処理します。つまり、グローバルなインメモリー・キューを処理に使用しません。
`SourceFileName`	ファイルI/O操作用のソース・ファイル。
`SourcePhysicalDirectory`	ファイルI/O操作用のソース・ディレクトリ。
`SourceSchema`	ソース・ファイルのスキーマに設定します。
`SourceSchemaRoot`	ソース・ファイルのルート要素名に設定します。
`SourceType`	ソース・ファイルがネイティブの場合は`native`に、xmlの場合は`xml`に設定します。
`TargetFileName`	ファイルI/O操作用のターゲット・ファイル。
`TargetPhysicalDirectory`	ファイルI/O操作用のターゲット・ディレクトリ。
`TargetSchema`	このプロパティ値は、ターゲット・ファイルのスキーマに設定します。
`TargetSchemaRoot`	このプロパティ値は、ターゲット・ファイルのルート要素名に設定します。
`TargetType`	ターゲット・ファイルがネイティブの場合は`native`に、xmlの場合はxmlに設定します。
`ThreadCount`	このプロパティを使用できる場合、アダプタはグローバル・スレッド・プールのプロセッサ・スレッドに依存せず、独自のプロセッサ・スレッドを作成します(デフォルトでは4つ)。つまり、このパラメータはインメモリー・キューを分割し、それぞれのコンポジット・アプリケーションが独自のインメモリー・キューを取得します。 `ThreadCount`プロパティが`0`に設定されている場合、スレッド動作はシングル・スレッド・モデルと同じになります。 `ThreadCount`プロパティが`-1`に設定されている場合、グローバル・スレッド・プールが使用され、動作はデフォルトのスレッド・モデルと同じになります。 `ThreadCount`プロパティの最大値は`40`です。
`TriggerFile`	インバウンドOracleファイル/FTPアダプタをアクティブ化するトリガー・ファイルの名前。
`TriggerFilePhysicalDirectory`	Oracleファイル/FTPアダプタがトリガー・ファイルを検索するディレクトリ・パス。
`TriggerFileStrategy`	このプロパティは、Oracleファイル/FTPアダプタがトリガー・ファイル・ディレクトリ内で指定のトリガー・ファイルを検索する際に使用する戦略を定義します。使用可能な値は、`EndpointActivation`、`EveryTime`または`OnceOnly`です。
`Type`	ファイルIO相互作用については、`COPY`、`MOVE`または`DELETE`に設定します。
`UseRemoteErrorArchive`	このプロパティは、インバウンド読取り時にエラーがアーカイブされる場所を定義します。インバウンド読取りの操作中、不正な形式のXMLファイルが読み取られるとエラーが発生します。エラーになったファイルは、デフォルトでリモート・ファイル・システムに送信されてアーカイブされます。エラーになったファイルは、jcaファイルにuseRemoteErrorArchiveプロパティを指定し、そのプロパティをfalseに設定することで、ローカル・ファイルシステムでアーカイブできます。このプロパティのデフォルト値はtrueです。
`UseHeaders`	このパラメータは、`true`または`false`に設定できます。インバウンドOracleファイルまたはFTPアダプタの使用中に、ファイル・ヘッダーを読み取り、ペイロードの読取りをスキップする必要がある場合は、`UseHeader`プロパティを`true`に設定します。これは通常、インバウンド・アダプタを通知機能として使用する、大きいペイロードのシナリオで使用されます。
`UseStaging`	`true`に設定されている場合、アウトバウンドOracleファイル/FTPアダプタは変換データをステージング・ファイルに書き込んだ後、そのステージング・ファイルをターゲット・ファイルにストリーミングします。`false`に設定されている場合、アウトバウンドOracleファイル/FTPアダプタは中間ステージング・ファイルを使用しません。
`Xsl`	ソースとターゲット間の`xsl`トランスフォーマに設定します。

表A-2 Oracle FTPアダプタに固有のJCAプロパティ

プロパティ	説明
`FileType`	このプロパティは、要件に応じて`ascii`または`binary`に設定します。
`SourceIsRemote`	IO操作のソースがリモートFTPサーバーではなくローカル・ファイルシステムであることをOracle FTPアダプタに通知する場合、このプロパティを`false`に設定します。
`TargetIsRemote`	IO操作のターゲットがリモートFTPサーバーではなくローカル・ファイルシステムであることをOracle FTPアダプタに通知する場合、このプロパティを`false`に設定します。
`UseNlst`	Oracle FTPアダプタでデフォルトの`LIST`コマンドのかわりに`NLST` FTPコマンドを使用する場合、このプロパティを`true`に設定します。
`UseRemoteArchive`	このプロパティを`true`に設定すると、アーカイブ・ディレクトリは同じFTPサーバー上にあることがOracle FTPアダプタに通知されます。`false`に設定すると、Oracle FTPアダプタはアーカイブにローカル・ファイルシステム・フォルダを使用します。

表A-3 Oracleファイル/FTPアダプタのバインディング・プロパティ

プロパティ	説明
`IgnoreListingErrors`	ポーリング操作中のインバウンドOracleファイル・アダプタの動作を制御できます。`true`に設定すると、Oracleファイル・アダプタはネストされたフォルダからの読取りができなくてもそれを通知しません。
`IgnoreZeroByteFile`	ファイルが見つからない場合に、アウトバウンド読取り操作中にOracleファイル/FTPアダプタが例外をスローしないようにするには、`true`に設定します。インバウンド・ファイルのスキーマが`Opaque`以外の場合、このプロパティは無視されます。
`NestedFolderLimit`	ファイル/FTPアダプタがファイルをポーリングするために入力ディレクトリに再帰的に処理するレベル数を制限します。
`InMemoryTranslation`	このプロパティは、`UseStaging`が`false`に設定されている場合にのみ適用されます。`UseStaging`が`true`に設定されている場合、変換ステップはメモリー内で行われます(つまり、インメモリー・バイト配列が作成されます)。`false`に設定されている場合、アダプタはターゲット・ファイル(FTP、FTPS、SFTPを含む)への出力ストリームを作成し、トランスレータにストリームの変換や直接書込みを許可します。
`jca.message.encoding`	このプロパティは、インバウンドOracleファイル/FTPアダプタのNXSDスキーマに指定されているエンコーディングをオーバーライドするために使用します。
`NotifyEachBatchFailure`	`true`に設定すると、デバッチ・シナリオでエラーが発生するたびに、Oracleファイル/FTPアダプタは通知エージェントの`onBatchFailure`をコールします。`false`に設定すると、すべてのメッセージのデバッチ後に1回のみ、Oracleファイル/FTPアダプタは`onBatchFailure`をコールします。
`oracle.tip.adapter.file.debatching.rejection.quantum`	このプロパティでは、インバウンドOracleファイル/FTPアダプタのパートナ・リンクで拒否されるメッセージのサイズを制御できます。たとえば、これを`100`に設定すると、実際のファイルが大きすぎる場合、Oracleファイル/FTPアダプタはファイルの100行を拒否します。
`oracle.tip.adapter.file.highavailability.maxRetry`	分散ポーリング・シナリオでデータベース接続の確立をインバウンドOracleファイル/FTPアダプタが再試行する回数。
`oracle.tip.adapter.file.highavailability.maxRetryInterval`	分散ポーリング・シナリオでデータベース接続の確立をインバウンドOracleファイル/FTPアダプタが再試行するまでのミリ秒数。
`oracle.tip.adapter.file.mutex`	このプロパティ値は、アウトバウンド書込み操作のmutexを指定するクラス名に設定します。このクラスは、`oracle.tip.adapter.file.Mutex`抽象化を拡張する必要があります。
`oracle.tip.adapter.file.rejectOriginalContent`	`true`に設定すると、Oracleファイル/FTPアダプタは元のコンテンツを拒否します。`false`に設定すると、アダプタは、変換ステップによって作成されたXMLデータを拒否します。
`oracle.tip.adapter.file.timeout.recoverpicked.minutes`	このプロパティは、`FILEADAPTER_IN`をコーディネータとして使用している際にインバウンドの高可用性アダプタが使用します。処理用のファイルがノードによって初めて要求(エンキュー)されると、`FILEADAPTER_IN`の`FILE_PROCESSED`列は`0`に設定されます。後で、分離されたプロセッサ・スレッドが処理用のファイルを取得すると、`FILE_PROCESSED`列の値は`0`から`1`に更新されます。ファイルの処理が完了すると、`FILE_PROCESSED`列は`1`から`2`に更新されます。ただし、プロセッサ・スレッドはファイルを取得したが、ファイルの処理前にノードがクラッシュした場合、そのファイルは処理されません。このプロパティは、取得操作をundoするために使用します。アダプタはこの際、取得後にここに指定した時間内に処理されなかった`FILEADAPTER_IN`表内のエントリを削除します。
`oracle.tip.adapter.file.timeout.recoverunpicked.minutes`	このプロパティは、`FILEADAPTER_IN`をコーディネータとして使用している際にインバウンドの高可用性アダプタが使用します。ノードがファイルを処理用に初めて要求すると、`FILEADAPTER_IN`の`FILE_PROCESSED`列は`0`に設定されることに注意してください。この後で、分離されたプロセッサ・スレッドがファイルを処理用に取得すると、`FILE_PROCESSED`列の値は`0`から`1`に更新されます。ファイルの処理が完了すると、`FILE_PROCESSED`列は`1`から`2`に更新されます。`FILE_PROCESSED`が`0`である間にノードがクラッシュすると、ファイルはノードによってエンキューされます(他のノードはこのファイルを取得できません)。ただしこの場合、分離されたプロセッサ・スレッドも、このファイルを処理用にまだ取得していません。このプロパティは、要求(`enqueue_ operation`)をundoするために使用されます。アダプタはこの際、要求後にまだ取得されていない`FILEADAPTER_IN`表内のエントリ(たとえば`FILE_PROCESSED =="0"`)を削除します。
`RecoveryInterval`	このプロパティは、エラーの発生時にインバウンド・アダプタがリカバリ間隔を構成するために使用します。たとえば、物理ディレクトリが存在しない場合、アダプタはこの値を使用して定期的なスリープまたはウェイクアップ・チェックを実行し、物理ディレクトリが作成されていてアクセス可能であるかどうかをチェックします。
`SerializeTranslation`	`true`に設定されている場合、変換ステップはセマフォを使用してシリアライズされます。セマフォ(変換ステップをガード)の許可数は、`ConcurrentThreshold`プロパティから導出されます。`false`の場合、変換ステップはセマフォ外で行われます。
`UseFileSystem`	このプロパティは、クラスタ環境での読取り専用ポーリング中にインバウンドOracleファイル/FTPアダプタが使用します。これを`true`に設定すると、アダプタはファイルシステムを使用して処理済のファイルのメタデータを格納します。`false`に設定すると、アダプタはデータベース表を使用します。

表A-4 Oracle FTPアダプタに固有のバインディング・プロパティ

プロパティ	説明
`TimestampOffset`	このプロパティは、タイムゾーンの問題を処理するためにOracle FTPアダプタによって使用されます。通常は、Oracle FTPアダプタが実行されているシステムとFTPサーバーとの時差をミリ秒に変換するために使用されます。
`control.so.timeout`	このプロパティを使用して、FTPサーバーへの制御ソケットのタイムアウトを定義できます。このパラメータは、ミリ秒単位で指定する必要があります。

表A-5 Oracleファイル・アダプタのJCAプロパティ: 正規化されたプロパティ

プロパティ	説明
`jca.file.FileName`	このプロパティは、インバウンド・ディレクトリから読み取られるか、またはアウトバウンド・ディレクトリに書き込まれるファイルの名前を指定します。
`jca.file.Directory`	このプロパティは、ファイルの読取り元または書込み先のディレクトリの名前を指定します。
`jca.file.Size`	このプロパティは、インバウンドOracleファイル・アダプタからパブリッシュされたファイルのサイズを指定します。
`jca.file.Batch`	このプロパティは、インバウンド・アダプタからパブリッシュされるファイルの一意の識別子を指定するために使用します。
`jca.file.BatchIndex`	ファイルに複数のメッセージとデバッチ処理が使用されている場合、この正規化されたプロパティは、同じバッチからのメッセージ(レコード)数を指定します。この場合、`jca.file.Batch`はそのままですが、`jca.file.BatchIndex`は同じバッチからのパブリッシュごとに1ずつ増分します。
`jca.file.IsEOF`	このプロパティは、チャンク相互作用で使用されます。ファイルの最後に達したかどうかを検出するのに使用されます。

表A-6 Oracle FTPアダプタのJCAプロパティ: 正規化されたプロパティ

プロパティ	説明
`jca.ftp.FileName`	このプロパティは、インバウンド・ディレクトリから読み取られるか、またはアウトバウンド・ディレクトリに書き込まれるファイルの名前を指定します。
`jca.ftp.Directory`	このプロパティは、ファイルの読取り元または書込み先のディレクトリの名前を指定します。
`jca.ftp.Size`	このプロパティは、インバウンドOracleファイル・アダプタからパブリッシュされたファイルのサイズを指定します。0を指定できます。
`jca.ftp.Batch`	このプロパティは、インバウンドOracle FTPアダプタからパブリッシュされるファイルの一意の識別子を指定するために使用します。
`jca.ftp.BatchIndex`	ファイルに複数のメッセージとデバッチ処理が使用されている場合、この正規化されたプロパティは、一致するバッチからのメッセージ(レコード)数を指定します。この場合、`jca.ftp.Batch`はそのままですが、`jca.ftp.BatchIndex`は同じバッチからのパブリッシュごとに1ずつ増分します。

A.2 Oracleソケット・アダプタのプロパティ

ここでは、Oracleソケット・アダプタに適用可能なプロパティを概観します。

表A-7

すべてのOracle JCAアダプタに適用可能なプロパティについては、「Oracle JCAアダプタの汎用プロパティ」を参照してください。

詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のOracleソケット・アダプタに関する項を参照してください。

表A-7 Oracleソケット・アダプタのJCAプロパティ

プロパティ	説明
`ByteOrder`	通信中のリモート・コンピュータのバイト順。
`CustomImpl`	`CustomImpl`を`TransMode`プロパティとして選択すると、それがハンドシェイクを定義するJavaクラスの名前になります。このプロパティは、ICustomParserインタフェースの具体的な実装です。
`Encoding`	リモート・コンピュータで使用するキャラクタ・エンコーディング。
`Host`	アウトバウンドの場合は、ソケット・サーバーが実行されていて、接続先となるコンピュータ名。インバウンドの場合は、常に`localhost`です。
`Port`	アウトバウンドの場合は、ソケット・サーバーが実行されていて、アダプタの接続先となるポート番号です。インバウンドの場合は、着信接続をソケット・アダプタがリスニングするポート番号です。
`ReplyXslt`	`XSLT`を`TransMode`プロパティとして選択すると、インバウンド・リプライのハンドシェイクを定義するスタイルシートへのパスが指定されます。
`TransMode`	プロトコル定義メカニズム。スタイルシートを使用する場合は`XSLT`に、カスタムJavaコードを使用する場合は`CustomImpl`に、通常のスキーマ変換を行う場合は`NXSD`に設定します。JavaScriptハンドシェイク・ベース・プロトコルの場合は、`Script`に設定します。
`Xslt`	`XSLT`を`TransMode`プロパティとして選択すると、インバウンドおよびアウトバウンドのリクエストまたはリプライの場合、インバウンド・リクエストのハンドシェイクを定義するスタイルシートへのパスが指定されます。
`RequestScript`	サービス側のみ。要求側の通信を処理するために使用されるJavaScriptファイルの名前。`TransMode`がスクリプトに設定されている場合に使用します。
`ReplyScript`	サービス側のみ。応答側の通信を処理するために使用されるJavaScriptファイルの名前。`TransMode`がスクリプトに設定されている場合に使用します。
`OutboundScript`	参照側のみ。アウトバウンド通信に使用されるJavaScriptファイルの名前。`TransMode`がスクリプトに設定されている場合に使用します。
`SupportNIO`	デフォルトでは、このプロパティは`true`に設定されています(指定がない場合)。NIOは、インバウンド方向に対してのみ、およびNXSDモードの変換に対してのみサポートされています。XSLT、CustomImpl、Script、SupportNIOといった他のモードでは、`false`に設定されています。また、NIOは非SSL接続に対してのみサポートされています。

A.3 Oracle AQアダプタのプロパティ

ここでは、Oracle AQアダプタに適用可能なプロパティを概観します。

すべてのOracle JCAアダプタに適用可能なプロパティについては、「Oracle JCAアダプタの汎用プロパティ」を参照してください。

詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のOracle AQアダプタに関する項を参照してください。

表A-8 Oracle AQアダプタのJCAプロパティ

プロパティ	説明
`QueueName`	読取りまたは書込みが行われるAQキューの名前。
`DatabaseSchema`	キューが存在するスキーマ。指定しない場合、現在の接続のスキーマが使用されます。
`SchemaValidation`	このプロパティが`true`に設定されている場合、指定したスキーマと対照してペイロードが検証されます。検証に失敗した場合、メッセージは拒否されます。
`EnableStreaming`	このプロパティが`true`に設定されている場合、キューからのペイロードはインメモリーDOMとして処理されるかわりにストリーミングされます。この機能は、大きなペイロードの処理中に使用する必要があります。このプロパティは、RAWメッセージ、XMLTypeメッセージおよびADT属性を介してペイロードが指定されるADTタイプのメッセージを処理する際に適用可能です。
`RecipientList`	コンシューマ名またはアダプタによってエンキューされたメッセージの対象受信者の名前を指定します。メッセージは、すべての受信者がメッセージをデキューするまでキュー内に残ります。このフィールドを空のままにした場合、現在アクティブなすべてのコンシューマが受信者になります。
`Consumer`	マルチ・コンシューマ・キューにのみ適用可能です。指定した場合、特定のコンシューマを対象としたメッセージのみが処理可能になります。
`ObjectFieldName`	このプロパティは、キューがADTキューである場合に、ビジネス・ペイロードを含むフィールドの識別に使用されます。ペイロードを構成するADTの属性を指定するか、またはペイロードを表すADT全体を指定できます。前者の場合は、「ObjectFieldName」はADTの属性名と同じである必要があります。後者の場合、このプロパティは指定されません。
`PayloadHeaderRequired`	`ObjectFieldName`プロパティに値を指定する場合にのみ適用可能です。`true`に設定すると、ADTのペイロード以外のすべての属性が、正規化されたメッセージ・プロパティ`jca.aq.HeaderDocument`として処理可能になります。
`MessageSelectorRule`	マルチ・コンシューマ・キューでデキューが実行される際には、メッセージを選別して特定の条件を満たすもののみを着信することが必要な場合があります。これらの条件はペイロード値またはキュー・ヘッダー値に基づき、アダプタの`MessageSelectorRule`プロパティを使用して指定できます。これらの条件は、特定の優先度のメッセージの選択、または$100,000を超えるローン・アプリケーションのみを選択する場合などはメッセージ・ペイロードの一部に関係します。
`DequeueCondition`	このプロパティは、デキュー操作に対してのみ有効です。SQL問合せの`WHERE`句に似たブール式を入力します。この式には、メッセージ・プロパティ、ユーザー・データ・プロパティ(オブジェクト・ペイロードのみ)およびPL/SQLまたはSQL関数に関する条件を含めることができます。複数のメッセージがデキュー条件を満たす場合、デキューの順序は未確定で、キューのソート順は考慮されません。
`Correlation`	各メッセージに識別子を割り当て、後で特定のメッセージを取得する方法を提供できます。入力する値は、非同期通信のためにエンキューの送信元とデキューの受信先で同意されています。この値は、正規化されたメッセージ・プロパティ`jca.aq.Correlation`を介してメッセージごとにオーバーライドできます。デキュー操作に対して指定されている場合、指定した値と一致するメッセージのみがデキューされます。何も指定されていない場合、キュー内のすべてのメッセージをデキュー操作に使用できます。
`PayloadSizeThreshold`	このプロパティでは、構成可能な制御メカニズムが公開され、これによりアダプタ・レイヤー内のペイロード・サイズしきい値を指定できます。サイズが構成されたしきい値の制限を超えるメッセージは拒否されます。このプロパティが構成されていない場合、メッセージ・サイズに対する制限はありません。

表A-9 Oracle AQアダプタのJCAプロパティ: 正規化されたプロパティ

プロパティ	説明
`jca.aq.Attempts`	メッセージのデキュー時における失敗の試行回数。
`jca.aq.Correlation`	ユーザーにより割り当てられた相関ID。
`jca.aq.Delay`	メッセージがデキュー可能になるまでの秒数。
`jca.aq.EnqueueTime`	メッセージがエンキューされた時間。
`jca.aq.ExceptionQueue`	例外キューの名前。
`jca.aq.Expiration`	メッセージが失効するまでの秒数。このパラメータは`Delay`パラメータからのオフセットです。指定しない場合、デフォルト値の`-1(never expires)`が使用されます。
`jca.aq.MessageId`	デキューされたメッセージの16進形式のメッセージID。
`jca.aq.OrigMessageId`	16進形式の元のメッセージID。
`jca.aq.Priority`	メッセージの優先度。数値が小さいほど高い優先度を示します。優先度には任意の数値を指定できます。デフォルト値は0です。
`jca.aq.RecipientList`	このメッセージの受信者リスト(カンマ区切り)。これにより、`InteractionSpec`の`RecipientList`がオーバーライドされます。
`jca.aq.HeaderDocument`	現在のヘッダーの文字列またはDOM (XML DOM形式のペイロード・ヘッダー)が含まれています。

表A-10 Oracle AQアダプタのバインディング・プロパティ

プロパティ	説明
`ConnectionRetryDelay`	Oracle AQアダプタが接続の消失後に接続の再作成を試行するまで待機する時間。デフォルト値は15です。
`DequeueTimeOut`	インバウンド・キューでメッセージが受信されない場合に`dequeue()` APIがタイムアウトになるまでの間隔。デフォルト値は1です。
`adapter.aq.dequeue.threads`	エンドポイントがアクティブ化されたときに作成されるポーラー・スレッドの数を指定します。デフォルト値は1です。

A.4 Oracle JMSアダプタのプロパティ

ここでは、Oracle JMSアダプタに適用可能なプロパティを概観します。

すべてのOracle JCAアダプタに適用可能なプロパティについては、「Oracle JCAアダプタの汎用プロパティ」を参照してください。

詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のOracle JMSアダプタに関する項を参照してください

表A-11 Oracle JMSアダプタのJCAプロパティ

プロパティ	説明
`DestinationName`	読取りまたは書込みが行われるキューまたはトピックの名前。
`UseMessageListener`	非推奨。現在のバージョンでサポートされているこのプロパティの値はfalseのみです。`false`の値を指定すると、メッセージのキューまたはトピックをポーリングする同期メカニズムがJMSアダプタで確実に使用されます。
`PayloadType`	このプロパティは、アダプタによってデキューまたはエンキューされるJMSメッセージのタイプを指定します。マップ・メッセージの場合、値は`MapMessage`で、テキスト・メッセージの場合、値は`TextMessage`です。
`DurableSubscriber`	永続サブスクリプションの識別に使用される名前。永続サブスクリプションを処理する場合は、`DurableSubscriber`プロパティ以外に、ClientIDも指定されていることを確認してください。`ClientID`は、管理コネクション・ファクトリ・インスタンスの定義時に`FactoryProperties`プロパティの一部として指定されます。このプロパティは、JMSトピック・シナリオで作業する場合にのみ適用可能です
`MessageS`elector	構文がSQL92条件式構文のサブセットに基づいている文字列。この文字列では、ヘッダー・フィールド参照およびプロパティ参照を使用して、メッセージ・アダプタが対象であることを指定できます。ヘッダー値およびプロパティ値がセレクタと一致するメッセージのみが配信されます。
PayloadEntry	タイプが`MapMessage`のメッセージを処理する場合にのみ適用可能です。このプロパティは、マップ・メッセージを処理する場合に、ビジネス・ペイロードを含むフィールドの識別に使用されます。それ以外のすべてのマップ・メッセージ・エントリは、`jca.jms.Map.MapMessage entry name`を使用してアクセスされる正規化されたメッセージ・プロパティとして使用可能になります
AttachmentList	タイプが`MapMessage`のメッセージを処理する場合にのみ適用可能です。このプロパティは、マップ・メッセージを処理する場合に、ビジネス・ペイロードを含むフィールドの識別に使用されます。また、この場合ペイロードは添付としてパブリッシュされます。`PayloadEntry`または`AttachmentList`を使用できます。それ以外のすべてのマップ・メッセージ・エントリは、`jca.jms.Map.MapMessage entry name`を使用してアクセスされる正規化されたメッセージ・プロパティとして使用可能になります
`RequestDestinationName`	このプロパティは、同期リクエスト-リプライ・シナリオに適用され、メッセージを送信する宛先の名前を指定します。
`ReplyDestinationName`	このプロパティは、同期リクエスト-リプライ・シナリオに適用され、メッセージを受信する返信先の名前を指定します。
`AllowTemporaryReplyDestination`	このプロパティは、同期リクエスト-リプライ・シナリオに適用されます。`true`に設定すると、`ReplyDestinationName`は不要になり、JMSアダプタではリプライの受信に一時返信先が使用されます。
`EnableStreaming`	このプロパティが`true`に設定されている場合、キューまたはトピックからのペイロードはインメモリーDOMとして処理されるかわりにストリーミングされます。この機能は、大きなペイロードの処理中に使用する必要があります。
`DeliveryMode`	使用する配信モードを表します。メッセージ・プロデューサのデフォルト配信モードは`PERSISTENT`です。この値は、正規化されたメッセージ・プロパティ`jca.JMSDeliveryMode`を使用して、メッセージごとにオーバーライドできます。
`TimeToLive`	メッセージの存続期間を表します(ミリ秒単位)。メッセージ・プロデューサのデフォルト存続時間は無制限です。メッセージは失効しません。`0`の値は、メッセージが失効しないことを示します。
`PayloadSizeThreshold`	このプロパティでは、構成可能な制御メカニズムが公開され、これによりアダプタ・レイヤー内のペイロード・サイズしきい値を指定できます。サイズが構成されたしきい値の制限を超えるメッセージは拒否されます。このプロパティが構成されていない場合、メッセージのサイズに制限はありません
`Priority`	このメッセージの優先度を表します。メッセージ・プロデューサのデフォルトの優先度は4です。この値は、正規化されたメッセージ・プロパティ`jca.jms.JMSPriority`を使用して、メッセージごとにオーバーライドできます。
`UnitOfOrder`	順序単位機能の使用を指定します。メッセージ順序単位機能を使用すると、メッセージ・プロデューサや単体として動作するプロデューサのグループが、複数のメッセージを1つの単位にグループ化してメッセージを作成順に処理することが可能になります。

表A-12 Oracle JMSアダプタのJCAプロパティ: 正規化されたプロパティ

プロパティ	説明
`jca.jms.JMSDestinationName`	このプロパティはメッセージの送信先を指定し、JMSプロデューサによって設定されます。
`jca.jms.JMSDestinationProperties`	このプロパティは、メッセージを送信する必要がある宛先オブジェクトを参照する場合に使用されるコンテキストを定義するプロパティを表します。
`jca.jms.JMSCorrelationID`	このプロパティは、レスポンス・メッセージとリクエスト・メッセージをリンクするために、プロデューサおよびコンシューマの両方によって設定されます。これはオプションの属性です。
`jca.jms.JMSType`	このプロパティは、JMSメッセージ・タイプを指定します。
`jca.jms.JMSReplyTo`	これは、メッセージの返信を送信する必要がある宛先を示すオプションの属性です。
`jca.jms.JMSPriority`	このプロパティは、0から9の優先度の数値を設定するために、コンシューマによって使用されます。数値が大きいほど優先度が高くなります。
`jca.jms.JMSExpiration`	このプロパティは、期限切れ前のメッセージの期間を指定します。メッセージが有効期限に達した場合、JMSプロバイダはそのメッセージを破棄する必要があります。
`jca.jms.JMSDeliveryMode`	このプロパティは、JMSクライアントによって`persistent`または`nonpersistent`モードに設定されます。
`jca.jms.JMSMessageID`	このプロパティは、一意のメッセージ識別子を指定するために使用します。一意性の正確な範囲はプロバイダによって定義されます。
`jca.jms.JMSRedelivered`	このプロパティは、メッセージが再配信されたものかどうかを示すために使用します。「JMSRedelivered」フィールドが設定されたメッセージをクライアントが受信した場合、そのメッセージは以前に配信されたが、そのときは受信が確認されなかった可能性があります。
`jca.jms.JMSTimestamp`	このプロパティは、送信先のJMSプロバイダにメッセージが渡される時間を指定するために使用します。
`jca.jms.JMSProperty.name`	このプロパティは、メッセージのカスタム(アプリケーション固有)プロパティを表します。サポートされているプロパティは、JMSの仕様に従って許可されたものに準拠します。無効なプロパティ値が指定された場合、アダプタによりユーザーに警告が通知され(ログ・ファイルに記録)、その無効なプロパティが無視されます。
`jca.jms.Map.name`	このプロパティは、ペイロードとして転送されないMapMessage要素を表します。
`jca.jms.WeblogicUnitOfOrder`	この値により、`JmsProduceInteractionSpec`の`UnitOfOrder`プロパティを使用して指定された値がオーバーライドされます。
`jca.jms.JMSProperty.JMS_BEA_UnitOfOrder`	この正規化されたプロパティは、BPELのreceiveアクティビティでインバウンドJMSメッセージに設定された順序単位の値を取得するために使用します。

表A-13 Oracle JMSアダプタのバインディング・プロパティ

プロパティ	説明
`adapter.jms.encoding`	インバウンド・テキスト・メッセージのエンコーディングに使用されます。このプロパティは、インバウンドとアウトバウンドの両方のメッセージに適用可能な`jca.message.encoding`と呼ばれる新たにサポートされたプロパティに置き換えられました。
`adapter.jms.DistributedDestinationConnectionEveryMember`	このプロパティは、ブール値になります。 [`true` \| `false`]。デフォルト値は`true`です。 trueの場合、アダプタは分散宛先の各メンバーに対してコンシューマ/サブスクライバを作成します。falseに設定すると、アダプタは分散宛先のローカル・メンバーに対してのみ、コンシューマ/サブスクライバを作成します。アダプタがリモート・クラスタ上の分散宛先またはリモート・ドメインのサーバーに接続している場合、プロパティ`adapter.jms.DistributedDestinationConnection EveryMember`は常にtrueに設定する必要があります。アダプタがローカル・クラスタ上の分散宛先に接続している場合、プロパティはtrueまたはfalseのいずれかに設定できます。trueに設定する場合、アダプタの動作は以前と同じままです(分散宛先ごとにコンシューマが作成されます)。 falseに設定すると、アダプタはローカル・メンバーに対してのみコンシューマ/サブスクライバを作成します。サービス側では、バインディング・プロパティとしてJDeveloperユーザー・インタフェースのプロパティは表示されません。<service> /<binding.jca>タグの下に、次のようにcomposite.xmlにプロパティを手動で追加する必要があります。 `<property name="adapter.jms.DistributedDestinationConnectionEveryMember" type="xs:string" many="false" override="may">false</property>`
`adapter.jms.receive.threads`	エンドポイントがアクティブ化されたときに作成されるポーラー・スレッドの数を指定します。デフォルトは1です。
`adapter.jms.receive.timeout`	同時受信コールに使用されるタイムアウト値。インバウンド・キューでメッセージが受信されない場合にreceive() APIがタイムアウトになるまでの時間。デフォルト値は1です。
`adapter.jms.registration.interval`	このプロパティは現在サポートされていません。
`adapter.jms.retry.interval`	インバウンド接続再試行レイヤーで使用されます。Oracle JMSアダプタが接続の消失後に接続の再作成を試行するまで待機する時間。デフォルト値は30です。
`JMSReplyToDestinationProperties`	インバウンド・リクエスト/リプライ・シナリオで受信された宛先オブジェクトにカスタム・プロパティ設定を宣言的に設定します。
`JMSReplyUseCorrelationIdForCorrelation`	相関に相関IDを使用するかどうかを指定するために使用されます。値は`true`および`false`です。デフォルト値は`false`です。
`JMSReplyUseMessageIdForCorrelation`	相関のメッセージIDかどうかを指定するために使用されます。値は`true`および`false`です。何も指定されていない場合のデフォルト値はfalseです。
`JMSReplyPropagateJMSExpiration`	ブール・プロパティは、リプライ・メッセージTTLが0に設定される(メッセージは失効しない)か、一部の指定された値がメッセージの有効期限に関連するかどうかを指定します。デフォルト値はfalseです。
`RequestReply.cacheReceivers`	同じ少数のJMS受信者が同じリクエスト宛先に繰り返し使用される場合、このプロパティを`true`に設定するとパフォーマンスが向上します。何も指定されていない場合のデフォルト値はfalseです。
`RequestReply.useCorrelation`	同期リクエスト-リプライ・シナリオに適用されます。`true`に設定すると、リプライ・メッセージの取得用にJMSメッセージ・セレクタが適用されます。リクエストの正規化されたメッセージ・プロパティ`jca.jms.JMSCorrelationID`が指定されている場合は、このプロパティが相関に使用されます。指定されていない場合には、JMSメッセージIDプロパティが使用されます。JMSアダプタはメッセージ・セレクタ`JMSCorrelationID = '<corrId>' [ AND (<wsdlSelector>) ]`を使用します(ANDブランチは、ユーザーが`MessageSelector`プロパティを指定した場合にのみ含まれます)。デフォルト値は`true`。
`SuppressHeaders`	ヘッダーのバイパスに使用されます。コンポジットがヘッダーを使用も生成もしないシナリオでは、`true`の値を使用できます。その場合、パフォーマンスが向上することがあります。デフォルト値は`false`です。

A.5 Oracleデータベース・アダプタのプロパティ

ここでは、Oracleデータベース・アダプタに適用可能なプロパティを概観します。

すべてのOracle JCAアダプタに適用可能なプロパティについては、「Oracle JCAアダプタの汎用プロパティ」を参照してください。

詳細は、次を参照してください。

『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のOracleデータベース・アダプタに関する項。
『Oracle SOA SuiteでのSOAアプリケーションの開発』の付録H「正規化されたメッセージ・プロパティ」。

表A-14 Oracleデータベース・アダプタのJCAプロパティ: インスタンス・プロパティ

プロパティ	説明
`DataSourceName`	このプロパティまたはxADataSource名、あるいはその両方は必須プロパティです。接続先の`tx-level="local"`データソースのJNDI名(`jdbc/...`)を指します。このプールを使用するすべての操作は、グローバル・トランザクションに依存せず、ローカルに処理されます。`xADataSourceName`と`dataSourceName`の両方が指定されている場合、後者が`READ`操作に使用されます。
`LogTopLinkAll`	デフォルト値は`FALSE`です。DBアダプタ・ロギングを増加し、基礎となるすべての`TopLink`ログ・メッセージが最大の粒度で含まれるようにする必要があります。このプロパティによって可視性は最大になりますが、アダプタ・ロギングは、最も関連のある`TopLink` SQLロギングを示すようにチューニングされています。
`PlatformClassName`	これは必須プロパティです。これは、接続先のデータベースのタイプを指します。このプロパティに対して提示される値は次のとおりです。 Oracle11Platform Oracle10Platform Oracle9Platform Oracle8Platform DB2Platform InformixPlatform SybasePlatform SQLServerPlatform MySQLPlatform DatabasePlatform `oracle.toplink.platform.database.DatabasePlatform`のサブクラスのフル・パッケージおよびクラス名も指定できます。AS/400上のDB2の場合、`oracle.tip.adapter.db.toplinkext.DB2AS400Platform`の値を指定することをお薦めします。
`UsesBatchWriting`	デフォルト値は`TRUE`です。複数の同一の文が単一のバッチ文として実行されます。このプロパティは、既知の問題がある特定のJDBCドライバに対してのみ無効にしてください。
`UsesSkipLocking`	デフォルト値は`TRUE`です。`SELECT FOR UPDATE`を使用するOracleデータベースのポーリング文は`SELECT FOR UPDATE SKIP LOCKED`に自動的にアップグレードされ、同時パフォーマンスが向上します。このプロパティは、ロッキングのスキップが他の機能または使用例に適合しない、特定の場合にのみ無効にします。
`UsesNativeSequencing`	デフォルト値は`TRUE`です。`INSERT`操作に対して順序番号を自動的に割り当てるSOAサービスが構成されている場合、`TRUE`を設定すると、順序番号がデータベースのネイティブ順序から導出されます。
XADataSourceName	これは必須プロパティです。データベースに接続する`tx-level="global"`データソースのJNDI名(`jdbc/...`)を指定します。このプールを使用するすべての操作では、グローバル・トランザクションにバインドし、1単位としてコミットまたはロールバックします。

表A-15 Oracleデータベース・アダプタのJCAプロパティ: 正規化されたメッセージ・プロパティ

プロパティ	説明
`jca.db.CursorName`	インバウンド/アウトバウンド。
`jca.db.DataSourceName`	アウトバウンド。
`jca.db.Password`	アウトバウンド。Oracle Containers for Java EE上で`jca.db.password`プロパティに値を割り当てることはできませんが、これは、そのデータソースでは`getConnection`メソッドに対するパスワードの動的な設定がサポートされていないためです。かわりに`jca.db.ProxyPassword`を使用することを検討してください。
`jca.db.ProxyCertificate`^脚注 1	アウトバウンド。設定する場合は、プロキシ・タイプとして`OracleConnection.PROXYTYPE_CERTIFICATE`を指定します。値は、証明書を含む`base64Binary`でエンコードされた`byte[]`配列です。設定する場合は、`jca.db.ProxyDistinguishedName`、`jca.db.ProxyUser`および`jca.db.ProxyPassword`は設定しません。
`jca.db.ProxyDistinguishedName`^脚注 1	アウトバウンド。設定する場合は、プロキシ・タイプとして`OracleConnection.PROXYTYPE_DISTINGUISHED_NAME`を指定します。値は`java.lang.String`としてプロキシ識別名を設定します。設定する場合は、`jca.db.ProxyCertificate`、`jca.db.ProxyUserName`および`jca.db.ProxyPassword`は設定しません。
`jca.db.ProxyIsThickDriver`^脚注 1	アウトバウンド。値は`true`および`false`です。JDBC-level APIにはthickドライバとthinドライバの間に一部不整合があるため、OCIドライバを使用する場合は、`true`に設定します。
`jca.db.ProxyPassword`^脚注 1	アウトバウンド。設定する場合は、プロキシ・タイプとして`OracleConnection.PROXYTYPE_USER_PASSWORD`を指定します。値は`java.lang.String`としてプロキシ・ユーザーのパスワードを設定します。設定する場合は、`jca.db.ProxyUserName`も設定する必要があります。設定する場合は、`jca.db.ProxyCertificate`名も`jca.db.ProxyDistinguished`名も設定しません。
`jca.db.ProxyRoles`^脚注 1	アウトバウンド。プロキシ・ユーザーに関連付けられたロールを定義するために設定します。値は`String[]`配列として指定し、配列内の各`java.lang.String`をロール名に対応させます。このプロパティは、`OracleConnection.PROXYTYPE_USER_PASSWORD`、`OracleConnection.PROXYTYPE_CERTIFICATE`および`OracleConnection.PROXYTYPE_DISTINGUISHED_NAME`のいずれかを使用する場合に適用可能です。
`jca.db.ProxyUserName`^脚注 1	アウトバウンド。設定する場合は、プロキシ・タイプとして`OracleConnection.PROXYTYPE_USER_PASSWORD`を指定します。値は`java.lang.String`としてプロキシ・ユーザーのユーザー名を設定します。設定する場合は、`jca.db.ProxyPassword`も設定する必要があります。設定する場合は、`jca.db.ProxyCertificate`名も`jca.db.ProxyDistinguished`名も設定しません。
`jca.db.UserName`	アウトバウンド。Oracle Containers for Java EE上で`jca.db.userName`プロパティに値を割り当てることはできませんが、これは、そのデータソースでは`getConnection`メソッドに対するユーザー名の動的な設定がサポートされていないためです。かわりに`jca.db.ProxyUserName`を使用することを検討してください。
`jca.db.XADataSourceName`	アウトバウンド。

^脚注1

詳細は、「プロキシ認証のサポート」を参照してください。

A.6 Oracle MQ Seriesアダプタのプロパティ

ここでは、Oracle MQ Seriesアダプタに適用可能なプロパティを概観します。

すべてのOracle JCAアダプタに適用可能なプロパティについては、「Oracle JCAアダプタの汎用プロパティ」を参照してください。

詳細は、『Oracle SOA SuiteおよびOracle Business Process Management Suiteの管理』のOracle MQアダプタに関する項を参照してください。

表A-16 Oracle MQ SeriesアダプタのJCAプロパティ

プロパティ	説明
`QueueName`	このプロパティは、メッセージの送受信用のMQキューの名前を指定します。
`MessageType`	このプロパティは、メッセージのタイプ「標準」、「リクエスト」、「リプライ」または「レポート」を指定します。
`MessageFormat`	このプロパティは、MQメッセージ・フォーマットのタイプ(「デフォルト」、「リクエスト/リプライ」など)を指定します。
`Priority`	このプロパティは、メッセージの優先度を指定します。値は`0`から`9`です。デフォルト値は`AS_Q_DEF`で、宛先キューで定義されている値が使用されます。
`Persistence`	このプロパティは、メッセージの永続性を設定するために使用します。このプロパティが`true`に設定されている場合、メッセージは保持されます。デフォルト値は`AS_Q_DEF`で、宛先キューで定義されている値が使用されます。
`OnDeliveryFailure`	このプロパティは、メッセージの配信に失敗した場合に使用します。デフォルト値は`DeadLetterQueue`で、メッセージは配信不能キューに送信されます。値が`DISCARD`に設定されている場合、メッセージは破棄されます。
`PartialDeliveryForDL`	このプロパティは、配布リストへの一部配信に使用します。デフォルト値は`false`です。
`SegmentIfRequired`	このプロパティは、メッセージのサイズがキューに設定された上限を超える場合に使用します。デフォルト値は`true`。
`Expiry`	このプロパティは、メッセージがキュー・マネージャによって削除されるまでの時間を指定します。デフォルト値は`NEVER`です。
`ReplyToQueueName`	このプロパティは、リプライまたはレポートを送信する必要があるキューの名前を指定します。
`ReportCOA`	このプロパティが設定されている場合、メッセージが宛先キューに着信したときに、着信時の確認レポートが`replyto`キューに送信されます。デフォルト値は`WITH_NO_DATA`です。この場合、データは送信されません。
`ReportCOD`	このプロパティが設定されている場合、メッセージが宛先キューに着信したときに、送信時の確認レポートが返信先キューに送信されます。デフォルト値は`WITH_NO_DATA`です。この場合、データは送信されません。
`ReportException`	このプロパティが設定されている場合、宛先キューへのメッセージ配信が失敗したとき、例外レポートが返信先キューに送信されます。デフォルト値は`WITH_NO_DATA`です。この場合、データは送信されません。
`ReportExpiry`	このプロパティが設定されている場合、宛先キューへ送信されたメッセージが失効したとき、有効期限レポートが返信先キューに送信されます。デフォルト値は`WITH_NO_DATA`です。この場合、データは送信されません。
`WaitInterval`	このプロパティは、アウトバウンドMQキューのメッセージをデキューする待機間隔を指定します。
`MessageId`	このプロパティは、リプライ・メッセージまたはレポート・メッセージのメッセージIDを生成するために使用します。デフォルトでは、新しいメッセージIDが生成されます。
`CorrelationId`	このプロパティは、リプライ・メッセージまたはレポート・メッセージの相関IDを生成するために使用します。デフォルトでは、リクエスト・メッセージのメッセージIDが相関IDとして使用されます。
`QueueOpenOptions`	このプロパティは、キューへのアクセス中に使用するキューのオープン・オプションを指定します。
`SecondaryQueueManagerName`	このプロパティは、エンキュー・キューのキュー・マネージャを指定します。このプロパティは、アウトバウンド・エンキュー・キューがインバウンド・キュー・マネージャの外部にある場合にのみ使用します。
`BackoutQueue`	このプロパティは、インバウンド・キューから拒否されたメッセージの送信先のバックアウト・キューを指定するために使用します。
`BackoutQueueManagerName`	このプロパティは、バックアウト・キューのキュー・マネージャを指定するために使用します。このプロパティは、バックアウト・キューがインバウンド・キュー・マネージャの外部にある場合にのみ使用します。
`MaximumBackoutCount`	このプロパティは、拒否されたメッセージがバックアウト・キューに送信されるまでの最大バックアウト再試行回数を指定するために使用します。
`BackoutInterval`	このプロパティは、バックアウト再試行間の間隔を指定するために使用します。デフォルト値は5秒です。
`BackoutRetries`	このプロパティは、バックアウト再試行の回数を指定するために使用します。デフォルト値は3です。
`FallbackReplyToQueueName`	このプロパティは、通常メッセージ・キューにレポートを送信するために使用します。
`FallbackReplyToQueueManagerName`	このプロパティは、JNDI接続で指定されたプライマリ・キュー・マネージャがキューにアクセスできない場合に使用します。
`DistributionList`	このプロパティは、メッセージをエンキューするための配布リストの要素を指定するために使用します。
`MessageSelector`	このプロパティは、MQキューから取得する必要があるメッセージを指定します。ヘッダーとプロパティが選択条件に一致するメッセージのみを取得します。
`AsAttachment`	このプロパティは、trueに設定した場合、すべてのメッセージを添付として処理するようアダプタを設定します。
`CharacterSet`	このプロパティはオプションで、AsAttachmentプロパティをtrueに設定している場合にのみ指定します。添付のキャラクタ・セットを定義し、Oracle MQ Seriesアダプタがパブリッシュした添付を処理するサード・パーティ・アプリケーションで使用されます。
`Encoding`	このプロパティはオプションで、AsAttachmentプロパティをtrueに設定している場合にのみ指定します。添付のエンコーディングを定義し、Oracle MQ Seriesアダプタがパブリッシュした添付を処理するサード・パーティ・アプリケーションで使用されます。
`ContentType`	このプロパティはオプションで、AsAttachmentプロパティをtrueに設定している場合にのみ指定します。添付のコンテンツ・タイプを定義し、Oracle MQ Seriesアダプタがパブリッシュした添付を処理するサード・パーティ・アプリケーションで使用されます。
`MaximumSegmentLength`	このプロパティはオプションで、メッセージをカスタム・サイズにセグメント化する場合にのみ、値を指定する必要があります。値は、integerValue[M/K/B]の形式にする必要があります。Mはメガバイト、Kはキロバイト、Bはバイトを表します。たとえば、230K、4M、512Bなどです。
`ServerHeartbeat`	このプロパティは、MQキュー・マネージャが停止した場合、再接続を試行するまでにアダプタが待機する必要がある時間をミリ秒単位で定義します。
`ExponentialBackOff`	このプロパティは、`MaxExponentialBackOffCount`プロパティと組み合せて使用する必要があります。このプロパティ(秒単位)は、アダプタがキュー・マネージャに再接続を試行する場合の指数的に増加する時間間隔の基準となる値を定義します。たとえば、値が2の場合、アダプタは2秒、4秒、8秒、16秒の間隔で再接続を試行します。
`MaxExponentialBackOffCount`	このプロパティは、ExponentialBackOffプロパティと組み合せて使用する必要があります。このプロパティは、ExponentialBackOffの時間間隔を制限するために使用します。たとえば、ExponentialBackOffを2に設定し、MaxExponentialBackOffCountを7に設定した場合、アダプタは2、4、8、16、32、64、128、128、128…秒の間隔で再試行します。
`UseDynamicResponseQueue`	ブール・プロパティを使用して、永続的なReplyToQueueではなく動的なレスポンス・キューを使用する必要があるかどうかを指定できます。trueに設定する場合、`ResponseModelQueueName`を指定する必要があります。
`ResponseModelQueueName`	モデル・キューの名前で、リプライ・メッセージを取得するために作成する必要がある動的なレスポンス・キューに基づいています。
`ResponseWaitInterval`	このプロパティは、リプライ・キューに到着するまでアダプタがレスポンス・メッセージを待つ待機間隔を指定します。
`LimitHeaderLength`	このプロパティは、MQヘッダー情報を削減するのに使用されます。このプロパティは、対応するMQアダプタのJCAファイルの`oracle.tip.adapter.mq.inbound.ActivationSpecImpl`に追加することができます。デフォルト値はfalseです。
`PollingFrequency`	このパラメータは、インバウンドMQアダプタがMQキューでメッセージをポーリングする頻度を指定します。パラメータ・タイプは`int`(ミリ秒単位)です。パラメータが指定されない場合、デフォルトは3000ミリ秒です。

表A-17 Oracle MQ SeriesアダプタのJCAプロパティ: 正規化されたプロパティ

プロパティ	説明
`jca.mqAccountingToken`	インバウンド/アウトバウンド。メッセージのアカウンティング・トークン情報。16進数のエンコードされた文字列。
`jca.mq.ApplIdentityData`	インバウンド/アウトバウンド。メッセージまたはその発信元の識別情報に関する追加情報を提供します。任意の文字列を受け入れます。
`jca.mq.ISpec.ResponseWaitInterva`l	アウトバウンド。リプライ・キューに到着するまでレスポンス・メッセージを待つ待機間隔。ミリ秒単位の整数値を受け入れます。
`jca.mq.MQMD.ApplOriginData`	インバウンド/アウトバウンド。このメッセージの発信元に関する追加情報を提供します。任意の文字列を受け入れます。
`jca.mq.MQMD.BackoutCount`	インバウンド/アウトバウンド。メッセージが作業ユニットの一部として以前にMQQueue.get()コールによって返された後、取り消された回数。ゼロおよび正の整数値を受け入れます。
`jca.mq.MQMD.CorrelId`	インバウンド/アウトバウンド。取得/蓄積するメッセージの相関識別子。16進数のエンコードされた文字列を受け入れます。
j`ca.mq.MQMD.Encoding.Decima`l	インバウンド/アウトバウンド。アプリケーション・メッセージ・データ内の数値に使用される表現。NORMALとREVERSEDを受け入れます。
`jca.mq.MQMD.Encoding.Float`	インバウンド/アウトバウンド。アプリケーション・メッセージ・データ内の数値に使用される表現。NORMAL、REVERSEDおよびS390を受け入れます。
`jca.mq.MQMD.Expiry`	インバウンド/アウトバウンド。メッセージの有効期限が経過し、キュー・マネージャによる破棄の対象になっています。NEVERまたはInbound/Outbound.negative以外の整数値を受け入れます
`jca.mq.MQMD.Feedback`	インバウンド/アウトバウンド。レポートの性質を示すためにMQC.MQMT_REPORTタイプのメッセージで使用されます。任意の文字列を受け入れます。
`jca.mq.MQMD.Feedback.ApplicationDefined`	インバウンド/アウトバウンド。アプリケーション定義のフィードバック。任意の文字列を受け入れます。
`jca.mq.MQMD.Format`	インバウンド/アウトバウンド。受信者へのメッセージに含まれるデータの性質を示すために、メッセージの送信者が使用する名前の書式を設定します。受け入れる書式は、NONE、ADMIN、CHANNEL_COMPLETED、CICS、CMD1、CMD2、DEAD_LETTER_HDR、DIST_HDR、EVENT、IMS、IMS_VAR_STRING、MD_EXTN、PCF、REF_MSG_HDR、RF_HDR_1、RF_HDR_2、STRING、TRIGGER、WORK_INFO_HDR、XMIT_Q_HDRです。
`jca.mq.MQMD.GroupId`	インバウンド/アウトバウンド。物理メッセージが属するメッセージ・グループを識別するバイト文字列。16進数のエンコードされた文字列を受け入れます。
`jca.mq.MQMD.MsgFlags.IsMsgInGroup`	インバウンド/アウトバウンド。メッセージがグループに属するかどうかを指定します。true、falseを受け入れます。
`jca.mq.MQMD.MsgFlags.IsLastMsgInGroup`	インバウンド/アウトバウンド。メッセージがグループの最後のメッセージかどうかを指定します。true、falseを受け入れます
`jca.mq.MQMD.MsgFlags.IsSegment`	インバウンド/アウトバウンド。メッセージがセグメントかどうかを指定します。true、falseを受け入れます
`jca.mq.MQMD.MsgFlags.IsLastSegment`	インバウンド/アウトバウンド。メッセージが最後のセグメントかどうかを指定します。true、falseを受け入れます
`jca.mq.MQMD.MsgId`	インバウンド/アウトバウンド。取得/蓄積するメッセージのメッセージ識別子。16進数のエンコードされた文字列を受け入れます。
`jca.mq.MQMD.MsgSeqNumber`	インバウンド/アウトバウンド。グループ内の論理メッセージのシーケンス番号。Inbound/Outbound.negative以外の整数値を受け入れます
`jca.mq.MQMD.MsgType`	インバウンド/アウトバウンド。メッセージのタイプを示します。任意の文字列を受け入れます。
`jca.mq.MQMD.MsgType.ApplicationDefined`	インバウンド/アウトバウンド。アプリケーション定義のメッセージ・タイプ。任意の文字列を受け入れます。
`jca.mq.MQMD.Offset`	インバウンド/アウトバウンド。論理メッセージの先頭からの物理メッセージ内のデータのオフセット。Inbound/Outbound.Negative以外の整数値を受け入れます。
`jca.mq.MQMD.OriginalLength`	インバウンド/アウトバウンド。セグメント化されたメッセージの元の長さです。負以外の整数値Inbound/Outboundを受け入れます
`jca.mq.MQMD.Persistence`	インバウンド/アウトバウンド。メッセージの永続性。true、false、AS_Q_DEFを受け入れます。
`jca.mq.MQMD.Priority`	インバウンド/アウトバウンド。メッセージの優先度。0- Inbound/Outbound.9、AS_Q_DEFを受け入れます
`jca.mq.MQMD.PutApplName`	インバウンド/アウトバウンド。メッセージを蓄積するアプリケーションの名前。任意の文字列を受け入れます
`jca.mq.MQMD.PutApplType`	インバウンド/アウトバウンド。メッセージを蓄積するアプリケーションのタイプ。任意の文字列を受け入れます。
`jca.mq.MQMD.PutApplType.UserDefined`	インバウンド/アウトバウンド。ユーザー定義の蓄積アプリケーション・タイプ。任意の文字列を受け入れます。
`jca.mq.MQMD.PutDateTime`	インバウンド/アウトバウンド。メッセージが蓄積された日時。year:month:date、year:month:date:hour:minute、year:month:date:hour:minute:secondを受け入れます
`jca.mq.MQMD.ReplyToQMgr`	インバウンド/アウトバウンド。リプライまたはレポート・メッセージの送信先のキュー・マネージャの名前。任意の文字列を受け入れます。
`jca.mq.MQMD.ReplyToQ`	インバウンド/アウトバウンド。リプライまたはレポート・メッセージの送信先のキューの名前。任意の文字列を受け入れます
`jca.mq.MQMD.Report.Generate.CorrelId`	インバウンド/アウトバウンド。リプライまたはレポート・メッセージのCorrelationIdを生成するためのスキーム。PASS_CORREL_ID、COPY_MSG_IDを受け入れます
`jca.mq.MQMD.Report.Generate.MsgId`	インバウンド/アウトバウンド。リプライまたはレポート・メッセージのMessageIdを生成するためのスキーム。NEW_MSG_ID、PASS_MSG_IDを受け入れます
`jca.mq.MQMD.Report.Generate.COA`	インバウンド/アウトバウンド。COAレポートの内容を指定します。WITH_NO_DATA、WITH_PARTIAL_DATA、WITH_FULL_DATAを受け入れます
`jca.mq.MQMD.Report.Generate.COD`	インバウンド/アウトバウンド。CODレポートの内容を指定します。WITH_NO_DATA、WITH_PARTIAL_DATA、WITH_FULL_DATAを受け入れます
`jca.mq.MQMD.Report.Generate.Exception`	インバウンド/アウトバウンド。例外レポートの内容を指定します。WITH_NO_DATA、WITH_PARTIAL_DATA、WITH_FULL_DATAを受け入れます
`jca.mq.MQMD.Report.Generate.Expiry`	インバウンド/アウトバウンド。有効期限レポートの内容を指定します。WITH_NO_DATA、WITH_PARTIAL_DATA、WITH_FULL_DATAを受け入れます
`jca.mq.MQMD.Report.Generate.NAN`	インバウンド/アウトバウンド。着信/発信メッセージがNANかどうかを指定します。true、falseを受け入れます
`jca.mq.MQMD.Report.Generate.PAN`	インバウンド/アウトバウンド。着信/発信メッセージがPANかどうかを指定します。true、falseを受け入れます
`jca.mq.MQMD.Report.TakeAction.OnMsgDeliveryFailure`	インバウンド/アウトバウンド。
`jca.mq.MQMD.Report.TakeAction.OnMsgDeliveryFailure`	DISCARD、DEADLETTERQUEUEを受け入れます
`jca.mq.MQMD.StrucId`	インバウンド/アウトバウンド。MQMDの構造体ID。任意の文字列を受け入れます
`jca.mq.MQMD.UserIdentifier`	インバウンド/アウトバウンド。このメッセージの発信元のユーザー。任意の文字列を受け入れます。
`jca.mq.MQMD.Version`	インバウンド/アウトバウンド。MQMDのバージョン。VERSION_1、VERSION_2を受け入れます
`jca.mq.Inbound.MQMD.CorrelId`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージの相関識別子。16進数のエンコードされた文字列を受け入れます。
`jca.mq.Inbound.MQMD.MsgId`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのメッセージ識別子。16進数のエンコードされた文字列を受け入れます。
`jca.mq.Inbound.MQMD.MsgType`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのメッセージ・タイプ。任意の文字列を受け入れます。
`jca.mq.Inbound.MQMD.Nan`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのNANレポート・オプション。true、falseを受け入れます
`jca.mq.Inbound.MQMD.Pan`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのPANレポート・オプション。true、falseを受け入れます
`jca.mq.Inbound.MQMD.ReplyToQMgr`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのReplyToQueueManager。任意の文字列を受け入れます。
`jca.mq.Inbound.MQMD.ReplyToQ`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのReplyToQueue。任意の文字列を受け入れます。
`jca.mq.Inbound.MQMD.Report.Generate.CorrelId`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのCorrelationId生成用の相関スキーム。PASS_CORREL_ID、COPY_MSG_IDを受け入れます
`jca.mq.Inbound.MQMD.Report.Generate.MsgId`	アウトバウンド。非同期リクエスト-リプライ・シナリオで取得されたメッセージのMessageId生成用の相関スキーム。NEW_MSG_ID、PASS_MSG_IDを受け入れます
`jca.mq.ISpec.EnqueueMsgToQMgr`	アウトバウンド。アウトバウンド・キューのキュー・マネージャ。任意の文字列を受け入れます
`jca.mq.ISpec.EnqueueMsgToQ`	アウトバウンド。アウトバウンド・キューのキュー名。任意の文字列を受け入れます。

表A-18 Oracle MQ Seriesアダプタの接続プロパティ

プロパティ	説明
`HostNam`	ホスト・コンピュータの名前。
`PortNumber`	使用するポート番号。
`ChannelName`	このプロパティには、使用するサーバー接続チャネルを設定します。
`QueueManagerName`	有効なキュー・マネージャ名。
`CipherSuite`	`CipherSuite`は、`SVRCONN`チャネルで設定されている`CipherSpec`と一致する名前に設定します。NULL(デフォルト)に設定すると、SSL暗号化は実行されません。
ClientEncoding	クライアントで使用するキャラクタ・エンコーディング。
`ConnectionFactoryLocation`	コネクション・ファクトリの場所。
`HostOSType`	ホスト・コンピュータで使用されるオペレーティング・システム。
`KeyStoreAlgorithm`	キーストアで使用されるアルゴリズム。
`KeyStoreLocation`	この値は、Oracle MQ Seriesアダプタが秘密鍵を格納するキーストアです。これは、アダプタがMQ Seriesサーバーから認証を受ける場合に必要になります。
`KeyStorePassword`	この値は、キーストアへのアクセスに必要なパスワードです。
`KeyStoreProviderName`	キーストア・プロバイダの名前。
`TrustStoreLocation`	これは、アダプタが信頼できる証明書情報を格納する場所です。この情報は、アダプタがMQ Seriesサーバーから認証を受ける場合に必要になります。
`TrustStorePassword`	このプロパティは、トラスト・ストアの場所のパスワードを指定します。
`KeyStoreType`	このプロパティは、キーストアのタイプを指定します。
`Protocol`	キー管理のアルゴリズム。
`SSLPeerName`	識別名パターン。`CipherSuite`が設定されている場合、この変数を使用することによって、常に正しいキュー・マネージャが使用されるようにできます。NULL(デフォルト)に設定すると、キュー・マネージャの識別名はチェックされません。`sslCipherSuite`がNULLの場合は、この変数は無視されます。
`SSLEnable`	このプロパティのtrueまたはfalse値は、Oracle MQ SeriesアダプタでのSSL有効化またはSSL無効化を示します。
`UserID`	このプロパティは、資格証明マッピングが設定されていない場合に使用されます。
`Password`	キュー・マネージャに接続するためのパスワードです。このプロパティは、資格証明マッピングが設定されていない場合に使用されます。
`XATransaction`	このプロパティは、XAトランザクションを有効化または無効化するために使用します。`true`に設定すると、XAトランザクションは有効になります。
`ReceiveExit`	これは、特定のキューでメッセージを受信するとトリガーされる`Receive Exit` Javaクラスです。
SecurityExit	これは、キュー・マネージャへの接続が試行されたときに発生するセキュリティ・フローをカスタマイズできる`Security Exit` Javaクラスです。
`SendExit`	これは、特定のキューへメッセージを送信するとトリガーされる`Send Exit` Javaクラスです。
`CCDTurl`	この値は、クライアント接続の詳細を指定するためにMQ Seriesアダプタで使用する必要があるCCDTファイルへのパスです。
`KeyStoreName`	指定のストライプの下のキーストアの名前。KeyStoreTypeをkssに設定する場合に使用します。
`StripeNameForKeyStore`	キーストアが作成されるストライプの名前。KeyStoreTypeを`kss`に設定する場合に使用します。
`StripeNameForTrustStore`	トラスト・ストアが作成されるストライプの名前。TrustStoreTypeを`kss`に設定する場合に使用します。
`TrustStoreAlgorithm`	トラスト・ストアで使用されるアルゴリズム。
`TrustStoreName`	指定のストライプの下のトラスト・ストアの名前。TrustStoreTypeをkssに設定する場合に使用します。
`TrustStoreProviderName`	トラスト・ストア・プロバイダの名前。
`TrustStoreType`	このプロパティは、トラスト・ストアのタイプを指定します。

表A-19 Oracle MQ Seriesアダプタのバインディング・プロパティ

プロパティ	説明
`adapter.mq.inbound.queueName`	このプロパティは、インバウンドMQキューのキュー・マネージャを指定するために使用します。
`adapter.mq.inbound.binaryNulls`	このプロパティは、バイナリ0(ゼロ)値によるメッセージのデキューに使用します。このプロパティのデフォルト値は`true`です。

A.7 LDAPアダプタのプロパティ

ここでは、LDAPアダプタに適用可能なプロパティを概観します。

表A-20 LDAPアダプタの接続プロパティ

プロパティ	指定できる値	説明
`HostName`	ホスト・マシンの名前またはIPアドレス。	LDAPサーバーをホストするマシン。
`BindDN`	`Cn=admin`
`InboundDataSource`	RCUスキーマがインストールされているJDBCデータソースのJNDI。このデータ・ストアは、最後の変更番号を永続化するために使用されます。このプロパティ値は、最新の増分同期シナリオに役立ちます。(LDAPアダプタをインバウンド方向で使用する必要がある場合に必要です)。	有効なXAデータソースを指すJNDI文字列の場所。
OperationTimeout		操作のタイムアウトを設定します。レスポンスがタイムアウト期間にディレクトリ・サーバーで受信されない場合、操作は中止され、例外が発生します。
`Password`	機密	不要
`SecurityProvider`
`SSLContextProtocol`		キー管理のプロトコル(不要)。
`TrustAll`	False	指定した場合、クライアントはサーバーが付与する証明書を盲目的に信頼します。useSSLまたはstartTLSを選択する場合にのみ必要です。
`TrustStoreProviderName`		JSSEプロバイダの名前。
P	整数値	LDAPサービスがホストで実行されているポート。
`UseSSL`	True/False(デフォルト値はfalse)。	LDAPアダプタがSSLを使用してディレクトリ・サーバーとの通信を保護していることを示します。SSLモードでリスニングするようにサーバーを構成する必要があり、ポート引数の値はサーバーがSSLベース接続をリスニングする場合の値である必要があります。
`UseStartTLS`	True/False(デフォルト値はfalse)。useSSLがtrueの場合は、falseにする必要があります。	Start TLS拡張操作を使用して、暗号化されていないチャネルでのディレクトリ・サーバーとの通信を保護します。この場合のポートは、クリアテキストのLDAP接続をリスニングします。
`TrustAll`	True/false(デフォルト値はfalse)。	指定した場合、クライアントはサーバーが付与する証明書を盲目的に信頼します。このオプションを選択すると、TrustStorePathは冗長なため無視されます。
`TrustStorePath`	useSSLまたはuseStartTLSのいずれかをtrueに設定する場合に、指定する必要があります。	クライアントがサーバー認証に使用するJKSトラスト・ストア・ファイルへのパスを指定します。
`TrustStorePassword`		トラスト・ストアのコンテンツにアクセスするために必要なパスワードを指定します。通常、トラスト・ストア・パスワードは必要ありません。これはトラスト・ストア・パスワード・ファイルのオプションと一緒には使用できません。
`Protocol`		ディレクトリ・サーバーとのセキュアな接続のためにプロトコル・バージョンを有効に設定します。プロトコルは、SSLコンテキストでサポートされる必要があります。
`EnableCipherSuites`	文字列。サーバーのJVMによって提供されるSSL暗号スイートのデフォルト・セットを使用します。JSSEプロバイダによって許可されるカンマ区切りの暗号スイートのリスト。	SSLまたはStartTLS通信で使用できるSSL暗号スイートの名前を指定します。

次の表に、LDAPアダプタのバインディング・プロパティを示します。JCAプロパティの一部は複数の操作に適用可能です。たとえば、TimeLimitはEntryChangeNotification、ChangelogNotificationまたは検索操作で使用できます。ただし、同じプロパティは、これらの操作で同じ意味になります。

表A-21 LDAPアダプタのバインディング・プロパティ(すべてのアダプタで共通)

プロパティ名	指定できる値	説明
Jca.retry.count		拒否までの最大再試行回数を示します。
Jca.retry.interval	秒単位	再試行の時間間隔を示します。
Jca.retry.backoff	正の整数	再試行間隔の増分ファクタを示します。
Jca.retry.maxInterval		再試行間隔の最大値を示します。
Jca.retry.maxPeriod		すべての再試行の累計期間の上限(ハード・リミット)です。
Jca.retry.count		拒否までの最大再試行回数を示します。
Jca.retry.interval	秒単位	再試行の時間間隔を示します。
Jca.retry.backoff	正の整数	再試行間隔の増分ファクタを示します。
Jca.retry.maxInterval		再試行間隔の最大値を示します。
Jca.retry.count		拒否までの最大再試行回数を示します。

表A-22 エントリ変更通知に対するLDAPアダプタのJCAアーティファクト

プロパティ名	指定できる値	説明
BaseDN	イベントをレポートする有効なDN。	このエントリのイベントを通知します。
EventScope	次の値で制限される文字列: {"baseObject"、"singleLevel"、"subordinates"、"wholeSubtree"}	構成済ベースDNのイベント・ソースのスコープ。
EventType	不明なマクロの値: {"add"、"modify"、"all"}	{"add"、"modify"、"all"} すべて選択すると、すべてのイベントがパブリッシュされます。
SearchFilter	LDAPフィルタの有効な文字列表現。	拡張フィルタ条件。特定のフィルタ条件を満たすイベントのみがアダプタによってパブリッシュされます。
ReturnAttributes	イベントの一部として戻されるすべての属性のcsvリスト。	-
ReturnAttributesDelimiter	文字列	デフォルトのデリミタ「,」が適切でない場合、属性デリミタを明示的に定義できます。
TypesOnly	trueまたはfalse(デフォルト値はfalse)。	trueに設定すると、属性名のみが戻されます。それ以外の場合は、属性名と値の両方が戻されます。
SizeLimit	正の整数。デフォルト値は1000。<= 0はsizeLimitが適用されないことを意味します。	検索操作の一部として戻されるエントリの最大数。DS側でも構成できます。2つの値のうち低い値が有効になります。SizeLimitは単一のページ内で施行されます。
PageSize	pageSizeを指定する整数値。`sizeLimit`はページ内のサイズを示し、検索時にすべてのページで戻されるエントリの合計数とは関係ありません。デフォルト値は-1で、無制限のpageSizeを意味します。	1ページに公開されるイベントの最大数。
TimeLimit	整数値(秒数) (デフォルト値は10秒)。	結果を戻すまでにサーバーが待機する最大時間。
NotificationStrategy	文字列値(TimeStampBasedのいずれか)。	永続検索オプションは、最初のリリースでは非推奨です。
PollingInterval	整数値(デフォルト値は10秒)。	新しいイベントの次の検索を実行するまでのポーリング間隔。

表A-23 変更ログ通知に対するLDAPアダプタのJCAアーティファクト

プロパティ名	指定できる値	説明
PollingInterval	整数値(デフォルト値は10秒)。	新しいイベントの次の検索を実行するまでのポーリング間隔。
EventType	不明なマクロの値: 不明なマクロ: {"add"、"delete"、"modify"、"moddn"、"all"} eventTypeの値は、ディレクトリ・サーバーの実装によって変わります。たとえば、OIDの場合、moddnはmodrdnになることがあります。	すべてを選択すると、すべてのイベントがパブリッシュされます。それ以外の場合は、パブリッシュするイベント・タイプのカンマ区切りリストが送信されます。たとえば、add,deleteです。
NotificationStrategy	不明なマクロの文字列値: {"OJD"、"OID"またはユーザー定義のchangelog実装の完全修飾名}	不明なマクロ: {"OJD"、"OID"またはユーザー定義のchangelog実装の完全修飾名} Oracle.tip.adapter.ldap.inbound.<customStrategy Impl>。
TimeLimit	整数値(秒数) (デフォルト値は0で時間無制限)。	結果を戻すまでにサーバーが待機する最大時間。
SizeLimit	整数値で、デフォルト値は1000です。	1つのトリップでパブリッシュされるイベントの最大数。
PageSize	pageSizeを指定する整数値。sizeLimitはページ内を示し、検索時にすべてのページで戻されるエントリの合計数とは関係ありません。	-

表A-24 検索操作に対するLDAPアダプタのJCAアーティファクト

プロパティ名	指定できる値	説明
SearchScope	次の値で制限される文字列。{"baseObject"、"singleLevel"、"subordinates"、"wholeSubtree"}: SubordinatesはLDAP仕様の一部ではなく、選択したDSによってのみサポートされます。このオプションを使用する前に、DSサーバーを確認してください。	検索スコープを定義します。これは、悪質な検索リクエストによるサーバー・リソースの操作を制御するために、サービスのデプロイ時に定義する必要があります。
AliasDereferencing	次の値で制限される文字列。不明なマクロ: {"never"、"search"、"find"、"always"}	検索の処理中に別名エントリを処理する動作。
FollowReferrals	次の値で制限される文字列。不明なマクロ: {"ignore"、"throwException"、"follow"} LDAPアダプタは、従うか例外をスローするよう明示的に指定された場合を除き、デフォルトではすべてのリフェラル候補を無視します。	追加エントリを検索リクエストの一部として検索/照合できる代替場所。
HopLimit	正の整数。デフォルト値は1です。	検索リフェラルに参加する代替場所の数。
SizeLimit	整数値(デフォルト値は1000)。	検索操作の一部として戻されるエントリの最大数。DS側でも構成できます。2つの値のうち低い値が有効になります。
TimeLimit	整数値(秒数) (デフォルト値は0で時間無制限)。	結果を戻すまでにサーバーが待機する最大時間(秒)。
TypesOnly	trueまたはfalse(デフォルト値はfalse)。	trueに設定すると、属性名のみが戻されます。それ以外の場合は、属性名と値の両方が戻されます。
ReturnAttributes	文字列値、この検索レスポンスの一部として戻される必要があるすべての属性の区切りリスト。	デフォルトのデリミタは「,」です。名前属性のみが検索レスポンスの一部として含まれます。
ReturnAttributesDelimiter	文字列	デフォルトのデリミタ「,」が適切でない場合、属性デリミタを明示的に定義できます。

表A-25 LDAPアダプタのDSML JCAアーティファクト

プロパティ名	指定できる値	説明
MaxDSMLRequestSize	整数値(デフォルト値は0で無制限)。	DSMLには、バッチ・リクエストが含まれています。このバッチ・リクエストには、何百万のLDAP操作リクエストが含まれている可能性があります。このプロパティを使用して、単一のDSMLバッチ・リクエストを介してLDAPアダプタに渡すことができる許容される操作リクエストの最大数を制御します。

表A-26 LDAPアダプタの削除操作のJCAアーティファクト

プロパティ	指定できる値	説明
RequestControls	文字列	操作とともに1つまたは複数のコントロールに渡します。
SuppressEntryDoesNotExist	True\|false	削除するエントリがターゲットDSに存在しない場合、削除操作は失敗します。相互作用の仕様でこの条件を指定すると、例外を抑止できます。

表A-27 LDAPアダプタの追加操作のJCAアーティファクト

プロパティ	指定できる値	説明
SuppressEntryAlreadyExists	True\|false	追加するエントリがターゲットDSにすでに存在する場合、追加操作は失敗します。相互作用の仕様でこのプロパティを指定すると、例外を抑止できます。
objectClass	CSV文字列	ターゲット・ディレクトリ・サーバーで追加するエントリの構造を構成するすべてのobjectClassのカンマ区切りリスト。

表A-28 LDAPアダプタの変更操作のJCAアーティファクト

プロパティ	指定できる値	説明
RequestControls	文字列	操作とともに1つまたは複数のコントロールに渡します。

表A-29 LDAPアダプタのDNの変更操作のJCAアーティファクト

プロパティ	指定できる値	説明
RequestControls	文字列	操作とともに1つまたは複数のコントロールに渡します。
DeleteOldRDN	trueまたはfalse(デフォルト値はfalse)	-

A.8 コヒーレンス・アダプタのプロパティ

ここでは、コヒーレンス・アダプタに適用可能なプロパティを概観します。

次の表に、コヒーレンス・アダプタのJCAプロパティを示します。

表A-30 コヒーレンス・アダプタのJCAプロパティ

プロパティ	説明	デフォルト値
CacheName	特定の操作に使用する特定のCoherenceキャッシュを識別します。コヒーレンス・アダプタ操作の`CacheName`エントリで指定されたキャッシュが存在しない場合、再試行不可エラーが発生します。	なし
Key	キャッシュ・エントリの識別子。	なし
KeyType	キーとして使用する値のJavaタイプを識別します(現在はjava.langパッケージの単純型)。	なし
ValueType	キャッシュに格納するオブジェクトまたはキャッシュから取得するオブジェクトを識別する完全修飾クラス名。XMLをキャッシュに格納するよう指示する場合、ValueTypeプロパティを指定する必要はありません。指定しない場合、コヒーレンス・アダプタはペイロードをバイナリXML表現に変換し、キャッシュに格納するか、キャッシュから取得します。	なし
Filter	操作を適用する必要があるキャッシュのサブセットを指定するために使用します。フィルタ式はCohQLに基づいており、バインド変数の使用をサポートします。	なし
PageSize	問合せ操作を実行したときに返される項目の数を指定します。リモート・キャッシュに関連するキャッシュ操作にのみ適用可能です。	なし
TimeToLive	キャッシュ・エントリが期限切れになるまでのミリ秒。非トランザクション・キャッシュに関連するキャッシュ操作にのみ適用可能です。	`EXPIRY_NEVER`
IndexName	キャッシュに追加する索引の名前。Book (author.firstName、author.LastName、price)オブジェクトを格納するキャッシュのprice属性に索引を作成するには、`IndexName`の値を`price`に設定する必要があります。firstName属性の索引の場合、`IndexName`を`author.firstName`に設定する必要があります。	なし
Ordered	索引を作成した情報の内容を並べ替えるかどうかを指定するブール。	False
MappingsMetadataFile	POJOからXMLへの変換で役立つメタデータ・マッピング・ファイルの名前を示します。XMLからPOJOへの変換も同様です。	なし
CacheOperation	CacheNameで識別されたキャッシュで実行される操作。CacheOperationでサポートされる値はget、put、queryおよびremoveです。	なし
ReturnCacheKeysOnly	問合せ操作を実行したときに、キャッシュ識別子(キー)のみを返すことができるブール。	False

次の表に、コヒーレンス・アダプタの正規化されたプロパティを示します。

表A-31 コヒーレンス・アダプタの正規化されたプロパティ

プロパティ	説明
jca.coherence.CacheName	Coherence操作に使用するキャッシュの名前。これにより、CoherenceInteractionSpecのCacheNameがオーバーライドされます。
jca.coherence.Key	キャッシュ・エントリを識別します。これにより、CoherenceInteractionSpecのKeyがオーバーライドされます。
jca.coherence.Filter	Coherence操作を実行するときに使用するフィルタを指定します。これにより、CoherenceInteractionSpecのFilterがオーバーライドされます。

次の表に、コヒーレンス・アダプタのコネクション・ファクトリ・プロパティを示します。

表A-32 コヒーレンス・アダプタのコネクション・ファクトリ・プロパティ

名前	説明	値
`ConnectionFactoryLocation`	coherence-transaction.rarが提供するコネクション・ファクトリのJNDI名を指定します。	`tangosol.coherenceTx`
`ServiceName`	接続に関連付けられているキャッシュ・サービスの名前。ServiceNameはTransactionalCachesにのみ必要です。非トランザクション/拡張には不要です。	XATransactionalCache (XA) TransactionalCache (ローカル・キャッシュ) リモート・キャッシュの場合は空白のまま
`CacheConfigLocation`	キャッシュおよび拡張クライアントの設定を定義するキャッシュ構成ファイルの場所。	-
`ClassLoaderMode`	キャッシュ操作に使用するクラス・ローダーが、コンポジットにバンドルされているドメイン・クラスに基づいているのか、JCA管理コネクション・ファクトリのPojoJarFileプロパティに基づいているのかを指定します。値はCUSTOMまたはCOMPONENTです。 CUSTOMの場合、アソシエーションはPojoJarFileプロパティに基づきます。COMPONENTの場合、コンポジットにバンドルされているドメイン・クラスに基づきます。 CUSTOMは、コンポジットの境界を越えて、または異なるOSBプロセスから、同じキャッシュを使用する必要がある場合に使用します。COMPONENTは、すべてのキャッシュ操作が同じコンポジットまたはOSBプロセスに組み込まれている場合に使用します。	CUSTOM
`WLSExtendProxy`	拡張プロキシがスタンドアロンかWLSサーバーの一部として動作するのかを指定します。falseの場合はスタンドアロン拡張プロキシで、そうでない場合はスタンドアロン拡張プロキシではありません。リモートの場合にのみ適用できます。	`True`
`PojoJarFile`	キャッシュ操作に使用するドメイン・クラスの場所を指定します。	-

A.9 MSMQ JCAアダプタのプロパティ

ここでは、MSMQ JCAアダプタに適用可能なプロパティを概観します。

表A-33 MSMQアダプタのJCAプロパティ

プロパティ	説明	デフォルト値	必須
`DestinationType`	パブリック・キュー、プライベート・キューまたは配布リストの名前で識別したキューのグループにメッセージを送信するかどうかを示します。値は次のとおりです。 `PUBLIC_QUEUE` `PRIVATE_QUEUE` `DISTRIBUTION_LIST`	なし	はい
`DestinationName`	MSMQキューの名前。	なし	はい(UseActiveDirectoryPathがFalseの場合)
`DestinationPath`	ActiveDirectoryで表されるDistributionListキューまたはPublicキューを識別する文字列。文字列の例を次に示します。 LDAP://MyLDAPServer/CN=MyQueue,CN=msmq,CN=MyComputer,CN=Computers,DC=MyDomain,DC=MyCompany,DC=COM	なし	はい(UseActiveDirectoryPathがTrueの場合)
`UseActiveDirectoryPath`	パブリック・キューの識別に、キュー名ではなくActive Directoryパスを使用することを許可するブール。このプロパティは、DestinationTypeが`DISTRIBUTION_LIST`または`PUBLIC_QUEUE`である場合に適用可能です	False	アウトバウンド(エンキュー)操作にのみ適用可能です。このプロパティは、インバウンド(デキュー)には適用できません。デキューは、配布リストではサポートされていません。
`UseDirectFormatName`	パブリックおよびプライベートのキューに直接フォーマット名を使用することを許可するブール。	False	-
`Priority`	優先度は7から0までの任意の整数値に設定できます(デフォルトは3)。7は高い優先度を意味します。0は最も低い優先度を意味します。最高優先度は、処理がより高速であることを意味します。アウトバウンド・エンキューにのみ適用可能です。	3	-
`TimeToLive`	このプロパティは、ターゲット・キューからメッセージを取得する時間制限(秒)を指定します。値は、指定したMSMQメッセージの`MaxTimeToReceive`プロパティに割り当てられます。インバウンドおよびアウトバウンド・キューに適用可能です。	-1 (無限)。メッセージが期限切れにならないことを意味します。	-
`Delivery`	このプロパティは、式(非永続)またはリカバリ可能なメッセージング(永続)の指定に使用します。高速メッセージングでは、スループットが高速になります。リカバリ可能なメッセージングにより、メッセージがキューに送信される途中でコンピュータがクラッシュしてもメッセージが配信されることが保証されます。値はPersistent、Non-Persistentで、アウトバウンド・エンキューにのみ適用可能です。	Persistent	-
`OperationType`	実行する操作。サポートされるOperationTypeの値は、`enqueue`および`dequeue`です。	なし	はい
`BodyType`	値は、`String` (デフォルト)および`ByteArray`です。不透明(スキーマ)処理オプションが選択されている場合は、ByteArrayのBodyType値を意味します。	文字列	はい
`EnableStreaming`	ペイロードのストリームを可能にするブール。インバウンド・デキュー・プロセスにのみ適用可能です。	False	-

次の表に、MSMQアダプタの正規化されたプロパティを示します。

表A-34 MSMQアダプタの正規化されたプロパティ

プロパティ名	説明	方向
`jca.msmq.message.SentTime`	このプロパティは、メッセージが送信されたときを示します。	インバウンド
`jca.msmq.message.Priority`	このプロパティは、メッセージの優先度を指定します。これにより、MSMQInteractionSpecの`Priority`がオーバーライドされます。	インバウンド/アウトバウンド
`jca.msmq.message.TimeToLive`	このプロパティは、ターゲット・キューからメッセージを取得する時間制限(秒)を指定します。これにより、MSMQInteractionSpecの`TimeToLive`がオーバーライドされます。	インバウンド/アウトバウンド
`jca.msmq.message.MaxTimeToReachQueue`	このプロパティは、メッセージがキューに到達する時間制限(秒)を指定します。ここで何も指定しない場合、メッセージ・キューイングでは、キューへの到達時間間隔に企業全体の設定が使用されます。	インバウンド/アウトバウンド
`jca.msmq.message.Id`	MSMQにより生成されたメッセージ識別子を使用して、メッセージを識別します。	インバウンド
`jca.msmq.message.Delivery`	値は`Persistent`または`Non` `Persistent`になります。このプロパティは、メッセージ・キューイングがメッセージを配信する方法を指定します。このプロパティにより、MSMQInteractionSpecの`Delivery`がオーバーライドされます。	インバウンド/アウトバウンド
`jca.msmq.message.BodyLength`	このプロパティは、メッセージ本文の長さ(バイト)を指定します。	インバウンド
`jca.msmq.message.ArrivedTime`	このプロパティは、メッセージがキューに到達したときを示します。	インバウンド

次の表に、MSMQアダプタのバインディング・プロパティを示します。

表A-35 MSMQアダプタのバインディング・プロパティ

プロパティ名説明

プロパティ名	説明
`adapter.msmq.receive.timeout`	次のポーリング・サイクルを開始する前にメッセージ・キューイングがメッセージの到着を待機する時間(ミリ秒)。デフォルト値は1秒(1)です。
`adapter.msmq.dequeue.threads`	エンドポイント・アクティブ化が発生するときに初期化されるポーラー・スレッドの数。指定する場合、`adapter.msmq.dequeue.threads`の値を使用して、複数のインバウンド・ポーラー・スレッドを生成します。パフォーマンスを向上させるために、複数のインバウンド・スレッドを使用できます。デフォルト値は1です。

adapter.msmq.receive.timeout

次のポーリング・サイクルを開始する前にメッセージ・キューイングがメッセージの到着を待機する時間(ミリ秒)。デフォルト値は1秒(1)です。

adapter.msmq.dequeue.threads

エンドポイント・アクティブ化が発生するときに初期化されるポーラー・スレッドの数。指定する場合、adapter.msmq.dequeue.threadsの値を使用して、複数のインバウンド・ポーラー・スレッドを生成します。パフォーマンスを向上させるために、複数のインバウンド・スレッドを使用できます。デフォルト値は1です。

次の表に、MSMQアダプタのコネクション・ファクトリ・プロパティを示します。

表A-36 MSMQアダプタのコネクション・ファクトリ・プロパティ

プロパティ名	説明	デフォルト
`Host`	MSMQホストのIPアドレス。	この値はホスト名で、ホスト・プロパティの値としてIPアドレスを指定できます。
`AccessMode`	接続ファクトリがネイティブ・アクセスを許可するかどうかを識別します。値は[`Native` \| `DCOM`]です。Nativeの場合、Oracle WebLogic ServerはMSMQと同じホストにインストールされている必要があります。	DCOM
`TransactionMode`	メッセージを送信および受信する場合に接続がトランザクションに参加するかどうかを示します。値は[Single\|None]です。Singleの場合、メッセージの送信先となるローカルおよびリモートのMSMQキューはトランザクションである必要があります。Singleの場合、メッセージを取得するローカルのMSMQキューはTransactionalである必要があります。Noneで、メッセージ送信先のキューがトランザクションの場合は、ResourceExceptionが発生します。	`None`
User	ユーザーを識別します	-
Password	指定したユーザーのパスワード。	-
`Domain`	MSMQホストのドメイン。	-

A.10 UMS JCAアダプタのプロパティ

ここでは、UMSアダプタに適用可能なプロパティを概観します。

次の表に、UMSアダプタのアクティブ化仕様プロパティを示します。

表A-37 UMSアダプタのアクティブ化仕様プロパティ

プロパティ名	説明
`JavaCalloutImpl`	メッセージ・フィルタまたはその他のチェックにカスタム・ロジックを定義するJavaクラス名。このクラスは、ICustomCalloutインタフェースの具体的な実装です。
`Name-InboundThreadCount`	インバウンド・ポーラーまたはリスナー・スレッドの数を指定します。
`ConsumeMode`	アダプタによってUMSからメッセージを受信する方法を指定します。ポーリング・モードではポーラーに設定され、リスナー・モードではリスナーに設定されます。
`To`	受信メッセージの受信元となるアドレス。電子メール配信タイプにおける1つまたは複数のカンマ区切り電子メール・アドレスです。
`DeliveryType`	送信メッセージの受信および送信用に電子メール・サポートを提供します。
`PollingInterval`	ポーラー・コンシューム・モードでのポーリング間隔(秒)です。
`MessageFilters`	1つまたは複数のメッセージ・フィルタが指定されます。単一フィルタの場合は、フィールド・タイプおよび取得されるアクション(同意または拒否)に対して受信メッセージを適合させるため、Javaのパターン文字列で構成されます。

次の表では、UMSアダプタの相互作用仕様プロパティについて説明します。

表A-38 UMSアダプタの相互作用仕様プロパティ

プロパティ名	説明
`DeliveryType`	送信メッセージの受信および送信のみに対する電子メール・サポート。
`Subject`	送信メッセージの件名。
`From`	送信メッセージの送信者アドレス。
`To`	1つまたは複数の受信者アドレス。
`Replyto`	返信先アドレス
`Cc`	電子メール配信の1つまたは複数のCCアドレス。
`Bcc`	電子メール配信の1つまたは複数のBccアドレス。
`SendEmailAsAttachment`	添付ファイルとして電子メールを送信するには`True`にします。

次の表では、UMSアダプタのメッセージ・ヘッダーについて説明します。

表A-39 UMSアダプタのメッセージ・ヘッダー

ヘッダー・フィールド名	最小発生数	最大発生数	マップされたアダプタのヘッダー・フィールド名
`Return-path`	0	1	`jca.ums.return-path`
`Received`	0	無制限	`jca.ums.received`
`Resent-Date`	0	無制限	`jca.ums.resent-date`
`Resent-From`	0	無制限	`jca.ums.resent-from`
`Resent-Sender`	0	1	`jca.ums.resent-sender`
`Resent-To`	0	無制限	`jca.ums.resent-to`
`Resent-Cc`	0	無制限	`jca.ums.resent-cc`
`Resent-Bcc`	0	無制限	`jca.ums.resent-bcc`
`Resent-Message-ID`	0	無制限	`jca.ums.resent-message-id`
`Date`	1	1	`jca.ums.date`
`From`	1	1	`jca.ums.from` (SMSおよびIMにも適用)
`Sender`	0	1	`jca.ums.sender`
`Reply-to`	0	1	`jca.ums.reply-to`
`To`	0	1	`jca.ums.to` (SMSおよびIMチャネルに適用可能)
Cc	0	1	`jca.ums.cc`
Bcc	0	1	`jca.ums.bcc`
`Message-ID`	0	1	`jca.ums.message-id`
`In-Reply-To`	0	1	`jca.ums.in-reply-to`
`References`	0	1	`jca.ums.references`
`Subject`	0	1	`jca.ums.subject` (SMSチャネルに適用可能)
`Comments`	0	無制限	`jca.ums.comments`
`Keywords`	0	無制限	`jca.ums.keywords`

次の表では、UMSアダプタのMIMEパート・メッセージ・ヘッダーについて説明します。

表A-40 UMSアダプタのMIMEパート・メッセージ・ヘッダー

ヘッダー・フィールド名	マップされたアダプタのヘッダー・フィールド名	ノート
Content-Type	`jca.ums.msg.content-type`	すべてのチャネルに適用可能です。SMSおよびIMの場合、現在サポートされているタイプは`text/plain`のみです。ボイスの場合は`text/vxml`、`text/x-vxml`です。
Content-Transfer-Encoding	`jca.ums.msg.content- transfer-encoding`	-
Content-ID	`jca.ums.msg.content-id`	-
Content-Description	`jca.ums.msg.content- description`	-
Content-Disposition	`jca.ums.msg.content- disposition`	-
Content-Language	`jca.ums.msg.content-language`	-
Mime-Extension-field	`jca.ums.mime-extension-headers`	その他のMIMEヘッダー・フィールドは、文字列のContent-で開始されます。次のように2つ以上のヘッダーを追加できます。`Content-* : value CRLF Content*- : value` `CRLF - \r\n`
MIME-Version	`jca.ums.mime-version`	-

次の表では、UMSアダプタ固有のヘッダーについて説明します。

表A-41 UMSアダプタ固有のヘッダー

ヘッダー名説明

ヘッダー名	説明
`jca.ums.msg.proprietary-headers`	2つ以上の固有のヘッダーを次の書式で追加できます。 Header Name : value CRLF Header Name : value (ヘッダー名は、ums.adapter.xxxxxのCRLF - \r\nに類似させる必要があります。)

jca.ums.msg.proprietary-headers

2つ以上の固有のヘッダーを次の書式で追加できます。

Header Name : value CRLF Header Name : value

(ヘッダー名は、ums.adapter.xxxxxのCRLF - \r\nに類似させる必要があります。)

A.11 Oracle JCAアダプタの汎用プロパティ

ここでは、すべての Oracle JCAアダプタに適用可能なプロパティを概観します。

表A-42

それぞれのOracle JCAアダプタに固有のプロパティについては、次を参照してください。

表A-42 すべてのOracle JCAアダプタのJCAプロパティ

プロパティ説明

プロパティ	説明
`WsdlLocation`	タイプが`xs:string`のオプションの`adapter-config`属性。アダプタのJCAファイルに関連付けられたWSDLの名前に設定した場合は、JCAファイルおよび関連するWSDLとスキーマのバルク・インポートを実行できるように、Oracle Service BusによってWSDLが自動的に解決されます。次の例は、`adapter-config`属性`wsdlLocation`が対応するWSDLファイル`FulFillmentBatch.wsdl`の名前に設定された`FulfillmentBatch_jms.jca`ファイルを示します。 <adapter-config name="FulfillmentBatch" adapter="Jms Adapter" xmlns="http://platform.integration.oracle/blocks/adapter/fw/metadata" wsdlLocation="FulfillmentBatch.wsdl" > ... </adapter-config>

WsdlLocation

タイプがxs:stringのオプションのadapter-config属性。

アダプタのJCAファイルに関連付けられたWSDLの名前に設定した場合は、JCAファイルおよび関連するWSDLとスキーマのバルク・インポートを実行できるように、Oracle Service BusによってWSDLが自動的に解決されます。

次の例は、adapter-config属性wsdlLocationが対応するWSDLファイルFulFillmentBatch.wsdlの名前に設定されたFulfillmentBatch_jms.jcaファイルを示します。

<adapter-config name="FulfillmentBatch" adapter="Jms Adapter" xmlns="http://platform.integration.oracle/blocks/adapter/fw/metadata" wsdlLocation="FulfillmentBatch.wsdl" >
...
</adapter-config>

A.12 Oracleアダプタの汎用バインディング・プロパティ

ここでは、すべての Oracle JCAアダプタに適用可能なバインディング・プロパティを概観します。

表A-43

それぞれのOracle JCAアダプタに固有のプロパティについては、次を参照してください。

表A-43 すべてのOracle JCAアダプタのバインディング・プロパティ

プロパティ	説明
`UseWorkManager`	デフォルトは`False`です。現在アダプタで使用しているデフォルト・ワーク・マネージャではなく、カスタム・ワーク・マネージャを指定します。バインディング・プロパティ`useWorkManager`を使用して、特定のWebLogic WorkManagerを使用するようにインバウンドJCAエンドポイント(SCAサービス・エンドポイント)を構成できます。JCAバインディングは、コンストラクタでワーク・マネージャを受け入れるSOAインフラストラクチャ・エグゼキュータにWorkManagerの名前を委任します。`useWorkManager`プロパティに入力する値は、name部分のみにする必要があります。残りは追加されます。たとえば、名前はfileReadのようになります。このJNDIルックアップが失敗すると、SOAエグゼキュータは、ワーク・マネージャを指定していない場合に通常使用される、デフォルトのSOAワーク・マネージャに戻ります。
`MinimumDelayBetweenMessages`	デフォルトは、`False`または遅延なしです。インバウンドのみです。このプロパティは、ミリ秒単位で構成されます。ダウンストリーム・コンポジット・アプリケーションにポストされている2つの連続したメッセージ間で少なくともMILLI_SECONDSの遅延が発生することを確認します。アダプタ・ポーリング・スレッドごとに`minimumDelayBetweenMessages`が有効であることに注意してください。複数のアダプタ・ポーリング・スレッドを構成している場合は、この設定により、各スレッドで処理されたメッセージ間の遅延のみを制御します。
`ActivationInstances`	各アダプタがネイティブでマルチ・スレッドをサポートしているため、非推奨です。ただし、このプロパティは依然として機能しており、特定のインバウンドJCAアクティブ化エージェントのインスタンスが生成される数を制御します。このプロパティを使用して同時実行性を向上できます。ActivationInstancesプロパティは、BPELコンソール(ディスクリプタ・ページ)を使用することで動的に更新可能で、アダプタ・フレームワークでさらにインスタンスを作成するか、既存インスタンスを即時停止します(停止する場合は、逆の順序で行います。つまり、最大のインスタンス番号を最初に停止します)。
`UseRejectedMessageRecovery`	trueに設定する場合、拒否されたメッセージをリカバリまたは中断できます。
`Singleton`	クラスタ化された高可用性環境では、このプロパティをtrueに設定すると1つの時点で1つのインスタンスのみが作成されます。
`EnableReports`	trueに設定すると、構成済インバウンド・アダプタのFusion Middleware Controlでアダプタ・レポートを生成できます。
`EnableSnapshots`	trueに設定すると、構成済インバウンド・アダプタのFusion Middleware Controlでスナップショット・レポートを生成できます。
`SnapshotInterval`	スナップショット・レポートの間隔。