Configurar o Visual Builder para o Aplicativo Wholesale CBDC Sample

Depois de configurar todos os outros produtos associados ao Oracle Blockchain Platform, você poderá configurar o Oracle Visual Builder para estabelecer conexão com eles.

Visão geral

Os detalhes a seguir devem ser atualizados na configuração do Oracle Visual Builder. Você obtém esses detalhes ao configurar o Oracle Blockchain Platform conforme descrito em Configurar o Oracle Blockchain Platform para o Aplicativo de Amostra de CBDC Atacado.

Atualizar Variáveis Globais

  1. Na home page Aplicativos Visuais do Visual Builder, clique em Aplicativos Web no Navegador para abrir o painel Aplicativos Web.
  2. Clique no aplicativo cbdcapp. O editor de aplicativos é aberto.
  3. Selecione Variáveis.
  4. Na seção Variáveis Globais, localize o objeto de variável configuration e atualize os seguintes parâmetros no objeto:
    Nome do Parâmetro Descrição Valor padrão
    chaincodeName O chaincodeName usado na rede do Oracle Blockchain Platform. WholesaleCBDC
    channel O nome do canal no qual o chaincode está implantado. test
    confidentialApplication Uma variável booliana definida como true para o modo confidencial, false para o modo genérico. false
    ordsEndpointUrls Um objeto que contém os URLs de ponto final do ORDS para o proprietário do sistema e as organizações participantes, que são exibidos na saída do script de criação da view do banco de dados. No modo genérico, você atualiza apenas o ponto final do proprietário do sistema, e deve deixar todas as organizações participantes nos valores padrão. No modo confidencial, você atualiza todos os pontos finais. Consulte as seguintes informações para obter mais detalhes
    restproxyId Um objeto que contém os IDs de proxy REST para o proprietário do sistema e as organizações participantes. Todos os IDs devem ser especificados, independentemente do modo de aplicativo. Consulte as seguintes informações para obter mais detalhes
    Objeto ordsEndpointUrls de amostra, 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 amostra, 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 amostra, ambos os modos:
    "restproxyId": {
        "systemOwner": "restProxy_CentralBank",
        "participantOrg1": "restProxy_Bank1",
        "participantOrg2": "restProxy_Bank2",
        "participantOrg3": "restProxy_Bank3",
        "participantOrg4": "restProxy_Bank4",
        "participantOrg5": "restProxy_Bank5",
        "participantOrg6": "restProxy_Bank6"
    }

Configurar Backends do Visual Builder

Uma conexão de serviço de back-end no Visual Builder é uma forma de estabelecer comunicação entre seu aplicativo visual e sistemas externos, fornecendo detalhes essenciais, como informações de conexão, propriedades e pontos finais da API REST necessários para acessar esses sistemas.

Para obter mais informações, consulte O Que São Back-ends?.

Execute as etapas a seguir para configurar backends do Visual Builder para interações do Oracle Blockchain Platform e interações de banco de dados de histórico avançado.

Configuração de Backend para Interações do Oracle Blockchain Platform

