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
    channel Nom du canal sur lequel le code chaîne est déployé. test
    confidentialApplication Variable booléenne définie sur true pour le mode confidentiel, false pour le mode générique. false
    ordsEndpointUrls Objet contenant les URL d'adresse ORDS pour le propriétaire du système et les organisations participantes, qui sont affichées dans la sortie du script de création de vue de base de données. En mode générique, vous mettez à jour uniquement l'adresse du propriétaire système et vous devez conserver les valeurs par défaut de toutes les organisations participantes. En mode confidentiel, vous mettez à jour toutes les adresses. Consultez les informations suivantes pour plus de détails
    restproxyId Objet contenant les ID proxy REST pour le propriétaire du système et les organisations participantes. Tous les ID doivent être spécifiés, quel que soit le mode d'application. Consultez les informations suivantes pour plus de détails
    Exemple d'objet ordsEndpointUrls, mode générique :
    "ordsEndpointUrls": {
        "SystemOwner": "https://<base_URL>/ords/obp/cbdc/accountTrxDetails",
        "ParticipantOrg1": "<default_value>",
        "ParticipantOrg2": "<default_value>",
        "ParticipantOrg3": "<default_value>",
        "ParticipantOrg4": "<default_value>",
        "ParticipantOrg5": "<default_value>",
        "ParticipantOrg6": "<default_value>"
    }
    Exemple d'objet ordsEndpointUrls, mode confidentiel :
    "ordsEndpointUrls": {
        "SystemOwner": "https://cb-centralbank.example.com/ords/obp/cbdc/accountTrxDetails",
        "ParticipantOrg1": "https://bank1.example.com/ords/obp/cbdc/accountTrxDetails",
        "ParticipantOrg2": "https://bank2.example.com/ords/obp/cbdc/accountTrxDetails",
        "ParticipantOrg3": "https://bank3.example.com/ords/obp/cbdc/accountTrxDetails",
        "ParticipantOrg4": "https://bank4.example.com/ords/obp/cbdc/accountTrxDetails",
        "ParticipantOrg5": "https://bank5.example.com/ords/obp/cbdc/accountTrxDetails",
        "ParticipantOrg6": "https://bank6.example.com/ords/obp/cbdc/accountTrxDetails"
    }
    Exemple d'objet restproxyId, les deux modes :
    "restproxyId": {
        "systemOwner": "restProxy_CentralBank",
        "participantOrg1": "restProxy_Bank1",
        "participantOrg2": "restProxy_Bank2",
        "participantOrg3": "restProxy_Bank3",
        "participantOrg4": "restProxy_Bank4",
        "participantOrg5": "restProxy_Bank5",
        "participantOrg6": "restProxy_Bank6"
    }

Configurer des back-ends Visual Builder

Dans Visual Builder, une connexion de service back-end permet d'établir la communication entre votre application visuelle et les 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.

Pour plus d'informations, reportez-vous à Que sont les back-ends ?.

Pour configurer les back-ends Visual Builder pour les interactions Oracle Blockchain Platform et les interactions riches avec la base de données d'historique, procédez comme suit :

Configuration de back-end pour les interactions Oracle Blockchain Platform

L'application CBDC de gros utilise les back-ends Visual Builder pour gérer les interactions avec Oracle Blockchain Platform.
Propriétaire du système
SystemOwnerMgmt : gère les interactions et la création d'inscription Oracle Blockchain Platform pour le propriétaire du système.
SystemOwnerRestproxyConfiguration : back-end dédié qui gère les appels de proxy REST pour le propriétaire du système.
Organisations participantes
ParticipantOrg1Mgmt : gère les interactions Oracle Blockchain Platform, la création d'inscription et les appels proxy REST pour l'organisation participante 1.
ParticipantOrg2Mgmt : gère les interactions Oracle Blockchain Platform, la création d'inscription et les appels proxy REST pour l'organisation participante 2.
ParticipantOrg3Mgmt : gère les interactions Oracle Blockchain Platform, la création d'inscription et les appels proxy REST pour l'organisation participante 3.
ParticipantOrg4Mgmt : gère les interactions Oracle Blockchain Platform, la création d'inscription et les appels proxy REST pour l'organisation participante 4.
ParticipantOrg5Mgmt : gère les interactions Oracle Blockchain Platform, la création d'inscription et les appels proxy REST pour l'organisation participante 5.
ParticipantOrg6Mgmt : gère les interactions Oracle Blockchain Platform, la création d'inscription et les appels proxy REST pour l'organisation participante 6.
Pour mettre à jour les détails du serveur back-end, procédez comme suit :
  1. Sur la page d'accueil des applications Visual Builder Visual, 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 Modifier en regard du serveur par défaut.
  4. Pour le back-end SystemOwnerRestproxyConfiguration uniquement, mettez à jour les éléments suivants dans la fenêtre 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. Pour tous les autres back-ends, mettez à jour les éléments suivants dans la fenêtre 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
    • 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.
  6. Répétez ces étapes pour mettre à jour tous les back-ends.

