Analyse de Stablecoin

Oracle Blockchain Platform Digital Assets Edition inclut un exemple de classeur Oracle Analytics pour le scénario stablecoin.

Pour utiliser l'exemple de classeur Oracle Analytics, vous devez exécuter le script Oracle REST Data Services (ORDS) pour configurer les définitions de vue de base de données, puis importer les fichiers de classeur pour configurer Oracle Analytics Cloud.

Définitions des vues Oracle Database pour Stablecoin

Vous devez configurer les définitions de vue de base de données avant de pouvoir utiliser le classeur Oracle Analytics dans le scénario stablecoin.

Activez et configurez la base de données d'historique enrichi.
Pour plus d'informations, reportez-vous à Activation et configuration de la base de données d'historique enrichi dans le guide Utilisation d'Oracle Blockchain Platform.
Activer l'historique enrichi sur les canaux contenant les données de code chaîne à écrire dans la base de données d'historique enrichie. Pour plus d'informations, reportez-vous à Configuration des canaux qui écrivent des données dans la base de données d'historique enrichi dans le guide Utilisation d'Oracle Blockchain Platform.
Téléchargez et installez Node.js version 18 ou ultérieure.
Sur la page Ressources numériques d'Oracle Blockchain Platform, sélectionnez Stablecoin.
Cliquez sur Télécharger le package des définitions de vue de base de données.
Extrayez le fichier d'archive téléchargé.
Accédez au dossier ORDSscript et installez les dépendances requises en exécutant la commande suivante.
```
npm install
```

Modifiez le fichier .env fourni avec le script afin de le configurer pour votre environnement.

Les adresses Oracle REST Data Services utilisent le format général suivant.

<base_URL>/<user_name>/<resource_link>

Type d'environnement/de configuration	Variables d'environnement/de configuration	Description	Exemple
`DB Connection`	`CONNECTION_STRING`	Chaîne de connexion pour la base de données.	`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`	Nom du code chaîne à partir duquel extraire les détails de transaction dans la base de données d'historique enrichie.	`CHAINCODE_NAME="Stablecoin"`
`View Configuration`	`INSTANCE_NAME`	Nom de l'instance sur laquelle le code chaîne est déployé.	`INSTANCE_NAME="Stablecoin"`
`View Configuration`	`CHANNEL_NAME`	Nom du canal sur lequel le code chaîne est déployé.	`CHANNEL_NAME="default"`
`ORDS Endpoint Setup`	`MODULE_NAME`	Nom du module ORDS à utiliser. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`MODULE_NAME="demotest"`
`ORDS Endpoint Setup`	`BASE_PATH`	Chemin de base de l'URL ORDS. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`BASE_PATH="demotest"`
`ORDS Endpoint Setup`	`PATTERN`	Nom du modèle de l'URL ORDS. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`PATTERN="accountTransactionDetails"`
`ORDS REST Endpoint`	`ORDS_REST_BASE_URL`	URL de base de l'adresse REST ORDS de la base de données.	`ORDS_REST_BASE_URL="https://g536390e55ee33f4_db_high.adg.ap-sydney-1.example.com"`
`Alias Configuration`	`ALIAS_NAME`	Alias à utiliser à la place d'un nom utilisateur dans l'URL d'adresse REST. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`ALIAS_NAME="demotestAlias"`
`ORDS Role`	`ROLE_NAME`	Le rôle ORDS affecté à l'utilisateur. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`ROLE_NAME="demotest_role"`
`ORDS Privilege`	`PRIVILEGE_NAME`	Privilège ORDS affecté à l'utilisateur. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`PRIVILEGE_NAME="demotest_priv"`
`ORDS Privilege`	`LABEL`	Libellé du privilège ORDS. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`LABEL="demotest_label"`
`ORDS Privilege`	`DESCRIPTION`	Description du privilège ORDS. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`CLIENT_NAME`	Nom du client à utiliser pour l'authentification OAuth avec l'adresse REST ORDS. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`CLIENT_NAME="demotest_client"`
`OAuth Configuration`	`OWNER`	Nom du propriétaire à utiliser pour l'authentification OAuth avec l'adresse REST ORDS. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`OWNER="demotest"`
`OAuth Configuration`	`DESCRIPTION`	Description de la configuration OAuth. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`SUPPORT_EMAIL`	Adresse électronique du support technique pour la configuration OAuth. Il peut s'agir de n'importe quelle valeur qui n'entre pas en conflit avec les ressources existantes de la base de données.	`SUPPORT_EMAIL="test@example.com"`

