Test de votre code chaîne à l'aide de code Visual Studio

Si votre code chaîne est exécuté sur un réseau, vous pouvez tester l'une des méthodes générées. Par ailleurs, si vous avez choisi de créer la méthode executeQuery lors du développement de votre code chaîne, vous pouvez exécuter des requêtes SQL riches si votre code chaîne est déployé sur un réseau Oracle Blockchain Platform.

Test de votre code chaîne sur un réseau Hyperledger Fabric local

Une fois que votre projet de code chaîne est exécuté sur un réseau local, vous pouvez le tester.

Blockchain App Builder contient un assistant intégré qui vous aide à appeler ou à interroger votre code chaîne.

1. Sélectionnez votre projet de code chaîne dans le panneau Codes chaîne. Dans le panneau Détails du code chaîne, sélectionnez Exécuter. Le nom de code chaîne est déjà sélectionné. Assurez-vous que l'environnement cible est défini sur Environnement local, de sorte que le canal soit par défaut le seul canal disponible.
2. Dans le champ Fonction, sélectionnez une méthode dans la liste déroulante. Toutes les méthodes disponibles dans le code chaîne sont répertoriées.
3. Dans le champ Paramètre de fonction, cliquez sur le bouton Actions supplémentaires. Cette action ouvre une fenêtre affichant les propriétés disponibles pour la méthode sélectionnée. Entrez les propriétés, puis cliquez sur Omettre pour toute propriété non obligatoire que vous ne souhaitez pas soumettre lorsque vous appelez la méthode. Cliquez sur Enregistrer.
4. Cliquez sur Appeler.

La fenêtre de la console Output indique que la fonction a été appelée. Sinon, dans le panneau Actions de code chaîne, la fenêtre Sortie de fonction affiche la sortie. Cliquez sur Actions supplémentaires pour afficher cette sortie formatée.

Pour enregistrer la méthode et les paramètres que vous venez d'exécuter, cliquez sur Enregistrer et entrez un nom et une description. La fonction est enregistrée dans votre projet de code chaîne dans le dossier Queries. Pour l'utiliser à nouveau, cliquez dessus avec le bouton droit de la souris et sélectionnez Ouvrir.

Si vous apportez des modifications au fichier de contrôleur qui modifient les méthodes, sélectionnez l'icône Recharger en haut du panneau Exécution de code chaîne. La modification sera ensuite reflétée dans la liste déroulante Fonction.

Remarques :

Si vous ne voulez pas utiliser l'assistant pour le test, vous pouvez également exécuter les outils de ligne de commande Blockchain App Builder dans la fenêtre Terminal de Visual Studio Code. Pour plus d'informations sur les tests à partir de la ligne de commande, reportez-vous à Test de votre code chaîne sur un réseau Hyperledger Fabric local.

Test local de plusieurs utilisateurs de jeton

Pour tester un projet de jeton avec plusieurs utilisateurs localement, vous pouvez utiliser la propriété tokenUser pour modifier l'appelant de chaque transaction. Chaque projet de code chaîne échafaudé comprend un fichier .ochain.json, qui stocke les métadonnées du code chaîne. Pour modifier l'appelant, mettez à jour la valeur du champ tokenUser dans le fichier .ochain.json.

{
  "name": "digiCurrCC",
  "description": "Chaincode package for digiCurrCC",
  "chaincodeName": "digiCurrCC",
  "chaincodeType": "node",
  "configFileLocation": "/Users/user1/token.yml",
  "appBuilderVersion": "21.2.3",
  "nodeVersion": "v12.18.1",
  "tokenUser": "admin"
}

Lorsqu'un projet est échafaudé, la propriété tokenUser est définie sur l'utilisateur admin par défaut du réseau local. Pour modifier l'appelant d'une transaction, modifiez la propriété tokenUser afin qu'elle corresponde à la propriété user_id qui a été définie lors de la création du compte lors de l'appel de la méthode createAccount (TypeScript) ou CreateAccount (Go).

Installation et déploiement automatiques après mise à jour

Chaque fois que vous mettez à jour et enregistrez votre code chaîne, les modifications sont compilées, installées et déployées automatiquement. Il n'est pas nécessaire d'arrêter ou de réactiver le réseau local. Tous les projets seront automatiquement compilés et déployés pour chaque modification.

Test des opérations de cycle de vie sur un réseau Oracle Blockchain Platform distant

Une fois que votre projet de code chaîne a été déployé sur votre réseau Oracle Blockchain Platform distant, vous pouvez le tester.

Vous testez le code chaîne exécuté sur un réseau Oracle Blockchain Platform distant de la même manière que sur un réseau local, comme décrit dans Test de votre code chaîne sur un réseau Hyperledger Fabric local.

