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.

Mettre à jour les variables globales

  1. Sur la page d'accueil des applications visuelles Visual Builder, cliquez sur Applications Web dans le navigateur pour ouvrir le panneau Applications Web.
  2. Cliquez sur l'application cbdcapp. L'éditeur d'application s'ouvre.
  3. Sélectionnez Variables.
  4. 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 :
  1. 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.
  2. Sélectionnez le back-end à mettre à jour. Cliquez sur Serveurs.
  3. Cliquez sur l'icône en regard du serveur par défaut.
  4. 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.
  5. 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 :
  1. 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.
  2. Sélectionnez le back-end à mettre à jour. Cliquez sur Serveurs.
  3. Cliquez sur l'icône en regard du serveur par défaut.
  4. 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.
  5. 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 :
  1. 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.
  2. Sélectionnez le back-end RichHistoryDBConfiguration DB. Cliquez sur Serveurs.
  3. Cliquez sur l'icône en regard du serveur par défaut.
  4. 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.

  1. 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

  2. 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.
  3. 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

  4. 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.
  5. 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.
  6. 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>