設定批發 CBDC 範例應用程式的 Visual Builder

設定與 Oracle Blockchain Platform 關聯的所有其他產品之後,您可以設定 Oracle Visual Builder 以連線至這些產品。

概觀

必須在 Oracle Visual Builder 組態中更新下列詳細資訊。當您設定 Oracle Blockchain Platform 時,會收到這些詳細資訊,如設定 Oracle Blockchain Platform for the Wholesale CBDC 範例應用程式中所述。

更新全域變數

  1. Visual Builder Visual Applications 首頁中,按一下「導覽器」中的 Web 應用程式,以開啟 Web 應用程式窗格。
  2. 按一下 cbdcapp 應用程式。應用程式編輯器即會開啟。
  3. 選取變數
  4. 全域變數區段中,找出 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
更新後端伺服器詳細資訊:
  1. 在 Visual Builder Visual Applications 首頁中,按一下「導覽器」中的服務以開啟「服務」窗格。按一下後端即可查看後端清單。
  2. 選取要更新的後端。按一下伺服器
  3. 按一下預設伺服器旁的「編輯」圖示。
  4. 在「伺服器詳細資訊」中更新下列項目:
    • 執行處理 URL:修改預設 URL (test-xyz-abc.blockchain.ocp.oraclecloud.com) 的基礎 URL 部分,以 Oracle Blockchain Platform 執行處理 URL 取代預設 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 IDClient Secret 欄位以符合您的 Oracle Blockchain Platform ID 和加密密碼。
  5. 重複這些步驟,透過在「服務」窗格的「服務連線檢視」中選取六位參與者的服務連線,來更新每位參與者的服務連線。

註冊

有七個與 Oracle Blockchain Platform 註冊相關的後端。這些後端是用來建立 Oracle Blockchain Platform 執行處理的註冊項目。

後端
CustomEnrollementCB
CustomEnrollementFI1
CustomEnrollementFI2
CustomEnrollementFI3
CustomEnrollementFI4
CustomEnrollementFI5
CustomEnrollementFI6
更新後端伺服器詳細資訊:
  1. 在 Visual Builder Visual Applications 首頁中,按一下「導覽器」中的服務以開啟「服務」窗格。按一下後端即可查看後端清單。
  2. 選取要更新的後端。按一下伺服器
  3. 按一下預設伺服器旁的「編輯」圖示。
  4. 在「伺服器詳細資訊」中更新下列項目:
    • 執行處理 URL:修改預設 URL (test-xyz-abc.blockchain.ocp.oraclecloud.com) 的基礎 URL 部分,以 Oracle Blockchain Platform 執行處理 URL 取代預設 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 IDClient Secret 欄位以符合您的 Oracle Blockchain Platform ID 和加密密碼。
  5. 重複這些步驟,即可在「服務」窗格的「後端檢視」中選取這六位參與者的後端來更新。

豐富歷史記錄資料庫組態資料庫

有一個後端與豐富的歷史記錄資料庫相關。此後端用於從 Rich history 資料庫擷取資料。

後端
RichHistoryDBConfiguration DB
更新後端伺服器詳細資訊:
  1. 在 Visual Builder Visual Applications 首頁中,按一下「導覽器」中的服務以開啟「服務」窗格。按一下後端即可查看後端清單。
  2. 選取 RichHistoryDBConfiguration DB 後端。按一下伺服器
  3. 按一下預設伺服器旁的「編輯」圖示。
  4. 在「伺服器詳細資訊」中更新下列項目:
    • 執行處理 URL:以 OAuth Base URL(ORDS_REST_BASE_URL/ords/<userName|aliasName>) 取代預設 URL。例如預設 URL:
      https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
      會由下列項目取代:
      https://g53630e55ee33f4-rhjkdb.adb.ap-sydney-1.oraclecloudapps.com/ords/vbcstest
    • 登入使用者的認證:「基本」用於認證。
    • 從屬端 ID 和從屬端加密密碼:按一下使用者名稱旁的「編輯」圖示。將使用者名稱更新為 Client ID,密碼更新為 Client Secret,以符合您的 ORDS 端點 ID 和密碼。

設定 Visual Builder 業務物件

業務物件是一種資源,例如商業發票或採購單,類似於資料庫表格;它具有保留您應用程式資料的欄位。與資料庫表格一樣,業務物件也提供資料的結構。業務物件儲存在資料庫中。您視覺應用程式和其他用戶端中的應用程式會透過其 REST 端點存取業務物件。

在 Visual Builder Visual Applications 首頁中,按一下「導覽器」中的商業物件,以開啟「商業物件」窗格。列示批發 CBDC 物件。
此畫面擷取顯示屬於 Visual Builder 之「業務物件」檢視中批發 CBDC 範例應用程式的業務物件完整清單。

您可以選取任何業務物件並移至其「資料」頁標,以更新或修改其資料。

組織名稱

此業務物件在「資料」頁籤中有四個欄位,可協助將 Oracle Blockchain Platform 執行處理與每個銀行的正確後端連線。例如,如果使用者在 FI1 系統中輸入 Bank1 詳細資訊,應用程式就必須將 FI1Bank1 連結。如此一來,每當與 Bank1 關聯的使用者登入時,系統就會知道要從 FI1 後端提取資料。

