Configuración de Visual Builder para la aplicación de muestra CBDC mayorista

Después de configurar todos los demás productos asociados a Oracle Blockchain Platform, puede configurar Oracle Visual Builder para conectarse a ellos.

Descripción general

Se deben actualizar los siguientes detalles en la configuración de Oracle Visual Builder. Obtendrá estos detalles al configurar Oracle Blockchain Platform como se describe en Configuración de Oracle Blockchain Platform para la aplicación de muestra CBDC mayorista.

ID de proxy REST, URL de instancia e ID de MSP de la instancia de Oracle Blockchain Platform.
Consulte: Recuperación de RestproxyId
ID de cliente y secreto de cliente de la instancia de Oracle Blockchain Platform.
Consulte: Recuperación de ClientId y ClientSecret.
Punto final de Oracle REST Data Services (ORDS), ID de cliente, secreto de cliente y URL base OAuth.
Consulte: Creación de vistas de base de datos de historial enriquecido.
Nombre de canal y nombre de código de cadenas.
Consulte: Despliegue del Código de Cadena para la Aplicación de Ejemplo CBDC Mayorista.

Actualizar variables globales

En la página inicial de Visual Builder Visual Applications, haga clic en Aplicaciones Web en el navegador para abrir el panel Aplicaciones Web.
Haga clic en la aplicación cbdcapp. Se abre el editor de aplicaciones.
Seleccione Variables.

En la sección Variables globales, busque el objeto de variable configuration y actualice los siguientes parámetros en el objeto:

Nombre de parámetro	Descripción	Valor por defecto
`chaincodeName`	`chaincodeName` utilizado en la red de Oracle Blockchain Platform.	`WholesaleCBDC`
`ordsUrl`	URL de punto final de ORDS, que se muestra en la salida del script de creación de la vista de base de datos.	`https://g53630e55ee33f4-test.xyz.abc.oraclecloudapps.com/ords/obp/cbdc/accountTrxDetails`

Configuración de backends de Visual Builder

Una conexión de servicio de backend en Visual Builder es una forma de establecer la comunicación entre la aplicación visual y los sistemas externos, proporcionando detalles esenciales, como la información de conexión, las propiedades y los puntos finales de la API de REST necesarios para acceder a dichos sistemas. Debe actualizar los backends con Oracle Blockchain Platform y detalles de base de datos de historial enriquecidos.

Para obtener más información, consulte What Are Backends?.

Es necesario actualizar los siguientes backends:

Llamadas de proxy REST
Inscripciones
Base de datos de configuración de base de datos de historial enriquecida

Llamadas de proxy REST

Hay un backend y seis conexiones de servicio relacionadas con el proxy de REST. Estos componentes se utilizan para realizar llamadas de proxy REST a la instancia de Oracle Blockchain Platform.

Backend: CentralBank
Conexiones de servicio: participantBank_FI1; participantBank_FI2; participantBank_FI3; participantBank_FI4; participantBank_FI5; participantBank_FI6

Para actualizar los detalles del servidor de backend:

En la página de inicio de Visual Builder Visual Applications, haga clic en Servicios en el navegador para abrir el panel Servicios. Haga clic en Backends para ver una lista de backends.
Seleccione el backend que desea actualizar. Haga clic en Servidores.
Haga clic en el icono Edit junto al servidor por defecto.
Actualice lo siguiente en los detalles del servidor:
- URL de instancia: sustituya la URL por defecto por la URL de instancia de Oracle Blockchain Platform modificando la parte de la URL base de la URL por defecto (test-xyz-abc.blockchain.ocp.oraclecloud.com). Por ejemplo:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy/api/v2/channels/{channelName}
```
- Variables de servidor: cambie channelName para reflejar el nombre del canal en el que se despliega el código de cadenas.
- Autenticación para usuarios conectados: se utiliza la afirmación de usuario OAuth 2.0 para la autenticación. Modifique la URL para que coincida con la URL de proxy de REST de Oracle Blockchain Platform. Por ejemplo:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- ID de cliente y secreto de cliente: haga clic en el icono Editar junto a ClientID. Actualice los campos Client ID y Client Secret para que coincidan con su ID y secreto de Oracle Blockchain Platform.
Repita estos pasos para actualizar las conexiones de servicio de cada uno de los seis participantes seleccionándolas en la vista Conexiones de servicio del panel Servicios.

Inscripciones

Hay siete backends relacionados con las inscripciones en Oracle Blockchain Platform. Estos backends se utilizan para crear las inscripciones en la instancia de Oracle Blockchain Platform.

Backends: CustomEnrollementCB; CustomEnrollementFI1; CustomEnrollementFI2; CustomEnrollementFI3; CustomEnrollementFI4; CustomEnrollementFI5; CustomEnrollementFI6

Para actualizar los detalles del servidor de backend:

En la página de inicio de Visual Builder Visual Applications, haga clic en Servicios en el navegador para abrir el panel Servicios. Haga clic en Backends para ver una lista de backends.
Seleccione el backend que desea actualizar. Haga clic en Servidores.
Haga clic en el icono Edit junto al servidor por defecto.
Actualice lo siguiente en los detalles del servidor:
- URL de instancia: sustituya la URL por defecto por la URL de instancia de Oracle Blockchain Platform modificando la parte de la URL base de la URL por defecto (test-xyz-abc.blockchain.ocp.oraclecloud.com). Por ejemplo:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/console/admin/api/v2/nodes/restproxies/{restProxyId}/enrollments
```
- Variables de servidor: cambie restProxyId para reflejar el ID de proxy REST real para la instancia de Oracle Blockchain Platform.
- Autenticación para usuarios conectados: se utiliza la afirmación de usuario OAuth 2.0 para la autenticación. Modifique la URL para que coincida con la URL de proxy de REST de Oracle Blockchain Platform. Por ejemplo:
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- ID de cliente y secreto de cliente: haga clic en el icono Editar junto a ClientID. Actualice los campos Client ID y Client Secret para que coincidan con su ID y secreto de Oracle Blockchain Platform.
Repita estos pasos para actualizar los backends de cada uno de los seis participantes seleccionándolos en la vista Backends del panel Services.

Base de datos de configuración de base de datos de historial enriquecida

Hay un backend relacionado con la base de datos de historial enriquecido. Este backend se utiliza para recuperar los datos de la base de datos de historial enriquecida.

Backend: RichHistoryDBConfiguration DB

Para actualizar los detalles del servidor de backend:

En la página de inicio de Visual Builder Visual Applications, haga clic en Servicios en el navegador para abrir el panel Servicios. Haga clic en Backends para ver una lista de backends.
Seleccione el backend RichHistoryDBConfiguration DB. Haga clic en Servidores.
Haga clic en el icono Edit junto al servidor por defecto.
Actualice lo siguiente en los detalles del servidor:
- URL de instancia: sustituya la URL por defecto por OAuth Base URL(ORDS_REST_BASE_URL/ords/<userName|aliasName>). Por ejemplo, la URL por defecto:
```
https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
```
  sería sustituido por:
```
https://g53630e55ee33f4-rhjkdb.adb.ap-sydney-1.oraclecloudapps.com/ords/vbcstest
```
- Autenticación para usuarios conectados: Basic se utiliza para la autenticación.
- ID de cliente y secreto de cliente: haga clic en el icono Editar junto a Nombre de usuario. Actualice el nombre de usuario con Client ID y la contraseña con Client Secret para que coincidan con el ID de punto final y el secreto de ORDS.

Configuración de objetos de negocio de Visual Builder

Un objeto de negocio es un recurso, como una factura de venta o una orden de compra, similar a una tabla de base de datos; tiene campos que contienen los datos de la aplicación. Al igual que una tabla de base de datos, un objeto de negocio proporciona la estructura para los datos. Los objetos de negocio se almacenan en una base de datos. Las aplicaciones de su aplicación visual y otros clientes acceden a los objetos de negocio a través de sus puntos finales de REST.