O aplicativo CBDC de atacado usa backends do Visual Builder para gerenciar interações com o Oracle Blockchain Platform.
Proprietário do sistema
SystemOwnerMgmt: trata as interações do Oracle Blockchain Platform e a criação de inscrições para o proprietário do sistema.
SystemOwnerRestproxyConfiguration: um backend dedicado que trata as chamadas de proxy REST para o proprietário do sistema.
Organizações participantes
ParticipantOrg1Mgmt: trata as interações do Oracle Blockchain Platform, criação de inscrições e chamadas de proxy REST para a organização participante 1.
ParticipantOrg2Mgmt: trata interações do Oracle Blockchain Platform, criação de inscrições e chamadas de proxy REST para a organização participante 2.
ParticipantOrg3Mgmt: trata as interações do Oracle Blockchain Platform, a criação de inscrições e as chamadas de proxy REST da organização participante 3.
ParticipantOrg4Mgmt: trata as interações do Oracle Blockchain Platform, a criação de inscrições e as chamadas de proxy REST da organização participante 4.
ParticipantOrg5Mgmt: trata as interações do Oracle Blockchain Platform, a criação de inscrições e as chamadas de proxy REST da organização participante 5.
ParticipantOrg6Mgmt: trata as interações do Oracle Blockchain Platform, a criação de inscrições e as chamadas de proxy REST da organização participante 6.
Para atualizar os detalhes do servidor de backend:
  1. Na home page do Visual Builder Visual Applications, clique em Serviços no Navegador para abrir o painel Serviços. Clique em Backends para ver uma lista de backends.
  2. Selecione o backend que deseja atualizar. Clique em Servidores.
  3. Clique no ícone Editar ao lado do servidor padrão.
  4. Para o backend SystemOwnerRestproxyConfiguration somente, atualize o seguinte na janela Detalhes do Servidor:
    • URL da Instância: Substitua o URL padrão pelo URL da instância do Oracle Blockchain Platform modificando a parte do URL base do URL padrão (test-xyz-abc.blockchain.ocp.oraclecloud.com). Por exemplo:
      https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy/api/v2/channels/{channelName}
    • Variáveis do servidor: Altere channelName para refletir o nome do canal no qual o chaincode está implantado.
    • Autenticação para usuários conectados: OAuth 2.0 A Asserção de Usuário é usada para autenticação. Modifique o URL para corresponder ao URL de proxy REST do Oracle Blockchain Platform. Por exemplo:
      https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
    • ID do cliente e segredo do cliente: Clique no ícone Editar ao lado de ClientID. Atualize os campos Client ID e Client Secret para corresponder ao seu ID e segredo do Oracle Blockchain Platform.
  5. Para todos os outros backends, atualize o seguinte na janela Detalhes do Servidor:
    • URL da Instância: Substitua o URL padrão pelo URL da instância do Oracle Blockchain Platform modificando a parte do URL base do URL padrão (test-xyz-abc.blockchain.ocp.oraclecloud.com). Por exemplo:
      https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443
    • Autenticação para usuários conectados: OAuth 2.0 A Asserção de Usuário é usada para autenticação. Modifique o URL para corresponder ao URL de proxy REST do Oracle Blockchain Platform. Por exemplo:
      https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
    • ID do cliente e segredo do cliente: Clique no ícone Editar ao lado de ClientID. Atualize os campos Client ID e Client Secret para corresponder ao seu ID e segredo do Oracle Blockchain Platform.
  6. Repita essas etapas para atualizar todos os backends.

Configuração de Backend para Interações de Banco de Dados de Histórico Rico

Cada organização tem um backend dedicado que gerencia o acesso ao banco de dados de histórico avançado.

Backends
SystemOwnerRichHistoryDBConfiguration
ParticipantOrg1RichHistoryDBConfiguration
ParticipantOrg2RichHistoryDBConfiguration
ParticipantOrg3RichHistoryDBConfiguration
ParticipantOrg4RichHistoryDBConfiguration
ParticipantOrg5RichHistoryDBConfiguration
ParticipantOrg6RichHistoryDBConfiguration

No modo genérico, você atualiza apenas o backend SystemOwnerRichHistoryDBConfiguration. No modo confidencial, você deve atualizar o backend do proprietário do sistema e os backends de todas as organizações participantes que estão em uso na sua implantação.

Para atualizar os detalhes do servidor de back-end:
  1. Na home page do Visual Builder Visual Applications, clique em Serviços no Navegador para abrir o painel Serviços. Clique em Backends para ver uma lista de backends.
  2. Selecione o backend apropriado. Clique em Servidores.
  3. Clique no ícone Editar ao lado do servidor padrão.
  4. Atualize o seguinte na seção Detalhes do Servidor:
    • URL da Instância: Substitua o URL padrão por OAuth Base URL(ORDS_REST_BASE_URL/ords/<userName|aliasName>). Por exemplo, o URL padrão:
      https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
      seria substituído por:
      https://g53630e55ee33f4-rhjkdb.adb.ap-sydney-1.oraclecloudapps.com/ords/vbcstest
    • Autenticação para usuários conectados: Básico é usado para autenticação.
    • ID do Cliente e segredo do cliente: Clique no ícone Editar ao lado de Nome do Usuário. Atualize o nome do usuário com Client ID e a senha com Client Secret para corresponder ao seu ID de ponto final e segredo do ORDS.