Configuration de back-end pour les interactions de base de données d'historique enrichi

Chaque organisation dispose d'un back-end dédié qui gère l'accès à la base de données d'historique riche.

Back-ends
SystemOwnerRichHistoryDBConfiguration
ParticipantOrg1RichHistoryDBConfiguration
ParticipantOrg2RichHistoryDBConfiguration
ParticipantOrg3RichHistoryDBConfiguration
ParticipantOrg4RichHistoryDBConfiguration
ParticipantOrg5RichHistoryDBConfiguration
ParticipantOrg6RichHistoryDBConfiguration

En mode générique, vous mettez à jour uniquement le back-end SystemOwnerRichHistoryDBConfiguration. En mode confidentiel, vous devez mettre à jour le back-end du propriétaire système et les back-ends de toutes les organisations participantes utilisées dans votre déploiement.

Pour mettre à jour les détails du serveur back-end :
  1. Sur la page d'accueil des applications Visual Builder Visual, 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 approprié. Cliquez sur Serveurs.
  3. Cliquez sur l'icône Modifier en regard du serveur par défaut.
  4. Mettez à jour les éléments suivants dans la section 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 visuelles de Visual Builder, cliquez sur Objets métier dans le navigateur pour ouvrir le volet Objets métier. Les objets CBDC de gros sont répertoriés.
Capture d'écran présentant la liste complète des objets fonctionnels appartenant à l'exemple d'application CBDC de gros dans la vue Business Objects 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 sur la page Données. Il permet de connecter les instances Oracle Blockchain Platform au back-end approprié pour chaque banque. Par exemple, si un utilisateur saisit les détails Bank1 dans le système ParticipantOrg1, l'application doit lier ParticipantOrg1 à Bank1. Ainsi, chaque fois qu'un utilisateur associé à Bank1 se connecte, le système sait extraire des données du back-end ParticipantOrg1.

Dans cet objet métier, mettez à jour les colonnes BankName et mspId pour les valeurs orgName respectives. Les mises à jour doivent correspondre au nombre d'organisations participantes dans le réseau. Par exemple, si le réseau comporte deux organisations participantes, vous devez mettre à jour les colonnes BankName et mspId pour ces deux organisations. Pour les organisations participantes restantes (ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6), laissez les colonnes BankName et mspId définies sur la valeur empty.

Nom du champ Description Valeurs par défaut Mise à jour requise (Oui/Non) Mettre à jour le besoin
BankName Correspondance utilisée entre les noms d'instance Oracle Blockchain Platform et les noms de banque utilisés dans l'application CBDC.

Par exemple, si vous avez créé l'instance Oracle Blockchain Platform portant le nom CentralBank mais que vous voulez que la valeur BankName soit BSP dans l'application, ce mapping crée le mapping entre l'instance Oracle Blockchain Platform et BSP.

CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6 Oui Obligatoire pour les organisations participantes actives ; ne renseignez pas les organisations participantes non utilisé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 des valeurs par défaut. CentralBank, Bank1, Bank2, Bank3, Bank4, Bank5, Bank6 Oui Obligatoire pour les organisations participantes actives ; ne renseignez pas les organisations participantes non utilisées.
OrgName Cette colonne représente les valeurs orgName mises en correspondance avec le back-end. SystemOwner représente le fondateur et ParticipantOrg# représente les participants. SystemOwner,ParticipantOrg1,ParticipantOrg2, ParticipantOrg3, ParticipantOrg4, ParticipantOrg5, ParticipantOrg6 No S/O

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 métier, entrez les valeurs d'URL homologue correspondantes dans la colonne peerURL avec leurs ID de fournisseur de services d'appartenance Oracle Blockchain Platform respectifs (mspId).

Par exemple, s'il existe une banque centrale et deux institutions financières, chacune avec deux pairs, vous devez entrer un total de six URL homologues avec les valeurs mspId associées.

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 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.
      OACSystemOwnerProjectPath
      Chemin du projet du classeur du propriétaire système dans Analytics Cloud.
      OACParticipantOrgProjectPath
      Chemin du projet du classeur de l'organisation du participant 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>