機械翻訳について

2 統合の問題

Oracle Integrationの統合の問題を確認します。

トピック:

• アダプタの問題

• 統合の問題

• ランタイムの問題

アダプタの問題

アダプタに関連する既知の問題を確認します。

トピック:

• Oracle Autonomous Transaction ProcessingアダプタWalletの問題

• リレーションを持つ複数の表に対して表更新操作を実行すると問題が発生

• Oracle Sales Cloud REST APIがOracle Sales Cloudアダプタに表示されないことがある

• Oracle HCM CloudアダプタZIPファイルの問題

• MySQLアダプタ接続を呼出しとして統合に追加する際、表関係がデフォルトで表示されない

• 複数の更新を含む単一のコールがSQL Serverアダプタの基本マップ・データ統合パターンでサポートされていない

• RESTアダプタ基本認証セキュリティ・ポリシー制約

• HTTP基本認証セキュリティ・ポリシーを使用したRESTアダプタ接続のテストでは、資格証明は検証されません

• RESTアダプタがマルチパート・データを返すサービスをサポートしていない

• 拡張ドメイン内で構成されたリダイレクトURLが「Provide Consent」ボタンで失敗する

• Oracle E-Business Suiteアダプタの問題

• SiebelアプリケーションSiebel Inboundサービスのアクティブ化中のWSDL検証エラー

• ERPシステムでは、ロード・インタフェース・ジョブが失敗すると、ドキュメントIDがJSON文字列で追加されない

Oracle Autonomous Transaction ProcessingアダプタWalletの問題

ウォレットの使用時に接続エージェントを介して接続する既存のOracle Autonomous Transaction Processingアダプタ接続では、2023年2月のパッチ適用が完了するまでウォレットを変更しないでください。 ウォレットを変更すると、ランタイム・エラーが発生します。

ウォレットの使用時に接続エージェントを介して接続する新しい接続を作成する必要がある場合は、2023年2月のパッチ適用が完了するまで待機してください。

リレーションを持つ複数の表に対して表更新操作を実行すると問題が発生

Oracle Databaseアダプタのリレーションを持つ2つ以上のテーブルに対してUpdate Table操作を実行すると、子テーブルのレコードが挿入または削除されることがあります。 したがって、更新への入力に1つの詳細レコードしか含まれていない場合、表の他の詳細レコードは削除されます。

Oracle Sales Cloud REST APIがOracle Sales Cloudアダプタに表示されないことがある

Oracle Sales Cloud Oracle Sales Cloudアダプタを統合の起動接続として使用すると、REST APIサービスが表示されないことがあります。

回避策として、次のステップを実行します。

1. Oracle Sales Cloudに新しいサンドボックスを作成します。

2. 「一般的なAppComposerアカウント」 > 「フィールド」 > Test_cに移動します。

3. 「サービス・ペイロードに含める」オプションの選択を解除します。

4. 「販売AppComposer」にナビゲートします。

5. Order_c > 「フィールド」 > AccountId_cを編集します。

6. 「サービス・ペイロードに含める」オプションの選択を解除します。

7. 「商談」 > 「案件オブジェクト」 > 「フィールド」の次のフィールドに対して同じステップを繰り返します(「サービス・ペイロードに含める」オプションの選択を解除します)。

   • Architect_c

   • Builder_c

   • Contractor_c

   • Designer_c

   • Installer_c

   • PriceBookName_c

8. 上記の呼び出しが現在動作しているかどうかをテストし、サンドボックスを公開します。

Oracle HCM CloudアダプタZIPファイルの問題

Oracle HCM Cloud Adapter ZIPファイル機能を使用する場合は、次の点に注意してください:

• Oracle HCM Cloudアダプタを使用して抽出されるZIPファイルには、単一のファイルのみが含まれていなければなりません。 複数のファイルがある場合は、最新のタイムスタンプを持つファイル「のみ」が抽出されます。

• Oracle HCM Cloud Adapter ZIPファイル機能を使用するためのサポートされているメソッドは、まずファイルを圧縮して暗号化することです。

