为批发 CBDC 示例应用程序配置 Visual Builder

配置与 Oracle Blockchain Platform 关联的所有其他产品后，可以配置 Oracle Visual Builder 以连接到这些产品。

概述

必须在 Oracle Visual Builder 配置中更新以下详细信息。如 Configure Oracle Blockchain Platform for the Wholesale CBDC Sample Application 中所述，在配置 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 代理相关的服务连接。这些组件用于对 Oracle Blockchain Platform 实例进行 REST 代理调用。

后端: CentralBank
服务连接: participantBank_FI1; participantBank_FI2; participantBank_FI3; participantBank_FI4; participantBank_FI5; participantBank_FI6

要更新后端服务器详细信息，请执行以下操作：

在“Visual Builder 可视应用程序”主页上，单击导航器中的服务以打开“服务”窗格。单击后端可查看后端列表。
选择要更新的后端。单击服务器。
单击默认服务器旁边的 "Edit"（编辑）图标。
更新服务器详细信息中的以下内容：
- 实例 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 用户断言用于验证。修改 URL 以与 Oracle Blockchain Platform REST 代理 URL 匹配。例如：
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- 客户机 ID 和客户机密钥：单击 ClientID 旁边的“编辑”图标。更新 Client ID 和 Client Secret 字段以匹配您的 Oracle Blockchain Platform ID 和密钥。
重复这些步骤以更新六个参与者的服务连接，方法是在“服务”窗格的“服务连接视图”中选择这些连接。

有七个与 Oracle Blockchain Platform 注册相关的后端。这些后端用于创建 Oracle Blockchain Platform 实例的注册。

后端: CustomEnrollementCB; CustomEnrollementFI1; CustomEnrollementFI2; CustomEnrollementFI3; CustomEnrollementFI4; CustomEnrollementFI5; CustomEnrollementFI6

要更新后端服务器详细信息，请执行以下操作：

在“Visual Builder 可视应用程序”主页上，单击导航器中的服务以打开“服务”窗格。单击后端可查看后端列表。
选择要更新的后端。单击服务器。
单击默认服务器旁边的 "Edit"（编辑）图标。
更新服务器详细信息中的以下内容：
- 实例 URL：通过修改默认 URL 的基本 URL 部分 (test-xyz-abc.blockchain.ocp.oraclecloud.com)，将默认 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 用户断言用于验证。修改 URL 以与 Oracle Blockchain Platform REST 代理 URL 匹配。例如：
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- 客户机 ID 和客户机密钥：单击 ClientID 旁边的“编辑”图标。更新 Client ID 和 Client Secret 字段以匹配您的 Oracle Blockchain Platform ID 和密钥。
重复这些步骤，通过在“服务”窗格的“后端视图”中选择后端来更新六个参与者的每个后端。

丰富的历史记录数据库配置数据库

有一个与富历史记录数据库相关的后端。此后端用于从富历史记录数据库提取数据。

后端: RichHistoryDBConfiguration DB

要更新后端服务器详细信息，请执行以下操作：

在“Visual Builder 可视应用程序”主页上，单击导航器中的服务以打开“服务”窗格。单击后端可查看后端列表。
选择 RichHistoryDBConfiguration DB 后端。单击服务器。
单击默认服务器旁边的 "Edit"（编辑）图标。
更新服务器详细信息中的以下内容：
- 实例 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 和客户端密钥：单击用户名旁边的“编辑”图标。使用 Client ID 更新用户名，使用 Client Secret 更新密码，以匹配 ORDS 端点 ID 和密钥。

配置 Visual Builder 业务对象

业务对象是一种资源，如发票或采购订单，类似于数据库表；它具有用于保存应用程序数据的字段。与数据库表一样，业务对象为数据提供结构。业务对象存储在数据库中。可视应用和其他客户端中的应用通过其 REST 端点访问业务对象。

在“Visual Builder 可视应用程序”主页上，单击导航器中的业务对象以打开“业务对象”窗格。应列出批发 CBDC 对象。
屏幕抓图中显示了属于批发 CBDC 示例应用程序的业务对象的完整列表，该应用程序位于 Visual Builder 的“业务对象”视图中。

您可以选择任何业务对象并转至其“数据”选项卡以更新或修改其数据。

组织名称

此业务对象在“数据”选项卡中有四个字段，可帮助将 Oracle Blockchain Platform 实例与每家银行的右后端连接起来。例如，如果用户在 FI1 系统中输入 Bank1 详细信息，则应用程序需要将 FI1 与 Bank1 链接。这样，只要与 Bank1 关联的用户登录，系统就会知道从 FI1 后端提取数据。

在此业务对象中，需要更新相应 orgNames 的 BankName 和 mspId 列。更新应与网络中的参与者数 (FI) 相对应。例如，如果网络中有 2 FIs (FI1, FI2)，则必须更新这两个 FI 的 BankName 和 mspId 列。对于剩余的 FI (FI3, FI4, FI5, FI6)，BankName 和 mspId 列应保留 empty。

字段名称	说明	默认值	需要更新（是/否）	更新需求
银行名称	这是 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 详细信息输入业务对象，应在 peerURL 列中输入对应的对等 URL 值及其各自的 Oracle Blockchain Platform 成员资格服务提供商 ID (mspId)。

例如，如果有一个中央银行 (CB) 和两个金融机构 (FI#)，每个金融机构都有两个对等点，则必须输入总共六个对等 URL 及其关联的 mspId。

字段名称	说明
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 控制台上，单击开发人员服务 > Visual Builder 。
2. 选择您的 Visual Builder 实例，然后单击服务主页。此时将打开 Visual Applications（可视应用程序）界面页面。从浏览器的地址栏复制域名。
  域名示例：Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com
将域添加为 Oracle Analytics Cloud 中的安全域。
1. 登录到 Oracle Analytics Cloud 实例，打开 Oracle Analytics Cloud 控制台，然后单击导航器菜单。
2. 在 Configuration and Settings 下，单击 Console（控制台） > Safe Domains（安全域）。
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. 单击导航菜单，然后单击设置。此时将显示 Tenant Settings（租户设置）页面。
3. 在允许的源部分中，单击 + 新源，然后将之前复制的 Analytics Cloud 域 URL 粘贴到源地址字段中。
更新 Visual Builder 应用程序中的配置变量。
1. 在应用程序编辑器中打开 cbdcapp 应用程序，然后选择变量。
2. 在全局变量部分中，更新 configuration variable 对象中的以下参数。
  
  OACHost
  
  以前复制的 Oracle Analytics Cloud 实例 URL。
  
  OACCBDCProjectPath
  
  Analytics Cloud 中央银行工作簿的项目路径。
  
  OACFIProjectPath
  
  Analytics Cloud 中金融机构工作簿的项目路径。
3. 要获取工作簿的项目路径，请单击“分析云”主页上的导航器 > 目录。
4. 单击工作簿的操作菜单，然后选择检查。此时将显示 "Inspect"（检查）窗口。
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>
```