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

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

概要

Oracle Visual Builder構成で次の詳細を更新する必要があります。これらの詳細は、Oracle Blockchain Platformを構成するときに、卸売CBDCサンプル・アプリケーション用の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`
`ordsUrl`	ORDSエンドポイントURL。データベース・ビュー作成スクリプトの出力に表示されます。	`https://g53630e55ee33f4-test.xyz.abc.oraclecloudapps.com/ords/obp/cbdc/accountTrxDetails`

Visual Builderバックエンドの構成

Visual Builderのバックエンド・サービス接続は、これらのシステムへのアクセスに必要な接続情報、プロパティ、REST APIエンドポイントなど、重要な詳細を提供することで、ビジュアル・アプリケーションと外部システム間の通信を確立する方法です。Oracle Blockchain Platformと豊富な履歴データベースの詳細を使用してバックエンドを更新する必要があります。

詳細は、「バックエンドとは」を参照してください。

次のバックエンドを更新する必要があります:

RESTプロキシ・コール
登録
リッチ履歴データベース構成データベース

RESTプロキシ・コール

RESTプロキシに関連する1つのバックエンドおよび6つのサービス接続があります。これらのコンポーネントは、Oracle Blockchain Platformインスタンスに対してRESTプロキシ・コールを実行するために使用されます。

バックエンド: CentralBank
サービス接続: participantBank_FI1; participantBank_FI2; participantBank_FI3; participantBank_FI4; participantBank_FI5; participantBank_FI6

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

Visual Builderビジュアル・アプリケーションのホームページで、ナビゲータの「サービス」をクリックして「サービス」ペインを開きます。「バックエンド」をクリックして、バックエンドのリストを表示します。
更新するバックエンドを選択します。「サーバー」をクリックします。
デフォルト・サーバーの横にある「編集」アイコンをクリックします。
「サーバーの詳細」で次を更新します。
- インスタンスURL: デフォルトURL (test-xyz-abc.blockchain.ocp.oraclecloud.com)のベースURL部分を変更して、デフォルトの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の横にある「編集」アイコンをクリックします。Client IDおよびClient SecretフィールドをOracle Blockchain Platform IDおよびシークレットと一致するように更新します。
「サービス」ペインの「サービス接続」ビューでサービス接続を選択して、これらのステップを繰り返し、6人の各参加者のサービス接続を更新します。

登録

Oracle Blockchain Platformの登録に関連するバックエンドは7つあります。これらのバックエンドは、Oracle Blockchain Platformインスタンスへの登録の作成に使用されます。

バックエンド: CustomEnrollementCB; CustomEnrollementFI1; CustomEnrollementFI2; CustomEnrollementFI3; CustomEnrollementFI4; CustomEnrollementFI5; CustomEnrollementFI6

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

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

リッチ履歴データベース構成データベース

リッチ履歴データベースに関連するバックエンドが1つあります。このバックエンドは、リッチ履歴データベースからデータをフェッチするために使用されます。

バックエンド: RichHistoryDBConfiguration DB

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

Visual Builderビジュアル・アプリケーションのホームページで、ナビゲータの「サービス」をクリックして「サービス」ペインを開きます。「バックエンド」をクリックして、バックエンドのリストを表示します。
RichHistoryDBConfiguration DBバックエンドを選択します。「サーバー」をクリックします。
デフォルト・サーバーの横にある「編集」アイコンをクリックします。
「サーバーの詳細」で次を更新します。
- インスタンス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インスタンスを各銀行の適切なバックエンドに接続するのに役立ちます。たとえば、ユーザーがFI1システムにBank1の詳細を入力した場合、アプリケーションはFI1をBank1にリンクする必要があります。このようにして、Bank1に関連付けられているユーザーがログインすると、システムはFI1バックエンドからデータをプルすることを認識します。

このビジネス・オブジェクトでは、それぞれのorgNamesのBankName列およびmspId列を更新する必要があります。更新は、ネットワーク内の参加者(FI)の数に対応している必要があります。たとえば、ネットワークに2 FIs (FI1, FI2)がある場合は、これら2つのFIのBankName列およびmspId列を更新する必要があります。残りのFI (FI3, FI4, FI5, FI6)では、BankName列とmspId列をemptyのままにする必要があります。

フィールド名	説明	デフォルト値	更新が必要(はい/いいえ)	要件の更新
BankName	これは、Oracle Blockchain Platformインスタンス名とCBDCアプリケーションで使用される`BankNames`の間で使用されるマッピングです。たとえば、`CentralBank`という名前のOracle Blockchain Platformインスタンスを作成したが、アプリケーションで`BankName`を`BSP`にする場合、このマッピングによってOracle Blockchain Platformインスタンスと`BankName`の間のマッピングが作成されます。	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5`および`Bank6`	○	アクティブなFIに必須。未使用のFIには空のままにします。
mspId	この列は、実際のOracle Blockchain PlatformインスタンスのMSP IDを表します。Oracle Blockchain Platformインスタンスが次に示すデフォルト値以外の名前で作成されている場合は、これらの値を更新する必要があります。	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5`および`Bank6`	○	アクティブなFIに必須。未使用のFIには空のままにします。
OrgName	この列は、バックエンドにマップする`orgNames`を表します。`CB`はファウンダを表し、`FI#`は参加者を表します。	`CB, FI1, FI2, FI3, FI4, FI5`および`FI6`	×	---

同僚

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

たとえば、中央銀行(CB)が1つと金融機関(FI#)が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分析パッケージを構成します。詳細は、Wholesale CBDC Sample Analytics Packageを参照してください。

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 Visual Builderで許可されたオリジンとしてOracle Analytics CloudホストURLを追加します。
1. Oracle Visual Builderインスタンスにログインし、「サービス・ホームページ」をクリックします。
2. 「ナビゲーション・メニュー」をクリックし、「設定」をクリックします。「テナント設定」ページが表示されます。
3. 「許可されたオリジン」セクションで、「+新規オリジン」をクリックし、以前にコピーしたAnalytics CloudドメインURLを「オリジン・アドレス」フィールドに貼り付けます。
Visual Builderアプリケーションの構成変数を更新します。
1. アプリケーション・エディタでcbdcappアプリケーションを開き、「変数」を選択します。
2. 「グローバル変数」セクションで、構成変数オブジェクトの次のパラメータを更新します。
  
  OACHost
  
  以前にコピーしたOracle Analytics CloudインスタンスURL。
  
  OACCBDCProjectPath
  
  Analytics Cloudの中央銀行ワークブックのプロジェクト・パス。
  
  OACFIProjectPath
  
  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>
```