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

Oracle Integration 3を使用したプロセスの有効化

Oracle Integrationでプロセスを使用するには、管理者がOracle CloudコンソールでOracle Integrationサービス・インスタンスからプロセスを有効にする必要があります。

有効にすると、プロセス・インスタンスはOracle Integrationインスタンスで自動的にプロビジョニングされます。このような場合、2つのサービスは相互に関連付けされ、Oracle Cloudコンソールの互いの「関連付けられたサービス」ページにリストされます。

Oracle Integrationでのプロセスの有効化に関する重要なポイント:

プロセスは、Oracle Integration 3 Enterprise Editionでのみ有効にできます。
Oracle Integrationでプロセスを有効にするユーザーは、Oracle Integrationインスタンスのアイデンティティ・ドメインに存在し、プロセスに対するMANAGE権限を持っている必要があります。
プロセス・インスタンスへのアクセスを管理するための正しいIAMポリシーが設定されていることを確認する必要があります。 Oracle Cloud Infrastructure Process Automationの管理のプロセス自動化インスタンスを管理するためのIAMポリシーの設定を参照してください。
Oracle Integrationでプロビジョニングされたプロセス・インスタンスは、個別に削除できません。このようなインスタンスは、関連付けられているOracle Integrationインスタンスが削除されるたびに削除されます。
Oracle Integrationでプロビジョニングされるプロセス・インスタンスは、Oracle Integrationインスタンスと同じテナンシ、リージョンおよびコンパートメントに存在する必要があります。インスタンスを別のコンパートメントに移動することはできません。

プロセス・インスタンスを管理するためのIAMポリシーの設定

Oracle Integrationでプロセスを有効にするには、指定したIAMグループに属するOracle Integration管理者がプロセス・インスタンスを管理できるようにするOracle Cloud Infrastructure Identity and Access Management (IAM)ポリシーを作成する必要があります。

プロセスに対して次のIAMポリシーを設定します:

構文: allow group <group_name> to manage process-automation-instances in compartment <compartment_name>

例: allow group domain_admins to manage process-automation-instances in compartment oicpa_compartment
構文: allow group <group_name> to read metrics in compartment <compartment_name>

例: allow group domain_admins to read metrics in compartment oicpa_compartment

Oracle Cloud Infrastructure Process Automationの管理のプロセス自動化のIAMポリシーについておよびアイデンティティ・ドメインでのIAMポリシーの作成を参照してください。

Oracle IntegrationのIAMポリシーの詳細は、Oracle IntegrationのIAMポリシーについておよびOracle Integrationのアイデンティティ・ドメインでのIAMポリシーの作成を参照してください。

プロセス使用可能

Oracle Integrationインスタンスでプロセス・インスタンスを有効にするには:

ナビゲーション・メニューを開き、「開発者サービス」をクリックします。「アプリケーションの統合」で、「統合」をクリックします。
「コンパートメント」ドロップダウン・リストから、プロビジョニングするコンパートメントを選択し、Oracle Integrationインスタンスでプロセス・インスタンスを有効にします。ページがリフレッシュされ、選択したコンパートメント内の既存のサービス・インスタンスが表示されます。
既存のインスタンスを選択するか、Oracle Integrationインスタンスを作成して選択します。統合インスタンスの詳細ページが開きます。
統合インスタンス情報タブで、プロセスの「有効化」リンクをクリックします。
プロンプトが表示されたら、「有効化」をクリックして、プロセスを有効にすることを確認します。次の点に注意してください。
- Oracle Integrationアイコンがオレンジ色に変わり、そのステータスが「更新中」に変わります。
- 有効化の完了には数分かかる場合があります。
- 完了すると、つまり、プロセス・インスタンスが有効化され、Oracle Integrationインスタンスでプロビジョニングされると、Oracle Integrationアイコンが緑色に戻り、「アクティブ」ステータスになり、「プロセス」は「有効」と表示されます。
作成したプロセス・インスタンスに移動するには、「リソース」の下の「関連付けられたサービス」をクリックします。
プロセス・インスタンスを選択し、その詳細を表示します。

アクセスを管理するためのIDCSアプリケーション・ロールの割当て

