Oracle Cloud Infrastructureドキュメント

Oracle Integration 3へのアップグレード: フェーズ1

フェーズ・アップグレードのフェーズ1のステップについて学習します。次のステップを実行して、統合およびVisual BuilderアプリケーションをOracle Integration 3にアップグレードします。

前提条件

中断を回避するために、インスタンスをアップグレードする前に前提条件を完了していることを確認してください。

Oracle Integration第2世代

  • Oracle Integration Generation 2インスタンス用に新しいホスト名が作成されます。この新しいホスト名を使用して、今後Oracle Integration Generation 2インスタンスでプロセスにアクセスするすべてのブラウザベース・アクセスを行う必要があります。
  • 新しいホスト名は、アップグレード・ページの「プロセス自動化事前チェック」セクションの「詳細」の下に表示されます。

Visual Builder

ProcessをコールするVisual Builderアプリケーションがある場合は、次のステップを実行してVisual Builderアプリケーションを更新します。
  1. Visual Builderコンソールで、「設定」、「サービス」、「バックエンド」、「アプリケーションの処理」、「サーバー」の順にナビゲートします。
  2. Oracle Integration Generation 2 Processサーバーの場合、「編集」をクリックします。
  3. 「インスタンスURL」フィールドで、前述のステップで指定されたホスト名にホスト名を更新します。
  4. 「認証」フィールドで、値を「Oracle Cloudアカウント」からOAuth 2.0ユーザー・アサーション」に変更します。「スコープ」フィールドを更新して、Oracle Integration RESTエンドポイント・スコープをプライマリ・オーディエンスURLとともに使用します。スコープは、Oracle IntegrationインスタンスのOAuth機密性アプリケーションからテナンシから取得できます。スコープは、その機密性アプリケーションで定義されます。Oracle Integration Generation 2でのOAuth機密性アプリケーションの作成の詳細は、「クライアント資格証明を使用したOAuth 2.0認証の構成」を参照してください。プライマリ・オーディエンスURLの例: https://E213D785B536427D9E7E0BE1C5D85300.integration.ocp.oraclecloud.com:443。
  5. 作成したVisual Builderアプリケーションごとに、次のステップを実行します。
    ノート

    aからcのステップは、Visual Builderを使用して外部UIを使用してタスクを処理する場合にのみ実行する必要があります。外部UI接続の詳細は、「外部UI接続の作成」を参照してください。
    1. Visual Builderアプリケーションのセキュリティ設定を開きます。
    2. 「埋込み」フィールドを「指定したドメインへの埋込みの許可」に設定します。
    3. 「ドメインURL」フィールドに、新しいOracle Integration Generation 2 Process URLを追加します。
  6. Visual Builder Webアプリケーションにプロセス・コンポーネント・ページ(VB_SERVER + "/ic/pub/components/pages/applist.html"など)への参照がある場合、オプションで、Oracle Integration Generation 2 PCSに新しいURLが設定されるため、PCSの新しいシステム変数を作成できます。
  7. Visual Builderアプリケーションを再デプロイします。
