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:
   • Bei Bedarf können Sie den Testfall aus Testläufen ausschließen, indem Sie Aktiviert deaktivieren.
   • 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, indem Sie die Unterschiede zwischen der erwarteten und der tatsächlichen Nachricht auf Postback-Variablenebene ignorieren.
   • Geben Sie einen Namen und einen Anzeigenamen ein, die den Test beschreiben.
   • Fügen Sie als optionalen Schritt 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 Test-Suite eine andere Testsuite als "Standard-Test-Suite" aus.
   • Um auf 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 ein Array {"AGE":["24","25","26"]} in das Feld "Eingabeparameter" und ${"AGE"} (der Platzhalter) im Textbereich "Unterhaltung" ein.
   • Wenn die Antworten des Skills oder digitalen Assistenten dynamische Informationen wie Zeitstempel enthalten, die dazu führen, dass Testfälle kontinuierlich nicht erfolgreich verlaufen, 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 ([]) Dialogfenster mit den Nachrichtenobjekten vervollständigen 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. Wenn sich Ihr Skill weiterentwickelt, müssen Sie möglicherweise Testfälle einstellen, die aufgrund der Änderungen, die absichtlich an einem Skill vorgenommen wurden, möglicherweise nicht erfolgreich verlaufen. Sie können einen Testfall auch vorübergehend wegen fortlaufender Entwicklung deaktivieren. Klicken Sie nach Abschluss des Testlaufs auf die Registerkarte Testlaufergebnisse, um herauszufinden, welche der Testfälle erfolgreich oder nicht erfolgreich waren.

Beschreibung der Abbildung test-run-results.png

Auf der Seite "Testergebnisse" werden die zuletzt ausgeführten Testläufe und ihre Ergebnisse aufgeführt. Die in den Testlauf kompilierten Testfälle sind entweder erfolgreich oder nicht erfolgreich, je nach einem Vergleich der erwarteten Ausgabe, die in der Testfalldefinition und der tatsächlichen Ausgabe aufgezeichnet ist. 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 parallele Versionen desselben Skills entwickeln oder mit Klonen arbeiten.

1. Um eine Testsuite zu exportieren, wählen Sie zuerst die Testsuite (oder die Testsuites) aus. Klicken Sie anschließend auf Mehr > 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 mit dem Namen testSuites, der eine JSON-Datei mit einer Beschreibung der exportierten Testsuite enthält. 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 "Testsuites" 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 des nicht erfolgreichen Ergebnisses zu finden, prüfen Sie das Array invalidReasons in der heruntergeladenen Datei importJSON.

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