設定批發 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
    channel 部署鏈碼的通道名稱。 test
    confidentialApplication 將機密模式的布林值變數設為 true,一般模式則設為 false false
    ordsEndpointUrls 包含系統擁有者與參與者組織之 ORDS 端點 URL 的物件,這些端點 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 Interactions 的後端組態

Wholesale 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 代理主機呼叫。
更新後端伺服器詳細資訊:
  1. 在 Visual Builder Visual Applications 首頁中,按一下導覽器中的服務以開啟服務窗格。按一下後端即可查看後端清單。
  2. 選取要更新的後端。按一下伺服器
  3. 按一下預設伺服器旁邊的編輯圖示。
  4. 僅限 SystemOwnerRestproxyConfiguration 後端,請在伺服器詳細資訊視窗中更新下列項目:
    • 執行處理 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. 對於所有其他後端,請在伺服器詳細資訊視窗中更新下列內容:
    • 執行處理 URL:修改預設 URL (test-xyz-abc.blockchain.ocp.oraclecloud.com) 的基礎 URL 部分,以 Oracle Blockchain Platform 執行處理 URL 取代預設 URL。舉例而言:
      https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443
    • 已登入使用者的認證: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 和加密密碼。
  6. 重複這些步驟以更新所有後端。

Rich History 資料庫互動的後端組態

每個組織都有一個專用的後端介面,用於管理 Rich History 資料庫的存取權。

後端
SystemOwnerRichHistoryDBConfiguration
ParticipantOrg1RichHistoryDBConfiguration
ParticipantOrg2RichHistoryDBConfiguration
ParticipantOrg3RichHistoryDBConfiguration
ParticipantOrg4RichHistoryDBConfiguration
ParticipantOrg5RichHistoryDBConfiguration
ParticipantOrg6RichHistoryDBConfiguration

在一般模式中,您只會更新 SystemOwnerRichHistoryDBConfiguration 後端。在機密模式中,您必須更新部署中使用之所有參與者組織的系統擁有者後端和後端。

更新後端伺服器詳細資訊:
  1. 在 Visual Builder Visual Applications 首頁中,按一下導覽器中的服務以開啟服務窗格。按一下後端即可查看後端清單。
  2. 選取適當的後端。按一下伺服器
  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 執行處理與每個銀行的正確後端連線。例如,如果使用者在 ParticipantOrg1 系統中輸入 Bank1 詳細資訊,則應用程式必須將 ParticipantOrg1Bank1 連結。如此一來,每當與 Bank1 相關聯的使用者登入時,系統都知道要從 ParticipantOrg1 後端提取資料。

在此業務物件中,更新個別 orgName 值的 BankNamemspId 資料欄。更新必須對應至網路中的參與者組織數。例如,如果網路中有兩個參與者組織,您必須更新這兩個組織的 BankNamemspId 資料欄。對於其餘的參與者組織 (ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6),請將 BankNamemspId 資料欄設為 empty 值。

欄位名稱 描述 預設值 需要更新 (是 / 否) 更新需求
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 編號

對等

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

例如,如果有一個中央銀行和兩個金融機構,每個機構都有兩個同儕,則總共必須輸入六個同儕 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。
      OACSystemOwnerProjectPath
      Analytics Cloud 中系統擁有者工作簿的專案路徑。
      OACParticipantOrgProjectPath
      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>