在此業務物件中,您必須更新個別 orgNamesBankNamemspId 資料欄。更新應與網路中的參與者人數 (FI) 相對應。例如,如果網路中有 2 FIs (FI1, FI2),您必須更新這兩個 FI 的 BankNamemspId 資料欄。對於其餘的 FI (FI3, FI4, FI5, FI6),BankNamemspId 資料欄應保留為 empty

欄位名稱 描述 預設值 需要更新 (是 / 否) 更新需求
BankName 這是 CBDC 應用程式中使用的 Oracle Blockchain Platform 執行處理名稱和 BankNames 之間的對應。

例如,如果您建立名稱為 CentralBank 的 Oracle Blockchain Platform 執行處理,但想要在應用程式中將 BankName 設為 BSP,則此對應會在 Oracle Blockchain Platform 執行處理與 BankName 之間建立對應。

CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5Bank6 作用中的金融機構所需;未使用的金融機構則保留空白。
mspId 此資料欄代表實際的 Oracle Blockchain Platform 執行處理 MSP ID。如果 Oracle Blockchain Platform 執行處理是以下列預設值以外的名稱建立,則您必須更新這些值。 CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5Bank6 作用中的金融機構所需;未使用的金融機構則保留空白。
OrgName 此資料欄代表與後端對應的 orgNamesCB 代表創始人,FI# 代表參與者。 CB, FI1, FI2, FI3, FI4, FI5FI6 編號 ---

對等

此業務物件旨在儲存網路內所有 Oracle Blockchain Platform 執行處理的同儕相關資訊。若要將對等 URL 詳細資訊輸入業務物件中,您應該在 peerURL 資料欄中輸入對應的對等 URL 值,以及它們各自的 Oracle Blockchain Platform 成員身分服務提供者 ID (mspId)。

例如,如果有一個 Central Bank (CB) 和兩個 Financial Institutions (FI#),每個都有兩個對等體,則您必須輸入總計六個對等 URL 以及其關聯的 mspId

欄位名稱 描述
orgName Oracle Blockchain Platform 執行處理 mspId
peerURL Oracle Blockchain Platform 執行處理的 peerURL 值。

附註:

此「業務介面」中所含的對等項目應新增至已建立的通用管道。

設定 Oracle Analytics Cloud for Oracle Visual Builder

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 範例分析套件

  1. 取得 Oracle Visual Builder 網域 URL。
    1. 在 OCI 主控台上,按一下開發人員服務 > Visual Builder
    2. 選取您的 Visual Builder 執行處理,然後按一下服務首頁視覺應用程式介面頁面隨即開啟。從瀏覽器的網址列複製網域名稱。

      網域名稱範例:Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com

  2. 將網域新增為 Oracle Analytics Cloud 中的安全網域。
    1. 登入您的 Oracle Analytics Cloud 執行處理、開啟 Oracle Analytics Cloud 主控台,然後按一下導覽器功能表
    2. 組態與設定值底下,按一下主控台 > 安全網域
    3. 按一下新增網域,然後貼上您先前複製的 Visual Builder 網域 URL。當您按一下顯示畫面上的其他任何位置時,會自動新增網域。
    4. 選取與您剛新增之網域關聯的允許框架內嵌核取方塊。
  3. 取得 Oracle Analytics Cloud 主機 URL。
    1. 登入您的 Oracle Analytics Cloud 執行處理。
    2. 從瀏覽器的網址列複製 Oracle Analytics Cloud 主機 URL。將完整網域名稱複製至 .com,包括 https://

      主機 URL 範例:https://<your-oac-instance>.analytics.ocp.example.com

  4. 新增 Oracle Analytics Cloud 主機 URL 作為 Oracle Visual Builder 中允許的來源。
    1. 登入您的 Oracle Visual Builder 執行處理,然後按一下服務首頁
    2. 按一下導覽功能表,然後按一下設定值。隨即顯示用戶設定值頁面。
    3. 允許的來源區段中,按一下 + 新來源,然後將先前複製的 Analytics Cloud 網域 URL 貼到來源位址欄位中。
  5. 更新 Visual Builder 應用程式中的組態變數。
    1. 在應用程式編輯器中開啟 cbdcapp 應用程式,然後選取變數
    2. 全域變數區段中,更新組態變數物件中的下列參數。
      OACHost
      您之前複製的 Oracle Analytics Cloud 執行處理 URL。
      OACCBDCProjectPath
      Analytics Cloud 中央銀行工作簿的專案路徑。
      OACFIProjectPath
      Analytics Cloud 中金融機構工作簿的專案路徑。
    3. 若要取得工作簿的專案路徑,請按一下 Analytics Cloud 首頁上的導覽器 > 目錄
    4. 按一下工作簿的動作功能表,然後選取檢查。就會顯示「檢查 (Inspect)」視窗。
    5. 按一下一般頁籤,然後按一下與物件 ID 關聯的複製
  6. 在 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>