Configurer Visual Builder pour l'exemple d'application Wholesale CBDC

Une fois que vous avez configuré tous les autres produits associés à Oracle Blockchain Platform, vous pouvez configurer Oracle Visual Builder pour qu'il se connecte à eux.

Présentation

Les détails suivants doivent être mis à jour dans la configuration d'Oracle Visual Builder. Vous obtenez ces détails lorsque vous configurez Oracle Blockchain Platform comme décrit dans Configuration d'Oracle Blockchain Platform pour l'exemple d'application CBDC de gros.

ID de proxy REST, URL d'instance et ID de fournisseur de services gérés de l'instance Oracle Blockchain Platform.
Voir : Extraire RestproxyId
ID client et clé secrète client de l'instance Oracle Blockchain Platform.
Voir : Extraire ClientId et ClientSecret.
Adresse Oracle REST Data Services (ORDS), ID client, clé secrète client et URL de base OAuth.
Voir : Créer des vues de base de données d'historique enrichi.
Nom de canal et nom de code chaîne.
Voir : Déployer le code chaîne pour l'exemple d'application Wholesale CBDC.

Mettre à jour les variables globales

Sur la page d'accueil des applications visuelles Visual Builder, cliquez sur Applications Web dans le navigateur pour ouvrir le panneau Applications Web.
Cliquez sur l'application cbdcapp. L'éditeur d'application s'ouvre.
Sélectionnez Variables.

Dans la section Variables globales, localisez l'objet de variable configuration et mettez à jour les paramètres suivants dans l'objet :

Nom de paramètre	Description	Valeur par défaut
`chaincodeName`	`chaincodeName` utilisé dans le réseau Oracle Blockchain Platform.	`WholesaleCBDC`
`ordsUrl`	URL endpoint ORDS, affichée dans la sortie du script de création de vue de base de données.	`https://g53630e55ee33f4-test.xyz.abc.oraclecloudapps.com/ords/obp/cbdc/accountTrxDetails`

Configurer des back-ends Visual Builder

Une connexion de service back-end dans Visual Builder permet d'établir la communication entre votre application visuelle et des systèmes externes en fournissant des détails essentiels tels que les informations de connexion, les propriétés et les adresses d'API REST nécessaires pour accéder à ces systèmes. Vous devez mettre à jour les back-ends avec Oracle Blockchain Platform et les détails de base de données d'historique enrichi.

Pour plus d'informations, reportez-vous à Présentation des back-ends.

Les back-ends suivants doivent être mis à jour :

Appels proxy REST
Inscriptions
Base de données d'historique enrichie

Appels proxy REST

Il existe une connexion de back-end et six connexions de service associées au proxy REST. Ces composants sont utilisés pour effectuer des appels proxy REST vers l'instance Oracle Blockchain Platform.

Back-end: CentralBank
Connexions de service: participantBank_FI1; participantBank_FI2; participantBank_FI3; participantBank_FI4; participantBank_FI5; participantBank_FI6

Pour mettre à jour les détails du serveur back-end, procédez comme suit :

