Análise de Stablecoin

O Oracle Blockchain Platform Digital Assets Edition inclui uma amostra de pasta de trabalho do Oracle Analytics para o cenário de stablecoin.

Para usar a pasta de trabalho de amostra do Oracle Analytics, execute o script ORDS (Oracle REST Data Services) para configurar as definições de exibição do banco de dados e, em seguida, importe os arquivos de pasta de trabalho para configurar o Oracle Analytics Cloud.

Ver definições do Oracle Database para Stablecoin

Configure as definições de exibição do banco de dados antes de usar a pasta de trabalho do Oracle Analytics no cenário stablecoin.

Ative e configure o banco de dados de histórico avançado.
Para obter mais informações, consulte Ativar e Configurar o Banco de Dados de Histórico Rico em Usando o Oracle Blockchain Platform.
Ative o histórico avançado nos canais que contêm os dados de chaincode que você deseja gravar no banco de dados rich history. Para obter mais informações, consulte Configurar os Canais que Gravam Dados no Banco de Dados de Histórico Rico em Usando o Oracle Blockchain Platform.
Faça download do Node.js versão 18 ou posterior e instale-o.
Na página Ativos Digitais no Oracle Blockchain Platform, selecione Stablecoin.
Clique em Fazer Download do pacote de Definições de View do Banco de Dados.
Extraia o arquivo compactado baixado.
Navegue até a pasta ORDSscript e instale as dependências necessárias executando o comando a seguir.
```
npm install
```

Edite o arquivo .env que é fornecido com o script para configurá-lo para seu ambiente.

Os pontos finais do Oracle REST Data Services usam o seguinte formato geral.

<base_URL>/<user_name>/<resource_link>

Tipo de Ambiente/Configuração	Variáveis de Ambiente/Configuração	Descrição	Exemplo
`DB Connection`	`CONNECTION_STRING`	A string de conexão para o banco de dados.	`CONNECTION_STRING="(description= (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522) (host=adg.ap-sydney-1.example.com))(connect_data= (service_name=g536390e55ee33f4_db_high.adg.example.com))(security=(ssl_server_dn_match=yes)))"`
`View Configuration`	`CHAINCODE_NAME`	O nome do chaincode do qual extrair detalhes da transação no banco de dados rich history.	`CHAINCODE_NAME="Stablecoin"`
`View Configuration`	`INSTANCE_NAME`	O nome da instância em que o chaincode está implantado.	`INSTANCE_NAME="Stablecoin"`
`View Configuration`	`CHANNEL_NAME`	O nome do canal no qual o chaincode está implantado.	`CHANNEL_NAME="default"`
`ORDS Endpoint Setup`	`MODULE_NAME`	O nome do módulo ORDS a ser usado. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`MODULE_NAME="demotest"`
`ORDS Endpoint Setup`	`BASE_PATH`	O caminho base do URL do ORDS. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`BASE_PATH="demotest"`
`ORDS Endpoint Setup`	`PATTERN`	O nome do padrão do URL do ORDS. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`PATTERN="accountTransactionDetails"`
`ORDS REST Endpoint`	`ORDS_REST_BASE_URL`	O URL base do ponto final REST do ORDS do banco de dados.	`ORDS_REST_BASE_URL="https://g536390e55ee33f4_db_high.adg.ap-sydney-1.example.com"`
`Alias Configuration`	`ALIAS_NAME`	O alias a ser usado no lugar de um nome de usuário no URL do ponto final REST. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`ALIAS_NAME="demotestAlias"`
`ORDS Role`	`ROLE_NAME`	A função ORDS que é atribuída ao usuário. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`ROLE_NAME="demotest_role"`
`ORDS Privilege`	`PRIVILEGE_NAME`	O privilégio ORDS atribuído ao usuário. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`PRIVILEGE_NAME="demotest_priv"`
`ORDS Privilege`	`LABEL`	Um rótulo para o privilégio ORDS. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`LABEL="demotest_label"`
`ORDS Privilege`	`DESCRIPTION`	Uma descrição do privilégio ORDS. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`CLIENT_NAME`	O nome do cliente a ser usado para autenticação OAuth com o ponto final REST do ORDS. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`CLIENT_NAME="demotest_client"`
`OAuth Configuration`	`OWNER`	O nome do proprietário a ser usado para autenticação OAuth com o ponto final REST do ORDS. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`OWNER="demotest"`
`OAuth Configuration`	`DESCRIPTION`	Uma descrição da configuração OAuth. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`SUPPORT_EMAIL`	O endereço de e-mail de suporte para a configuração OAuth. Pode ser qualquer valor que não entre em conflito com os ativos existentes no banco de dados.	`SUPPORT_EMAIL="test@example.com"`

