Integration between ABCS and PCS

注)ABCSとは現在のVBCS、Visual Builder Cloud Serviceです。

ちょっと前に以下のような記事が上がっていました。

Automating Processes With Application Builder and Process Cloud Services
https://blogs.oracle.com/shay/automating-processes-with-application-builder-and-process-cloud-services

エントリ内で紹介されている動画を見ると、ちょっとしたお作法を理解すれば簡単に連携できることがわかりますが、一部事前構成が抜けていたので、そのあたりを含め、実際の流れを備忘録として残しておきます。

動作確認したバージョンは、Process Cloud Service (PCS) は17.2.3、Application Builder Cloud Service (ABCS) は17.2.5 です。

ABCSとPCS間の連携はPCS、ABCSとも17.2.3から利用できるようになりました。

実際の業務で使いたいという場合は、同一アイデンティティドメインでABCSとPCSをプロビジョニングする必要があります。

この操作の詳細は、ABCSのドキュメントに記載されています。PCSのドキュメントには記載がありませんので、ご注意ください。

Oracle® Cloud Using Oracle Application Builder Cloud Service
Creating Processes for Business Objects
http://docs.oracle.com/en/cloud/paas/app-builder-cloud/csapb/creating-processes-business-objects.html#GUID-901AA6E3-3545-4D6C-9048-B3A9A1D975AE

1. ABCSからPCSへの接続設定

まず、事前にABCSのインスタンスでPCSとの連携を設定しておく必要があります。この部分は動画では抜けていました。この設定をしないと、ABCSからPCSプロセスアプリケーションを作成することができません。

設定手順は以下の通りです。

  1. Homeの右端にあるアイコンをクリックし、Administer Application Builderを選択
    Administer Application Builder
  2. Administration optionsでAssociated Service Instancesタブを開き、PCSのURLを指定
    Associated Service Instances
  3. Allowed Originsで、先ほど指定したPCSのURLを指定し、チェックマークをクリックして登録し、Closeをクリックしてダイアログを閉じる
    CORS Configuration

ドキュメントでの記述は以下の場所にあります。

Oracle® Cloud Administrator’s Guide for Oracle Application Builder Cloud Service
Add a Connection to Process Cloud Service
http://docs.oracle.com/en/cloud/paas/app-builder-cloud/abcag/administrative-tasks1.html#GUID-6A3FAB15-F93B-4717-B1C8-AB3580D315D2

2. ABCSアプリケーションの作成

設定が終われば、ABCSでアプリケーションを作成していきます。ビジネスオブジェクトを作成し、当該ビジネスオブジェクトに対してPCSプロセスを紐付けます。このタイミングで、PCSに新規スペースならびに新規PCSアプリケーションが作成されます。PCSとABCS間はREST APIを呼び合うかたちで連携するため、基本認証を使ったABCSのREST API呼び出しを許可する必要があります。

ABCSのBusiness Object(以下BO)にPCSプロセスを紐付けるには以下のように設定します。

  1. Data Designer > Business Objects でPCSプロセスと紐付けたいBOを選択し、Processタブを開く
    BO-Procss_1
  2. New Processをクリック
  3. プロセス名を指定し、Createをクリック(Descriptionは任意)
    BO-Procss_2
  4. 右上に現れるSaveをクリックすると、テンプレートを使いPCSアプリケーションがPCS内に作成されます。PCS Process Composerで確認することができます。
    BO-Procss_3
  5. PCSからBasic認証を使ったABCS REST APIの呼び出しを許可するため、Application Settings > Securityに移動する
    ABCS Security_1
  6. Enable basic authentication for business objeect REST APIsにチェックを入れる
    ABCS Security_2

3. PCSアプリケーション(プロセス)の編集

PCSアプリケーションでPCSのプロセスを編集していきます。2. で作成したPCSアプリケーションに手をいれていきますが、これは通常のPCSプロセスの作成と変わりがないので、詳細は省略します。

作成済みのPCSプロセスは、ABCSのREST APIを呼び出しています(厳密には、作成しているABCSアプリケーションにアクセスするためのREST APIを呼び出しています)。このAPI呼び出しに必要な設定を追加しておきます。

  1. 統合(Integration)をクリックし、ABCSConnectorをクリック
    PCS_Integration_1
  2. URLの構成を変更するため、[編集]をクリック
    PCS_Integration_2
  3. 認証方式を設定(初期状態では認証なし)し、[適用]をクリック。実際に使えるのはBasic認証のみ。
    PCS_Integration_3

ここまで終了したら、公開(Publish) しておきましょう。デプロイはこのタイミングで実施しても結構ですし、後でABCSから実施することもできます。

4. ABCS UIでのPCSプロセスの起動

PCSプロセスを起動するために、ABCSのUIにボタンを貼り付け、アクションを指定します。

  1. プロセスを開始したいUIにボタンを貼り付ける
  2. ボタンのプロパティウィンドウで、アクションを選択し、Add Actionをクリック
    Action_1
  3. Add Custom Actionをクリック
    Action_2
  4. アクション・パレットからStart a Processをドラッグ&ドロップし、起動したいプロセスを選択する
    Action_3

5. PCSのタスク取得設定

ABCSからPCSのタスクを取得できるように設定しておきます。

  1. ABCSのUIコンポーネントの一つ、タスクリスト・コンポーネント(左)を貼り付ける
    TaskUIComponent
  2. ウィザードの中で、確認対象のデータ(BO)を決める
  3. 当該BOのUIに、タスクアクションコンポーネントを貼り付ける(上図の右のコンポーネント)

6. PCSアプリケーションのデプロイ

ABCSのBO>ProcessタブにあるDeploy Allをクリックし、デプロイします。これはPCSアプリケーションをテストモードでデプロイします。もちろん、通常通り、PCS Process Composerで[テスト]をクリックしてテストモードにデプロイすることもできます。

7. テスト

ABCSのPage Builderにあるテストボタンをクリックすると、PCSのテストモードと連携してテストすることができます。PCS Process Workspaceのインスタンストラッキングを使って、正しく動作しているか確認します。以下のQuery Parameterを付けることでPCS Process Workspaceをテストモードで表示することができます。

https://{PCS Service Instance}-{Identity Domain}.process.{Data Center ID}.oraclecloud.com/bpm/workspace?mode=test

8. Staging

ABCSアプリケーションをStagingとは、本番環境で使うためのデプロイに相当します。この場合、PCSもテストモードではなく本番モード(つまりPCS Workspaceでmode=testを付けない)で動作するため、事前にPCS Process Workspaceで各ロールにユーザーもしくはグループを割り付けておく必要があります。

anishi1222 について

とあるキャラクターの中の人です。
カテゴリー: Cloud, 未分類 タグ: , , パーマリンク

コメントを残す

以下に詳細を記入するか、アイコンをクリックしてログインしてください。

WordPress.com ロゴ

WordPress.com アカウントを使ってコメントしています。 ログアウト / 変更 )

Twitter 画像

Twitter アカウントを使ってコメントしています。 ログアウト / 変更 )

Facebook の写真

Facebook アカウントを使ってコメントしています。 ログアウト / 変更 )

Google+ フォト

Google+ アカウントを使ってコメントしています。 ログアウト / 変更 )

%s と連携中