Sur la page d'accueil des applications Visual Visual Builder, cliquez sur Services dans le navigateur pour ouvrir le panneau Services. Cliquez sur Back-ends pour afficher la liste des back-ends.
Sélectionnez le back-end à mettre à jour. Cliquez sur Serveurs.
Cliquez sur l'icône en regard du serveur par défaut.
Mettez à jour les éléments suivants dans les détails du serveur :
- URL d'instance : remplacez l'URL par défaut par l'URL d'instance Oracle Blockchain Platform en modifiant la partie URL de base de l'URL par défaut (test-xyz-abc.blockchain.ocp.oraclecloud.com). Exemple :
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy/api/v2/channels/{channelName}
```
- Variables de serveur : modifiez channelName pour refléter le nom du canal sur lequel le code chaîne est déployé.
- Authentification pour les utilisateurs connectés : l'assertion utilisateur OAuth 2.0 est utilisée pour l'authentification. Modifiez l'URL pour qu'elle corresponde à l'URL proxy REST Oracle Blockchain Platform. Exemple :
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- ID client et clé secrète client : cliquez sur l'icône Modifier en regard de ClientID. Mettez à jour les champs Client ID et Client Secret pour qu'ils correspondent à l'ID et à la clé secrète Oracle Blockchain Platform.
Répétez ces étapes pour mettre à jour les connexions de service de chacun des six participants en les sélectionnant dans la vue Connexions de service du volet Services.

Inscriptions

Il existe sept back-ends associés aux inscriptions à Oracle Blockchain Platform. Ces back-ends sont utilisés pour créer les inscriptions à l'instance Oracle Blockchain Platform.

Back-ends: CustomEnrollementCB; CustomEnrollementFI1; CustomEnrollementFI2; CustomEnrollementFI3; CustomEnrollementFI4; CustomEnrollementFI5; CustomEnrollementFI6

Pour mettre à jour les détails du serveur back-end, procédez comme suit :

Sur la page d'accueil des applications Visual Visual Builder, cliquez sur Services dans le navigateur pour ouvrir le panneau Services. Cliquez sur Back-ends pour afficher la liste des back-ends.
Sélectionnez le back-end à mettre à jour. Cliquez sur Serveurs.
Cliquez sur l'icône en regard du serveur par défaut.
Mettez à jour les éléments suivants dans les détails du serveur :
- URL d'instance : remplacez l'URL par défaut par l'URL d'instance Oracle Blockchain Platform en modifiant la partie URL de base de l'URL par défaut (test-xyz-abc.blockchain.ocp.oraclecloud.com). Exemple :
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/console/admin/api/v2/nodes/restproxies/{restProxyId}/enrollments
```
- Variables de serveur : modifiez restProxyId pour refléter l'ID de proxy REST réel de votre instance Oracle Blockchain Platform.
- Authentification pour les utilisateurs connectés : l'assertion utilisateur OAuth 2.0 est utilisée pour l'authentification. Modifiez l'URL pour qu'elle corresponde à l'URL proxy REST Oracle Blockchain Platform. Exemple :
```
https://centralbank-oabcs1-hyd.blockchain.ocp.oraclecloud.com:7443/restproxy
```
- ID client et clé secrète client : cliquez sur l'icône Modifier en regard de ClientID. Mettez à jour les champs Client ID et Client Secret pour qu'ils correspondent à l'ID et à la clé secrète Oracle Blockchain Platform.
Répétez ces étapes pour mettre à jour les back-ends de chacun des six participants en les sélectionnant dans la vue Back-ends du volet Services.

Base de données d'historique enrichie

Il existe un back-end lié à la base de données d'historique enrichi. Ce back-end est utilisé pour extraire les données de la base de données d'historique enrichi.

Back-end: RichHistoryDBConfiguration DB

Pour mettre à jour les détails du serveur back-end, procédez comme suit :

Sur la page d'accueil des applications Visual Visual Builder, cliquez sur Services dans le navigateur pour ouvrir le panneau Services. Cliquez sur Back-ends pour afficher la liste des back-ends.
Sélectionnez le back-end RichHistoryDBConfiguration DB. Cliquez sur Serveurs.
Cliquez sur l'icône en regard du serveur par défaut.
Mettez à jour les éléments suivants dans les détails du serveur :
- URL d'instance : remplacez l'URL par défaut par OAuth Base URL(ORDS_REST_BASE_URL/ords/<userName|aliasName>). Par exemple, l'URL par défaut :
```
https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
```
  serait remplacé par :
```
https://g53630e55ee33f4-rhjkdb.adb.ap-sydney-1.oraclecloudapps.com/ords/vbcstest
```
- Authentification pour les utilisateurs connectés : Basic est utilisé pour l'authentification.
- ID client et clé secrète client : cliquez sur l'icône Modifier en regard de Nom utilisateur. Mettez à jour le nom utilisateur avec Client ID et le mot de passe avec Client Secret pour qu'ils correspondent à l'ID d'adresse et à la clé secrète ORDS.

Configurer des objets fonctionnels Visual Builder

Un objet métier est une ressource, telle qu'une facture ou une commande d'achat, semblable à une table de base de données. Il comporte des champs contenant les données de votre application. A l'instar d'une table de base de données, un objet métier fournit la structure des données. Les objets fonctionnels sont stockés dans une base de données. Les applications de votre application visuelle et d'autres clients accèdent aux objets fonctionnels via leurs adresses REST.