MySQLアダプタ接続を呼出しとして統合に追加する際、表関係がデフォルトで表示されない

MySQLアダプタを呼出しとして統合に追加する際、2つの関連した表の関係はデフォルトで表示されません。 この動作は、インポートされた表のいずれかで外部キーが宣言されている場合にも発生します。 回避策はありません。

複数の更新を含む単一のコールがSQL Serverアダプタの基本マップ・データ統合パターンでサポートされていない

複数の更新を含む単一のコールは、SQL Serverアダプタの基本マップ・データ統合パターンでサポートされていません。 更新が複数の場合は、オーケストレートされた統合パターンを使用するか、基本マップ・データ統合パターンをエンリッチメントとともに使用してください。

RESTアダプタ基本認証セキュリティ・ポリシー制約

RESTアダプタ基本認証セキュリティ・ポリシーにはトークン管理およびトークン・リフレッシュがありません。 トークンが失効した場合、続行する前にデザインタイムで接続をテストする必要があります。 たとえば、RESTアダプタおよびGoogle Calendarアダプタを含む統合があり、Google Calendarトークンが失効すると障害が発生します。

回避策として、次のいずれかのステップを実行します。

• 「Connections」ページの「Credentials」ダイアログに進み、「Provide Consent」をクリックします。

• リフレッシュ・トークン・リクエストとともに、OAuthカスタム3レッグ・フローのセキュリティ・ポリシーを使用します。

HTTP基本認証セキュリティ・ポリシーを使用したRESTアダプタ接続のテストでは、資格証明は検証されません

HTTP Basic認証セキュリティ・ポリシーおよび「トリガーと起動」または「起動」のロール接続を使用して構成されたRESTアダプタ接続をテストしても、資格証明は検証されず、指定したURLへの接続がオープンします。 エンドポイントと資格証明を検証するには、RESTアダプタがべき等なAPIを呼び出す必要があります。

RESTアダプタがマルチパート・データを返すサービスをサポートしていない

multipart/mixedまたはmultipart/form-dataを返すRESTアダプタ接続を作成する場合、RESTアダプタとの統合をインバウンド接続とアウトバウンド接続の両方として設計することはできません。これは、レスポンスでmultipart/mixedとmultipart/form-dataメディア・タイプの両方はサポートされないためです。

拡張ドメイン内で構成されたリダイレクトURLが「Provide Consent」ボタンで失敗する

OAuth認証コード資格証明およびOAuthカスタム3レッグ・フローのセキュリティ・ポリシーについて、RESTアダプタを使用したリダイレクトURI構成が必要です。

クライアント・アプリケーション用にリダイレクトURIを構成する際は、次の形式を使用します。

https://ICS_HOST:ICS_SSL_PORT/icsapis/agent/oauth/callback

OAuthカスタム3脚式フロー・セキュリティ・ポリシーを使用してRESTアダプタとの接続を作成する前に、サードパーティ・プロジェクトを作成する必要があります。

1. サードパーティ・アプリケーションの開発者コンソールに移動します。

2. 新規アプリケーションを作成します。

3. サードパーティ・アプリケーション内にOracle IntegrationリダイレクトURIを指定します。

   Oracle IntegrationインスタンスのOAuthコールバックのSSL URLを入力します。 形式は次のとおりです。

   https://ICS_HOST:ICS_SSL_PORT/icsapis/agent/oauth/callback

   たとえば、Oracle Integrationインスタンスにアクセスするために使用するURLが次のようになっているとします:

   http://example.com:7001/ics/faces/global

   OAuthコールバックのSSL URLは、次のようになります:

   https://example.com:7002/icsapis/agent/oauth/callback

   ノート:

   アプリケーションの作成は、各ベンダー固有のものです。

Google Calendarアダプタを使用したリダイレクトURIの構成例は、Google Calendarプロジェクトの作成を参照してください。

Oracle E-Business Suiteアダプタの問題

統合でOracle E-Business Suiteアダプタを使用している場合、次の問題が発生する可能性があります。

