Stablecoin Analytics

Oracle Blockchain Platform Digital Assets Edition include una cartella di lavoro Oracle Analytics di esempio per lo scenario stablecoin.

Per utilizzare la cartella di lavoro di esempio di Oracle Analytics, è necessario eseguire lo script ORDS (Oracle REST Data Services) per impostare le definizioni delle viste di database, quindi importare i file della cartella di lavoro per configurare Oracle Analytics Cloud.

Definizioni vista Oracle Database per Stablecoin

È necessario impostare le definizioni delle viste di database prima di poter utilizzare la cartella di lavoro di Oracle Analytics nello scenario stablecoin.

Abilita e configura il database della cronologia avanzata.
Per ulteriori informazioni, vedere Abilitare e configurare il database Rich History in Uso di Oracle Blockchain Platform.
Abilita la cronologia avanzata sui canali che contengono i dati del codice concatenato che si desidera scrivere nel database della cronologia avanzata. Per ulteriori informazioni, vedere Configurare i canali che scrivono dati nel Rich History Database in Uso di Oracle Blockchain Platform.
Scaricare e installare Node.js versione 18 o successiva.
Nella pagina Asset digitali di Oracle Blockchain Platform, selezionare Stablecoin.
Fare clic su Scarica il package Database View Definitions.
Estrarre il file di archivio scaricato.
Passare alla cartella ORDSscript e installare le dipendenze richieste eseguendo il comando seguente.
```
npm install
```

Modificare il file .env fornito con lo script per configurarlo per l'ambiente in uso.

Gli endpoint di Oracle REST Data Services utilizzano il formato generale riportato di seguito.

<base_URL>/<user_name>/<resource_link>

Ambiente/Tipo di configurazione	Variabili di ambiente/configurazione	Descrizione	Esempio
`DB Connection`	`CONNECTION_STRING`	La stringa di connessione per il database.	`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`	Nome del codice concatenato da cui recuperare i dettagli delle transazioni nel database della cronologia RTF.	`CHAINCODE_NAME="Stablecoin"`
`View Configuration`	`INSTANCE_NAME`	Nome dell'istanza in cui viene distribuito il codice concatenato.	`INSTANCE_NAME="Stablecoin"`
`View Configuration`	`CHANNEL_NAME`	Nome del canale in cui viene distribuito il codice concatenato.	`CHANNEL_NAME="default"`
`ORDS Endpoint Setup`	`MODULE_NAME`	Il nome del modulo ORDS da utilizzare. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`MODULE_NAME="demotest"`
`ORDS Endpoint Setup`	`BASE_PATH`	Percorso di base dell'URL ORDS. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`BASE_PATH="demotest"`
`ORDS Endpoint Setup`	`PATTERN`	Nome del pattern dell'URL ORDS. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`PATTERN="accountTransactionDetails"`
`ORDS REST Endpoint`	`ORDS_REST_BASE_URL`	URL di base dell'endpoint REST ORDS del database.	`ORDS_REST_BASE_URL="https://g536390e55ee33f4_db_high.adg.ap-sydney-1.example.com"`
`Alias Configuration`	`ALIAS_NAME`	Alias da utilizzare al posto di un nome utente nell'URL dell'endpoint REST. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`ALIAS_NAME="demotestAlias"`
`ORDS Role`	`ROLE_NAME`	Ruolo ORDS assegnato all'utente. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`ROLE_NAME="demotest_role"`
`ORDS Privilege`	`PRIVILEGE_NAME`	Il privilegio ORDS assegnato all'utente. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`PRIVILEGE_NAME="demotest_priv"`
`ORDS Privilege`	`LABEL`	Etichetta per il privilegio ORDS. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`LABEL="demotest_label"`
`ORDS Privilege`	`DESCRIPTION`	Descrizione del privilegio ORDS. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`CLIENT_NAME`	Nome del client da utilizzare per l'autenticazione OAuth con l'endpoint REST ORDS. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`CLIENT_NAME="demotest_client"`
`OAuth Configuration`	`OWNER`	Nome del proprietario da utilizzare per l'autenticazione OAuth con l'endpoint REST ORDS. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`OWNER="demotest"`
`OAuth Configuration`	`DESCRIPTION`	Descrizione della configurazione OAuth. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`SUPPORT_EMAIL`	L'indirizzo e-mail di supporto per la configurazione OAuth. Questo può essere qualsiasi valore che non sia in conflitto con gli asset esistenti nel database.	`SUPPORT_EMAIL="test@example.com"`

