トラブルシューティングおよび回避策

この付録の構成は、次のとおりです。

一般的な問題点と回避策

一般的な問題点と回避策

この項では、次の問題点と回避策について説明します。

PL/SQL APIを使用する場合のレコード・タイプに対するデフォルト値の移入

Oracle E-Business Suiteから公開された特定のPL/SQL APIは、入力としてレコード・タイプを取ります。このようなAPIは、正常に実行されるために、これらのレコード・タイプ内のパラメータにデフォルト値が移入されることを予期しています。

デフォルト値は、文字の場合はFND_API.G_MISS_CHAR、日付の場合はFND_API.G_MISS_DATE、および数値の場合はFND_API.G_MISS_NUMです。Oracle Adapter for Oracle Applicationsでは、次にしめすようにレコード・タイプ内のパラメータがnil値として渡される場合には、これらの値をデフォルト値に設定できます。
```
<PRICE_LIST_REC>
<ATTRIBUTE1 xsi:nil="true"/>
<ATTRIBUTE2 xsi:nil="true"/>
<ATTRIBUTE3 xsi:nil="true"/>
...
</PRICE_LIST_REC>
```
これは、transformアクティビティの機能を使用するか、nil値のXML入力を直接渡して、それらをassignアクティビティ内のレコード・タイプに割り当てることによって実現できます。
既存のPL/SQL SOAコンポジットを別のリリース・インスタンスに対して使用する場合のラッパー・パッケージの再作成

ユーザーがOracle E-Business Suiteリリース11iインスタンスに対して作成されたPL/SQL APIのSOAコンポジットを使用しており、このコンポジットをリリース12インスタンスに対して使用するか、またはその逆の場合、ターゲット・インスタンスの互換性を確保するために、SOAコンポジットのラッパー・パッケージを再作成する必要があります。この方法を使用すると、ターゲット・インスタンスに対して生成されたラッパーSQLファイル内のシグネチャが更新され、ターゲット・インスタンス内でシグネチャが同じであるか、または変更されているかに関する混乱が回避されます。
WSDLコンテキスト情報のデフォルト値

アプリケーション・コンテキストは、ビジネス・アクティビティに必要となったり、BPELプロセスを完了するのに必要となるヘッダー変数を渡すときに使用されます。コンテキストを設定する場合は、ヘッダー・プロパティ（「ユーザー名」、「職責」、「職責アプリケーション」、「セキュリティ・グループ」および「NLS言語」を含む）に渡される値が考慮されます。

新しいヘッダー・プロパティ「職責アプリケーション」、「セキュリティ・グループ」および「NLS言語」の値が渡されない場合、コンテキスト情報は「ユーザー名」と「職責」に基づいて判断されます。

デフォルトの「ユーザー名」はSYSADMIN、デフォルトの「職責」はSYSTEM ADMINISTRATOR、デフォルトの「セキュリティ・グループ・キー」は「標準」、およびデフォルトの「NLS言語」はUSです。

生成WSDLに指定されているデフォルト値は変更できます。これは、コンテキスト情報を静的に変更する方法です。これらの値は、デプロイ済のビジネス・プロセスのすべての起動に適用されます。ただし、ビジネス・プロセスの起動ごとに異なるコンテキスト情報を提供する必要がある場合は、ヘッダー値に動的に値を移入できます。コンテキスト情報はinvokeアクティビティを構成することにより指定できます。

アプリケーション・コンテキストの詳細は、「正規化されたメッセージ・プロパティのサポート」を参照してください。
XML GatewayトランザクションのBPELにデフォルト設定される相関ID

Oracle Adapter for Oracle Applicationsの「アダプタ構成ウィザード」は、インバウンドまたはアウトバウンド・インタフェースのXML Gatewayトランザクションの相関IDを指定しません。かわりに、BPELのデフォルト相関IDがWSDLファイルで自動的に設定されます。この構成を機能させるには、対応するXML GatewayトランザクションにBPELと同一の相関ID値を設定するようにOracle Applicationsを構成する必要があります。