Configurar Objetos de Negócios do Visual Builder

Um objeto de negócios é um recurso, como uma NFF ou uma ordem de compra, semelhante a uma tabela de banco de dados; ele tem campos que contêm os dados do seu aplicativo. Como uma tabela de banco de dados, um objeto de negócios fornece a estrutura dos dados. Os objetos de negócios são armazenados em um banco de dados. Os aplicativos em seu aplicativo visual e outros clientes acessam os objetos de negócios por meio de seus pontos finais REST.

Na home page Aplicativos Visuais do Visual Builder, clique em Objetos de Negócios no Navegador para abrir o painel Objetos de Negócios. Os objetos CBDC de atacado são listados.
Captura de tela mostrando a lista completa de objetos de negócios pertencentes ao aplicativo de amostra de CBDC de atacado na exibição Objetos de Negócios do Visual Builder.

Você pode selecionar qualquer objeto de negócios e ir até a guia Dados para atualizar ou modificar seus dados.

Nomes da Organização

Este objeto de negócios tem quatro campos na página Dados e é usado para conectar as instâncias do Oracle Blockchain Platform ao backend correto para cada banco. Por exemplo, se um usuário informar detalhes de Bank1 no sistema ParticipantOrg1, o aplicativo deverá vincular ParticipantOrg1 a Bank1. Dessa forma, sempre que um usuário associado ao Bank1 faz log-in, o sistema sabe extrair dados do back-end do ParticipantOrg1.

Neste objeto de negócios, atualize as colunas BankName e mspId para os respectivos valores orgName. As atualizações devem corresponder ao número de organizações participantes na rede. Por exemplo, se houver duas organizações participantes na rede, você deverá atualizar as colunas BankName e mspId para essas duas organizações. Para as organizações participantes restantes (ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6), deixe as colunas BankName e mspId definidas com o valor empty.

Nome do Campo Descrição Valores Padrão Atualização Obrigatória (Sim/Não) Atualizar Requisito
BankName O mapeamento usado entre os nomes de instâncias do Oracle Blockchain Platform e os nomes de bancos usados no Aplicativo CBDC.

Por exemplo, se você criou a instância do Oracle Blockchain Platform com o nome CentralBank, mas quiser que o valor BankName seja BSP no aplicativo, esse mapeamento criará o mapeamento entre a instância do Oracle Blockchain Platform e BSP.

CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6 Sim Obrigatório para organizações participantes ativas; deixe em branco para organizações participantes não utilizadas.
mspId Esta coluna representa o ID do MSP da instância real do Oracle Blockchain Platform. Atualize esses valores se as instâncias do Oracle Blockchain Platform forem criadas com nomes diferentes dos valores padrão. CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6 Sim Obrigatório para organizações participantes ativas; deixe em branco para organizações participantes não utilizadas.
OrgName Essa coluna representa valores orgName que são mapeados com o backend. SystemOwner representa o fundador e ParticipantOrg# representa os participantes. SystemOwner,ParticipantOrg1,ParticipantOrg2, ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6 No N/D

Pares

Este objeto de negócios foi projetado para armazenar informações sobre os pares em todas as instâncias do Oracle Blockchain Platform na rede. Para informar os detalhes do URL de pareamento no objeto de negócios, informe os valores correspondentes do URL de pareamento na coluna peerURL juntamente com seus respectivos IDs do Provedor de Serviços de Associação do Oracle Blockchain Platform (mspId).

Por exemplo, se houver um banco central e duas instituições financeiras, cada uma com dois pares, você deverá informar um total de seis URLs de mesmo nível, juntamente com seus valores mspId associados.

Nome do Campo Descrição
orgName Instância do Oracle Blockchain Platform mspId.
peerURL O valor peerURL das instâncias do Oracle Blockchain Platform.

Observação:

Os pares incluídos nesta Interface de Negócios devem ser adicionados ao canal comum que foi criado.

Configurar o Oracle Analytics Cloud para o Oracle Visual Builder