Le viste Oracle Analytics riportate di seguito vengono generate dallo script: ACCOUNTS_MOD, TRANSACTION_MOD e ACCOUNTS_TRANSACTION_MOD.

Eseguire lo script ORDS utilizzando il comando seguente.
```
npm run start
```
Quando viene eseguito il comando, vengono visualizzati i seguenti prompt.

Enter your DB User Name

Immettere il nome utente per il database della cronologia avanzata. L'account deve disporre delle autorizzazioni necessarie per creare viste e endpoint ORDS.

Enter your DB Password

Immettere la password del database della cronologia avanzata.

Please select a chaincode type

Selezionare STABLECOIN. Utilizzare i tasti freccia per spostarsi, quindi premere Invio per confermare la selezione.

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

Immettere y per creare la vista e l'endpoint. Immettere n se la vista e l'endpoint sono già stati creati.

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

Se si è immesso y in precedenza, immettere TS per TypeScript.

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

Immettere y per generare le credenziali dell'endpoint. In caso contrario, immettere n.

Configurare Oracle Analytics Cloud per Stablecoin

Completare i passi riportati di seguito per configurare Oracle Analytics Cloud e utilizzare la cartella di lavoro di analitica per lo scenario di stablecoin.

Creare un'istanza di Oracle Autonomous Database.
Impostare le definizioni della vista del database. Per informazioni su come impostare le definizioni delle viste di database per l'esempio di stablecoin, vedere Oracle Database View Definitions for Stablecoin.
Crea un'istanza di Oracle Analytics Cloud in Oracle Cloud Infrastructure (OCI).
1. Eseguire il login a OCI Console.
2. Fare clic su Analytics e AI > Oracle Analytics Cloud.
3. Selezionare Crea istanza, quindi aggiungere le informazioni necessarie.
4. Selezionare Crea, quindi attendere il completamento della creazione dell'istanza.
Per ulteriori informazioni su Oracle Analytics Cloud, vedere Oracle Analytics Cloud.
In Cartella di lavoro Stablecoin Analytics di esempio nella pagina Asset digitali di Oracle Blockchain Platform Digital Assets Edition, selezionare Scarica package Analytics di esempio. Il file StablecoinAnalyticsPackage.zip, che contiene l'applicazione di esempio, viene scaricato sul computer.
Estrarre il file StablecoinAnalyticsPackage.zip contenente la directory StablecoinAnalyticsPackage. I file della cartella di lavoro (.dva) si trovano nella directory StablecoinAnalyticsPackage
Eseguire il backup di entrambi i file della cartella di lavoro, System Owner Dashboard.dva e Participating Org Dashboard.dva.
Passare a Oracle Analytics Cloud nella console OCI, quindi selezionare Home page di Analytics.
Selezionare Importa cartella di lavoro/flusso e importare entrambi i file della cartella di lavoro. Selezionare Includi tutte le autorizzazioni se esistenti. Immettere OraAnalytic@2025 come password. Per ulteriori informazioni, vedere Importazione di un file cartella di lavoro.
Aggiornare i dettagli di connessione all'origine dati per il set di dati Analytics_Connection.
1. Andare alla pagina Dati in Oracle Analytics Cloud.
2. Trovare il data set Analytics_Connection, quindi selezionare Ispeziona/Modifica > Aggiorna connessione al database.
3. Mappare le viste del database.
4. Selezionare Salva.
Per ulteriori informazioni sulla connessione di Oracle Autonomous Transaction Processing a Oracle Analytics Cloud, vedere Connettersi a Oracle Autonomous Transaction Processing.
Impostare i ruoli e le autorizzazioni per i dashboard del proprietario di sistema e dell'organizzazione dei partecipanti.
1. In Oracle Analytics Cloud selezionare Console.
2. Selezionare Ruoli e autorizzazioni, quindi selezionare Ruoli applicazione.
3. Selezionare Crea ruolo applicazione e creare il ruolo applicazione SystemOwnerRole.
4. In Membri selezionare Gruppi, quindi selezionare Aggiungi gruppi.
5. Assegnare i gruppi ai ruoli SystemOwnerRole e BI Dataload Author. Il ruolo BI Dataload Author è necessario per incorporare i dati di Oracle Analytics Cloud in Oracle Visual Builder. I gruppi Oracle Identity Cloud Service (IDCS) associati all'applicazione di esempio devono essere mappati al ruolo BI Dataload Author. Se i ruoli SystemOwnerRole e BI Dataload Author non vengono mappati, i dati di analitica non verranno visualizzati nell'applicazione di esempio, anche se Oracle Analytics Cloud è integrato con Oracle Visual Builder. Mappare tutti i gruppi IDCS pertinenti dall'applicazione di esempio a questi ruoli. Ad esempio, mappare i seguenti gruppi.
  - SYSTEM_ADMINS
  - SYSTEM_AUDITORS
  - SYSTEM_CREATORS
  - SYSTEM_MANAGERS
  - SYSTEM_ISSUERS
  - SYSTEM_RETIRERS
