Analyse de Stablecoin

Oracle Blockchain Platform Digital Assets Edition comprend 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 de vue 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.

Activer et configurer la base de données d'historique complet.
Pour plus d'informations, voir Activer et configurer la base de données d'historique enrichi dans Utilisation d'Oracle Blockchain Platform.
Activez l'historique enrichi sur les canaux qui contiennent les données de code de chaîne à écrire dans la base de données de l'historique enrichi. Pour plus d'informations, voir Configurer les canaux qui écrivent des données dans la base de données d'historique enrichi dans Utilisation d'Oracle Blockchain Platform.
Téléchargez et installez Node.js version 18 ou ultérieure.
Dans la page Ressources numériques d'Oracle Blockchain Platform, sélectionnez Stablecoin.
Cliquez sur Télécharger l'ensemble Définitions de vue de base de données.
Extraire le fichier d'archives téléchargé.
Naviguez jusqu'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 pour le configurer pour votre environnement.

Les points d'extrémité Oracle REST Data Services utilisent le format général suivant.

<base_URL>/<user_name>/<resource_link>

Environnement/Type 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 de chaîne à partir duquel extraire les détails des transactions de la base de données d'historique enrichi.	`CHAINCODE_NAME="Stablecoin"`
`View Configuration`	`INSTANCE_NAME`	Nom de l'instance où le code de chaîne est déployé.	`INSTANCE_NAME="Stablecoin"`
`View Configuration`	`CHANNEL_NAME`	Nom du canal où le code de chaîne est déployé.	`CHANNEL_NAME="default"`
`ORDS Endpoint Setup`	`MODULE_NAME`	Nom du module ORDS à utiliser. Il peut s'agir de toute valeur qui n'est 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 toute valeur qui n'est 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 toute valeur qui n'est 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 du point d'extrémité 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 d'utilisateur dans l'URL du point d'extrémité REST. Il peut s'agir de toute valeur qui n'est pas en conflit avec les ressources existantes de la base de données.	`ALIAS_NAME="demotestAlias"`
`ORDS Role`	`ROLE_NAME`	Rôle ORDS affecté à l'utilisateur. Il peut s'agir de toute valeur qui n'est 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 toute valeur qui n'est pas en conflit avec les ressources existantes de la base de données.	`PRIVILEGE_NAME="demotest_priv"`
`ORDS Privilege`	`LABEL`	Étiquette du privilège ORDS. Il peut s'agir de toute valeur qui n'est 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 toute valeur qui n'est 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 le point d'extrémité REST ORDS. Il peut s'agir de toute valeur qui n'est pas en conflit avec les ressources existantes de la base de données.	`CLIENT_NAME="demotest_client"`
`OAuth Configuration`	`OWNER`	Nom du responsable à utiliser pour l'authentification OAuth avec le point d'extrémité REST ORDS. Il peut s'agir de toute valeur qui n'est 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 toute valeur qui n'est pas en conflit avec les ressources existantes de la base de données.	`DESCRIPTION="demotest_description"`
`OAuth Configuration`	`SUPPORT_EMAIL`	Adresse de courriel du soutien pour la configuration OAuth. Il peut s'agir de toute valeur qui n'est 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 sont affichées.

Enter your DB User Name

Entrez le nom d'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 points d'extrémité ORDS.

Enter your DB Password

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

Please select a chaincode type

Sélectionnez STABLECOIN. Utilisez les flèches 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 le point d'extrémité. Entrez n si vous avez déjà créé la vue et le point d'extrémité.

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

Si vous avez entré 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 données d'identification du point d'extrémité. Sinon, entrez n.

Configurer Oracle Analytics Cloud pour Stablecoin

Effectuez les étapes suivantes pour configurer Oracle Analytics Cloud et utiliser le classeur d'analyse pour le scénario stablecoin.

Créez une instance d'Oracle Autonomous Database.
définition des vues de base de données; Pour plus d'informations sur la configuration des définitions de vue de base de données pour l'échantillon de stablecoin, voir Définitions de vue d'Oracle Database pour Stablecoin.
Créez une instance d'Oracle Analytics Cloud dans Oracle Cloud Infrastructure (OCI).
1. Connectez-vous à la console OCI.
2. Cliquez sur Analyse et intelligence artificielle > 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, voir Oracle Analytics Cloud.
Sous Exemple de classeur d'analyse Stablecoin dans la page Ressources numériques d'Oracle Blockchain Platform - Édition des ressources numériques, sélectionnez Télécharger l'exemple d'ensemble d'analyse. 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.
Naviguez jusqu'à Oracle Analytics Cloud dans la console OCI, puis sélectionnez Page d'accueil des analyses.
Sélectionnez Importer le classeur/flux et importez les deux fichiers de classeur. Sélectionnez Inclure toutes les autorisations s'il existe. Entrez le mot de passe OraAnalytic@2025. Pour plus d'informations, voir Importer un fichier de classeur.
Mettez à jour les détails de connexion à la source de données pour le jeu de données Analytics_Connection.
1. Allez à la page Données dans Oracle Analytics Cloud.
2. Recherchez le jeu 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, voir Connexion à Oracle Autonomous Transaction Processing.
Configurer les rôles et les autorisations pour le responsable du système et les tableaux de bord de l'organisation du participant.
1. Dans Oracle Analytics Cloud, sélectionnez Console.
2. Sélectionnez Rôles et autorisations, 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 mappés au rôle BI Dataload Author. Si les rôles SystemOwnerRole et BI Dataload Author ne sont pas mappés, les données d'analyse ne seront pas affichées dans l'exemple d'application, même si Oracle Analytics Cloud est intégré à Oracle Visual Builder. Mappez tous les groupes IDCS pertinents de l'exemple d'application à 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 du participant et au rôle BI Dataload Author. Vous pouvez créer des groupes avec n'importe quel nom, tels que 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 le responsable du système et les tableaux de bord de l'organisation du participant.
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 responsable du système.
4. Entrez le nom de l'instance du responsable du système ou le fournisseur de services d'association (MSP). Par exemple, entrez CB.
5. Répétez les étapes précédentes pour mettre à jour le nom de l'instance responsable du système dans le tableau de bord de l'organisation du participant.
Mettre à 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. Sélectionnez le bouton Ajouter à côté de Filtres de rôle.
  2. Ajoutez une expression de filtre qui inclut une interrogation. Par exemple, ajoutez l'interrogation 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. Naviguez jusqu'à 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 Dossiers partagés.
Effectuez des tests approfondis pour vous assurer que toutes les visualisations, connexions de données, accès utilisateur et autres fonctions fonctionnent comme prévu.