L'enregistrement de conversations est plus rapide et génère moins d'erreurs que la création d'un fichier JSON. Pour créer un scénario de test à partir d'une conversation :

1. Ouvrez la compétence ou l'assistant numérique pour lequel vous voulez créer le test.
2. Dans la barre d'outils située en haut de la page, cliquez sur Prévisualiser.
   
   
   
   
3. Cliquez sur Bot Tester.
4. Sélectionnez le canal.
   Note
   
   Les scénarios de test sont propres au canal : c'est la conversation de test, telle qu'elle est traitée par le canal sélectionné, qui est enregistrée pour un scénario de test. Par exemple, les scénarios de test enregistrés à l'aide de l'un des canaux texte du testeur de compétence ne peuvent pas être utilisés pour tester la même conversation sur le canal Web Oracle.
5. Entrez les énoncés spécifiques au comportement ou à la sortie à tester.
6. Cliquez sur Save as Test (Enregistrer en tant que test).
   
   
   
   
7. Complétez la boîte de dialogue Save Conversation as Test Case (Enregistrer la conversation en tant que test) :
   • Si nécessaire, excluez le scénario de test des exécutions de test en désactivant Activé.
   • Si vous exécutez un scénario de test pour des conversations ou des messages ayant des actions de republication, vous pouvez activer Ignorer les variables de republication pour permettre au scénario de réussir en ignorant les différences entre le message attendu et le message réel au niveau de la variable de republication.
   • Entrez un nom et un nom d'affichage décrivant le test.
   • Comme étape facultative, ajoutez des détails dans le champ Description qui décrivent comment le scénario de test valide le comportement attendu pour un scénario ou un cas d'utilisation.
   • Si nécessaire, sélectionnez une suite de tests autre que la suite de tests par défaut dans la liste Test Suite (Suite de tests).
   • Pour tester les différentes valeurs de paramètre que les utilisateurs peuvent entrer dans leurs demandes ou réponses, ajoutez des tableaux à l'objet dans le champ Paramètres d'entrée pour chaque paramètre d'entrée et remplacez les paramètres fictifs correspondants par l'entrée utilisateur que vous testez dans la zone de texte Conversation. Par exemple, entrez un tableau {"AGE":["24","25","26"]} dans le champ Paramètres d'entrée et ${"AGE"} (paramètre fictif) dans la zone de texte Conversation.
   • Si les réponses de la compétence ou de l'assistant numérique incluent des informations dynamiques telles que des horodatages qui entraîneront l'échec continu des scénarios de test, remplacez la définition de variable qui alimente ces valeurs par un paramètre fictif formaté comme ${MY_VARIBALE_NAME}.
8. Cliquez sur Add to Suite (Ajouter à la suite).
   
   
   Description de l'illustration save-conversation-history-test-case.png
   
   

Vous créez un scénario de test à partir d'un objet de tableau d'objets de message en cliquant d'abord sur + Test Case (Cas de test) dans la page Test Suite (Suite de tests), puis en remplissant la boîte de dialogue New Test Case (Nouveau cas de test). Les propriétés sont les mêmes que pour les scénarios de test enregistrés, sauf que vous devez remplir la fenêtre Conversations du tableau ([]) avec les objets de message. Voici le modèle pour les différents types de données utiles :

    {
        source: "user",             //text only message format is kept simple yet extensible.
        type: "text"
        payload: {
            message: "order pizza" 
        }
    },{
        source: "bot",
        type: "text",
        payload: {
            message: "how old are you?"
            actions: [action types --- postback, url, call, share],  //bot messages can have actions and globalActions which when clicked by the user to send specific JSON back to the bot.
            globalActions: [...]
        }
    },
    {
        source: "user",
        type: "postback"
        payload: {      //payload object represents the post back JSON sent back from the user to the bot when the button is clicked
            variables: {
                accountType: "credit card"
            }, 
            action: "credit card", 
            state: "askBalancesAccountType"
        }
    },
    {
        source: "bot",
        type: "cards"
        payload: {
            message: "label"
            layout: "horizontal|vertical"
            cards: ["Thick","Thin","Stuffed","Pan"],    // In test files cards can be strings which are matched with button labels or be JSON matched  
            cards: [{
                title: "...",
                description: "..."
                imageUrl: "...",
                url: "...",
                actions: [...]  //actions can be specific to a card or global
            }],
            actions: [...],
            globalActions: [...]
        }
         
    },
    {
        source: "bot|user",
        type: "attachment"  //attachment message could be either a bot message or a user message    
        payload: {
            attachmentType: "image|video|audio|file"
            url: "https://images.app.goo.gl/FADBknkmvsmfVzax9"
            title: "Title for Attachment"
        }   
    },
    {
        source: "bot",
        type: "location"       
        payload: {
            message: "optional label here"
            latitude: 52.2968189
            longitude: 4.8638949
        }
    },
    {
        source: "user",
        type: "raw"
        payload: {
            ... //free form application specific JSON for custom use cases. Exact JSON matching
        }
    }
    ...
    //multiple bot messages per user message possible.]
}
 

