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.
- ID de proxy REST, URL da instância e IDs MSP da instância do Oracle Blockchain Platform.
Consulte: Extrair RestproxyId
- ID do Cliente e segredo do cliente da instância do Oracle Blockchain Platform.
Consulte: Extraia ClientId e ClientSecret.
- Ponto final do Oracle REST Data Services (ORDS), ID do cliente, segredo do cliente e URL base OAuth.
- Nome do canal e nome do chaincode.
Consulte: Implantar o Chaincode para o Aplicativo de Amostra de CBDC Atacado.
Atualizar Variáveis Globais
- Na home page Aplicativos Visuais do Visual Builder, clique em Aplicativos Web no Navegador para abrir o painel Aplicativos Web.
- Clique no aplicativo
cbdcapp
. O editor de aplicativos é aberto. - Selecione Variáveis.
- 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?.
- 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.
- 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.
- Selecione o backend que você deseja atualizar. Clique em Servidores.
- Clique no ícone Editar ao lado do servidor padrão.
- 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
eClient Secret
para corresponder ao seu ID e segredo do Oracle Blockchain Platform.
- 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 (
- 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.
- 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.
- Selecione o backend que você deseja atualizar. Clique em Servidores.
- Clique no ícone Editar ao lado do servidor padrão.
- 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
eClient Secret
para corresponder ao seu ID e segredo do Oracle Blockchain Platform.
- 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 (
- 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.
- 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.
- Selecione o backend
RichHistoryDBConfiguration DB
. Clique em Servidores. - Clique no ícone Editar ao lado do servidor padrão.
- 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:
seria substituído por:https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
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 comClient Secret
para corresponder ao seu ID de ponto final e segredo do ORDS.
- URL da Instância: Substitua o URL padrão por
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.
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, 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.
- Obtenha o URL do domínio do Oracle Visual Builder.
- No console da OCI, clique em Developer Services > Visual Builder.
- 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
- Adicione o domínio como um domínio seguro no Oracle Analytics Cloud.
- 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.
- Em Configuração e Definições, clique em Console > Domínios Seguros.
- 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.
- Marque as caixas de seleção Permitir Quadros e Incorporar associadas ao domínio que você acabou de adicionar.
- Obtenha o URL do host do Oracle Analytics Cloud.
- Faça log-in na sua instância do Oracle Analytics Cloud.
- 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
, incluindohttps://
.Exemplo de URL do host:
https://<your-oac-instance>.analytics.ocp.example.com
- Adicione o URL do host do Oracle Analytics Cloud como uma origem permitida no Oracle Visual Builder.
- Faça log-in na instância do Oracle Visual Builder e clique em Página Inicial do Serviço.
- Clique em Menu de Navegação e, em seguida, clique em Configurações. A página Definições do Tenant é exibida.
- 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.
- Atualize as variáveis de configuração no aplicativo Visual Builder.
- Abra o aplicativo
cbdcapp
no editor de aplicativos e selecione Variáveis. - Na seção Variáveis Globais, atualize os parâmetros a seguir no objeto variável de configuração.
- Para obter o caminho do projeto de uma pasta de trabalho, clique em Navegador > Catálogo na home page do Analytics Cloud.
- Clique no menu Ações da pasta de trabalho e selecione Inspecionar. A janela Inspecionar é exibida.
- Clique na guia Geral e, em seguida, clique em Copiar que está associado ao ID do Objeto.
- Abra o aplicativo
- Edite o HTML no Visual Builder.
- Abra o aplicativo
cbdcapp
no editor de aplicativos e navegue até a seção HTML. - 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>
- Abra o aplicativo