機械翻訳について

統合のエンドポイントのリフレッシュ

統合のクローニング、事前構築された統合のカスタマイズ、または既存の統合のOracle Integrationへのインポートが完了したら、統合環境の要件に従って接続情報(WSDL、ユーザー名およびパスワード)を更新します。 指定する接続WSDLにカスタム・フィールドが含まれるか、接続WSDLが異なるバージョンを使用して更新されている場合、これらはマッパーに表示されません。 カスタム・フィールドまたは更新されたフィールドをマッパーに表示するには、Oracle Integrationのエンドポイントをリフレッシュする必要があります。

たとえば、ある接続(Salesforce接続など)のWSDLは頻繁に変更されるため、最新のWSDLを統合に取り込む必要があります。 WSDLファイルをリフレッシュしても、インポートされたマッピングのカスタム・フィールドは削除されず、必要に応じて編集できます。 これにより、マッパーでソース要素とターゲット要素を最初から再マップする必要がなくなります。

エンドポイントのリフレッシュは非同期操作です。 これにより、タイムアウトが発生する可能性が低くなります。 リフレッシュは、単一のアクションから統合全体までスケーリングできます。

制限事項

  • 統合は、アクティブ、アクティブ化中または非アクティブ化中はリフレッシュできません。
  • 統合はリフレッシュ中にロックされます。 この期間中に統合を変更することはできません。
  • 統合のアクティブ化は、リフレッシュ中にブロックされます。
  • エンドポイントのリフレッシュ中に、統合キャンバスを表示または終了できます。 エンドポイントのリフレッシュが完了してもキャンバス上に残っている場合は、キャンバスがリフレッシュされ、編集を再開できます。 キャンバスから移動すると、リフレッシュが完了し、ロックが解除されたというアラートが表示されます。
  • 統合のリフレッシュ中に編集しようとすると、「接続」ページに警告メッセージが表示されます。
  • リフレッシュが完了するまで統合のロックを解除できません。
  • リフレッシュが正常に完了すると、前の状態にロールバックできません。
  • リフレッシュの使用を最小限に抑えます。 この機能は、絶対に必要な場合にのみ使用します。

  • 新旧のWSDLの間でルート・レベルを異なるものにすることはできません。 差異がある場合、WSDLのリフレッシュは失敗します。 したがって、接続情報は変更できますが、新しいWSDLに以前のWSDLと異なるルート要素がないことを確認する必要があります。

  • 「Oracle Service Cloud (RightNow)アダプタ」 WSDLバージョン1.2を使用する統合を作成し、「Oracle Service Cloud (RightNow)アダプタ」 WSDLバージョン1.3でリフレッシュしようとすると、マッパー・エラーが発生します。

  • JCAアーティファクトはリフレッシュされません。

  • 新しいWSDLは、異なるデータ構造を持つ別のスキーマへの参照を持つことができます(たとえば、ルート要素に対して新しい複合要素を追加、変更または削除してスキーマを変更する場合)、スキーマ内のルート要素が変更、追加または削除されない場合「のみ」です。 この状況では、ルート要素内の子要素を変更したり、任意の新しいデータ構造やデータ型を参照することができます。

    リフレッシュ・ロジックは参照およびインポートに従うか、新しいWSDLに新しいデータ構造を含めます。 スキーマ内のルート要素は、最初のレベルの<xs:element/>または型要素(<xs:complexType/>または<xs:simpleType/>)です。 最初のレベルの<xs:element/>の場合、次が適用されます。

    • QNameは変更できません。

    • 新しいルート要素は追加できません。

    • 古いルート要素は削除できません。

    最初のレベルの型要素の場合、次が適用されます。

    • QNameは変更しないでください。

    • 古いルート・タイプは削除できません。

    • 新しい型要素は、他の参照元の子要素または型により設定できます。

    たとえば、ルート要素内に定義された一方の子要素または型は新しい型要素を参照できます。 リフレッシュ・ロジックは、子要素/タイプと同じターゲット・ネームスペースを持つ場合は既存のスキーマにインポートするか、子要素/タイプとは異なるターゲット・ネームスペースを持つ場合は新しいスキーマを作成します。 新しいルート・レベルの型要素は、もう一方の子要素/型により参照される必要があります。 スタンドアロン・ルート・タイプ要素の場合、インポートまたは最終リフレッシュWSDLに含まれません。

ノート:

リフレッシュ中にエラーが発生した場合は、エンドポイント/マッピングの更新を保存しないでください。 かわりに、保存せずに統合をクローズして破棄し、編集のために統合を再オープンしてリフレッシュを再試行してください。
  1. 開始する場所を決定します:
    • プロジェクトでの作業。
      1. ナビゲーション・ペインで、「プロジェクト」をクリックします。
      2. プロジェクト名を選択します。
      3. 「Integrations」をクリックします 統合アイコン
      4. 「統合」セクションで、リフレッシュする統合を検索します。
    • プロジェクト外の作業
      1. ナビゲーション・ペインで、「設計」、「統合」の順にクリックします。
      2. リフレッシュする統合を検索します。

    統合内の個々のエンドポイントまたはすべてのエンドポイントのエンドポイントをリフレッシュできます。

  2. 次の2つの方法のいずれかでエンドポイントをリフレッシュします:
    1. 「アクション」をクリックします 「アクション」アイコン
    2. 適切なエンドポイントに「エンドポイントのリフレッシュ」を選択します。
    または
    1. エンドポイントをリフレッシュする統合の名前をクリックします。
      統合キャンバスが表示されます。
    2. 統合の上にあるパレットのアイコンをクリックして、エンドポイントをリフレッシュします。

      統合キャンバスの上のパレットには、8つのアイコンが表示されています。 左から3番目のアイコンが強調表示され、エンドポイントのリフレッシュに使用されます。

      エンドポイントのリフレッシュ・パネルが開きます。

  3. アーティファクトをリフレッシュする接続をリストから選択します。 エンドポイントのリフレッシュは、ビジネス識別子およびマップに影響する可能性があります。
  4. 「リフレッシュ」をクリックします。

    影響を受ける接続エンドポイントのリフレッシュが進行中として表示されます。 統合ページでは、統合リフレッシュ全体の状態も進行中として表示されます。

    このプロセスでは、エンドポイントおよび依存アーティファクトがリフレッシュされ、マッピング中にカスタム要素が表示されるようになります。 事前作成された統合からインポートされたマッピングは削除されません。 マップが検証され、影響を受けたマップには警告(黄色のアイコン)またはエラー(赤色のアイコン)が表示されます。 警告とエラーの両方が1つのマッパーに存在する場合は、エラー・アイコンのみが表示されます。 マッパーがカスタマイズされていることを示すアイコン(青色のアイコン)は、マッパーの下部に表示されます。

  5. 進行中のエンドポイントのリフレッシュを取り消す必要がある場合は、「停止およびロールバック」をクリックします。

「Oracle Integration 3でのOracle Mapperの使用」の「データのマップ」を参照してください。