En la página inicial de Visual Builder Visual Applications, haga clic en Objetos de negocio en el navegador para abrir el panel Objetos de negocio. Se deben mostrar los objetos CBDC mayoristas.
Captura de pantalla que muestra la lista completa de objetos de negocio que pertenecen a la aplicación de ejemplo CBDC mayorista en la vista Objetos de negocio de Visual Builder.

Puede seleccionar cualquier objeto de negocio y ir al separador Data para actualizar o modificar sus datos.

Nombres de Organización

Este objeto de negocio tiene cuatro campos en el separador Datos y ayuda a conectar las instancias de Oracle Blockchain Platform con el backend adecuado para cada banco. Por ejemplo, si un usuario introduce los detalles de Bank1 en el sistema FI1, la aplicación debe enlazar FI1 con Bank1. De esta forma, cada vez que un usuario asociado a Bank1 se conecta, el sistema sabe extraer datos del backend FI1.

En este objeto de negocio, debe actualizar las columnas BankName y mspId para los respectivos orgNames. Las actualizaciones deben corresponder al número de participantes (IF) en la red. Por ejemplo, si hay 2 FIs (FI1, FI2) en la red, debe actualizar las columnas BankName y mspId para estas dos interfaces de usuario. Para el resto de IF (FI3, FI4, FI5, FI6), las columnas BankName y mspId deben dejarse en empty.

Nombre de campo	Descripción	Valor por defecto	Actualización necesaria (Sí/No)	Actualizar requisito
BankName	Esta es la asignación utilizada entre los nombres de instancia de Oracle Blockchain Platform y `BankNames` utilizada en la aplicación CBDC. Por ejemplo, si ha creado la instancia de Oracle Blockchain Platform con el nombre `CentralBank` pero desea que `BankName` sea `BSP` en la aplicación, esta asignación crea la asignación entre la instancia de Oracle Blockchain Platform y `BankName`.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5` y `Bank6`	Sí	Obligatorio para los IF activos; deje vacío para los IF no utilizados.
mspId	Esta columna representa el ID real de MSP de la instancia de Oracle Blockchain Platform. Debe actualizar estos valores si las instancias de Oracle Blockchain Platform se crean con nombres distintos de los valores por defecto mencionados a continuación.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5` y `Bank6`	Sí	Obligatorio para los IF activos; deje vacío para los IF no utilizados.
OrgName	Esta columna representa `orgNames` que se asignan al backend. `CB` representa al fundador y `FI#` representa a los participantes.	`CB, FI1, FI2, FI3, FI4, FI5` y `FI6`	N.º	---

Peers

Este objeto de negocio está diseñado para almacenar información sobre los peers en todas las instancias de Oracle Blockchain Platform de la red. Para introducir los detalles de URL de peer en el objeto de negocio, debe introducir los valores de URL de peer correspondientes en la columna peerURL junto con sus respectivos ID de proveedor de servicios de miembros de Oracle Blockchain Platform (mspId).