Vous pouvez utiliser les mêmes commandes pour effectuer toutes les transactions de méthode sur un réseau Oracle Blockchain Platform Cloud ou Enterprise Edition distant. Tous les éléments pris en charge sur le réseau local sont également pris en charge sur le réseau distant. Sélectionnez l'instance Oracle Blockchain Platform en tant qu'environnement cible lors de l'exécution des tests.

Test des projets de jeton sur un réseau Oracle Blockchain Platform distant

Vous pouvez tester les projets de code chaîne qui fonctionnent avec les jetons à l'aide de Blockchain App Builder, du proxy REST Oracle Blockchain Platform ou du kit SDK Hyperledger Fabric.

Générateur d'applications Blockchain

Vous pouvez utiliser l'extension Visual Studio Code pour appeler des transactions avec plusieurs utilisateurs afin de tester les codes chaîne de jeton. Pour effectuer un test avec plusieurs utilisateurs, modifiez les paramètres d'autorisation (nom utilisateur et mot de passe) dans l'onglet Environnements, puis enregistrez l'environnement. Lors de l'appel de transactions, sélectionnez le même environnement dans la liste déroulante, puis exécutez la transaction.

Proxy REST Oracle Blockchain Platform

Vous pouvez utiliser le proxy REST dans Oracle Blockchain Platform pour exécuter votre code chaîne de jetons sur un réseau Oracle Blockchain Platform distant. Utiliser n'importe quel client proxy REST, tel que le client REST Postman, pour tester votre projet de code chaîne.

Pour tester plusieurs utilisateurs, modifiez les paramètres d'autorisation (nom utilisateur et mot de passe) dans le client REST ou connectez-vous à une autre instance d'Oracle Blockchain Platform.

Exécuter des requêtes enrichies Berkeley DB SQL

Si vous avez choisi de créer la méthode executeQuery lors du développement de code chaîne, vous pouvez exécuter des requêtes SQL riches si votre code chaîne est déployé sur un réseau Oracle Blockchain Platform.

Si vous avez utilisé executeQuery dans la section customMethods du fichier de spécification, une méthode executeQuery correspondante est créée dans le contrôleur.

Fichier de spécification :

customMethods:
    - executeQuery
    - "fetchRawMaterial(supplierid: string, rawMaterialSupply: number)"
    - "getRawMaterialFromSupplier(manufacturerId: string, supplierld: string, rawMaterialSupply: number)"
    - "createProducts(manufacturerId: string, rawMaterialConsumed: number, productsCreated: number)"
    - "sendProductsToDistribution()"

Fichier de contrôleur:

**
*
* BDB sql rich queries can be executed in OBP CS/EE.
* This method can be invoked only when connected to remote OBP CS/EE network.
*
*/
@Validator(yup.string())
public async executeQuery(query: string) {
    const result = await OchainController.query(query); 
    return result;
}

Vous pouvez appeler cette méthode pour exécuter des requêtes enrichies Berkeley DB SQL sur le réseau Oracle Blockchain Platform. Vous devez sélectionner l'environnement Oracle Blockchain Platform que vous avez créé en tant qu'environnement cible lors de l'exécution des requêtes.

Par exemple :

1. Dans le panneau Détails du code chaîne, sélectionnez Exécuter. Le nom de code chaîne, l'environnement cible et le canal sont déjà indiqués à partir de l'étape de déploiement.
2. Dans le champ Nom de la fonction, sélectionnez executeQuery dans la liste déroulante.
3. Dans le champ Paramètre de fonction, cliquez sur Actions supplémentaires. Cette action ouvre une fenêtre dans laquelle vous pouvez saisir la chaîne de requête. Entrez les arguments de la requête, puis cliquez sur Enregistrer.
4. Cliquez sur Requête.

La fenêtre Sortie s'ouvre et affiche la requête en cours d'exécution, ainsi que le résultat.

ochain query executeQuery "SELECT key, valueJson FROM <STATE> WHERE
json_extract(valueJson, '$.rawMaterialAvailable') = 4" 

L'ensemble de l'interrogation SQL est pris dans l'argument, de sorte que vous pouvez apporter des modifications à votre interrogation à la volée.

Génération de commandes CLI à partir de requêtes

Si vous avez des requêtes enregistrées dans un projet de code chaîne dans Visual Studio Code, vous pouvez générer automatiquement les commandes d'interface de ligne de commande équivalentes.

Vous devez disposer d'au moins une requête enregistrée dans un projet de code chaîne pour générer des commandes d'interface de ligne de commande pour macOS et Linux et pour Microsoft Windows.

1. Développez le projet dans le panneau Codes chaîne.
2. Cliquez avec le bouton droit de la souris sur Queries.
3. Cliquez sur Générer des commandes d'interface de ligne de commande.

Deux fichiers texte sont générés et affichés dans la section Requêtes du panneau Codes chaîne : CLIcommandsForLinux.txt et CLIcommandsForWindows.txt. Sélectionnez le nom du fichier pour ouvrir le fichier et afficher les commandes CLI correspondantes.