도매 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에 설명된 대로 이러한 세부정보가 제공됩니다.

Oracle Blockchain Platform 인스턴스의 REST 프록시 ID, 인스턴스 URL 및 MSP ID입니다.
참조: RestproxyId 가져오기
Oracle Blockchain Platform 인스턴스의 클라이언트 ID 및 클라이언트 암호입니다.
Fetch ClientId and ClientSecret를 참조하십시오.
ORDS(Oracle REST Data Services) 끝점, 클라이언트 ID, 클라이언트 암호 및 OAuth 기본 URL입니다.
참조: 리치 내역 데이터베이스 뷰 생성.
채널 이름 및 체인코드 이름입니다.
참조: 도매 CBDC 샘플 애플리케이션에 대한 체인 코드 배치.

전역 변수 업데이트

Visual Builder 시각적 애플리케이션 홈 페이지의 네비게이터에서 웹 애플리케이션을 눌러 웹 앱 창을 엽니다.
cbdcapp 애플리케이션을 누릅니다. 앱 편집기가 열립니다.
변수를 선택합니다.

전역 변수 섹션에서 configuration 변수 객체를 찾아 객체에서 다음 매개변수를 업데이트합니다.

매개변수 이름	설명	기본값
`chaincodeName`	Oracle Blockchain Platform 네트워크에서 사용되는 `chaincodeName`입니다.	`WholesaleCBDC`
`channel`	체인 코드가 배포되는 채널의 이름입니다.	`test`
`confidentialApplication`	기밀 모드의 경우 `true`, 일반 모드의 경우 `false`로 설정된 부울 변수입니다.	`false`
`ordsEndpointUrls`	시스템 소유자 및 참가자 조직에 대한 ORDS 끝점 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 상호 작용에 대한 백엔드 구성

도매 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 프록시 호출을 처리합니다.

백엔드 서버 세부정보를 업데이트하려면 다음과 같이 하십시오.

Visual Builder Visual Applications 홈 페이지의 네비게이터에서 서비스를 눌러 서비스 창을 엽니다. 백엔드 목록을 보려면 백엔드를 누릅니다.
업데이트할 백엔드를 선택합니다. 서버를 누릅니다.
기본 서버 옆에 있는 편집 아이콘을 누릅니다.
SystemOwnerRestproxyConfiguration 백엔드의 경우에만 서버 세부정보 창에서 다음을 업데이트합니다.
- 인스턴스 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 필드를 업데이트합니다.
다른 모든 백엔드의 경우 서버 세부정보 창에서 다음을 업데이트합니다.
- 인스턴스 URL: 기본 URL(test-xyz-abc.blockchain.ocp.oraclecloud.com)의 기본 URL 부분을 수정하여 기본 URL을 Oracle Blockchain Platform 인스턴스 URL로 바꿉니다. 예:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443
```
- 로그인한 사용자에 대한 인증: 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 필드를 업데이트합니다.
모든 백엔드를 업데이트하려면 이 단계를 반복합니다.

리치 내역 데이터베이스 상호 작용에 대한 백엔드 구성

각 조직에는 풍부한 기록 데이터베이스에 대한 액세스를 관리하는 전용 백엔드가 있습니다.

백엔드: SystemOwnerRichHistoryDBConfiguration; ParticipantOrg1RichHistoryDBConfiguration; ParticipantOrg2RichHistoryDBConfiguration; ParticipantOrg3RichHistoryDBConfiguration; ParticipantOrg4RichHistoryDBConfiguration; ParticipantOrg5RichHistoryDBConfiguration; ParticipantOrg6RichHistoryDBConfiguration

일반 모드에서는 SystemOwnerRichHistoryDBConfiguration 백엔드만 업데이트합니다. 기밀 모드에서는 배포에서 사용 중인 모든 참가자 조직의 시스템 소유자 백엔드 및 백엔드를 업데이트해야 합니다.

백엔드 서버 세부정보를 업데이트하려면 다음과 같이 하십시오.

Visual Builder Visual Applications 홈 페이지의 네비게이터에서 서비스를 눌러 서비스 창을 엽니다. 백엔드 목록을 보려면 백엔드를 누릅니다.
적절한 백엔드를 선택합니다. 서버를 누릅니다.
기본 서버 옆에 있는 편집 아이콘을 누릅니다.
서버 세부정보 섹션에서 다음을 업데이트합니다.
- 인스턴스 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 인스턴스를 각 은행에 대한 올바른 백엔드와 연결하는 데 사용됩니다. 예를 들어, 사용자가 ParticipantOrg1 시스템에 Bank1 세부정보를 입력하는 경우 애플리케이션은 ParticipantOrg1를 Bank1와 연결해야 합니다. 이렇게 하면 Bank1와 연관된 사용자가 로그인할 때마다 시스템은 ParticipantOrg1 백엔드에서 데이터를 가져올 수 있습니다.

이 비즈니스 객체에서 해당 orgName 값에 대한 BankName 및 mspId 열을 업데이트합니다. 업데이트는 네트워크의 참여자 조직 수와 일치해야 합니다. 예를 들어, 네트워크에 두 개의 참가자 조직이 있는 경우 이 두 조직에 대해 BankName 및 mspId 열을 업데이트해야 합니다. 나머지 참가자 조직(ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6)의 경우 BankName 및 mspId 열을 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`	아니요	N/A

피어

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

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

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

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. 방금 추가한 도메인과 연관된 Allow Frames(프레임 허용) 및 Embedding(포함) 확인란을 선택합니다.
Oracle Analytics Cloud 호스트 URL을 가져옵니다.
1. Oracle Analytics Cloud 인스턴스에 로그인합니다.
2. 브라우저의 주소 표시줄에서 Oracle Analytics Cloud 호스트 URL을 복사합니다. 정규화된 도메인 이름을 https://를 포함하여 .com까지 복사합니다.
  호스트 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입니다.
  
  OACSystemOwnerProjectPath
  
  Analytics Cloud의 시스템 소유자 워크북에 대한 프로젝트 경로입니다.
  
  OACParticipantOrgProjectPath
  
  Analytics Cloud의 참가자 조직 워크북에 대한 프로젝트 경로입니다.
3. 워크북의 프로젝트 경로를 가져오려면 Analytics Cloud 홈 페이지에서 네비게이터 > 카탈로그를 누릅니다.
4. 워크북에 대한 작업 메뉴를 누른 다음 검사를 선택합니다. Inspect window가 표시됩니다.
5. 일반 사항 탭을 누른 다음 객체 ID와 연관된 복사를 누릅니다.
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>
```