As seguintes views do Oracle Analytics são geradas pelo script: ACCOUNTS_MOD, TRANSACTION_MOD e ACCOUNTS_TRANSACTION_MOD.

Execute o script ORDS usando o comando a seguir.
```
npm run start
```
Quando o comando é executado, os prompts a seguir são exibidos.

Enter your DB User Name

Informe o nome do usuário do banco de dados de histórico avançado. A conta deve ter as permissões necessárias para criar views e pontos finais do ORDS.

Enter your DB Password

Informe a senha do banco de dados do histórico avançado.

Please select a chaincode type

Selecione STABLECOIN. Use as teclas de seta para navegar e pressione a tecla Enter para confirmar sua seleção.

Do you want to create the View and ORDS Endpoint? (y/n)

Digite y para criar a view e o ponto final. Informe n se você já tiver criado a view e o ponto final.

Please select the language of your chaincode? (TS/GO)

Se você digitou y anteriormente, digite TS para TypeScript.

Do you want to generate ORDS Endpoint URL and Bearer Token? (y/n)

Digite y para gerar as credenciais do ponto final. Caso contrário, informe n.

Configurar o Oracle Analytics Cloud para Stablecoin

Siga as etapas abaixo para configurar o Oracle Analytics Cloud e usar a pasta de trabalho de análise para o cenário stablecoin.

Crie uma instância do Oracle Autonomous Database.
Definir as definições de visualização do banco de dados. Para obter informações sobre como configurar as definições de visualização do banco de dados para a amostra stablecoin, consulte Oracle Database View Definitions for Stablecoin.
Crie uma instância do Oracle Analytics Cloud na Oracle Cloud Infrastructure (OCI).
1. Faça log-on na console do OCI.
2. Clique em Análise e IA > Oracle Analytics Cloud.
3. Selecione Criar Instância e adicione as informações necessárias.
4. Selecione Criar e aguarde a conclusão da criação da instância.
Para mais informações sobre a Oracle Analytics Cloud, consulte Oracle Analytics Cloud.
Em Pasta de Trabalho de Análise de Stablecoin de Amostra na página Ativos Digitais no Oracle Blockchain Platform Digital Assets Edition, selecione Fazer download do pacote de Análise de amostra. O arquivo StablecoinAnalyticsPackage.zip, que contém o aplicativo de amostra, é baixado no seu computador.
Extraia o arquivo StablecoinAnalyticsPackage.zip, que contém o diretório StablecoinAnalyticsPackage. Os arquivos da pasta de trabalho (.dva) estão no diretório StablecoinAnalyticsPackage
Faça backup dos arquivos de pasta de trabalho, System Owner Dashboard.dva e Participating Org Dashboard.dva.
Navegue até o Oracle Analytics Cloud na console do OCI e selecione Home Page do Analytics.
Selecione Importar Pasta de Trabalho/Fluxo e importe os dois arquivos de pasta de trabalho. Selecione Incluir todas as permissões, se existir. Informe OraAnalytic@2025 como a senha. Para obter mais informações, consulte Importar um Arquivo de Pasta de Trabalho.
Atualize os detalhes da conexão da origem de dados para o conjunto de dados Analytics_Connection.
1. Vá para a página Dados no Oracle Analytics Cloud.
2. Localize o conjunto de dados Analytics_Connection e selecione Inspecionar/Editar > Atualizar conexão com o banco de dados.
3. Mapeie as views do banco de dados.
4. Selecione Salvar.
Para obter mais informações sobre como conectar o Oracle Autonomous Transaction Processing ao Oracle Analytics Cloud, consulte Conectar ao Oracle Autonomous Transaction Processing.
Configure funções e permissões para os painéis de controle do proprietário do sistema e da organização participante.
1. No Oracle Analytics Cloud, selecione Console.
2. Selecione Atribuições e Permissões e, em seguida, Atribuições de Aplicativo.
3. Selecione Criar Atribuição de Aplicativo e crie a atribuição de aplicativo SystemOwnerRole.
4. Em Membros, selecione Grupos e, em seguida, Adicionar Grupos.
5. Designe grupos às atribuições SystemOwnerRole e BI Dataload Author. A atribuição BI Dataload Author é necessária para incorporar dados do Oracle Analytics Cloud ao Oracle Visual Builder. Os grupos do Oracle Identity Cloud Service (IDCS) associados ao aplicativo de amostra devem ser mapeados para a atribuição BI Dataload Author. Se as atribuições SystemOwnerRole e BI Dataload Author não forem mapeadas, os dados de análise não serão mostrados no aplicativo de amostra, mesmo que o Oracle Analytics Cloud esteja integrado ao Oracle Visual Builder. Mapeie todos os grupos do IDCS relevantes do aplicativo de amostra para essas atribuições. Por exemplo, mapeie os seguintes grupos.
  - SYSTEM_ADMINS
  - SYSTEM_AUDITORS
  - SYSTEM_CREATORS
  - SYSTEM_MANAGERS
  - SYSTEM_ISSUERS
  - SYSTEM_RETIRERS