Por ejemplo, si hay un Banco Central (CB) y dos Instituciones Financieras (FI#), cada una con dos pares, debe introducir un total de seis URL de pares junto con su mspId asociado.

Nombre de campo	Descripción
orgName	Instancia de Oracle Blockchain Platform `mspId`.
peerURL	Valor `peerURL` de las instancias de Oracle Blockchain Platform.

Note:

Los peers incluidos en esta interfaz de negocio se deben agregar al canal común que se ha creado.

Configuración de Oracle Analytics Cloud para Oracle Visual Builder

La instancia de Oracle Analytics Cloud y la instancia de Oracle Visual Builder deben residir en el mismo arrendamiento de OCI.

La instancia de Oracle Analytics Cloud y la instancia de Oracle Visual Builder también deben utilizar el mismo Oracle Identity Cloud Service para la gestión de identidades. Los usuarios que acceden a la aplicación Oracle Visual Builder deben tener los privilegios necesarios para Oracle Analytics Cloud y Oracle Visual Builder.

Antes de completar los siguientes pasos, configure el paquete de análisis CBDC mayorista. Para obtener más información, consulte Wholesale CBDC Sample Analytics Package.

Obtenga la URL de dominio de Oracle Visual Builder.
1. En la consola de OCI, haga clic en Developer Services > Visual Builder.
2. Seleccione la instancia de Visual Builder y, a continuación, haga clic en Página inicial de servicio. Se abre la página de interfaz Visual Applications. Copie el nombre de dominio de la barra de direcciones del explorador.
  Nombre de dominio de ejemplo: Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com
Agregue el dominio como un dominio seguro en Oracle Analytics Cloud.
1. Conéctese a la instancia de Oracle Analytics Cloud, abra la consola de Oracle Analytics Cloud y, a continuación, haga clic en Menú de navegador.
2. En Configuración y valores, haga clic en Consola > Dominios seguros.
3. Haga clic en Agregar dominio y, a continuación, pegue la URL de dominio de Visual Builder que ha copiado anteriormente. El dominio se agrega automáticamente al hacer clic en cualquier otro lugar de la pantalla.
4. Seleccione las casillas de control Permitir marcos e Incrustar asociadas al dominio que acaba de agregar.
Obtenga la URL de host de Oracle Analytics Cloud.
1. Conéctese a la instancia de Oracle Analytics Cloud.
2. Copie la URL de host de Oracle Analytics Cloud de la barra de direcciones del explorador. Copie el nombre de dominio completo hasta .com, incluido https://.
  URL de host de ejemplo: https://<your-oac-instance>.analytics.ocp.example.com
Agregue la URL de host de Oracle Analytics Cloud como origen permitido en Oracle Visual Builder.
1. Conéctese a la instancia de Oracle Visual Builder y, a continuación, haga clic en Página inicial de servicio.
2. Haga clic en Menú de navegación y, a continuación, en Configuración. Aparece la página Configuración de inquilino.
3. En la sección Orígenes permitidos, haga clic en + Nuevo origen y, a continuación, pegue la URL de dominio de Analytics Cloud que ha copiado anteriormente en el campo Dirección de origen.
Actualice las variables de configuración en la aplicación Visual Builder.
1. Abra la aplicación cbdcapp en el editor de aplicaciones y, a continuación, seleccione Variables.
2. En la sección Variables globales, actualice los siguientes parámetros en el objeto configuration variable.
  
  OACHost
  
  URL de la instancia de Oracle Analytics Cloud, que ha copiado anteriormente.
  
  OACCBDCProjectPath
  
  Ruta de proyecto del libro de trabajo del banco central en Analytics Cloud.
  
  OACFIProjectPath
  
  Ruta de proyecto para el libro de trabajo de institución financiera en Analytics Cloud.
3. Para obtener la ruta de proyecto de un libro de trabajo, haga clic en Navegador > Catálogo en la página de inicio de Analytics Cloud.
4. Haga clic en el menú Acciones del libro de trabajo y, a continuación, seleccione Inspeccionar. Se muestra la ventana Inspect.
5. Haga clic en el separador General y, a continuación, haga clic en Copiar asociado al ID de objeto.
Edite el HTML en Visual Builder.
1. Abra la aplicación cbdcapp en el editor de aplicaciones y, a continuación, vaya a la sección HTML.
2. Actualice la URL de host de Analytics Cloud en las líneas 30 y 31 para que coincida con la instancia de Analytics Cloud, como se muestra en el siguiente fragmento de código. No cambie la estructura del subdirectorio de la URL, solo la parte del dominio hasta .com.
```
<script src="https://abc-xyz-ia.analytics.ocp.example.com/public/dv/v1/embedding/jet/embedding.js" type="application/javascript"></script>
```