Sur la page d'accueil des applications Visual Visual Builder, cliquez sur Objets métier dans le navigateur pour ouvrir le panneau Objets métier. Les objets CBDC de gros doivent être répertoriés.
Capture d'écran présentant la liste complète des objets fonctionnels appartenant à l'application échantillon CBDC de gros dans la vue Objets fonctionnels de Visual Builder.

Vous pouvez sélectionner n'importe quel objet métier et accéder à son onglet Données pour mettre à jour ou modifier ses données.

Noms d'organisation

Cet objet métier comporte quatre champs dans l'onglet Données et permet de connecter les instances Oracle Blockchain Platform avec le back-end approprié pour chaque banque. Par exemple, si un utilisateur saisit les détails Bank1 dans le système FI1, l'application doit lier FI1 à Bank1. De cette façon, chaque fois qu'un utilisateur associé à Bank1 se connecte, le système sait extraire les données du back-end FI1.

Dans cet objet fonctionnel, vous devez mettre à jour les colonnes BankName et mspId pour les colonnes orgNames respectives. Les mises à jour doivent correspondre au nombre de participants (IF) du réseau. Par exemple, s'il existe 2 FIs (FI1, FI2) dans le réseau, vous devez mettre à jour les colonnes BankName et mspId pour ces deux indicateurs. Pour les autres IF (FI3, FI4, FI5, FI6), les colonnes BankName et mspId doivent être à gauche de empty.

Nom du champ	Description	Valeurs par défaut	Mise à jour nécessaire (Oui/Non)	Mettre à jour le besoin
BankName	Correspondance utilisée entre les noms d'instance Oracle Blockchain Platform et `BankNames` utilisés dans l'application CBDC. Par exemple, si vous avez créé l'instance Oracle Blockchain Platform avec le nom `CentralBank` mais que vous voulez que `BankName` soit `BSP` dans l'application, ce mapping crée la correspondance entre l'instance Oracle Blockchain Platform et `BankName`.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5` et `Bank6`	Oui	Obligatoire pour les IF actives. Laissez le champ vide pour les IF inutilisées.
mspId	Cette colonne représente l'ID MSP réel de l'instance Oracle Blockchain Platform. Vous devez mettre à jour ces valeurs si des instances Oracle Blockchain Platform sont créées avec des noms autres que les valeurs par défaut mentionnées ci-dessous.	`CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5` et `Bank6`	Oui	Obligatoire pour les IF actives. Laissez le champ vide pour les IF inutilisées.
OrgName	Cette colonne représente `orgNames` qui est mis en correspondance avec le back-end. `CB` représente le fondateur et `FI#` représente les participants.	`CB, FI1, FI2, FI3, FI4, FI5` et `FI6`	No	---

Homologues

Cet objet métier est conçu pour stocker des informations sur les homologues dans toutes les instances Oracle Blockchain Platform du réseau. Pour entrer les détails de l'URL homologue dans l'objet fonctionnel, vous devez entrer les valeurs d'URL homologue correspondantes dans la colonne peerURL, ainsi que leurs ID de fournisseur de services d'appartenance Oracle Blockchain Platform respectifs (mspId).

Par exemple, s'il existe une banque centrale (CB) et deux institutions financières (FI#), chacune avec deux pairs, vous devez entrer un total de six URL homologues avec leur mspId associé.

Nom du champ	Description
orgName	Instance Oracle Blockchain Platform `mspId`.
peerURL	Valeur `peerURL` des instances Oracle Blockchain Platform.

Remarques :

Les homologues inclus dans cette interface métier doivent être ajoutés au canal commun qui a été créé.

Configurer Oracle Analytics Cloud pour Oracle Visual Builder

L'instance Oracle Analytics Cloud et l'instance Oracle Visual Builder doivent résider dans la même location OCI.

L'instance Oracle Analytics Cloud et l'instance Oracle Visual Builder doivent également utiliser le même service Oracle Identity Cloud Service pour la gestion des identités. Les utilisateurs qui accèdent à l'application Oracle Visual Builder doivent disposer des privilèges nécessaires pour Oracle Analytics Cloud et Oracle Visual Builder.