6. Crie funções para as organizações participantes: ParticipantOrg1Role, ParticipantOrg2Role e assim por diante.
7. Atribua grupos às funções da organização do participante e à função BI Dataload Author. Você pode criar grupos com qualquer nome, como os grupos de exemplo a seguir. Nos grupos de exemplo a seguir, altere o número da organização participante no nome do grupo para corresponder à função da organização correspondente.
  - ORG1_ADMINS
  - ORG1_AUDITORS
  - ORG1_MANAGERS
  - ORG1_OFFICERS
Para obter mais informações, consulte Designar Atribuições de Aplicativo a Grupos.
Atualize os parâmetros de nome da instância para os painéis de controle do proprietário do sistema e da organização participante.
1. Faça login como administrador e abra o painel de controle do proprietário do sistema.
2. Selecione Editar.
3. Em Parâmetros, clique com o botão direito do mouse para editar o parâmetro do nome da instância do proprietário do sistema.
4. Insira o nome da instância do proprietário do sistema ou o ID do provedor de serviços de associação (MSP). Por exemplo, informe CB.
5. Repita as etapas anteriores para atualizar o nome da instância do proprietário do sistema no painel da organização do participante.
Atualize as funções no painel da organização do participante.
1. Abra o painel da organização do participante e selecione Editar Painel.
2. Selecione a guia Dados e selecione a exibição System_Owner_Account_Trans_Mod-Participating_Org.
3. Selecione Diagrama de Associação.
4. Adicione funções e filtros para cada participante.
  1. Selecione o botão Adicionar ao lado de Filtros de função.
  2. Adicione uma expressão de filtro que inclua uma consulta. Por exemplo, adicione a seguinte consulta SQL à atribuição ParticipantOrg1Role, que menciona Org1 e Org2 como organizações participantes.
```
FROM_ORG_ID = 'Org1' AND TO_ORG_ID = 'Org2'
```
    Adicione funções e filtre expressões sequencialmente antes de passar para a próxima função.
  3. Repita esse processo para as funções ParticipantOrg2Role, ParticipantOrg3Role e assim por diante.
Mova os painéis de controle para pastas compartilhadas no Oracle Analytics Cloud.
1. Navegue até Catálogo > Minhas Pastas.
2. Crie uma pasta chamada Shared no diretório Shared Folders.
3. Mova os painéis do diretório My Folders para a pasta Shared dentro do diretório Pastas Compartilhadas.
Faça um teste completo para garantir que todas as visualizações, conexões de dados, acesso do usuário e outras funções estejam funcionando conforme esperado.