Die Aufzeichnung von Unterhaltungen ist schneller und weniger fehleranfällig als die Definition einer JSON-Datei. So erstellen Sie einen Testfall aus einer Unterhaltung:

1. Öffnen Sie den Skill oder den digitalen Assistenten, für den Sie den Test erstellen möchten.
2. Klicken Sie oben auf der Seite in der Symbolleiste auf Vorschau.
   
   
   
   
3. Klicken Sie auf Bottester.
4. Wählen Sie den Kanal aus.
   Hinweis
   
   Testfälle sind kanalspezifisch: Für einen Testfall wird jeweils die Testunterhaltung aufgezeichnet, wie sie vom ausgewählten Kanal bearbeitet wird. Beispielsweise können Testfälle, die mit einem der textbasierten Kanäle des Skilltesters aufgezeichnet wurden, nicht zum Testen derselben Unterhaltung im Oracle-Webkanal verwendet werden.
5. Geben Sie die für das Verhalten oder die Ausgabe, die getestet werden soll, spezifischen Äußerungen ein.
6. Klicken Sie auf Als Test speichern.
   
   
   
   
7. Füllen Sie das Dialogfeld "Unterhaltung als Testfall speichern" aus:
   • Entfernen Sie bei Bedarf den Testfall aus den Testläufen, indem Sie Aktiviert ausschalten.
   • Wenn Sie einen Testfall für Unterhaltungen oder Nachrichten mit Postback-Aktionen ausführen, können Sie Postback-Variablen ignorieren aktivieren, damit der Testfall erfolgreich verläuft. Dabei werden die Unterschiede zwischen der erwarteten Nachricht und der tatsächlichen Nachricht auf Postback-Variablenebene ignoriert.
   • Geben Sie einen Namen und einen Anzeigenamen ein, die den Test beschreiben.
   • Als optionalen Schritt fügen Sie im Feld "Beschreibung" Details hinzu, die beschreiben, wie der Testfall das erwartete Verhalten für ein Szenario oder einen Anwendungsfall validiert.
   • Wählen Sie bei Bedarf in der Liste Testsuite eine andere Testsuite als die Standardtestsuite aus.
   • Um die verschiedenen Parameterwerte zu testen, die Benutzer in ihre Anforderungen oder Antworten eingeben können, fügen Sie dem Objekt im Feld "Eingabeparameter" für jeden Eingabeparameter Arrays hinzu, und ersetzen Sie die entsprechenden Platzhalter für die Benutzereingabe, die Sie im Textbereich "Unterhaltung" testen. Beispiel: Geben Sie im Feld "Eingabeparameter" ein Array {"AGE":["24","25","26"]} und im Textbereich "Unterhaltung" ${"AGE"} (Platzhalter) ein.
   • Wenn der Skill oder die Antworten des digitalen Assistenten dynamische Informationen wie Zeitstempel enthalten, die dazu führen, dass Testfälle kontinuierlich nicht erfolgreich sind, ersetzen Sie die Variablendefinition, die diese Werte auffüllt, durch einen Platzhalter, der als ${MY_VARIBALE_NAME} formatiert ist.
8. Klicken Sie auf Zu Suite hinzufügen.
   
   
   Beschreibung der Abbildung save-conversation-history-test-case.png
   
   

Sie erstellen einen Testfall aus einem Arrayobjekt von Nachrichtenobjekten, indem Sie zuerst auf der Seite "Testsuite" auf + Testfall und dann auf das Dialogfeld "Neuer Testfall" klicken. Die Eigenschaften sind mit denen für aufgezeichnete Testfälle identisch, mit der Ausnahme, dass Sie das Array-Unterhaltungsfenster ([]) mit den Nachrichtenobjekten ausfüllen müssen. Im Folgenden finden Sie eine Vorlage für die verschiedenen Payload-Typen:

    {
        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.]
}
 

Sie können Testläufe für einen einzelnen Testfall, eine Teilmenge von Testfällen oder für die gesamte Gruppe von Testfällen erstellen, die auf der Seite "Testsuite" aufgeführt sind. Während sich Ihr Skill weiterentwickelt, müssen Sie möglicherweise Testfälle zurückziehen, die aufgrund der absichtlichen Änderungen an einem Skill nicht erfolgreich sind. Sie können einen Testfall auch vorübergehend wegen fortlaufender Entwicklung deaktivieren. After the test run completes, click the Test Run Results tab to find out which of the test cases passed or failed.

Description of the illustration test-run-results.png

Auf der Seite "Testlaufergebnisse" werden die zuletzt ausgeführten Testläufe und deren Ergebnisse aufgeführt. Die in den Testlauf kompilierten Testfälle sind nach einem Vergleich der erwarteten Ausgabe, die in der Testfalldefinition aufgezeichnet ist, und der tatsächlichen Ausgabe entweder erfolgreich oder nicht erfolgreich. Bei einer Übereinstimmung wird der Testfall als erfolgreich markiert. Andernfalls ist der Testfall nicht erfolgreich. Wenn Testfälle nicht erfolgreich sind, können Sie den Grund ermitteln, indem Sie auf Unterschiede anzeigen klicken.

Sie können Testsuites von einer Version des Skills in eine andere importieren, wenn Sie Parallelversionen desselben Skills entwickeln oder mit Klonen arbeiten.

1. Um eine Testsuite zu exportieren, wählen Sie zuerst die Testsuite (oder die Testsuiten) aus. Klicken Sie dann auf Weitere Informationen > Ausgewählte Suite exportieren oder Alle exportieren. (Sie können auch alle Testsuites exportieren, indem Sie im Kebab-Menü die Option Tests exportieren auswählen.
   
   
   
   in der Skillkachel.) Die exportierte ZIP-Datei enthält einen Ordner namens testSuites mit einer JSON-Datei, in der die exportierte Testsuite beschrieben wird. Beispiel für das JSON-Format:

   {
     "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. Öffnen Sie die Seite "Testsuiten" des Zielskills, und klicken Sie auf Weitere Informationen > Importieren.
3. Navigieren Sie zur ZIP-Datei mit der JSON-Definition der Testsuites, und wählen Sie sie aus. Klicken Sie dann auf Hochladen.
4. Nachdem der Import abgeschlossen ist, klicken Sie in der Bestätigungsbenachrichtigung auf Bericht herunterladen, um weitere Details zum Import in der JSON-Datei zu erhalten, die in der heruntergeladenen ZIP-Datei enthalten ist.
   
   
   
   Beispiel:

   {
     "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" : [ ]
       } ]
     } ]
   }

Sie können nur gültige Testfälle importieren.

Um die Ursache für das nicht erfolgreiche Ergebnis zu ermitteln, prüfen Sie das Array invalidReasons in der heruntergeladenen Datei importJSON.

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