1. Oracle Blockchain Platform 디지털 자산 에디션
  2. Wholesale Central Bank 디지털 통화 애플리케이션
  3. 도매 CBDC 샘플 애플리케이션 및 분석 패키지
  4. 도매 CBDC 샘플 애플리케이션
  5. 도매 CBDC 샘플 애플리케이션에 대한 Visual Builder 구성

도매 CBDC 샘플 애플리케이션에 대한 Visual Builder 구성

Oracle Blockchain Platform과 연관된 다른 모든 제품을 구성한 후 Oracle Visual Builder를 구성하여 연결할 수 있습니다.

개요

Oracle Visual Builder 구성에서 다음 세부정보를 업데이트해야 합니다. Oracle Blockchain Platform을 구성할 때 Configure Oracle Blockchain Platform for the Wholesale CBDC Sample Application에 설명된 대로 이러한 세부정보가 제공됩니다.

전역 변수 업데이트

  1. Visual Builder 시각적 애플리케이션 홈 페이지의 네비게이터에서 웹 애플리케이션을 눌러 웹 앱 창을 엽니다.
  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 프록시와 관련된 백엔드 및 서비스 연결은 1개입니다. 이러한 구성요소는 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. Server Details(서버 세부정보)에서 다음을 업데이트합니다.
    • 인스턴스 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 옆에 있는 Edit(편집) 아이콘을 누릅니다. Oracle Blockchain Platform ID 및 암호와 일치하도록 Client ID 및 Client Secret 필드를 업데이트합니다.
  5. 이러한 단계를 반복하여 서비스 창의 서비스 연결 뷰에서 6명의 각 참가자의 서비스 연결을 선택하여 업데이트합니다.

등록

Oracle Blockchain Platform 등록과 관련된 7개의 백엔드가 있습니다. 이러한 백엔드는 Oracle Blockchain Platform 인스턴스에 대한 등록을 생성하는 데 사용됩니다.

백엔드
CustomEnrollementCB
CustomEnrollementFI1
CustomEnrollementFI2
CustomEnrollementFI3
CustomEnrollementFI4
CustomEnrollementFI5
CustomEnrollementFI6
백엔드 서버 세부정보를 업데이트하려면 다음과 같이 하십시오.
  1. Visual Builder Visual Applications 홈 페이지의 네비게이터에서 서비스를 눌러 [서비스] 창을 엽니다. 백엔드를 눌러 백엔드 목록을 봅니다.
  2. 업데이트할 백엔드를 선택합니다. 서버를 누릅니다.
  3. 기본 서버 옆의 편집 아이콘을 누릅니다.
  4. Server Details(서버 세부정보)에서 다음을 업데이트합니다.
    • 인스턴스 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
    • 서버 변수: Oracle Blockchain Platform 인스턴스에 대한 실제 REST 프록시 ID를 반영하도록 restProxyId를 변경합니다.
    • 로그인한 사용자에 대한 인증: OAuth 2.0 사용자 검증이 인증에 사용됩니다. Oracle Blockchain Platform REST 프록시 URL과 일치하도록 URL을 수정합니다. 예:
      https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
    • 클라이언트 ID 및 클라이언트 암호: ClientID 옆에 있는 Edit(편집) 아이콘을 누릅니다. Oracle Blockchain Platform ID 및 암호와 일치하도록 Client ID 및 Client Secret 필드를 업데이트합니다.
  5. 이러한 단계를 반복하여 [서비스] 창의 [백엔드 뷰]에서 6명의 참가자 각각을 선택하여 백엔드를 업데이트합니다.

풍부한 내역 데이터베이스 구성 데이터베이스

리치 기록 데이터베이스와 관련된 하나의 백엔드가 있습니다. 이 백엔드는 리치 내역 데이터베이스에서 데이터를 인출하는 데 사용됩니다.

백엔드
RichHistoryDBConfiguration DB
백엔드 서버 세부정보를 업데이트하려면 다음과 같이 하십시오.
  1. Visual Builder Visual Applications 홈 페이지의 네비게이터에서 서비스를 눌러 [서비스] 창을 엽니다. 백엔드를 눌러 백엔드 목록을 봅니다.
  2. RichHistoryDBConfiguration DB 백엔드를 선택합니다. 서버를 누릅니다.
  3. 기본 서버 옆의 편집 아이콘을 누릅니다.
  4. Server Details(서버 세부정보)에서 다음을 업데이트합니다.
    • 인스턴스 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
    • 로그인한 사용자에 대한 인증: 기본이 인증에 사용됩니다.
    • 클라이언트 ID 및 클라이언트 암호: 사용자 이름 옆에 있는 편집 아이콘을 누릅니다. 사용자 이름을 Client ID으로, 비밀번호를 Client Secret로 업데이트하여 ORDS 끝점 ID 및 암호와 일치시킵니다.

Visual Builder 비즈니스 객체 구성