プロセスを有効にすると、ServiceDeveloperロールを持つ既存のユーザーはプロセス・デザイナにアクセスでき、ServiceAdministratorロールを持つ既存のユーザーはワークスペースで管理タスクを実行できます。

プロセス・アプリケーションのエクスポートおよびインポート

Oracle Integration Generation 2からプロセス・アプリケーションをエクスポートし、Oracle Integration 3でプロセスにインポートします。

移行するアプリケーションを決定します。
この機会に、不要なアプリケーションをクリーンアップできます。本番環境にあるアプリケーションのみを移行するかどうかを検討してください。

個々のアプリケーションを移行する場合は、移行するアプリケーションとその依存関係に注意してください。
次のいずれかのメソッドを使用してアプリケーションを移行します:
- すべてのアプリケーションを一括で移行
  1. Oracle Cloudコンソールで、オブジェクト・ストレージ・バケットを作成します。「オブジェクト・ストレージ・バケットの作成」を参照してください。
    次のステップで必要になるストレージ・バケットURLの形式は次のとおりです:
    
    https://swiftobjectstorage.region.oraclecloud.com/v1/namespace/bucket
    
    説明:
    - regionは、Oracle Cloud Infrastructure (OCI)データ・センターの識別子です。
    - namespaceは、バケットを作成したテナンシです。
    - bucketはバケット名です。
  2. Oracle Integration Generation 2インスタンスにPOSTリクエストを実行して、アプリケーションをエクスポートします:
    curl -X POST https://Generation2_hostname/ic/api/process/v1/exportArtifactsInternal
    
    次のペイロードを使用:
```
{
    "jobId": "enter_a_descriptive_ID",
    "storageInfo": {
        "storageUrl": "Swift_storage_bucket_URL",
        "storageUser": "OCI_Console_user",
        "storagePassword": "OCI_Console_user_password"
    }
}
```
    バケットにprocess_status.jsonファイルが表示されたら、エクスポート・ジョブが完了したことがわかります。このファイルには、ジョブのステータス、その完了率、および失敗した場合はエラー・メッセージが含まれます。バケットに次のコンテンツも表示されます:
    - Process/project folder-すべてのプロセス・アプリケーションが含まれます。
    - Process/dmn folder-すべてのディシジョン・モデルが含まれます。
  3. アプリケーションがバケットにエクスポートされたら、Oracle Integration 3インスタンスにPOSTリクエストを行ってアプリケーションを移行します:
    curl -X POST https://Integration3_hostname/process/api/v1/oic-migration/jobs/
    
    テナントID:
    
    x-tenant-id: tenant_OCID
    
    バケット情報:
```
{
    "bucketInfo": {
        "region": "region",
        "namespace": "namespace",
        "bucket": "bucket"
    }
}
```
    Oracle Cloud Infrastructure Process Automation開発者APIのセキュリティ、認証および認可を参照してください。
  4. 移行ジョブが完了するまで待機します。移行ジョブのステータスを確認するには:
    curl http://localhost:8080/process/internal-api/v1/oic-migration/jobs/job_ID
- 個々のアプリケーションの移行
  1. Oracle Integration Generation 2プロセス・アプリケーションをエクスポートします。
    移行するアプリケーションを含むOracle Integration Generation 2インスタンスで、移行する各アプリケーションをエクスポートします。「Oracle Integration Generation 2でのプロセスの使用」の「アプリケーションのエクスポート」を参照してください。
  2. プロセス・アプリケーションをOracle Integration 3プロセスにインポートします。
    Oracle Integration 3プロセスで、Oracle Integration Generation 2プロセス・アプリケーションをインポートします。「Oracle Cloud Infrastructure Process Automationの使用」の「アプリケーションのインポート」を参照してください。
    
    Oracle Integration 3プロセスは、レガシー・プロセス・アプリケーションを最新の製品バージョンに変換します。
移行レポートを確認します。
インポートと変換が完了すると、正常にインポートされた内容、追加作業が必要な内容、および移行できなかった項目を示す移行レポートが表示されます。これにより、処理する必要がある移行の問題がわかります。

メイン・メニューで元の移行レポートを参照できます。「Oracle Cloud Infrastructure Process Automationの使用」の「アプリケーションのインポート」を参照してください。

