統合設計時間のトラブルシューティング

統合にプライマリ・ビジネス識別子がありません

統合をアクティブ化できるように、少なくとも1つのビジネス識別子トラッキング・フィールドを構成する必要があります。これは、プライマリ・ビジネス識別子と呼ばれます。ビジネス識別子を使用すると、実行時にメッセージ内のペイロード・フィールドを追跡できます。少なくとも1つのビジネス識別子をまだ構成していない場合は、統合の設計キャンバスの「統合エラー」アイコンにカーソルを置くと、次のエラー・メッセージが表示されます。

左側に次のエラー・メッセージが表示されます: トラッキングのプライマリ・ビジネス識別子がありません。メニューのトラッキング・オプションを使用してプライマリ識別子を定義してください。右側には、統合エラー・アイコンがあります。

このエラー・メッセージを削除するには、少なくとも1つのビジネス識別子を構成します。「ビジネス識別子の割当て」を参照してください。

replaceAll JavaScript関数を呼び出すことができません

Oracle IntegrationでreplaceAll JavaScript関数をコールしようとすると、次のエラーが表示されます:

ode=<code>JavaScript execution error</code>\n,detail=<detail>Review
JavaScript error(s) and fix them:\nerror: null@3 -> TypeError: Cannot find
function replaceAll in object

replaceAll関数は、Oracle IntegrationのJavaScriptエンジンではサポートされていません。

replaceAllの機能を実現するには、次の代替方法のいずれかを使用します:

次のように、replace関数をグローバル・オプションとともに使用します:
```
function myFunction(Input) {
  var res = Input.replace(/<\/>/g,'');
 return res;
}
```
replaceAllのかわりにsplitおよびjoin関数を使用します。

文字列データ型の変数の使用と算術比較式の適用の競合

Oracle Integrationで作成されたすべての変数は、現在文字列データ型のみです。これらの変数を直接使用して算術コンパレータ式を適用すると、通常とは異なる動作になります。

たとえば、割当てアクションでは、var1とvar2の2つの変数がそれぞれ1と10の値を使用して作成されます。 Whileアクションでは、次に条件を$var1 < $var2として設定すると、ループは2回の反復後に終了します。正しい使用方法は、number XPath機能で変数をラップして、条件を設定することです: number($var1) < number($var2)。このループは、終了する前に10回繰り返します。

レコードの書込みによって発生する停止プロセスが遅いネットワーク・コールを減らします

FTPアダプタのアダプタ・エンドポイント構成ウィザードの操作ページで「既存のファイルに追加」オプションを使用してレコードごとにレコードを書き込むと、作成されるネットワーク・コールが多すぎて最終的にはプロセスが遅くなります。かわりに、ステージング・ファイル・アクションを使用し、レコードをステージング・ディレクトリに書き込みます。すべてのレコードが書き込まれたら、ステージング・ファイル・アクションとFTPアダプタの「ファイルの書込み」オプションで「ファイルのリスト」オプションを使用して、ファイルをFTPのロケーションに転送します。このアプローチでは、処理時間が短縮され、FTPサーバーへのコールが多すぎないようになります。

単一のREST API接続を使用したサブプロセス統合の起動

特定のタスクを実行するために、別々の統合(サブプロセスとみなす)を作成するモジュラ設計アプローチに従うとします。たとえば:

ファイル - ステージング
翻訳
ステージ - コア
ジョブ・プロセスをトリガー

これらの各サブプロセスは、WSDLコネクタとして作成されます。しかし、複数のコネクタを維持する必要があるため、状況が複雑になります。単一のREST APIの作成およびAPIコールを使用したサブプロセスのトリガーは、保守が最適です。次の詳細に注意してください。

単一のREST API接続を使用してサブプロセスを起動することができます。
スケジュールAPIを使用して、必要な統合をトリガーできます。ただし、これはスケジュール統合の場合にのみ可能です。さらに、スケジュールAPIは指定された統合をただちに実行するようになり、このタイプの統合は入力パラメータを取得するように構成できません。

もう1つの方法として、入力パラメータを取得するように構成できるトリガーとして使用されるREST接続を使用したアプリケーション統合を作成できます。その統合はREST API自体として起動でき、スケジュールをAPIで起動する必要はありません。 REST APIのv2バージョンのスケジュールAPIのURLは次のとおりです:

http://host:port/icsapis/v2/integrations/SAYHELLO%7c01.00.0000/schedule/jobs

つまり、URLには、実行する統合を指定するCODE|VERSIONが含まれています。

サブプロセスを呼び出すことができるのは、SOAPコネクタだけです。

トリガー接続は、対応するJSONが空のJSONを受信した場合、JSONでは空の配列を受信できません

要素が空の配列の場合、アダプタはマッパーから要素を受け取りません。空の配列の場合にマッパーから要素を取得するには、XSLファイルを手動で変更します。

統合をエクスポートします。

XSLファイルのマッピングを手動で変更し、ソース要素が存在しないか空であってもターゲットにデフォルト要素が生成されるようにします。たとえば:

XSLファイルを編集する前に:

<xsl:for-each
select="$Cheers_API/nsmpr0:executeResponse/nsmpr1:response-wrapper/nsmpr1:
employeeEarnedDetails/nsmpr1:earnedBadges" xml:id="id_24">
<nstrgdfl:earnedBadges xml:id="id_23">
<xsl:value-of select="." xml:id="id_25" />
</nstrgdfl:earnedBadges>
</xsl:for-each>

XSLファイルを編集した後:

<nstrgdfl:earnedBadges xml:id="id_23">
<xsl:for-each
select="$Cheers_API/nsmpr0:executeResponse/nsmpr1:response-wrapper/nsmpr1: 
employeeEarnedDetails/nsmpr1:earnedBadges" xml:id="id_24">
<xsl:value-of select="." xml:id="id_25" />
</xsl:for-each>
</nstrgdfl:earnedBadges>

統合をインポートします。

オブジェクト・ストレージ・バケット・エラー作成

オブジェクト・ストレージ・バケットがデフォルト・ドメインにない場合は、「インスタンス・ストレージ」ページでバケットを作成するときに次のエラーが表示されます。

An error occurred while saving storage changes
{ "servlet":"jersey", "message":"insufficient content written", "url":"/ic/api/common/v1/storages", "status":"500" }

「インスタンス・ストレージ」ページの「ユーザー名」フィールドに、ユーザー名の前にドメイン名を追加します:

domain_name/username

登録済AIエンジンの管理

以前にOracle IntegrationでAIエンジンを登録していた場合(2025年6月より前)、それらを削除できます。

AI機能は、Oracle Integration 3のプロビジョニングと管理のAI機能の可用性で説明されているように、選択したリージョンでサポートされます。

登録済AIエンジンを削除するには:

ナビゲーション・ペインで、「設定」、「AIエンジン」の順にクリックします。
エントリの横にあるをクリックし、「削除」をクリックします。

すべてのAIエンジン・エントリを削除すると、「AIエンジン」設定ページが消えます。