Visual Builder Webアプリケーションを外部UIとしてコールするプロセス・アプリケーションを更新するには:
  1. プロセス・アプリケーションを開き、「フォーム」に移動します。
  2. 外部UIフォームを開き、ステージングまたはライブのVisual BuilderアプリケーションURL (https://oicvb-vb-axkbv4jfb37h.builder.toronto-1.ocp.oraclecloud.com/ic/builder/rt/ExternalUI_1_0/1.0/webApps/webapp/など)を使用します。
  3. アプリケーションを公開してアクティブ化します。
  4. ワークスペースで、外部UIフォームを使用してタスクを開きます。「ビジュアル・ビルダー」ページが使用可能になりました。
ノート

  • 前述のステップを使用してVisual Builderアプリケーションを更新した後、Visual BuilderからProcessへのコールが正しく機能していることを確認します。
  • Visual Builderアプリケーションを更新するアップグレード前のステップを完了すると、次のことが保証されます。
    • 実際のアップグレード前にプロセスへのVisual Builder接続を検証し、アップグレード後の停止時間を回避します。
    • 新しいホスト名および認可ポリシーを使用するようにVisual Builderを更新すると、元に戻す必要はありません。
  • Visual Builderの更新が失敗した場合: 長期にわたる停止を回避するために、構成変更を元に戻し、My Oracle Supportでサービス・リクエスト(SR)を送信します。
  • アップグレード前にアクションを実行しない場合: アップグレード後にVisual Builderアプリケーションを更新するステップを実行する必要があります。これにより、停止時間が発生します。アップグレードする前に、これらのステップを完了することを強くお薦めします。
ノート

PCSからVisual Builderへのコールでは、Basic Authセキュリティ・ポリシーで構成されたREST接続のみを使用する必要があります。

その他のフロントエンド・アプリケーション

プロセスAPIで他のフロントエンド・アプリケーションを使用している場合は、新しいホスト名を使用するように更新する必要があります。ホスト名を更新しないと、HTTPリダイレクト・エラーが発生する可能性があります。

Oracle Content Management

Oracle Content Management (OCM)と統合されたプロセスを使用している場合は、OCMの統合設定でプロセス自動化のホスト名を更新する必要があります。次の変更により、OCMとプロセスの統合は、OCMの寿命に達するまで機能します。

  • プロセスがOCMのサポートにのみ使用される場合: OCMから移動するまで(2025年12月までに)アップグレードを再スケジュールするには、アカウント・チームに連絡してください。
  • それ以外の場合: インスタンスは、プロセスのフェーズ・アップグレードを使用してアップグレードされます。OCMとプロセスの統合は、OCMが寿命に達するまで機能します。

プロセス

  • アップグレード後まで新しい開発作業を一時停止または制限することをお薦めします。
  • サービス登録が期待どおりに機能するには、RESTトリガーでOAuth 2.0およびBasic Authenticationセキュリティ・ポリシーが使用されていることを確認します。
  • プロセスによって呼び出される統合がある場合は、次のようになります。
    • アップグレード前: これらの統合に対してOAuthおよびBasic認証を有効にします。これらの統合のRESTトリガーでは、OAuthおよびBasic認証セキュリティ・ポリシーを有効にする必要があります。OAuthのみまたは基本認証のみを使用している場合は、アップグレード後の失敗を回避するために、OAuthおよび基本認証を使用するように更新します。
      ノート

      トリガー・タイプのRESTトリガー接続のみを使用する必要があります。
    • アップグレード後: プロセスによってコールされた統合で、セキュリティ・ポリシーとしてOAuthおよびBasic Authenticationが使用されていることを確認します。
  • Oracle Integration Generation 2に統合を呼び出す動的プロセスがある場合は、RESTコネクタを使用して、Oracle Integration 3にそのようなプロセスをデプロイします。RESTコネクタのかわりにネイティブ・アダプタを使用して、Oracle Integration 3にそのようなプロセスをデプロイすると、エラーが発生する可能性があります。

アップグレード後のタスク

フェーズ1のアップグレードが完了した後に何が起こるかを確認し、アップグレード後のタスクを完了します。

ノート

次の情報は、プロセスのフェーズ・アップグレードを使用して移行された顧客にのみ適用されます。

フェーズ1のアップグレードが完了したら、何が起こるか、そして何をすべきかを次に示します。

Oracle Integration第2世代

ノート

アップグレード後も、Oracle Integration Generation 2環境にアクセスできます。

たとえば: https://<original instance ID>-process.integration.ocp.oraclecloud.com/ic/home/。

既存の(処理中および完了済の)すべてのトランザクションが使用可能になります。

  • Oracle Integration Generation 2インスタンスでは、プロセス機能のみが使用可能であり、他のすべてのコンポーネントはアップグレードされています。
  • この時点以降、Oracle Integration Generation 2では新しい開発作業は発生しません。
  • Oracle Integration Generation 2インスタンスはOracle Cloudコンソールで使用できなくなるため、Oracle Integration Generation 2インスタンスの管理アクション(開始/停止など)は実行できなくなります。
  • 既存のプロセスで修正を適用する必要がある場合は、Oracle Integration 3で統合を検出できます。
  • 統合アクティビティを使用した動的プロセス・コールは、アップグレード後に機能しません。そのため、サービス・アクティビティ接続を使用して統合をコールするように、動的プロセスを更新する必要があります。アップグレード前にこれを行わないと、アップグレード後にサービスの中断が発生する可能性があります。
  • SOAPエンドポイントを使用してプロセスを呼び出す場合、Webサービス・エンドポイントではデザイナに正しいアドレスが表示されないことに注意してください。ただし、実行時に、コールはOracle Integration 3インスタンスによって正しくリダイレクトされます。正しいWSDLエンドポイントを使用するようにクライアントを手動で更新する場合は、次のステップを実行します。
    1. Oracle Integration Generation 2インスタンスのナビゲーション・ペインで、「プロセス」をクリックし、「アプリケーションの処理」をクリックします。

      プロセス アプリケーション ページが表示されます。

    2. プロセス・アプリケーション・ページで、「アクティブ化」をクリックします。

      「アクティブ化」ページが表示され、管理できるアプリケーションがリストされます。

    3. 「アクション」 [アクション]アイコンをクリックし、「Webサービス」を選択します。

      「Webサービスの管理」ダイアログが表示されます。

    4. 「Webサービスの管理」ダイアログの「公開済」タブには、アクティブなアプリケーションが公開しているWebサービスURLが表示されます。新しいホスト名を使用するように、このWebサービスURLのホスト名を手動で更新します。

Oracle Integration 3

  • アップグレード後、プロセスはOracle Integration 3で有効になりません。
  • プロセスを呼び出す統合が移行され、アクティブ化されました。
  • 既存のソリューションに修正を適用する必要がある場合は、Oracle Integration Generation 2で新しいプロセスを検出できます。
  • プロセスを呼び出すプロセス・アクションとのスケジュール統合は、フェーズ・アップグレード後に自動的に開始されません。これらのスケジュール統合は、段階的なアップグレード後に開始する必要があります。

Visual Builderおよびその他のフロントエンド・アプリケーション

  • プロセスをコールするVisual Builderアプリケーションがあり、アップグレード前のステップを完了しなかった場合は、ここでそれらを完了する必要があります。
  • Oracle Integration Generation 2プロセスは検出できなくなり、アクション・チェーンでコールできなくなります。すべての新しいVisual Builder開発イニシアチブにOracle Integration 3プロセスを使用する必要があります。

検証

  • 妥当性チェックを実施して、統合、フロントエンド・アプリケーションおよびプロセス間の接続性を検証すること。
  • プロセス環境で機能テストを実行します。

操作の再開

  • 検証が完了すると、ビジネス・ユーザーはプロセス・インスタンスの作成およびタスクの実行を再開できます。