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.

Actualizar variables globales

  1. En la página inicial de Visual Builder Visual Applications, haga clic en Aplicaciones Web en el navegador para abrir el panel Aplicaciones Web.
  2. Haga clic en la aplicación cbdcapp. Se abre el editor de aplicaciones.
  3. Seleccione Variables.
  4. 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
    Objeto ordsEndpointUrls de ejemplo, modo genérico:
    "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>"
    }
    Objeto ordsEndpointUrls de ejemplo, modo confidencial:
    "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"
    }
    Objeto 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

La aplicación mayorista CBDC utiliza backends de Visual Builder para gestionar las 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.
SystemOwnerRestproxyConfiguration: backend dedicado que maneja llamadas de proxy REST 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.
ParticipantOrg2Mgmt: gestiona las interacciones de Oracle Blockchain Platform, la creación de inscripciones y las llamadas de proxy REST para la organización participante 2.
ParticipantOrg3Mgmt: gestiona las interacciones de Oracle Blockchain Platform, la creación de inscripciones y las llamadas de proxy REST para la organización participante 3.
ParticipantOrg4Mgmt: gestiona las interacciones de Oracle Blockchain Platform, la creación de inscripciones y las llamadas de proxy REST para la organización participante 4.
ParticipantOrg5Mgmt: gestiona las interacciones de Oracle Blockchain Platform, la creación de inscripciones y las llamadas de proxy REST para la organización participante 5.
ParticipantOrg6Mgmt: gestiona las interacciones de Oracle Blockchain Platform, la creación de inscripciones y las llamadas de proxy REST para la organización participante 6.
Para actualizar los detalles del servidor de backend:
  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.
  2. Seleccione el backend que desea actualizar. Haga clic en Servidores.
  3. Haga clic en el icono Editar situado junto al servidor por defecto.
  4. 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 y Client Secret para que coincidan con su ID y secreto de Oracle Blockchain Platform.
  5. 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 y Client Secret para que coincidan con su ID y secreto de Oracle Blockchain Platform.
  6. 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.

Backends
SystemOwnerRichHistoryDBConfiguration
ParticipantOrg1RichHistoryDBConfiguration
ParticipantOrg2RichHistoryDBConfiguration
ParticipantOrg3RichHistoryDBConfiguration
ParticipantOrg4RichHistoryDBConfiguration
ParticipantOrg5RichHistoryDBConfiguration
ParticipantOrg6RichHistoryDBConfiguration

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.

Para actualizar los detalles del servidor backend:
  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.
  2. Seleccione el backend adecuado. Haga clic en Servidores.
  3. Haga clic en el icono Editar situado junto al servidor por defecto.
  4. 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:
      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 muestran los objetos CBDC mayoristas.
Captura de pantalla en la que se 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 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 pero desea que el valor BankName sea BSP en la aplicación, esta asignación crea la asignación entre la instancia de Oracle Blockchain Platform y BSP.

CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6 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 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.

  1. 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

  2. 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.
  3. 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

  4. 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.
  5. 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.
      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.
    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.
  6. 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>