• Trading Partner Setupフォームでは特殊文字を含むパスワードを使用できません

  Trading Partner Setupフォームでは特殊文字を含むパスワードを使用できません。 したがって、Oracle Integrationパスワードは、テキストと数字の組み合わせでなければなりません。

  この問題を解決するには、次のパッチを適用して、Oracle XML Gatewayで特殊文字のパスワードを使用できるようにします:

  • Oracle E-Business Suiteリリース12.2では、パッチ27752692:R12.ECX.Cを適用します。
  • Oracle E-Business Suiteリリース12.1.3の場合、パッチ28310667:R12.ECX.Bを適用します。

• 表の入力パラメータを持つ特定のPL/SQL APIのサービス呼び出しが失敗

  表型入力パラメータを持つ特定のPL/SQL APIを起動すると、次の例外が発生することがあります:

  java.sql.SQLException: ORA-06531: Reference to uninitialized collection ORA-06512 

  例外を解決するには、APIの表型に対応するリクエストの空の要素を渡します。 たとえば、P_BOM_REVISION_TBL、P_BOM_REF_DESIGNATOR_TBL、およびP_BOM_SUB_COMPONENT_TBLという表型パラメータを使用してPROCESS_BOM APIを起動する場合、回避策として空のタグを渡します:

  1. Oracle E-Business Suiteリクエストのマッピングとの統合をエクスポートします。

  2. 対応する.xslファイルを探して、P_BOM_REVISION_TBL、P_BOM_REF_DESIGNATOR_TBL、およびP_BOM_SUB_COMPONENT_TBLのマッピング・エントリを次のように変更します:

     <P_BOM_REVISION_TBL/>
     <P_BOM_REF_DESIGNATOR_TBL/> 
     <P_BOM_SUB_COMPONENT_TBL/>

  3. このマッピングをリクエスト・マッピングにインポートします。

  4. 統合をアクティブにすると、APIが正常に起動されます。

SiebelアプリケーションSiebel Inboundサービスのアクティブ化中のWSDL検証エラー

SiebelアプリケーションいくつかのSiebelインバウンド・サービスのアクティブ化中にWSDL検証エラーがスローされます。

SiebelアプリケーションWSDLは、同一の名前空間に重複した要素定義を持ちます。 Oracle Siebelアダプタを構成すると、これらのSiebelインバウンド・サービスのアクティブ化中にSiebelアプリケーションのWSDL検証エラーがスローされます。

回避策

次の回避策のいずれかを実装して、検証エラーを解決します。

• SiebelアプリケーションでWSDLを修正し、Oracle Integrationで統合フローを再構成して、Siebelアダプタが正しいWSDLを選択するようにします。

• Siebel Call Centerのサービスを非アクティブ化し、これらのサービスがSiebelアダプタの操作ページに表示されないようにします。

ERPシステムでは、ロード・インタフェース・ジョブが失敗すると、ドキュメントIDがJSON文字列で追加されない

統合インポートの際にロード・インタフェース・ジョブが失敗すると、ERPシステムではJSONコールバック文字列でドキュメントIDが追加されます。 ただし、ERP JSONペイロードにはドキュメントIDがありません。 そのため、Oracle ERP Cloud Adapterでは、ERPコールバック・ペイロードを処理できません。

統合の問題

統合に関する既知の問題を確認します。

トピック:

• Oracle Cloud at Customer環境のCacertsストアへのMicrosoft中間証明書のインポート

• 入力引数のないメッセージ開始を使用したプロセスの起動エラー

• Windows 10のデザイン時の問題

• 通知アクションの失敗は、オーケストレートされた統合フローに影響しません

• SafariブラウザでAdblock Plus Extensionを有効にすると、アイコンとスクリーン・テキストがオーバーレイされる

• バッジを表示し、正常に統合された場合の監査証跡にトラッキングされない

• Windows 10でのタッチ・スクリーン・インタフェースによるマッパーの使用

• APIライブラリの問題

• エラー・ホスピタルへのメッセージ送信を防止するためのグローバル・フォルトの構成

• Oracle Integrationメッセージ配信がXAモードで機能しない