Les vues Oracle Analytics suivantes sont générées par le script : ACCOUNTS_MOD, TRANSACTION_MOD et ACCOUNTS_TRANSACTION_MOD.

Exécutez le script ORDS à l'aide de la commande suivante.
```
npm run start
```
Lorsque la commande est exécutée, les invites suivantes s'affichent.

Enter your DB User Name

Entrez le nom utilisateur de la base de données d'historique enrichi. Le compte doit disposer des autorisations nécessaires pour créer des vues et des adresses ORDS.

Enter your DB Password

Entrez le mot de passe correspondant à la base de données d'historique enrichi.

Please select a chaincode type

Sélectionnez STABLECOIN. Utilisez les touches fléchées pour naviguer, puis appuyez sur la touche Entrée pour confirmer votre sélection.

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

Entrez y pour créer la vue et l'adresse. Entrez n si vous avez déjà créé la vue et l'adresse.

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

Si vous avez saisi y précédemment, entrez TS pour TypeScript.

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

Entrez y pour générer les informations d'identification d'adresse. Sinon, entrez n.

Configurer Oracle Analytics Cloud pour Stablecoin

Pour configurer Oracle Analytics Cloud et utiliser le classeur d'analyse pour le scénario stablecoin, procédez comme suit :

Créez une instance d'Oracle Autonomous Database.
Paramétrer les définitions de vue de la base de données. Pour plus d'informations sur la configuration des définitions de vue de base de données pour l'exemple stablecoin, reportez-vous à Oracle Database View Definitions for Stablecoin.
Créez une instance d'Oracle Analytics Cloud dans Oracle Cloud Infrastructure (OCI).
1. Connectez-vous à la console OCI.
2. Cliquez sur Analytics et IA > Oracle Analytics Cloud.
3. Sélectionnez Créer une instance, puis ajoutez les informations requises.
4. Sélectionnez Créer, puis attendez la fin de la création de l'instance.
Pour plus d'informations sur Oracle Analytics Cloud, reportez-vous à Oracle Analytics Cloud.
Sous Exemple de classeur d'analyse Stablecoin sur la page Ressources numériques dans Oracle Blockchain Platform Digital Assets Edition, sélectionnez Télécharger le package d'analyse échantillon. Le fichier StablecoinAnalyticsPackage.zip, qui contient l'exemple d'application, est téléchargé sur votre ordinateur.
Extrayez le fichier StablecoinAnalyticsPackage.zip qui contient le répertoire StablecoinAnalyticsPackage. Les fichiers de classeur (.dva) se trouvent dans le répertoire StablecoinAnalyticsPackage
Sauvegardez les deux fichiers de classeur, System Owner Dashboard.dva et Participating Org Dashboard.dva.
Accédez à Oracle Analytics Cloud dans la console OCI, puis sélectionnez Page d'accueil Analyse.
Sélectionnez Importer un classeur/flux et importez les deux fichiers de classeur. Sélectionnez Inclure tous les droits d'accès s'il existe. Entrez le mot de passe OraAnalytic@2025. Pour plus d'informations, reportez-vous à Importation d'un fichier de classeur.
Mettez à jour les détails de connexion à la source de données pour l'ensemble de données Analytics_Connection.
1. Accédez à la page Données dans Oracle Analytics Cloud.
2. Recherchez l'ensemble de données Analytics_Connection, puis sélectionnez Inspecter/Modifier > Mettre à jour la connexion à la base de données.
3. Mappez les vues de base de données.
4. Sélectionnez Enregistrer.
Pour plus d'informations sur la connexion d'Oracle Autonomous Transaction Processing à Oracle Analytics Cloud, reportez-vous à Connexion à Oracle Autonomous Transaction Processing.
Paramétrer les rôles et les autorisations pour les tableaux de bord du propriétaire système et de l'organisation des participants.
1. Dans Oracle Analytics Cloud, sélectionnez Console.
2. Sélectionnez Rôles et droits d'accès, puis Rôles d'application.
3. Sélectionnez Créer un rôle d'application et créez le rôle d'application SystemOwnerRole.
4. Sous Membres, sélectionnez Groupes, puis Ajouter des groupes.
5. Affectez des groupes aux rôles SystemOwnerRole et BI Dataload Author. Le rôle BI Dataload Author est requis pour intégrer des données Oracle Analytics Cloud dans Oracle Visual Builder. Les groupes Oracle Identity Cloud Service (IDCS) associés à l'exemple d'application doivent être mis en correspondance avec le rôle BI Dataload Author. Si les rôles SystemOwnerRole et BI Dataload Author ne sont pas mis en correspondance, les données analytiques ne seront pas affichées dans l'exemple d'application, même si Oracle Analytics Cloud est intégré à Oracle Visual Builder. Mettez en correspondance tous les groupes IDCS pertinents de l'application échantillon avec ces rôles. Par exemple, mappez les groupes suivants.
  - SYSTEM_ADMINS
  - SYSTEM_AUDITORS
  - SYSTEM_CREATORS
  - SYSTEM_MANAGERS
  - SYSTEM_ISSUERS
  - SYSTEM_RETIRERS