プロセス・アプリケーションのリファクタ

検証の問題を解決するためにプロセス・アプリケーションをリファクタします。 Oracle Integration 3プロセスでアプリケーションをアクティブ化します。

インポート済プロセス・アプリケーションの検証およびアクティブ化

プロセス・アプリケーションを検証およびアクティブ化するには、次のステップを実行します:

各アプリケーションを検証し、エラーおよび警告を修正します。
をクリックし、メニューから「検証」を選択して、デザイナから各アプリケーションを検証します。

検証の問題を解決するには、「アップグレードがプロセス機能に与える影響」を参照してください。
アプリケーションをアクティブにします。
すべての検証エラーを解決したら、アプリケーションをアクティブ化できます。「Oracle Cloud Infrastructure Process Automationの使用」の「アプリケーションのアクティブ化」を参照してください。

新規アプリケーション・ロールへのユーザーおよびグループのマップ

Oracle Integration 3でアプリケーション・ロールが大幅に変更されました。 ProcessOwner、AnalyticsViewerおよびProcessReviewerロールがアプリケーションごとに明示的に定義されるようになり、そのメンバーおよび権限を制御できるようになりました。

次の表に、Oracle Integration Generation 2ロールがOracle Integration 3プロセス・ロールにどのようにマップされるかを示します。

Oracle Integration Generation 2	Oracle Integration 3プロセス
<application-name>.ProcessOwner	プロセス所有者
<application-name>.AnalyticsViewer	該当なし
<application-name>.<swim-lane>	<swim-lane>
<application-name>.ProcessReviewer	プロセス・レビューア

新しいロールは移行後に使用可能ですが、メンバー(ユーザーおよびグループ)を追加する必要があります。各ロールに割り当てるメンバーを確認するには、Oracle Integration Generation 2環境を参照する必要があります。

Oracle Integration 3プロセスが既存のOracle Integration Generation 2インスタンスと同じアイデンティティ・ドメインを共有している場合、既存のユーザーおよびグループを選択できます。

メンバーは、デザイナでアクティブ化する前に、またはワークスペースでアクティブ化した後で追加できます。

Oracle Integration 3プロセスの詳細は、Oracle Cloud Infrastructure Process Automationの使用のプロセス・アプリケーションのロールの構成を参照してください。

プロセス・アプリケーションをコールするクライアントの更新

使用方法によっては、クライアントを更新するために様々なステップを実行します。

実装に適用するステップを実行します:

統合コール・プロセス

Oracle Integration 3でプロセスをコールする統合は、新しいプロセス・アクションを使用するように更新する必要があります。これを行うには、統合の新しいメジャー・バージョンを作成し、新しいプロセス・アクションを追加して、Oracle Integration 3から開始するプロセスを参照します。レガシー・プロセス処理を削除し、統合をアクティブ化します。

プロセス別インテグレーション

Oracle Integration 3プロセスは、サービス登録を介したRESTベースの通信のみをサポートします。つまり、SOAPベースの統合への接続はできなくなります。

SOAPトリガーを使用する統合があり、これらがOracle Integration Generation 2のプロセスによってコールされる場合、Oracle Integration 3プロセスへのRESTベースのインタフェースを提示するための追加のステップを実行する必要があります。これは、次のoneを実行する必要があることを意味します:

RESTベースのラッパー統合を作成します。
または
既存のトリガーをSOAPからRESTに変更します。

移行されたプロセス・アプリケーションのすべての統合接続を確認します。接続メタデータをリフレッシュして、最新の定義がプロセス・アプリケーションに組み込まれていることを確認します。無効なデータ・マッピングを更新し、新しいバージョンでプロセスを再デプロイします。

Visual Builderアプリケーション

プロセスおよびデシジョン・アプリケーション用の開発者APIは、アップグレード後に変更されます。その結果、「非推奨の統合パターン」を置き換えて、それらと相互作用するVisual Builderアプリケーションを更新する必要があります。「Visual Builder Studioでのレスポンシブ・アプリケーションのビルド」の「ビジネス・プロセスの使用」を参照してください。

