会話の記録は、JSONファイルを定義するよりも迅速で、エラーが少なくなります。会話からテスト・ケースを作成するには:

1. テストを作成するスキルまたはデジタル・アシスタントを開きます。
2. ページ上部のツールバーで、「プレビュー」をクリックします。
   
   
   
   
3. 「ボット・テスター」をクリックします。
4. チャネルを選択します。
   ノート
   
   テスト・ケースはチャネル固有です。テスト会話は、選択したチャネルで処理されるため、テスト・ケースについて記録される内容です。たとえば、スキル・テスターのテキストベースのチャネルのいずれかを使用して記録されたテスト・ケースを使用して、Oracle Web Channelで同じ会話をテストすることはできません。
5. テストする動作または出力に固有の発話を入力します。
6. 「テストとして保存」をクリックします。
   
   
   
   
7. 「会話をテスト・ケースとして保存」ダイアログを完成させます:
   • 必要に応じて、「有効」をオフにして、テスト実行からテスト・ケースを除外します。
   • ポストバック・アクションがある会話またはメッセージに対してテスト・ケースを実行している場合は、「ポストバック変数の無視」をオンにすると、ポストバック変数レベルで予期されるメッセージと実際のメッセージの違いを無視して、テスト・ケースが合格するようにできます。
   • テストを説明する名前および表示名を入力します。
   • オプションのステップとして、テスト・ケースがシナリオまたはユース・ケースに対して予想される動作をどのように検証するかを説明する詳細を「説明」フィールドに追加します。
   • 必要に応じて、「テスト・スイート」リストから「デフォルト・テスト・スイート」以外のテスト・スイートを選択します。
   • ユーザーがリクエストまたはレスポンスに入力できる様々なパラメータ値をテストするには、各入力パラメータの「入力パラメータ」フィールドのオブジェクトにアレイを追加し、「会話」テキスト領域でテストするユーザー入力に対応するプレースホルダを置き換えます。たとえば、「入力パラメータ」フィールドに配列{"AGE":["24","25","26"]}、「会話」テキスト領域に${"AGE"} (プレースホルダ)を入力します。
   • スキルまたはデジタル・アシスタントのレスポンスに、テスト・ケースの継続的な失敗の原因となるタイムスタンプなどの動的情報が含まれている場合は、これらの値を移入する変数定義を、${MY_VARIBALE_NAME}として書式設定されたプレースホルダに置き換えます。
8. 「スイートに追加」をクリックします。
   
   
   
   
   

メッセージ・オブジェクトの配列オブジェクトからテスト・ケースを作成するには、まず「テスト・スイート」ページで「+テスト・ケース」をクリックし、「新規テスト・ケース」ダイアログを完了します。プロパティは、記録されたテスト・ケースと同じですが、配列([])の「会話」ウィンドウにメッセージ・オブジェクトを入力する必要がある点が異なります。次に、様々なペイロード・タイプのテンプレートを示します:

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

単一のテスト・ケース、テスト・ケースのサブセット、または「テスト・スイート」ページにリストされているテスト・ケースのセット全体に対して、テスト実行を作成できます。スキルが進化するにつれて、意図的にスキルに加えられた変更のために失敗するテスト・ケースをリタイアする必要がある場合があります。開発が進行中であることを理由に、テスト・ケースを一時的に無効にすることもできます。 テスト実行が完了したら、「テスト実行結果」タブをクリックし、合格または失敗したテスト・ケースを確認します。

テスト実行結果ページには、最近実行されたテスト実行とその結果がリストされます。テスト実行にコンパイルされたテスト・ケースは、テスト・ケース定義に記録された予想される出力と実際の出力の比較に従って、合格または不合格のいずれかです。2つが一致する場合、テスト・ケースは成功します。そうでない場合、テスト・ケースは失敗します。テスト・ケースが失敗した場合は、「差異の表示」をクリックしてその理由を確認できます。

同じスキルのパラレル・バージョンを開発する場合、またはクローンで作業する場合、スキルのあるバージョンから別のバージョンにテスト・スイートをインポートできます。

1. テスト・スイートをエクスポートするには、最初にテスト・スイート(またはテスト・スイート)を選択します。次に、「詳細」→「選択したスイートのエクスポート」または「すべてエクスポート」をクリックします。(ケバブ・メニューから「テストのエクスポート」を選択して、すべてのテスト・スイートをエクスポートすることもできます)
   
   
   
   スキル・タイル内)。エクスポートされたZIPファイルには、エクスポートされたテスト・スイートを記述するJSONファイルを含むtestSuitesというフォルダが含まれます。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. ターゲット・スキルの「テスト・スイート」ページを開き、「詳細」→「インポート」をクリックします。
3. テスト・スイートのJSON定義を含むZIPファイルを参照して選択します。次に、「アップロード」をクリックします。
4. インポートが完了したら、確認通知の「レポートのダウンロード」をクリックして、ダウンロードしたZIPファイルに含まれるJSONファイルのインポートの詳細を確認します。
   
   
   
   例:

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

有効なテスト・ケースのみインポートできます。

失敗した結果の原因を確認するには、ダウンロードしたimportJSONファイルのinvalidReasons配列を確認します。

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