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.
- 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.
- 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.
- 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
etClient Secret
pour qu'ils correspondent à l'ID et à la clé secrète Oracle Blockchain Platform.
- 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 (
- 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.
- 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
etClient Secret
pour qu'ils correspondent à l'ID et à la clé secrète Oracle Blockchain Platform.
- 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 (
- 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.
- 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 :
serait remplacé par :https://g53630e55ee33f4-abc.def.gh-xyz-1.oraclecloudapps.com/ords/aliasName
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 avecClient Secret
pour qu'ils correspondent à l'ID d'adresse et à la clé secrète ORDS.
- URL d'instance : remplacez l'URL par défaut par
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.
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, 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.
- Sur la console OCI, cliquez sur Services de développeur > Visual Builder.
- 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.
- Connectez-vous à votre instance Oracle Analytics Cloud, ouvrez la console Oracle Analytics Cloud, puis cliquez sur Menu du navigateur.
- Sous Configuration et paramètres, cliquez sur Console > Domaines sécurisés.
- 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.
- 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.
- Connectez-vous à votre instance Oracle Analytics Cloud.
- 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 comprishttps://
.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.
- Connectez-vous à votre instance Oracle Visual Builder, puis cliquez sur Page d'accueil Service.
- Cliquez sur Menu de navigation, puis sur Paramètres. La page Paramètres de locataire apparaît.
- 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.
- Ouvrez l'application
cbdcapp
dans l'éditeur d'application, puis sélectionnez Variables. - Dans la section Variables globales, mettez à jour les paramètres suivants dans l'objet configuration variable.
- Pour obtenir le chemin de projet d'un classeur, cliquez sur Navigateur > Catalogue sur la page d'accueil Analytics Cloud.
- Cliquez sur le menu Actions du classeur, puis sélectionnez Inspecter. La fenêtre Inspecter s'affiche.
- Cliquez sur l'onglet Général, puis sur Copier associé à l'ID d'objet.
- Ouvrez l'application
- Modifiez le code HTML dans Visual Builder.
- Ouvrez l'application
cbdcapp
dans l'éditeur d'application, puis accédez à la section HTML. - 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>
- Ouvrez l'application