• 「Tracking」ページでスキーマのロードが遅延するため、使用中アイコンが表示されない

• ブラウザのCookieを削除すると、プリファレンスがクリアされる

• 頻度のスケジュールで月数を多く指定した場合の不正確なエラー・メッセージ

Oracle Cloud at Customer環境のCacertsストアへのMicrosoft中間証明書のインポート

2022年12月リリースのOracle IntegrationをOracle Cloud at Customer環境で使用し、schemas.xmlsoap.orgのスキーマを参照するSOAP関連の統合フローがある場合、Microsoft中間証明書をcacertsストアにインポートする必要があります。

http://schemas.xmlsoap.orgへのアクセスがhttps://schemas.xmlsoap.orgにリダイレクトされたため、このタスクが必要です。 必要な証明書がJDKトラスト・ストアで使用できない場合、https://schemas.xmlsoap.orgへのコールはPKIX例外で失敗します。

1. msft.cerファイルをダウンロードし、Oracle WebLogic Serverコンテナにコピーします。
   1. https://schemasxmlsoap.azurewebsites.net/soap/envelope/にアクセスし、アドレス・バーのロックをクリックして証明書をダウンロードします。
   2. Oracle WebLogic Serverコンテナ内で、ディレクトリを次のロケーションに変更します。

      cd /u01/jdk/jre/lib/security

   3. 証明書を削除します。

      sh -c "keytool -storepass changeit -delete -alias msicert -file
      /oic_admin/certs/msft.cer -keystore $keystore_loc/cacerts"

   4. 証明書をインポートします。

      sh -c "keytool -storepass changeit -import -alias msicert -file
      /oic_admin/certs/msft.cer -keystore $keystore_loc/cacerts"

   5. インポートされたファイルを検索します。
      sh -c "keytool -storepass changeit -list -keystore cacerts"

      このコマンドの出力でmscertを検索して、証明書がインポートされていることを確認します。

2. SOAP関連の統合フローを確認します。

入力引数のないメッセージ開始を使用したプロセスの起動エラー

プロセスがメッセージ開始イベントを使用する統合でアクティブ化されたプロセスを起動する場合、メッセージ開始には、入力パラメータ(引数)が定義されている必要があります。 パラメータが存在しない場合、400不正なリクエスト・レスポンス・ステータスが返されます。

Windows 10のデザイン時の問題

Windows 10でChromeブラウザを使用しているときに、接続を統合にドラッグしようとすると、その接続は追加されません。 Internet Explorerを使用すると、禁止されたアイコンが表示されます。

タッチ・スクリーンのサポートを無効にしてブラウザを再起動すると、この問題は解決しません。

通知アクションの失敗は、オーケストレートされた統合フローに影響しません

通知アクションが失敗した場合、全体の統合フローはそのアクションを過ぎて実行され続けます。 「トラッキング」ページには、対応する通知アクションの赤いアイコンが表示されます。 障害はログに記録されますが、インスタンスの障害として報告されません。 トラッキング・ページでエラーを表示すると、障害は表示されません。

SafariブラウザでAdblock Plus Extensionを有効にすると、アイコンとスクリーン・テキストがオーバーレイされる

Adblock Plus拡張機能を有効にしてSafariブラウザを使用すると、統合作成/編集のステータスを示すバナーに表示されているアイコンと画面のテキストが上書きされます。 この拡張機能を無効にして問題を解消します。

バッジを表示し、正常に統合された場合の監査証跡にトラッキングされない

トラッキング・インスタンスの詳細ページで、for-eachアクション内のアクティビティは記録されず、内部for-eachアクションには完了した統合のバッジは表示されません。 監査証跡には、外部for-eachアクションが開始され、終了したというメッセージのみが表示されます。 障害が発生した場合(たとえば、内部for-eachアクションが失敗した場合)、内部for-eachアクションのバッジが表示されます。 監査証跡には、障害発生時までの各アクション内のアクティビティに関連するメッセージが表示されます。