6. Créez des rôles pour les organisations participantes : ParticipantOrg1Role, ParticipantOrg2Role, etc.
7. Affectez des groupes aux rôles d'organisation des participants et au rôle BI Dataload Author. Vous pouvez créer des groupes avec n'importe quel nom, comme les exemples de groupes suivants. Dans les exemples de groupes suivants, modifiez le numéro de l'organisation participante dans le nom du groupe pour qu'il corresponde au rôle d'organisation correspondant.
  - ORG1_ADMINS
  - ORG1_AUDITORS
  - ORG1_MANAGERS
  - ORG1_OFFICERS
Pour plus d'informations, voir Affecter des rôles d'application à des groupes.
Mettez à jour les paramètres de nom d'instance pour les tableaux de bord propriétaire du système et organisation participante.
1. Connectez-vous en tant qu'administrateur et ouvrez le tableau de bord du propriétaire du système.
2. Sélectionnez Modifier.
3. Sous Paramètres, cliquez avec le bouton droit de la souris pour modifier le paramètre du nom de l'instance propriétaire du système.
4. Saisissez le nom de l'instance du propriétaire du système ou le code du prestataire de services d'adhésion. Par exemple, entrez CB.
5. Répétez les étapes précédentes pour mettre à jour le nom de l'instance propriétaire du système dans le tableau de bord de l'organisation du participant.
Mettez à jour les rôles dans le tableau de bord de l'organisation du participant.
1. Ouvrez le tableau de bord de l'organisation du participant, puis sélectionnez Modifier le tableau de bord.
2. Sélectionnez l'onglet Données, puis sélectionnez la vue System_Owner_Account_Trans_Mod-Participating_Org.
3. Sélectionnez Diagramme de jointure.
4. Ajoutez des rôles et des filtres pour chaque participant.
  1. Cliquez sur le bouton Ajouter en regard de Filtres de rôle.
  2. Ajoutez une expression de filtre qui inclut une requête. Par exemple, ajoutez la requête SQL suivante au rôle ParticipantOrg1Role, qui mentionne Org1 et Org2 en tant qu'organisations participantes.
```
FROM_ORG_ID = 'Org1' AND TO_ORG_ID = 'Org2'
```
    Vous devez ajouter des rôles et filtrer les expressions de manière séquentielle avant de passer au rôle suivant.
  3. Répétez ce processus pour les rôles ParticipantOrg2Role, ParticipantOrg3Role, etc.
Déplacez les tableaux de bord vers des dossiers partagés dans Oracle Analytics Cloud.
1. Accédez à Catalogue > Mes dossiers.
2. Créez un dossier nommé Shared dans le répertoire Shared Folders.
3. Déplacez les tableaux de bord du répertoire My Folders vers le dossier Shared dans le répertoire Shared Folders.
Testez soigneusement pour vous assurer que toutes les visualisations, connexions de données, accès utilisateur et autres fonctions fonctionnent comme prévu.