Vous pouvez créer des exécutions de test pour un seul scénario, un sous-ensemble de scénarios ou pour l'ensemble des scénarios répertoriés dans la page Test Suite. Au fur et à mesure que votre compétence évolue, vous devrez peut-être mettre fin à des cas de test qui risquent d'échouer en raison des modifications apportées délibérément à une compétence. Vous pouvez également désactiver temporairement un scénario de test à cause d'un développement en cours. Une fois l'exécution du test terminée, cliquez sur l'onglet Test Run Results (Résultats d'exécution du test) pour savoir quels scénarios de test ont réussi ou échoué.

Description de l'illustration test-run-results.png

La page Tester les résultats d'exécution répertorie les derniers tests exécutés et leurs résultats. Les scénarios de test compilés dans l'exécution de test ont réussi ou échoué en fonction d'une comparaison de la sortie attendue enregistrée dans la définition du scénario de test et de la sortie réelle. Si les deux résultats correspondent, le scénario de test a réussi. Sinon, le scénario de test échoue. Lorsque les scénarios de test échouent, vous pouvez savoir pourquoi en cliquant sur Voir les différences.

Vous pouvez importer des suites de tests d'une version de la compétence vers une autre lorsque vous développez des versions parallèles de la même compétence ou lorsque vous utilisez des clones.

1. Pour exporter une suite de tests, sélectionnez d'abord la suite de tests (ou les suites de tests). Cliquez ensuite sur Plus > Exporter la suite sélectionnée ou sur Tout exporter. (Vous pouvez également exporter toutes les séries de tests en sélectionnant Exporter les tests dans le menu kebab.
   
   
   
   dans la vignette de compétence.) Le fichier ZIP exporté contient un dossier nommé testSuites qui contient un fichier JSON décrivant la suite de tests exportée. Voici un exemple de format JSON :

   {
     "displayName" : "TestSuite0001",
     "name" : "TestSuite0001",
     "testCases" : [ {
       "channelType" : "websdk",
       "conversation" : [ {
         "messagePayload" : {
           "type" : "text",
           "text" : "I would like a large veggie pizza on thin crust delivered at 4:30 pm",
           "channelExtensions" : {
             "test" : {
               "timezoneOffset" : 25200000
             }
           }
         },
         "source" : "user"
       }, {
         "messagePayload" : {
           "type" : "text",
           "text" : "Let's get started with that order"
         },
         "source" : "bot"
       }, {
         "messagePayload" : {
           "type" : "text",
           "text" : "How old are you?"
         },
         "source" : "bot"
       }, {
         "messagePayload" : {
           "type" : "text",
           "text" : "${AGE}",
           "channelExtensions" : {
             "test" : {
               "timezoneOffset" : 25200000
             }
           }
         },
         "source" : "user"
       }, {
         "messagePayload" : {
           "type" : "text",
           "text" : "You placed an order at ${ORDER_TIME} for a large Veggie pizza on thin crust. Your order will be delivered to your home at 04:30 PM."
         },
         "source" : "bot"
       } ],
       "description" : "Tests all values with a single utterance. Uses input parameters and variable values",
       "displayName" : "Full Utterance Test",
       "enabled" : true,
       "inputParameters" : {
         "AGE" : [ "24", "25", "26" ]
       },
       "name" : "FullUtteranceTest",
       "platformVersion" : "1.0",
       "trackingId" : "A0AAA5E2-5AAD-4002-BEE0-F5D310D666FD"
     } ],
     "trackingId" : "4B6AABC7-3A65-4E27-8D90-71E7B3C5264B"
   }

2. Ouvrez la page Suites de tests de la compétence cible, puis cliquez sur More (Plus) > Import (Importer).
3. Accédez au fichier ZIP contenant la définition JSON des suites de tests, puis sélectionnez-le. Cliquez ensuite sur Charger.
4. Une fois l'importation terminée, cliquez sur Télécharger le rapport dans l'avis de confirmation pour obtenir plus de détails sur l'importation dans le fichier JSON inclus dans le fichier ZIP téléchargé.
   
   
   
   Par exemple :

   {
     "status" : "SUCCESS",
     "statusMessage" : "Successfully imported test cases and test suites. Duplicate and invalid test cases/test suites ignored.",
     "truncatedDescription" : false,
     "validTestSuites" : 2,
     "duplicateTestSuites" : 0,
     "invalidTestSuites" : 0,
     "validTestCases" : 2,
     "duplicateTestCases" : 0,
     "invalidTestCases" : 0,
     "validationDetails" : [ {
       "name" : "DefaultTestSuite",
       "validTestCases" : 1,
       "duplicateTestCases" : 0,
       "invalidTestCases" : 0,
       "invalidReasons" : [ ],
       "warningReasons" : [ ],
       "testCasesValidationDetails" : [ {
         "name" : "Test1",
         "invalidReasons" : [ ],
         "warningReasons" : [ ]
       } ]
     }, {
       "name" : "TestSuite0001",
       "validTestCases" : 1,
       "duplicateTestCases" : 0,
       "invalidTestCases" : 0,
       "invalidReasons" : [ ],
       "warningReasons" : [ ],
       "testCasesValidationDetails" : [ {
         "name" : "Test2",
         "invalidReasons" : [ ],
         "warningReasons" : [ ]
       } ]
     } ]
   }

Vous ne pouvez importer que des scénarios de test valides.

Pour trouver la cause du résultat de l'échec, vérifiez le tableau invalidReasons dans le fichier importJSON téléchargé.

    "testCasesValidationDetails" : [ {
      "name" : "Test",
      "invalidReasons" : [ "INVALID_INPUT_PARAMETERS" ],
   ...