A instância do Oracle Analytics Cloud e a instância do Oracle Visual Builder devem residir na mesma tenancy do OCI.

A instância do Oracle Analytics Cloud e a instância do Oracle Visual Builder também devem usar o mesmo Oracle Identity Cloud Service para gerenciamento de identidades. Os usuários que acessam o aplicativo Oracle Visual Builder devem ter os privilégios necessários para o Oracle Analytics Cloud e o Oracle Visual Builder.

Antes de concluir as etapas a seguir, configure o pacote de análise CBDC por atacado. Para obter mais informações, consulte Pacote de Análise de Amostra de CBDC Atacadista.

  1. Obtenha o URL do domínio do Oracle Visual Builder.
    1. No console da OCI, clique em Developer Services > Visual Builder.
    2. Selecione sua instância do Visual Builder e clique em Página Inicial de Serviço. A página da interface Aplicativos Visuais é aberta. Copie o nome de domínio da barra de endereços do navegador.

      Exemplo de nome de domínio: Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com

  2. Adicione o domínio como um domínio seguro no Oracle Analytics Cloud.
    1. Faça log-in na sua instância do Oracle Analytics Cloud, abra a console do Oracle Analytics Cloud e clique em Menu do Navegador.
    2. Em Configuração e Definições, clique em Console > Domínios Seguros.
    3. Clique em Adicionar Domínio e cole o URL de domínio do Visual Builder que você copiou anteriormente. O domínio é adicionado automaticamente quando você clica em qualquer outro lugar na exibição.
    4. Marque as caixas de seleção Permitir Quadros e Incorporando associadas ao domínio que você acabou de adicionar.
  3. Obtenha o URL do host do Oracle Analytics Cloud.
    1. Faça log-in na sua instância do Oracle Analytics Cloud.
    2. Copie o URL do host do Oracle Analytics Cloud da barra de endereços do browser. Copie o nome de domínio totalmente qualificado até .com, incluindo https://.

      Exemplo de URL do host: https://<your-oac-instance>.analytics.ocp.example.com

  4. Adicione o URL do host do Oracle Analytics Cloud como uma origem permitida no Oracle Visual Builder.
    1. Faça log-in na instância do Oracle Visual Builder e clique em Página Inicial do Serviço.
    2. Clique em Menu de Navegação e, em seguida, clique em Configurações. A página Definições do Tenant é exibida.
    3. Na seção Origens Permitidas, clique em + Nova Origem e cole o URL de domínio do Analytics Cloud que você copiou anteriormente no campo Endereço de Origem.
  5. Atualize as variáveis de configuração no aplicativo Visual Builder.
    1. Abra o aplicativo cbdcapp no editor de aplicativos e selecione Variáveis.
    2. Na seção Variáveis Globais, atualize os parâmetros a seguir no objeto variável de configuração.
      OACHost
      O URL da instância do Oracle Analytics Cloud, que você copiou anteriormente.
      OACSystemOwnerProjectPath
      O caminho do projeto para a pasta de trabalho do proprietário do sistema no Analytics Cloud.
      OACParticipantOrgProjectPath
      O caminho do projeto para a pasta de trabalho da organização do participante no Analytics Cloud.
    3. Para obter o caminho do projeto de uma pasta de trabalho, clique em Navegador > Catálogo na home page do Analytics Cloud.
    4. Clique no menu Ações da pasta de trabalho e selecione Inspecionar. A janela Inspecionar é exibida.
    5. Clique na guia Geral e, em seguida, clique em Copiar que está associado ao ID do Objeto.
  6. Edite o HTML no Visual Builder.
    1. Abra o aplicativo cbdcapp no editor de aplicativos e navegue até a seção HTML.
    2. Atualize o URL do host do Analytics Cloud nas linhas 30 e 31 para corresponder à sua instância do Analytics Cloud, conforme mostrado no trecho de código a seguir. Não altere a estrutura do subdiretório do URL, apenas a parte do domínio até .com.
      <script src="https://abc-xyz-ia.analytics.ocp.example.com/public/dv/v1/embedding/jet/embedding.js" type="application/javascript"></script>