Avant de réaliser les étapes suivantes, configurez le progiciel d'analyse CBDC de gros. Pour plus d'informations, reportez-vous à la section Wholesale CBDC Sample Analytics Package.

Obtenez l'URL du domaine Oracle Visual Builder.
1. Sur la console OCI, cliquez sur Services de développeur > Visual Builder.
2. Sélectionnez votre instance Visual Builder, puis cliquez sur Page d'accueil Service. La page de l'interface Applications visuelles s'ouvre. Copiez le nom de domaine depuis la barre d'adresse de votre navigateur.
  Exemple de nom de domaine : Example: https://wcbdc-vb-oabcs1.builder.ap-hyderabad-1.ocp.example.com
Ajoutez le domaine en tant que domaine sécurisé dans Oracle Analytics Cloud.
1. Connectez-vous à votre instance Oracle Analytics Cloud, ouvrez la console Oracle Analytics Cloud, puis cliquez sur Menu du navigateur.
2. Sous Configuration et paramètres, cliquez sur Console > Domaines sécurisés.
3. Cliquez sur Ajouter un domaine, puis collez l'URL de domaine Visual Builder que vous avez copiée précédemment. Le domaine est ajouté automatiquement lorsque vous cliquez ailleurs sur l'affichage.
4. Cochez les cases Autoriser les cadres et Incorporation associées au domaine que vous venez d'ajouter.
Obtenez l'URL d'hôte Oracle Analytics Cloud.
1. Connectez-vous à votre instance Oracle Analytics Cloud.
2. Copiez l'URL d'hôte Oracle Analytics Cloud à partir de la barre d'adresse de votre navigateur. Copiez le nom de domaine complet jusqu'à .com, y compris https://.
  Exemple d'URL d'hôte : https://<your-oac-instance>.analytics.ocp.example.com
Ajoutez l'URL d'hôte Oracle Analytics Cloud en tant qu'origine autorisée dans Oracle Visual Builder.
1. Connectez-vous à votre instance Oracle Visual Builder, puis cliquez sur Page d'accueil Service.
2. Cliquez sur Menu de navigation, puis sur Paramètres. La page Paramètres de locataire apparaît.
3. Dans la section Origines autorisées, cliquez sur + Nouvelle origine, puis collez l'URL de domaine Analytics Cloud que vous avez copiée précédemment dans le champ Adresse d'origine.
Mettez à jour les variables de configuration dans l'application Visual Builder.
1. Ouvrez l'application cbdcapp dans l'éditeur d'application, puis sélectionnez Variables.
2. Dans la section Variables globales, mettez à jour les paramètres suivants dans l'objet configuration variable.
  
  OACHost
  
  URL de l'instance Oracle Analytics Cloud, que vous avez copiée précédemment.
  
  OACCBDCProjectPath
  
  Chemin du projet pour le classeur de la banque centrale dans Analytics Cloud.
  
  OACFIProjectPath
  
  Chemin du projet pour le classeur de l'institution financière dans Analytics Cloud.
3. Pour obtenir le chemin de projet d'un classeur, cliquez sur Navigateur > Catalogue sur la page d'accueil Analytics Cloud.
4. Cliquez sur le menu Actions du classeur, puis sélectionnez Inspecter. La fenêtre Inspecter s'affiche.
5. Cliquez sur l'onglet Général, puis sur Copier associé à l'ID d'objet.
Modifiez le code HTML dans Visual Builder.
1. Ouvrez l'application cbdcapp dans l'éditeur d'application, puis accédez à la section HTML.
2. Mettez à jour l'URL d'hôte Analytics Cloud sur les lignes 30 et 31 pour qu'elle corresponde à votre instance Analytics Cloud, comme indiqué dans le fragment de code suivant. Ne modifiez pas la structure de sous-répertoire de l'URL, mais uniquement la partie domaine jusqu'à .com.
```
<script src="https://abc-xyz-ia.analytics.ocp.example.com/public/dv/v1/embedding/jet/embedding.js" type="application/javascript"></script>
```