Wholesale CBDCサンプル・アプリケーションのVisual Builderの構成

Oracle Blockchain Platformに関連付けられた他のすべての製品を構成した後、それらに接続するようにOracle Visual Builderを構成できます。

概要

次の詳細は、Oracle Visual Builder構成で更新する必要があります。これらの詳細は、「卸売CBDCサンプル・アプリケーション用のOracle Blockchain Platformの構成」の説明に従ってOracle Blockchain Platformを構成するときに取得します。

Oracle Blockchain PlatformインスタンスのRESTプロキシID、インスタンスURLおよびMSP ID。
関連項目: RestproxyIdのフェッチ
Oracle Blockchain PlatformインスタンスのクライアントIDおよびクライアント・シークレット。
関連項目: ClientIdおよびClientSecretのフェッチ
Oracle REST Data Services (ORDS)エンドポイント、クライアントID、クライアント・シークレットおよびOAuthベースURL。
関連項目: リッチ履歴データベース・ビューの作成
チャネル名およびチェーンコード名。
関連項目: 卸売CBDCサンプル・アプリケーションのチェーンコードのデプロイ

グローバル変数の更新

Visual Builderビジュアル・アプリケーションのホーム・ページで、ナビゲータで「Webアプリケーション」をクリックして「Webアプリケーション」ペインを開きます。
cbdcappアプリケーションをクリックします。アプリケーション・エディタが開きます。
「変数」を選択します。

「グローバル変数」セクションで、configuration変数オブジェクトを見つけて、オブジェクト内の次のパラメータを更新します。

パラメータ名	説明	デフォルト値
`chaincodeName`	Oracle Blockchain Platformネットワークで使用される`chaincodeName`。	`WholesaleCBDC`
`channel`	チェーンコードが配置されるチャネルの名前。	`test`
`confidentialApplication`	機密モードの場合は`true`、汎用モードの場合は`false`に設定されるブール変数。	`false`
`ordsEndpointUrls`	データベース・ビュー作成スクリプトの出力に表示される、システム所有者および参加者組織のORDSエンドポイントURLを含むオブジェクト。汎用モードでは、システム所有者エンドポイントのみを更新し、すべての参加者組織をデフォルト値のままにする必要があります。機密モードでは、すべてのエンドポイントを更新します。	詳細は、次の情報を参照してください
`restproxyId`	システム所有者および参加者組織のRESTプロキシIDを含むオブジェクト。アプリケーションモードに関係なく、すべてのIDを指定する必要があります。	詳細は、次の情報を参照してください

汎用モードのordsEndpointUrlsオブジェクトのサンプル:

"ordsEndpointUrls": {
    "SystemOwner": "https://<base_URL>/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg1": "<default_value>",
    "ParticipantOrg2": "<default_value>",
    "ParticipantOrg3": "<default_value>",
    "ParticipantOrg4": "<default_value>",
    "ParticipantOrg5": "<default_value>",
    "ParticipantOrg6": "<default_value>"
}

機密モードのordsEndpointUrlsオブジェクトのサンプル:

"ordsEndpointUrls": {
    "SystemOwner": "https://cb-centralbank.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg1": "https://bank1.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg2": "https://bank2.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg3": "https://bank3.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg4": "https://bank4.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg5": "https://bank5.example.com/ords/obp/cbdc/accountTrxDetails",
    "ParticipantOrg6": "https://bank6.example.com/ords/obp/cbdc/accountTrxDetails"
}

サンプルrestproxyIdオブジェクト(両方のモード):

"restproxyId": {
    "systemOwner": "restProxy_CentralBank",
    "participantOrg1": "restProxy_Bank1",
    "participantOrg2": "restProxy_Bank2",
    "participantOrg3": "restProxy_Bank3",
    "participantOrg4": "restProxy_Bank4",
    "participantOrg5": "restProxy_Bank5",
    "participantOrg6": "restProxy_Bank6"
}

Visual Builderバックエンドの構成

Visual Builderのバックエンド・サービス接続は、それらのシステムへのアクセスに必要な接続情報、プロパティおよびREST APIエンドポイントなどの重要な詳細を提供することで、ビジュアル・アプリケーションと外部システム間の通信を確立する方法です。

詳細は、バックエンドの概要を参照してください。

次のステップを実行して、Oracle Blockchain Platformのインタラクションと豊富な履歴データベース・インタラクションの両方にVisual Builderバックエンドを構成します。

Oracle Blockchain Platformインタラクションのバックエンド構成

卸売CBDCアプリケーションでは、Visual Builderバックエンドを使用して、Oracle Blockchain Platformとの相互作用を管理します。

