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
channel
Nombre del canal donde se despliega el código de cadena. test
confidentialApplication
Variable booleana definida en true
para el modo confidencial,false
para el modo genérico.false
ordsEndpointUrls
Objeto que contiene las URL de punto final de ORDS para el propietario del sistema y las organizaciones participantes, que se muestran en la salida del script de creación de vista de base de datos. En el modo genérico, sólo actualiza el punto final del propietario del sistema y debe dejar todas las organizaciones participantes en los valores por defecto. En modo confidencial, actualiza todos los puntos finales. Consulte la siguiente información para obtener más información restproxyId
Objeto que contiene los ID de proxy REST para el propietario del sistema y las organizaciones participantes. Se deben especificar todos los ID, independientemente del modo de aplicación. Consulte la siguiente información para obtener más información ordsEndpointUrls
de ejemplo, modo genérico:
Objeto"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
de ejemplo, modo confidencial:
Objeto"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
de ejemplo, ambos modos:"restproxyId": { "systemOwner": "restProxy_CentralBank", "participantOrg1": "restProxy_Bank1", "participantOrg2": "restProxy_Bank2", "participantOrg3": "restProxy_Bank3", "participantOrg4": "restProxy_Bank4", "participantOrg5": "restProxy_Bank5", "participantOrg6": "restProxy_Bank6" }
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, al proporcionar los detalles esenciales, como la información de conexión, las propiedades y los puntos finales de la API de REST necesarios para acceder a esos sistemas.
Para obtener más información, consulte Definición de Backends.
Complete los siguientes pasos para configurar backends de Visual Builder tanto para interacciones de Oracle Blockchain Platform como para interacciones de bases de datos de historial enriquecido.
Configuración de backend para interacciones con Oracle Blockchain Platform
- Propietario del sistema
SystemOwnerMgmt
: gestiona las interacciones de Oracle Blockchain Platform y la creación de inscripciones para el propietario del sistema.- Organizaciones participantes
ParticipantOrg1Mgmt
: gestiona las interacciones de Oracle Blockchain Platform, la creación de inscripciones y las llamadas de proxy REST para la organización participante 1.
- En la página inicial de Visual Builder Visual Applications, haga clic en Services en el navegador para abrir el panel Services. 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 Editar situado junto al servidor por defecto.
- Solo para el backend
SystemOwnerRestproxyConfiguration
, actualice lo siguiente en la ventana Detalles de 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
yClient Secret
para que coincidan con su ID y secreto de Oracle Blockchain Platform.
- 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 (
- Para todos los demás backends, actualice lo siguiente en la ventana 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
- 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
yClient Secret
para que coincidan con su ID y secreto de Oracle Blockchain Platform.
- 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 (
- Repita estos pasos para actualizar todos los backends.
Configuración de backend para interacciones de base de datos de historial enriquecido
Cada organización tiene un backend dedicado que gestiona el acceso a la base de datos de historial enriquecido.
En modo genérico, solo actualiza el backend SystemOwnerRichHistoryDBConfiguration
. En modo confidencial, debe actualizar el backend del propietario del sistema y los backends de todas las organizaciones participantes que están en uso en el despliegue.
- En la página inicial de Visual Builder Visual Applications, haga clic en Services en el navegador para abrir el panel Services. Haga clic en Backends para ver una lista de backends.
- Seleccione el backend adecuado. Haga clic en Servidores.
- Haga clic en el icono Editar situado junto al servidor por defecto.
- Actualice lo siguiente en la sección 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:
sería sustituido por:https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
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 conClient Secret
para que coincidan con el ID de punto final y el secreto de ORDS.
- URL de instancia: sustituya la URL por defecto por
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 muestran los objetos CBDC mayoristas.
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 la página Datos y se utiliza para conectar las instancias de Oracle Blockchain Platform con el backend correcto para cada banco. Por ejemplo, si un usuario introduce los detalles de Bank1
en el sistema ParticipantOrg1
, la aplicación debe enlazar ParticipantOrg1
con Bank1
. De esta forma, cada vez que un usuario asociado a Bank1
se conecta, el sistema sabe extraer datos del backend ParticipantOrg1
.
En este objeto de negocio, actualice las columnas BankName
y mspId
para los respectivos valores orgName
. Las actualizaciones deben corresponder al número de organizaciones participantes en la red. Por ejemplo, si hay dos organizaciones participantes en la red, debe actualizar las columnas BankName
y mspId
para estas dos organizaciones. Para el resto de las organizaciones participantes (ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6
), deje las columnas BankName
y mspId
definidas en el valor empty
.
Nombre de campo | Descripción | Valor por defecto | Actualización necesaria (Sí/No) | Actualizar requisito |
---|---|---|---|---|
BankName | Asignación utilizada entre los nombres de instancia de Oracle Blockchain Platform y los nombres bancarios utilizados en la aplicación CBDC.
Por ejemplo, si ha creado la instancia de Oracle Blockchain Platform con el nombre |
CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6 |
Sí | Obligatorio para organizaciones participantes activas; deje vacío para organizaciones participantes no utilizadas. |
mspId | Esta columna representa el ID de MSP de la instancia real de Oracle Blockchain Platform. Debe actualizar estos valores si las instancias de Oracle Blockchain Platform se crean con nombres que no sean valores por defecto. | CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6 |
Sí | Obligatorio para organizaciones participantes activas; deje vacío para organizaciones participantes no utilizadas. |
OrgName | Esta columna representa los valores orgName que se asignan al backend. SystemOwner representa al fundador y ParticipantOrg# representa a los participantes.
|
SystemOwner,ParticipantOrg1,ParticipantOrg2, ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6
|
N.º | No disponible |
Peers
Este objeto de negocio está diseñado para almacenar información sobre los iguales en todas las instancias de Oracle Blockchain Platform de la red. Para introducir los detalles de la URL de peer en el objeto de negocio, introduzca los valores de URL de peer correspondientes en la columna peerURL junto con sus respectivos ID de proveedor de servicios de membresía de Oracle Blockchain Platform (mspId
).
Por ejemplo, si hay un banco central y dos instituciones financieras, cada una con dos iguales, debe introducir un total de seis URL peer junto con sus valores mspId
asociados.
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 creó.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.
- En la consola de OCI, haga clic en Developer Services > Visual Builder.
- 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.
- 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.
- En Configuración y valores, haga clic en Consola > Dominios seguros.
- 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.
- 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.
- Conéctese a la instancia de Oracle Analytics Cloud.
- Copie la URL de host de Oracle Analytics Cloud de la barra de direcciones del explorador. Copie el nombre de dominio completo hasta
.com
, incluidohttps://
.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.
- Conéctese a la instancia de Oracle Visual Builder y, a continuación, haga clic en Página inicial de servicio.
- Haga clic en Menú de navegación y, a continuación, en Configuración. Aparece la página Configuración de inquilino.
- 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.
- Abra la aplicación
cbdcapp
en el editor de aplicaciones y, a continuación, seleccione Variables. - 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.
-
OACSystemOwnerProjectPath
- Ruta de proyecto del libro de trabajo del propietario del sistema en Analytics Cloud.
-
OACParticipantOrgProjectPath
- Ruta de proyecto para el libro de trabajo de organización del participante en Analytics Cloud.
-
- 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.
- Haga clic en el menú Acciones del libro de trabajo y, a continuación, seleccione Inspeccionar. Se muestra la ventana Inspect.
- Haga clic en el separador General y, a continuación, haga clic en Copiar asociado al ID de objeto.
- Abra la aplicación
- Edite el HTML en Visual Builder.
- Abra la aplicación
cbdcapp
en el editor de aplicaciones y, a continuación, vaya a la sección HTML. - 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>
- Abra la aplicación