そのためには、現在のプロセス使用状況を評価する必要があります。 Visual Builderの各アプリケーションを調べ、アクション・チェーン、直接コール、または埋込み可能なプロセス・コンポーネント(CCAとも呼ばれる)を使用して、プロセス用の開発者APIをコールしているかどうかを判断します。

アプリケーションがプロセス・エンドポイントをコールしている場合は、次のステップを実行します:

Oracle Integration 3プロセスに接続します。
Oracle Integration 3プロセスへのバックエンド接続を作成します。このバックエンドは、新しいOracle Integration 3プロセス・インスタンスへの接続を確立するために使用されます。 Visual Builder Studioを使用したレスポンシブ・アプリケーションの構築のプロセス自動化のための開発者APIへの接続を参照してください。
アプリケーションの新しいバージョンを作成します。
Oracleでは、必要な変更を実装するために、Visual Builderアプリケーションの新しいバージョンを作成することをお薦めします。「Oracle Visual Builderを使用したアプリケーションの開発」の「アプリケーションのバージョンを作成する方法」を参照してください。

アクション・チェーン

アプリケーションでアクション・チェーンを使用してプロセスを開始したり、タスクに対してアクションを実行している場合は、これらをそれぞれRESTベースのサービス接続に置き換える必要があります。プロセス・アクション・チェーン・タスクごとにこれらのステップを繰り返します。

プロセスのトリガー

「プロセスの開始」アクション・チェーンをカタログ・ベースのサービス接続に置き換えます。

Oracle Integration Generation 2にナビゲートし、コールしているプロセスをノートします。これは、アクション・チェーン・プロセス・ステップから、または左側のアプリケーション・メニューの「プロセス」タブから決定できます。
新しいバージョンのVisual Builderアプリケーションで、プロセスへのカタログベースのサービス接続を作成します。「Visual Builder Studioでのレスポンシブ・アプリケーションのビルド」の「OCIプロセス自動化カタログからのサービス接続の作成」を参照してください。前に参照していたプロセスと同じプロセスを選択してください。

ノート:
プロセスはすでにアクティブ化されている必要があります。
前述のプロセスのエンドポイントに基づいてタイプを作成します。「Oracle Visual Builderを使用したアプリケーションの開発」の「エンドポイントからのタイプの作成」を参照してください。
前述のタイプに基づいて変数を作成します。「Oracle Visual Builderを使用したアプリケーションの開発」の「変数の作成」を参照してください。
アクション・チェーンにナビゲートし、次のアクションを実行します:
1. 変数の割当てアクションを現在の開始プロセス・アクションの上にドラッグします。
2. プロセスを起動するために必要なデータ・フィールドと入力パラメータをマッピングします。
3. 「コールRESTアクション」を現在の「開始プロセス・アクション」の上にドラッグします。
4. POST/Instancesエンドポイントを選択して、コールRESTアクションを構成します。
5. 前述の変数をRESTアクションのリクエスト本文にマップします。
6. レガシー開始プロセス処理を削除します。
コールをテストし、Oracle Integration 3プロセスでプロセスが正常にコールされていることを確認します。

プロセス・インスタンスのGET

「プロセス・インスタンスの取得」アクション・チェーンをカタログベースのサービス接続に置き換えます。

前述のステップに従って、プロセスへのカタログベースのサービス接続を作成した場合は、サービス接続で「プロセス・インスタンスの取得」エンドポイントが使用可能になります。

レガシーのプロセス・インスタンスの取得プロセス・アクションを、前述のエンドポイントで構成されているコールRESTアクションに置き換え、instanceIDフィールドを再マップします。

ノート:

ここでのレスポンス・ペイロードの値が変更されました。

その他のプロセス処理

「タスクの実行」や「タスクの取得」など、他のすべてのプロセス処理に対して次のステップを実行します:

Oracle Integration Generation 2にナビゲートし、使用しているプロセス・アクションをノートにとります。

これらのアクションをエンドポイント・ベースのサービス接続に置き換えます。

次の表に、これらの各アクションを対応するDeveloper API for Processにマップします。