システム所有者: SystemOwnerMgmt: システム所有者のOracle Blockchain Platformインタラクションおよび登録作成を処理します。; SystemOwnerRestproxyConfiguration: システム所有者のRESTプロキシ・コールを処理する専用バックエンド。
関係者組織: ParticipantOrg1Mgmt: 参加者組織1に対するOracle Blockchain Platformの相互作用、登録作成およびRESTプロキシ・コールを処理します。; ParticipantOrg2Mgmt: 参加者組織2に対するOracle Blockchain Platformの相互作用、登録作成およびRESTプロキシ・コールを処理します。; ParticipantOrg3Mgmt: 参加者組織3に対するOracle Blockchain Platformの相互作用、登録作成およびRESTプロキシ・コールを処理します。; ParticipantOrg4Mgmt: 参加者組織4に対するOracle Blockchain Platformの相互作用、登録作成およびRESTプロキシ・コールを処理します。; ParticipantOrg5Mgmt: 参加者組織5に対するOracle Blockchain Platformの相互作用、登録作成およびRESTプロキシ・コールを処理します。; ParticipantOrg6Mgmt: 参加者組織6に対するOracle Blockchain Platformの相互作用、登録作成およびRESTプロキシ・コールを処理します。

バックエンド・サーバーの詳細を更新するには:

Visual Builder Visual Applicationsホーム・ページで、ナビゲータの「サービス」をクリックして、「サービス」ペインを開きます。「バックエンド」をクリックして、バックエンドのリストを表示します。
更新するバックエンドを選択します。「サーバー」をクリックします。
デフォルト・サーバーの横にある「編集」アイコンをクリックします。
SystemOwnerRestproxyConfigurationバックエンドの場合のみ、「サーバー詳細」ウィンドウで次を更新します:
- インスタンスURL: デフォルトURLのベースURL部分(test-xyz-abc.blockchain.ocp.oraclecloud.com)を変更して、デフォルトURLをOracle Blockchain PlatformインスタンスURLに置き換えます。たとえば:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy/api/v2/channels/{channelName}
```
- サーバー変数: チェーンコードがデプロイされているチャネルの名前を反映するようにchannelNameを変更します。
- ログイン・ユーザーの認証: OAuth 2.0ユーザー・アサーションが認証に使用されます。Oracle Blockchain Platform RESTプロキシURLと一致するようにURLを変更します。たとえば:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- クライアントIDおよびクライアント・シークレット: ClientIDの横にある「編集」アイコンをクリックします。Oracle Blockchain Platform IDおよびシークレットと一致するように、Client IDおよびClient Secretフィールドを更新します。
その他のすべてのバックエンドについて、「サーバー詳細」ウィンドウで次を更新します:
- インスタンスURL: デフォルトURLのベースURL部分(test-xyz-abc.blockchain.ocp.oraclecloud.com)を変更して、デフォルトURLをOracle Blockchain PlatformインスタンスURLに置き換えます。たとえば:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443
```
- ログイン・ユーザーの認証: OAuth 2.0ユーザー・アサーションが認証に使用されます。Oracle Blockchain Platform RESTプロキシURLと一致するようにURLを変更します。たとえば:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- クライアントIDおよびクライアント・シークレット: ClientIDの横にある「編集」アイコンをクリックします。Oracle Blockchain Platform IDおよびシークレットと一致するように、Client IDおよびClient Secretフィールドを更新します。
すべてのバックエンドを更新するには、これらのステップを繰り返します。

リッチ履歴データベース相互作用のバックエンド構成

各組織には、リッチ履歴データベースへのアクセスを管理する専用のバックエンドがあります。

バックエンド: SystemOwnerRichHistoryDBConfiguration; ParticipantOrg1RichHistoryDBConfiguration; ParticipantOrg2RichHistoryDBConfiguration; ParticipantOrg3RichHistoryDBConfiguration; ParticipantOrg4RichHistoryDBConfiguration; ParticipantOrg5RichHistoryDBConfiguration; ParticipantOrg6RichHistoryDBConfiguration

汎用モードでは、SystemOwnerRichHistoryDBConfigurationバックエンドのみを更新します。機密モードでは、デプロイメントで使用されているすべての参加者組織のシステム所有者バックエンドおよびバックエンドを更新する必要があります。

バックエンド・サーバーの詳細を更新するには:

Visual Builder Visual Applicationsホーム・ページで、ナビゲータの「サービス」をクリックして、「サービス」ペインを開きます。「バックエンド」をクリックして、バックエンドのリストを表示します。
適切なバックエンドを選択します。「サーバー」をクリックします。
デフォルト・サーバーの横にある「編集」アイコンをクリックします。
「サーバーの詳細」セクションで、次を更新します。
- インスタンスURL: デフォルトのURLをOAuth Base URL(ORDS_REST_BASE_URL/ords/<userName|aliasName>)に置き換えます。たとえば、デフォルトのURLは次のようになります。
```
https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
```
  これは次の文で置換されます。
```
https://g53630e55ee33f4-rhjkdb.adb.ap-sydney-1.oraclecloudapps.com/ords/vbcstest
```
- ログイン・ユーザーの認証: 認証にはBasicが使用されます。
- クライアントIDおよびクライアント・シークレット: 「ユーザー名」の横にある「編集」アイコンをクリックします。ORDSエンドポイントIDおよびシークレットと一致するように、ユーザー名をClient IDで更新し、パスワードをClient Secretで更新します。

Visual Builderビジネス・オブジェクトの構成

ビジネス・オブジェクトは、請求書や購買オーダーなどのリソースで、データベース表に似ています。ビジネス・オブジェクトには、アプリケーションのデータを保持するフィールドがあります。データベース表と同様に、ビジネス・オブジェクトはデータの構造を提供します。ビジネス・オブジェクトはデータベースに格納されます。ビジュアル・アプリケーションや他のクライアントのアプリは、RESTエンドポイント経由でビジネス・オブジェクトにアクセスします。

Visual Builderビジュアル・アプリケーションのホームページで、ナビゲータの「ビジネス・オブジェクト」をクリックして「ビジネス・オブジェクト」ペインを開きます。卸売CBDCオブジェクトがリストされます。
Visual Builderの「ビジネス・オブジェクト」ビューで、卸売CBDCサンプル・アプリケーションに属するビジネス・オブジェクトの完全なリストを示すスクリーン・キャプチャ。

任意のビジネス・オブジェクトを選択し、その「データ」タブに移動して、そのデータを更新または変更できます。

組織名称

このビジネス・オブジェクトには、「データ」ページに4つのフィールドがあり、Oracle Blockchain Platformインスタンスを各銀行の正しいバックエンドに接続するために使用されます。たとえば、ユーザーがParticipantOrg1システムにBank1の詳細を入力した場合、アプリケーションはParticipantOrg1をBank1にリンクする必要があります。このようにして、Bank1に関連付けられたユーザーがログインするたびに、システムはParticipantOrg1バックエンドからデータをプルすることを認識します。

このビジネス・オブジェクトで、それぞれのorgName値のBankNameおよびmspId列を更新します。更新は、ネットワーク内の参加者組織の数に対応している必要があります。たとえば、ネットワークに2つの参加者組織がある場合は、これら2つの組織のBankName列とmspId列を更新する必要があります。残りの参加者組織(ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6)では、BankName列およびmspId列をempty値に設定したままにします。

フィールド名	説明	デフォルト値	更新が必要(Yes/No)	要件の更新
BankName	Oracle Blockchain Platformインスタンス名とCBDCアプリケーションで使用される銀行名の間で使用されるマッピング。たとえば、`CentralBank`という名前のOracle Blockchain Platformインスタンスを作成したが、アプリケーションで`BankName`値を`BSP`にする場合、このマッピングによって、Oracle Blockchain Platformインスタンスと`BSP`の間のマッピングが作成されます。	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6`	○	アクティブな参加者組織の場合は必須で、未使用の参加者組織の場合は空のままにします。
mspId	この列は、実際のOracle Blockchain PlatformインスタンスMSP IDを表します。Oracle Blockchain Platformインスタンスがデフォルト値以外の名前で作成されている場合は、これらの値を更新する必要があります。	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6`	○	アクティブな参加者組織の場合は必須で、未使用の参加者組織の場合は空のままにします。
OrgName	この列は、バックエンドにマップされる`orgName`値を表します。`SystemOwner`はファウンダを表し、`ParticipantOrg#`は参加者を表します。	`SystemOwner,ParticipantOrg1,ParticipantOrg2, ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6`	×	N/A

同僚

このビジネス・オブジェクトは、ネットワーク内のすべてのOracle Blockchain Platformインスタンスにピアに関する情報を格納するように設計されています。ピアURLの詳細をビジネス・オブジェクトに入力するには、対応するピアURL値をpeerURL列とそれぞれのOracle Blockchain Platformメンバーシップ・サービス・プロバイダID (mspId)に入力します。