さらに、統合が成功するためには、それぞれのアクションの中に線が点線(...)で示されています。 for-eachアクション内で障害が発生した場合は、障害が発生するポイントの前に実線(緑色)が表示され、赤色でマークされる前に障害が発生したノードとラインが表示されます。

Windows 10でのタッチ・スクリーン・インタフェースによるマッパーの使用

マッパーでは、Windows 10ホストでコンポーネントをドラッグ・アンド・ドロップする場合(たとえば、接続パレットから接続をドラッグ・アンド・ドロップする場合)、タッチ・スクリーン・インタフェースで既知の問題が発生しています。 Windows 10ホストでタッチ画面が有効になっているかどうかを確認します。 正常に実行された場合は、無効にします。

APIライブラリの問題

次のAPIライブラリの問題に注意してください。

• Librariesページで機能を持たないアップロードされたライブラリを登録して保存しようとすると、nullポインタ例外エラーが発生します。 アップロードしたライブラリに機能が含まれていることを確認してください。

エラー・ホスピタルへのメッセージ送信を防止するためのグローバル・フォルトの構成

オーケストレートされた統合にグローバル・フォルトを構成すると、エラー・ホスピタルへのメッセージ送信を防ぐことができます。 最初にグローバル・フォルトに自動的に追加された「エラー・ホスピタル」アイコンを削除してから、次のいずれかのオプションを実行します:

• 「停止」アクションを追加し、「切替え」アクションを追加します。 「停止」アクションは削除できます。 ただし、「停止」アクションを削除すると、確認ダイアログが表示されます。 あなたのディシジョンを確認した後、削除されている「停止」アクションは自動的に別の「停止」アクションに置き換えられます。

• 「切替え」アクションを追加します。 「停止」アクションは自動的に追加されますが、削除して「エラー・ホスピタル」アイコンに置き換えることはできません。

「エラー・ホスピタル」アイコンを元に戻したい場合は、統合を再作成する必要があります(たとえば、統合全体を削除して再作成したり、統合内のすべてのアクションを空にしてから、「エラー・ホスピタル」アイコンを再度追加します)。

Oracle Integrationメッセージ配信がXAモードで機能しない

Oracle Integrationメッセージ配信はXAモードでは機能しません。 重複するメッセージが宛先に配信される可能性があります。 これは、管理対象サーバーが停止したとき、またはメッセージが処理されるときに管理対象サーバーを停止する必要があるその他のシナリオで発生することがあります。

「Tracking」ページでスキーマのロードが遅延するため、使用中アイコンが表示されない

「Tracking」ページの「Business Identifiers」で、3レベルより深い要素を追跡用に選択する場合(「Load more」リンクのクリックが必要)、このページを保存して終了してから再表示しても、これらの要素は緑色の使用中アイコンでマークされません。 これは単に表示上の問題です。 要素を再度ドラッグしようとすると、この要素が現在追跡中であることを示すエラーが表示されます。

ブラウザのCookieを削除すると、プリファレンスがクリアされる

ページの右上隅で「user_name」 > 「Preferences」を選択して、「Show these options at sign in」を選択し、変更を保存してログアウトしたとします。 次にログインしたとき、プリファレンス・ページが表示されます。 ただし、ログアウト後WebブラウザですべてのCookieを削除した場合、次にログインしたときにプリファレンス・ページは表示されません。 これは、プリファレンスがブラウザのCookieに格納されるためです。 Cookieをクリアすると、プリファレンスがリセットされます。

頻度のスケジュールで月数を多く指定した場合の不正確なエラー・メッセージ

スケジュールの作成において、「Frequency」セクションで月数を指定する際に10000000000という値を手動で入力すると、「The number must be less than or equal to 2147483647」というエラー・メッセージが表示されます。 指定できるのは、12以下の値に限られます。

ランタイムの問題

実行時に関連する既知の問題を確認します。

トピック:

• 同期統合およびリカバリできない失敗ではペイロードの表示が不可

同期統合およびリカバリできない失敗ではペイロードの表示が不可

同期統合およびリカバリできない失敗では、「Error Message Details」ページおよび「Tracking」ページでペイロードを表示できません。