Visual Builderアクション	開発者向けAPI	説明
タスクの実行	POST /process/api/v1/tasks/{id}/complete	承認、却下などの承認アクション。
タスクの実行	PUT /process/api/v1/tasks/{id}	タスク優先度、ペイロード、タイトルなどを更新します。
タスクの実行	PUT /process/api/v1/tasks/{id}/payload	タスク・ペイロードの更新
タスクの実行	POST /process/api/v1/tasks/{id}/claim	タスクを要求します。
タスクの実行	POST /process/api/v1/tasks/{id}/release	タスクを解放します。
タスクの実行	POST /process/api/v1/tasks/{id}/request-for-info	タスクに関する情報をリクエストします。
タスクの実行	POST /process/api/v1/tasks/{id}/submit-info	タスクに対してリクエストされた情報を送信します。
タスクの実行	POST /process/api/v1/tasks/{id}/reassign	タスクを再割当てします。
タスク・コレクションの取得	GET /process/api/v1/tasks
タスクの取得	GET /process/api/v1/tasks/{id}
デプロイ済プロセス収集の取得	GET /process/api/v1/instances
プロセス・インスタンス収集の取得	POST /process/api/v1/instances

ダイレクト・コール
プロセスおよびデシジョン・アプリケーション用の開発者APIは、アップグレード後に変更されます。そのため、直接サービス接続を更新する必要があります。 Oracle Cloud Infrastructure Process Automationの開発者APIを参照してください。

CCAコンポーネント

Oracle Integration Generation 2 Process CCAコンポーネントを使用している場合は、同等のOracle Integration 3プロセス・コンポーネントに置き換える必要があります。

Component Name	Oracle Integration Generation 2 CCA	Oracle Integration 3の同等のプロセス
Task List	oj-pcs-task-list	oj-opac-task-list
タスク詳細	oj-pcs-task-detail	oj-opac-task-detail
アプリ・リスト	oj-pcs-app-list	oj-opac-applist
開始フォーム	oj-pcs-start-form	oj-opac-start-form
DPリスト	oj-pcs-dplist	oj-opac-instance-list (構造化プロセスと動的プロセスの両方を表示)
視覚化	oj-pcs-visualization	oj-opac-analytics (ビジュアライゼーションを保存できません)

ノート:

新しいバージョンのプロセスを作成してデプロイした場合は、Visual Builderが新しいプロセスを呼び出すために別名が定義されていることを確認してください。

Oracle統合以外のクライアント

Oracle Integrationの外部からプロセス・アプリケーション(たとえば、独自のカスタム・アプリケーション)をコールする場合は、新しく構成されたOracle Integration 3プロセス・インスタンスのコールに使用されるRESTエンドポイントおよび認可ポリシーを更新する必要があります。新しいAPIエンドポイントおよびサポートされている認可ポリシーの詳細は、Oracle Cloud Infrastructure Process Automation開発者APIを参照してください。

検証

システム統合テストを実行して、作業を検証します。

新しいプロセス環境への接続をテストします。このテストでは、使用状況に基づいて次の相互作用パターンの検証に焦点を当てる必要があります:

Oracle Integration 3プロセス- Oracle Integration 3 - 統合
Oracle Integration 3 - Oracle Integration 3への統合- プロセス
Visual Builder - Oracle Integration 3プロセスに対するアプリケーション- プロセス

プロセス・アプリケーションを本番に昇格

Oracle Integration 3アセットをユーザー承認インスタンスおよび本番インスタンスに移動します。

プロセス・アプリケーション、Visual Builderアプリケーション、統合など、すべてのOracle Integration 3アセットの新しいバージョンを検証のために上位環境にデプロイする必要があります。

Oracle Integration 3プロセスへのスイッチオーバーの実行

次のステップを実行します。

クライアントの変更をアクティブ化してデプロイし、前述のようにすべての新しいシステムドリブン・リクエストがOracle Integration 3プロセスに送信されるようにします。
新しいOracle Integration 3プロセス・ワークスペースURLをユーザーと通信し、ユーザーが次のことを実行できるようにします。
- Oracle Integration 3プロセス・ワークスペースをブックマークします。
- Oracle Integration 3プロセスでのみ新規プロセスを作成します。
- Oracle Integration 3プロセスで新しいタスクを完了します。
Oracle Integration Generation 2アプリケーションをリタイアして、新規プロセスを作成できず、既存のプロセスを完了できるようにします。「Oracle Integration 2でのプロセスの使用」の「アクティブなアプリケーションの管理」を参照してください。