たとえば、中央銀行が1つと金融機関が2つあり、それぞれにピアが2つある場合は、関連するmspId値とともに合計6つのピアURLを入力する必要があります。

フィールド名	説明
orgName	Oracle Blockchain Platformインスタンス`mspId`。
peerURL	Oracle Blockchain Platformインスタンスの`peerURL`値。

ノート:

このビジネス・インタフェースに含まれるピアは、作成された共通チャネルに追加する必要があります。

Oracle Visual Builder用のOracle Analytics Cloudの構成

Oracle Analytics CloudインスタンスとOracle Visual Builderインスタンスは、同じOCIテナンシに存在する必要があります。

Oracle Analytics CloudインスタンスとOracle Visual Builderインスタンスも、アイデンティティ管理に同じOracle Identity Cloud Serviceを使用する必要があります。Oracle Visual Builderアプリケーションにアクセスするユーザーは、Oracle Analytics CloudとOracle Visual Builderの両方に必要な権限を持っている必要があります。

次のステップを完了する前に、卸売CBDC分析パッケージを構成します。詳細は、「卸売CBDCサンプル分析パッケージ」を参照してください。

Oracle Visual BuilderドメインのURLを取得します。
1. OCIコンソールで、「開発者サービス」→「ビジュアル・ビルダー」をクリックします。
2. Visual Builderインスタンスを選択し、「サービス・ホームページ」をクリックします。「ビジュアル・アプリケーション」インタフェース・ページが開きます。ブラウザのアドレス・バーからドメイン名をコピーします。
  ドメイン名の例: Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com
Oracle Analytics Cloudでドメインを安全なドメインとして追加します。
1. Oracle Analytics Cloudインスタンスにログインし、Oracle Analytics Cloudコンソールを開き、「ナビゲータ・メニュー」をクリックします。
2. 「構成および設定」で、「コンソール」→「安全ドメイン」をクリックします。
3. 「ドメインの追加」をクリックし、以前にコピーしたVisual BuilderドメインURLを貼り付けます。表示上の他の場所をクリックすると、ドメインが自動的に追加されます。
4. 追加したドメインに関連付けられている「フレームの許可」および「埋込み」チェック・ボックスを選択します。
Oracle Analytics CloudのホストURLを取得します。
1. Oracle Analytics Cloudインスタンスにログインします。
2. ブラウザのアドレス・バーからOracle Analytics CloudホストURLをコピーします。.comまでの完全修飾ドメイン名(https://を含む)をコピーします。
  ホストURLの例: https://<your-oac-instance>.analytics.ocp.example.com
Oracle Analytics CloudのホストURLを許可されたオリジンとしてOracle Visual Builderに追加します。
1. Oracle Visual Builderインスタンスにログインし、「サービス・ホームページ」をクリックします。
2. 「ナビゲーション・メニュー」をクリックし、「設定」をクリックします。「テナント設定」ページが表示されます。
3. 「許可されるオリジン」セクションで、「+新規オリジン」をクリックし、以前にコピーしたAnalytics CloudドメインURLを「オリジン・アドレス」フィールドに貼り付けます。
Visual Builderアプリケーションの構成変数を更新します。
1. アプリケーション・エディタでcbdcappアプリケーションを開き、「変数」を選択します。
2. 「グローバル変数」セクションで、構成変数オブジェクトの次のパラメータを更新します。
  
  OACHost
  
  以前にコピーしたOracle Analytics CloudインスタンスURL。
  
  OACSystemOwnerProjectPath
  
  Analytics Cloudのシステム所有者ワークブックのプロジェクト・パス。
  
  OACParticipantOrgProjectPath
  
  Analytics Cloudでの参加者組織ワークブックのプロジェクト・パス。
3. ワークブックのプロジェクト・パスを取得するには、Analytics Cloudホーム・ページで「ナビゲータ」→「カタログ」をクリックします。
4. ワークブックの「アクション」メニューをクリックし、「検査」を選択します。「検査」ウィンドウが表示されます。
5. 「一般」タブをクリックし、「オブジェクトID」に関連付けられている「コピー」をクリックします。
Visual BuilderでHTMLを編集します。
1. アプリケーション・エディタでcbdcappアプリケーションを開き、「HTML」セクションに移動します。
2. 次のコード・スニペットに示すように、行30および31のAnalytics CloudホストURLをAnalytics Cloudインスタンスと一致するように更新します。URLのサブディレクトリ構造は変更しないでください。.comまでのドメイン部分のみが変更されます。
```
<script src="https://abc-xyz-ia.analytics.ocp.example.com/public/dv/v1/embedding/jet/embedding.js" type="application/javascript"></script>
```