Adapterでデフォルトと異なる相関IDを使用するには、Oracle Applicationsで相関IDを構成した後、アダプタ・サービスWSDLの<jca:operation>セクションに含まれるCorrelation="BPEL"行を編集する必要があります。「BPEL」を、Oracle Applicationsで指定した相関IDの文字列値に置き換えます。
複合型とDEFAULT句を使用するストアド・プロシージャの回避策

「アダプタ構成ウィザード」がラッパーSQLストアド・プロシージャを生成する必要があるストアド・プロシージャを使用する場合、生成されるラッパー・ストアド・プロシージャにDEFAULT句が引き継がれないという制限があります。

回避策として、特定のストアド・プロシージャに対して次の手順を1回のみ実行します。
1. 生成されたラッパーSQLスクリプトを開きます。
2. ベース・ストアド・プロシージャから対応するラッパーにすべてのDEFAULT句をコピーします。
3. SQL*Plusを使用して、ラッパーSQLスクリプトをデータベースにリロードします。
4. 生成されたXSDを編集します。パラメータがDEFAULT句を持つ場合は、XSD内の対応する要素に追加の属性db:default="true"が必要です。
  
  たとえば、次のようなSQLを使用します。
```
FINANCE$INVOICE(isTrue INTEGER DEFAULT 1, value NUMBER DEFAULT 0)
```
  XSD内のisTrueおよびvalueの要素には、新しい属性が必要です。
```
<element name="ISTRUE" ... db:default="true" .../>
<element name="VALUE" ... db:default="true" .../>
```
コンカレント・プログラムとE-Commerce Gatewayインタフェースの一時的な回避策

コンカレント・プログラムおよびE-Commerce Gatewayインタフェースを使用する場合、特定のE-Business Suiteインスタンスに対して次の回避策を1回のみ実行する必要があります。

注意: これは、「アダプタ構成ウィザード」が、カバーの下に生成されるPL/SQLラッパーのDEFAULT句を保持できないという既知の問題に対処するための方法です。

「アダプタ構成ウィザード」を起動してコンカレント・プログラムまたはE-Commerce Gatewayインタフェース用のサービスを作成する前に、次のSQLファイルをAPPSスキーマに（SQL*Plusを使用して）ロードする必要があります。
```
ORACLE_HOME\bpel\samples\tutorials\150.AppsAdapter\OrderImportConcurrentProgram\bpel\XX_BPEL_FND_REQUEST_SUBMIT_REQUEST.sql
```
基礎となるAPIが再作成された場合、パートナ・リンクを作成できない

同じ名前と別のパラメータのセットを使用して再作成されたAPIのラッパーを生成することはできません。

注意: これは、生成されたラッパーを必要とするパッケージ化プロシージャとトップレベルまたはルート・プロシージャの両方で発生する可能性があります。

次の例は、この問題を示しています。
1. トップレベルで定義される初期APIを作成します。
```
SQL> create procedure test (a number, b varchar2, c BOOLEAN)
```
  BOOLEANパラメータは、ラッパーが必要であることを示しています。
2. 「アダプタ構成ウィザード」でストアド・プロシージャのデータベース・アダプタを使用して、このAPIのラッパーを生成およびロードします。
3. APIをドロップし、別のパラメータのセットを使用してAPIを再作成します。
```
SQL> drop procedure test
SQL> create procedure test (a number, b varchar2, c number, d BOOLEAN)
```
4. 「アダプタ構成ウィザード」を使用してこのAPIのパートナ・リンクを生成しようとすると、次のメッセージが表示されて失敗します。
```
The wrapper procedure, TOPLEVEL$TEST, could not be found
```
5. 回避策として、JDeveloper BPEL Designerを終了し、ストアド・プロシージャを作成した後、2番目のパートナ・リンクを作成する前に、JDeveloper BPEL Designerを再起動します。