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
    ordsUrl O URL do ponto final do ORDS, que é exibido na saída do script de criação da view do banco de dados. https://g53630e55ee33f4-test.xyz.abc.oraclecloudapps.com/ords/obp/cbdc/accountTrxDetails

Configurar Backends do Visual Builder

Uma conexão de serviço de backend no Visual Builder é uma maneira de estabelecer comunicação entre seu aplicativo visual e sistemas externos, fornecendo detalhes essenciais, como informações de conexão, propriedades e pontos finais de API REST necessários para acessar esses sistemas. Você precisa atualizar os backends com o Oracle Blockchain Platform e detalhes do banco de dados de histórico avançado.

Para obter mais informações, consulte O que São Backends?.

Os seguintes backends precisam ser atualizados:
  • Chamadas de proxy REST
  • Inscrições
  • Banco de dados de configuração de banco de dados de histórico avançado

Chamadas de proxy REST

Há um backend e seis conexões de serviço relacionadas ao proxy REST. Esses componentes são usados para fazer chamadas de proxy REST para a instância do Oracle Blockchain Platform.

Backend
CentralBank
Conexões de serviço
participantBank_FI1
participantBank_FI2
participantBank_FI3
participantBank_FI4
participantBank_FI5
participantBank_FI6
Para atualizar os detalhes do servidor de backend:
  1. Na home page Aplicativos Visuais do Visual Builder, 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 você deseja atualizar. Clique em Servidores.
  3. Clique no ícone Editar ao lado do servidor padrão.
  4. Atualize o seguinte nos 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. Repita essas etapas para atualizar as conexões de serviço de cada um dos seis participantes selecionando-as na Exibição de Conexões de Serviço no painel Serviços.

Inscrições

Há sete backends relacionados a inscrições no Oracle Blockchain Platform. Esses backends são usados para criar as inscrições na instância do Oracle Blockchain Platform.

Backends
CustomEnrollementCB
CustomEnrollementFI1
CustomEnrollementFI2
CustomEnrollementFI3
CustomEnrollementFI4
CustomEnrollementFI5
CustomEnrollementFI6
Para atualizar os detalhes do servidor de backend:
  1. Na home page Aplicativos Visuais do Visual Builder, 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 você deseja atualizar. Clique em Servidores.
  3. Clique no ícone Editar ao lado do servidor padrão.
  4. Atualize o seguinte nos 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/console/admin/api/v2/nodes/restproxies/{restProxyId}/enrollments
    • Variáveis do servidor: Altere restProxyId para refletir o ID de proxy REST real para sua instância do Oracle Blockchain Platform.
    • 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. Repita essas etapas para atualizar os backends de cada um dos seis participantes selecionando-os na Exibição de Backends no painel Serviços.

Banco de dados de configuração de banco de dados de histórico avançado

Há um backend relacionado ao banco de dados de histórico avançado. Este backend é usado para extrair os dados do banco de dados de histórico avançado.

Backend
RichHistoryDBConfiguration DB
Para atualizar os detalhes do servidor de backend:
  1. Na home page Aplicativos Visuais do Visual Builder, 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 RichHistoryDBConfiguration DB. Clique em Servidores.
  3. Clique no ícone Editar ao lado do servidor padrão.
  4. Atualize o seguinte nos 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 devem ser listados.
Captura de tela mostrando a lista completa de objetos de negócios pertencentes ao aplicativo de amostra 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

Esses objetos de negócios têm quatro campos na guia Dados e ajudam a conectar as instâncias do Oracle Blockchain Platform com o backend certo para cada banco. Por exemplo, se um usuário informar detalhes de Bank1 no sistema FI1, o aplicativo precisará vincular FI1 a Bank1. Dessa forma, sempre que um usuário associado ao Bank1 fizer log-in, o sistema saberá extrair dados do backend FI1.

Neste objeto de negócios, você precisa atualizar as colunas BankName e mspId para o respectivo orgNames. As atualizações devem corresponder ao número de participantes (IF) na rede. Por exemplo, se houver 2 FIs (FI1, FI2) na rede, você deverá atualizar as colunas BankName e mspId para essas duas FIs. Para as FIs restantes (FI3, FI4, FI5, FI6), as colunas BankName e mspId devem ficar empty.

Nome do Campo Descrição Valores Padrão Atualização Necessária (Sim/Não) Atualizar Requisito
BankName Este é o mapeamento usado entre os nomes de instância do Oracle Blockchain Platform e BankNames usados no Aplicativo CBDC.

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

CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5 e Bank6 Sim Obrigatório para FIs ativas; deixe em branco para FIs não utilizadas.
mspId Esta coluna representa o ID MSP da instância real do Oracle Blockchain Platform. Você deverá atualizar esses valores se as instâncias do Oracle Blockchain Platform forem criadas com nomes diferentes dos valores padrão mencionados abaixo. CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5 e Bank6 Sim Obrigatório para FIs ativas; deixe em branco para FIs não utilizadas.
OrgName Esta coluna representa orgNames que mapeiam com o backend. CB representa o fundador e FI# representa os participantes. CB, FI1, FI2, FI3, FI4, FI5 e FI6 No ---

Pares

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

Por exemplo, se houver um Banco Central (CB) e duas Instituições Financeiras (FI#), cada uma com dois pares, você deverá informar um total de seis URLs pares juntamente com seu mspId associado.

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 Incorporar 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.
      OACCBDCProjectPath
      O caminho do projeto da pasta de trabalho do banco central no Analytics Cloud.
      OACFIProjectPath
      O caminho do projeto da pasta de trabalho da instituição financeira 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>