重要:

この時点以降、Oracle Integration 3プロセスはすべての新規リクエストを処理する必要があります。

共存期間

Oracle Integration 3プロセスが本番で新しいトランザクションの処理を開始すると、共存期間と呼ばれるものを入力する可能性があります。

この期間:

新しいプロセス・インスタンスは、Oracle Integration 3プロセスによって提供されます。
既存のプロセス・インスタンスは、完了するまでOracle Integration Generation 2プロセスで実行し続けます。

ノート:

共存期間中、ユーザーは、Oracle Integration 3プロセスとOracle Integration Generation 2の両方で割り当てられたタスクを実行する必要があります。

この期間中、プロセス・ユーザーは次を実行する必要があります。

主にOracle Integration 3プロセス・ワークスペースから作業します。
Oracle Integration Generation 2「自分のタスク」リストを確認することがあります。
Eメール内のリンクはタスクを実行するために適切な場所に移動するため、可能なかぎりEメール・ベースの承認に依存します。

共存期間は、Oracle Integration Generation 2で作成されたすべてのトランザクションが完了するまで続きます。できるだけ期間を短くするように努めるべきです。次に一部のガイドラインを示します。

除売却機能を使用して、Oracle Integration Generation 2での新規トランザクションの作成を防止します。これは、receiveアクティビティを含まないすべての構造化プロセスに適用されます。除売却機能では、新規インスタンスの作成はできませんが、既存のトランザクションを完了することもできます。「Oracle Integration 2でのプロセスの使用」の「アクティブなアプリケーションの管理」を参照してください。
Oracle Integration Generation 2インスタンスを完了まで確認するアクションをユーザーにフォローアップすることで、可能なかぎり迅速に完了できるようにします。「プロセス」、「管理」、「移行レポート」の順にナビゲートすると使用可能な新しいレポートを使用して、プロセス当たりのオープン・トランザクションの数および関連タスクの割当先を確認できます。
非常に長時間実行されるプロセスの場合、数か月以内に完了できないインスタンスについては、次のオプションを確認してください:
- Oracle Integration 3プロセスでインスタンスを再作成し、フローの変更機能を使用してペイロードを更新し、プロセス・インスタンスを現在のアクション(現在Oracle Integration Generation 2 Processにある)に移動します。これが完了すると、既存のOracle Integration Generation 2インスタンスを終了できます。「Oracle Cloud Infrastructure Process Automationの使用」の「プロセスのフローの変更」を参照してください。
- 移行されたアプリケーションを、既存のOracle Integration Generation 2プロセス・インスタンスの最新の状態を使用して開始できるように変更します。

残りのOracle Integration Generation 2プロセス・トランザクションを追跡するには、「マイ・タスク」をクリックし、Oracle Integration Generation 2インスタンスで「プロセス」を選択します。サービス管理者ロールを持つユーザーでサインインする必要があります。

Oracle Integration Generation 2プロセスの終了

サービスの中断を回避するには、2026年12月31日までにOracle Integration Generation 2プロセスを終了する予定である必要があります。 Oracle Integration Generation 2のプロセスは、2026年12月31日に廃止されます。

Oracle Integration 3でプロセスを有効にすることで、2026年12月31日より前にプロセス・アプリケーションをOracle Integration 3に移動できます。「Oracle Integration 3でのプロセスの有効化」を参照してください。プロセス・アプリケーション設計時アーティファクトのエクスポートまたはインポートの詳細は、「すべてのアプリケーションのRESTエンドポイントの移行」を参照してください。

Oracle Integration Generation 2プロセスからランタイム・データを保存します。このステップは、完了したトランザクションの履歴が失われないようにするために重要です。アップグレード「前に」これを行う必要があります。「データのアーカイブおよびパージ」を参照してください。次の点に注意してください。

アーカイブされた情報は、構成されたオブジェクト・ストレージ・バケットで使用可能になります。
添付はアーカイブ・ファイルに含まれません。これらは手動でエクスポートする必要があります。「Oracle Integration 2のREST API」の「プロセス・アタッチメントをストリームとして取得」を参照してください。