비즈니스 객체는 데이터베이스 테이블과 유사한 송장 또는 구매 주문과 같은 자원이며 애플리케이션에 대한 데이터를 보유하는 필드가 있습니다. 비즈니스 객체는 데이터베이스 테이블과 마찬가지로 데이터 구조를 제공합니다. 업무 객체는 데이터베이스에 저장됩니다. 시각적 애플리케이션 및 기타 클라이언트의 앱은 REST 엔드포인트를 통해 비즈니스 객체에 접근합니다.

Visual Builder Visual Applications 홈 페이지의 네비게이터에서 비즈니스 객체를 눌러 [비즈니스 객체] 창을 엽니다. 도매 CBDC 객체가 나열되어야 합니다.
Visual Builder의 비즈니스 객체 뷰에서 도매 CBDC 샘플 애플리케이션에 속하는 전체 비즈니스 객체 목록을 보여주는 화면 캡처입니다.

비즈니스 객체를 선택하고 해당 데이터 탭으로 이동하여 데이터를 업데이트하거나 수정할 수 있습니다.

조직 이름

이 비즈니스 객체는 데이터 탭에 4개의 필드가 있으며 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로 유지되어야 합니다.

필드 이름 설명 기본값 갱신이 필요함(예/아니요) 요구사항 업데이트
BankName Oracle Blockchain Platform 인스턴스 이름과 CBDC 애플리케이션에 사용된 BankNames 간에 사용되는 매핑입니다.

예를 들어, 이름이 CentralBank인 Oracle Blockchain Platform 인스턴스를 생성했지만 애플리케이션에서 BankName를 BSP로 지정하려는 경우 이 매핑은 Oracle Blockchain Platform 인스턴스와 BankName 간의 매핑을 생성합니다.

CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5 및 Bank6 예 활성 FI에 필요합니다. 사용되지 않은 PI의 경우 비워 두십시오.
mspId 이 열은 실제 Oracle Blockchain Platform 인스턴스 MSP ID를 나타냅니다. Oracle Blockchain Platform 인스턴스가 아래에 언급된 기본값 이외의 이름으로 생성된 경우 이 값을 업데이트해야 합니다. CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5 및 Bank6 예 활성 FI에 필요합니다. 사용되지 않은 PI의 경우 비워 두십시오.
OrgName 이 열은 백엔드와 매핑되는 orgNames을 나타냅니다. CB는 설립자를 나타내고 FI#는 참가자를 나타냅니다. CB, FI1, FI2, FI3, FI4, FI5 및 FI6 아니요 ---

피어

이 비즈니스 객체는 네트워크 내의 모든 Oracle Blockchain Platform 인스턴스에 피어에 대한 정보를 저장하도록 설계되었습니다. 피어 URL 세부정보를 비즈니스 객체에 입력하려면 peerURL 열에 해당 피어 URL 값을 해당 Oracle Blockchain Platform 멤버쉽 서비스 제공자 ID(mspId)와 함께 입력해야 합니다.

예를 들어, 중앙 은행(CB)과 금융 기관(FI#)이 각각 두 개 있는 경우 연관된 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 인스턴스도 ID 관리에 동일한 Oracle Identity Cloud Service를 사용해야 합니다. Oracle Visual Builder 애플리케이션에 액세스하는 사용자에게는 Oracle Analytics Cloud 및 Oracle Visual Builder에 필요한 권한이 있어야 합니다.

다음 단계를 완료하기 전에 도매 CBDC 분석 패키지를 구성합니다. 자세한 내용은 도매 CBDC 샘플 분석 패키지를 참조하십시오.

  1. Oracle Visual Builder 도메인 URL을 가져옵니다.
    1. OCI 콘솔에서 개발자 서비스 > 시각적 빌더를 누릅니다.
    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을 복사합니다. 정규화된 도메인 이름을 https://를 포함하여 .com까지 복사합니다.

      호스트 URL 예: https://<your-oac-instance>.analytics.ocp.example.com

  4. Oracle Visual Builder에서 허용된 원점으로 Oracle Analytics Cloud 호스트 URL을 추가합니다.
    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 window가 표시됩니다.
    5. 일반 사항 탭을 누른 다음 객체 ID와 연관된 복사를 누릅니다.
  6. Visual Builder에서 HTML을 편집합니다.
    1. 앱 편집기에서 cbdcapp 애플리케이션을 열고 HTML 섹션으로 이동합니다.
    2. 다음 코드 조각에 표시된 대로 Analytics Cloud 인스턴스와 일치하도록 30행과 31행의 Analytics Cloud 호스트 URL을 업데이트합니다. URL의 하위 디렉토리 구조를 변경하지 마십시오. 도메인 부분만 .com까지 변경하십시오.
      <script src="https://abc-xyz-ia.analytics.ocp.example.com/public/dv/v1/embedding/jet/embedding.js" type="application/javascript"></script>