6. Creare ruoli per le organizzazioni partecipanti: ParticipantOrg1Role, ParticipantOrg2Role e così via.
7. Assegnare i gruppi ai ruoli organizzazione partecipanti e al ruolo BI Dataload Author. È possibile creare gruppi con qualsiasi nome, ad esempio i seguenti gruppi di esempio. Nei gruppi di esempio riportati di seguito, modificare il numero dell'organizzazione partecipante nel nome del gruppo in modo che corrisponda al ruolo organizzazione corrispondente.
  - ORG1_ADMINS
  - ORG1_AUDITORS
  - ORG1_MANAGERS
  - ORG1_OFFICERS
Per ulteriori informazioni, vedere Assegnare ruoli applicazione ai gruppi.
Aggiornare i parametri del nome dell'istanza per i dashboard del proprietario di sistema e dell'organizzazione partecipante.
1. Eseguire il login come amministratore e aprire il dashboard del proprietario del sistema.
2. Selezionare Modifica.
3. In Parametri, fare clic con il pulsante destro del mouse per modificare il parametro per il nome dell'istanza del proprietario del sistema.
4. Immettere il nome dell'istanza del proprietario del sistema o l'ID MSP (Membership Service Provider). Ad esempio, immettere CB.
5. Ripetere i passi precedenti per aggiornare il nome dell'istanza del proprietario del sistema nel dashboard dell'organizzazione partecipante.
Aggiornare i ruoli nel dashboard dell'organizzazione partecipante.
1. Aprire il dashboard dell'organizzazione partecipante, quindi selezionare Modifica dashboard.
2. Selezionare la scheda Dati, quindi selezionare la vista System_Owner_Account_Trans_Mod-Participating_Org.
3. Selezionare Join Diagram.
4. Aggiungere ruoli e filtri per ogni partecipante.
  1. Selezionare il pulsante Aggiungi accanto a Filtri ruolo.
  2. Aggiungere un'espressione di filtro che includa una query. Ad esempio, aggiungere la query SQL seguente al ruolo ParticipantOrg1Role, che menziona Org1 e Org2 come organizzazioni partecipanti.
```
FROM_ORG_ID = 'Org1' AND TO_ORG_ID = 'Org2'
```
    È necessario aggiungere ruoli ed espressioni di filtro in sequenza prima di passare al ruolo successivo.
  3. Ripetere questo processo per i ruoli ParticipantOrg2Role, ParticipantOrg3Role e così via.
Spostare i dashboard in cartelle condivise in Oracle Analytics Cloud.
1. Passare a Catalogo > Cartelle personali.
2. Creare una cartella denominata Shared nella directory Shared Folders.
3. Spostare i dashboard dalla directory My Folders alla cartella Shared nella directory Cartelle condivise.
Eseguire test approfonditi per garantire che tutte le visualizzazioni, le connessioni dati, l'accesso utente e altre funzioni funzionino come previsto.