テストシナリオを使用したデシジョンサービスのテスト

手順

1. Business Central で、Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Add Asset → Data Object をクリックします。

3. 一意の データオブジェクト 名を入力し、パッケージ を選択します。これにより、その他のルールアセットでもデータオブジェクトを利用できるようになります。同じパッケージに、同じ名前のデータオブジェクトを複数作成することはできません。指定の DRL ファイルで、どのパッケージからでもデータオブジェクトをインポートできます。

   別のパッケージからのデータオブジェクトのインポート

   別のパッケージから直接アセットデザイナーに、既存のデータオブジェクトをインポートすることができます。プロジェクトで関連するルールアセットを選択し、アセットデザイナーで Data Objects → New item に移動して、インポートするオブジェクトを選択します。

4. データオブジェクトを永続化するには、Persistable チェックボックスを選択します。永続型データオブジェクトは、JPA 仕様に準じてデータベースに保存できます。デフォルトの JPA は Hibernate です。
5. OK をクリックします。

6. データオブジェクトデザイナーで add field をクリックして、Id 属性、Label 属性、および Type 属性を使用するオブジェクトにフィールドを追加します。必須属性にはアスタリスク (*) マークが付いています。

   • Id: フィールドの一意の ID を入力します。
   • Label: (任意) フィールドのラベルを入力します。
   • Type: フィールドのデータ型を入力します。

   • List: このチェックボックスを選択すると、このフィールドで、指定したタイプのアイテムを複数保持できるようになります。

     図2.1 データオブジェクトへのデータフィールドの追加

     

7. Create をクリックして、新しいフィールドを追加します。Create and continue をクリックすると、新しいフィールドが追加され、別のフィールドを引き続き作成できます。

   注記

   フィールドを編集するには、フィールド行を選択し、画面右側の general properties を使用します。

手順

1. テストシナリオ デザイナーでテストシナリオを開きます。
2. テストシナリオの説明を入力して、行のセルに必要な値を入力します。

3. コンテキストメニューを使用して、必要に応じて行を追加または削除します。

   セルをダブルクリックしてインラインの編集を開始します。テスト評価で特定のセルを省略するには、そのセルを空白のままにします。

手順

1. 列タイプを先に設定します (タイプがリストまたはマッピングのフィールドを使用します)。
2. 列内のセルをダブルクリックして、値を入力します。
3. コレクションエディターのポップアップで、Add new item をクリックします。
4. 必要な値を入力して、チェックアイコン をクリックし、追加した各コレクションアイテムを保存します。

5. Save をクリックします。

   コレクションからアイテムを削除するには、コレクションのポップアップエディターでゴミ箱のアイコンをクリックします。Remove をクリックして、コレクション自体を削除します。

手順

1. テストシナリオ デザイナーの上部にある テストの実行 アイコンをクリックします。
2. Test Report パネルでは、デザイナーの右側にポップアップ表示され、テスト結果の概要とシナリオのステータスが表示されます。
3. テストの実行後に、View Alerts をクリックして、デザイナーの下部にある Alerts パネルを開き、エラーメッセージを確認します。

4. テストに失敗したら、エラーメッセージを確認します。赤いバツマークの付いたメッセージは、テストに失敗したことを示し、緑のチェックマークはテストに成功したことを示します。

   デザイナーでは、エラーのある行やセルが赤で強調表示されます。

5. 必要な変更を加えて、テストに成功するまでもう一度テストを実行します。

手順

1. Business Central で、Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. プロジェクトのホームページで Settings タブを選択します。
3. git URL を選択し、Clipboard をクリックして git url をコピーします。
4. コマンドターミナルを開いて、git プロジェクトのクローンを作成するディレクトリーに移動します。

5. プロジェクトのディレクトリーから、以下のコマンドを実行します。

   git clone your_git_project_url

   your_git_project_url は、git://localhost:9418/MySpace/ProjectTestScenarios などの適切なデータに置き換えます。

6. プロジェクトのクローンを正しく作成したら、git プロジェクトディレクトリーに移動して、以下のコマンドを実行します。

   mvn clean test

   プロジェクトのビルド情報およびテスト結果 (テスト実行回数およびテスト実行が成功したかどうかなど) は、コマンドターミナルに表示されます。エラーがある場合には、修正して、もう一度コマンドを実行します。

手順

1. Business Central にログインし、Menu → Design → Projects の順にクリックし、Mortgages をクリックします。
2. プロジェクトが Projects の下にリストされていない場合は、MySpace から 3 つのドット ( ) ページの右上隅にあります。

3. Try Samples → Mortgages → OK の順にクリックします。

   アセットのウィンドウが表示されます。

4. Add Asset → Test Scenario の順にクリックします。

5. Test Scenario の名前として、scenario_pricing_loans を入力し、Package ドロップダウンリストから、デフォルトの mortgages.mortgages パッケージを選択します。

   選択するパッケージには、必要なルールアセットがすべて含まれている必要があります。

6. Ok をクリックして、テストシナリオ デザイナーでテストシナリオを作成して開きます。

7. Project Explorer を展開して以下を確認します。

   • Applicant、Bankruptcy、IncomeSource、および LoanApplication データオブジェクトが存在する。
   • Pricing loans ガイド付きのデシジョンテーブルが存在する。
   • 新しいテストシナリオが Test Scenario に表示されていることを確認する。

8. データオブジェクトがすべて配置されていることを確認してから、テストシナリオデザイナーの Model タブに戻り、利用可能なデータオブジェクトのシナリオに、 GIVEN データと EXPECT データを定義します。

   図3.1 空のテストシナリオデザイナー

   

9. GIVEN コラムの詳細を定義します。

   1. GIVEN 列ヘッダーにある INSTANCE 1 という名前のセルをクリックします。
   2. Test Tools → Test Editor から LoanApplication データオブジェクトを選択します。
   3. Add をクリックします。
10. データオブジェクトのプロパティーを作成するには、必要に応じて Insert column right または Insert column left を選択します。この例では、GIVEN 列の下に。プロパティーセルをさらに 2 つ作成する必要があります。

11. 最初のプロパティーセルをクリックします。

    1. Test Tools → Test Editor から LoanApplication データオブジェクトを選択して展開します。
    2. amount をクリックして、追加 し、プロパティーセルにデータオブジェクトフィールドをマッピングします。

12. 2 つ目のプロパティーセルをクリックします。

    1. Test Tools → Test Editor から LoanApplication データオブジェクトを選択して展開します。
    2. deposit をクリックしてから Add をクリックします。

13. 2 つ目のプロパティーセルをクリックします。

    1. Test Tools → Test Editor から LoanApplication データオブジェクトを選択して展開します。
    2. lengthYears をクリックしてから Add をクリックします。
14. LoanApplication ヘッダーセルを右クリックし、Insert column right を選択します。右側に新しい GIVEN 列が作成されます。

15. 新しいヘッダーセルをクリックします。

    1. Test Tools → Test Editor から IncomeSource データオブジェクトを選択します。
    2. Add をクリックして、データオブジェクトをヘッダーセルにマッピングします。

16. IncomeSource の下のプロパティーセルをクリックします。

    1. Test Tools → Test Editor から IncomeSource データオブジェクトを選択して展開します。

    2. type をクリックして、追加 し、プロパティーセルにデータオブジェクトフィールドをマッピングします。

       GIVEN 列セルがすべて定義されました。

17. 次に EXPECT コラムの詳細を定義します。

    1. EXPECT 列ヘッダーにある INSTANCE 2 という名前のセルをクリックします。
    2. Test Tools → Test Editor から LoanApplication データオブジェクトを選択します。
    3. Add をクリックします。
18. データオブジェクトのプロパティーを作成するには、必要に応じて Insert column right または Insert column left を選択します。EXPECT 列の下に、プロパティーセルをさらに 2 つ作成します。

19. 最初のプロパティーセルをクリックします。

    1. Test Tools → Test Editor から LoanApplication データオブジェクトを選択して展開します。
    2. approved をクリックして、追加 し、プロパティーセルにデータオブジェクトフィールドをマッピングします。

20. 2 つ目のプロパティーセルをクリックします。

    1. Test Tools → Test Editor から LoanApplication データオブジェクトを選択して展開します。
    2. insuranceCost をクリックしてから Add をクリックします。

21. 2 つ目のプロパティーセルをクリックします。

    1. Test Tools → Test Editor から LoanApplication データオブジェクトを選択して展開します。
    2. approvedRate をクリックしてから Add をクリックします。

22. 次に、テストシナリオを定義するには、1 行目に以下のデータを入力します。

    • GIVEN コラムの値として、Scenario Description には Row 1 test scenario、amount には 150000、deposit には 19000、lenghtYears には 30、type には Asset を入力します。
    • EXPECT コラムの値として、approved には true、insuranceCost には 0 を入力します。

23. 次に 2 番目の行に、以下のデータを入力します。

    • GIVEN 列の値として、Scenario Description には Row 2 test scenario、amount には 100002、deposit には 2999、lenghtYears には 20、type には Job を入力します。
    • EXPECT コラムの値として、approved には true、insuranceCost には 10 を入力します。
24. シナリオに対して、GIVEN、EXPECT、その他のデータをすべて定義したら、テストシナリオデザイナーで Save をクリックして、設定した内容を保存します。

25. 右上隅の Run Test をクリックして .scesim ファイルを実行します。

    テスト結果は、Test Report パネルに表示されます。View Alerts をクリックして、Alerts セクションからメッセージを表示します。テストに失敗した場合は、ウィンドウの下部にある Alerts セクションのメッセージを参照し、シナリオの全コンポーネントをレビューして修正してから、シナリオが合格するまでシナリオの検証を再度行います。

26. テストシナリオデザイナーで Save をクリックして、必要な変更をすべて加えてから、作業を保存します。

手順

1. Business Central で、Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Add Asset → テストシナリオ (レガシー) の順にクリックします。
3. テストシナリオ 名を入力し、適切な パッケージ を選択します。指定するパッケージは、必要なルールアセットが割り当てられている、またはこれから割り当てるパッケージと同じにする必要があります。データオブジェクトは、パッケージからアセットのデザイナーにインポートできます。

4. OK をクリックして、テストシナリオを作成します。

   Project Explorer の Test Scenarios パネルに、新しいテストシナリオが追加されました。

5. Data Objects タブをクリックして、テストするルールに必要なデータオブジェクトがすべてリストされていることを検証します。追加されていない場合は、New item をクリックして別のパッケージから必要なデータオブジェクトをインポートするか、パッケージに データオブジェクトを作成 します。

6. データオブジェクトをすべて配置したら、テストシナリオデザイナーの Model タブに戻り、利用可能なデータオブジェクトに基づいたシナリオに、GIVEN データと EXPECT データを定義します。

   図4.1 テストシナリオデザイナー

   

   GIVEN セクションには、テストする入力ファクトを定義します。たとえば、プロジェクトの Underage ルールで、ローン申請者の年齢が 21 歳未満であれば承認しない場合は、テストシナリオの GIVEN ファクトで、Applicant の age に、21 より小さい数字に設定する必要があります。

   EXPECT セクションには、GIVEN に入力したファクトに基づいて想定される結果を定義します。つまり、入力ファクトを GIVEN (指定) すると、その他のファクトが有効であること、またはルール全体が有効であることを EXPECT (想定) します。たとえば、このシナリオで、申請者が 21 歳未満の場合に 想定される 結果は、(申請者の年齢が基準を満たさないため) LoanApplication の approved が false になるか、Underage ルール全体が有効になります。

7. CALL METHOD と globals をテストシナリオに追加することもできます。

   • CALL METHOD: ルールの実行を開始する際に、別のファクトからメソッドを呼び出します。CALL METHOD をクリックし、ファクトを選択し、 をクリックして呼び出すメソッドを選択します。(可能な場合は) プロジェクトに対してインポートした Java ライブラリー、または JAR から (ArrayList のメソッドなどの) Java クラスメソッドを呼び出すことができます。
   • globals: テストシナリオで妥当性を確認するプロジェクトにグローバル変数を追加します。globals をクリックして、妥当性を確認する変数を選択し、テストシナリオデザイナーでグローバル名をクリックして、グローバル変数に適用するフィールド値を定義します。グローバル変数が利用できない場合は、Business Central に新しいアセットとして作成する必要があります。グローバル変数はデシジョンエンジンに表示されますが、ファクトに対するオブジェクトとは異なるオブジェクトの名前です。グローバルのオブジェクトを変更しても、ルールの再評価は行われません。
8. 必要に応じて、テストシナリオデザイナーの下部で More をクリックし、同じシナリオファイルに別のデータブロックを追加します。
9. シナリオに対して、GIVEN、EXPECT、その他のデータをすべて定義したら、テストシナリオデザイナーで Save をクリックして、設定した内容を保存します。

10. 右上の Run scenario をクリックして、この .scenario ファイルを実行します。プロジェクトパッケージに .scenario ファイルが複数ある場合にすべて保存している場合は、Run all scenarios をクリックして、すべてのシナリオを実行します。Run scenario オプションでは、個々の .scenario ファイルを保存する必要はありませんが、Run all scenarios オプションを使用する場合は、すべての .scenario ファイルを保存する必要があります。

    テストに失敗したら、ウィンドウ下部の Alerts メッセージに記載されている問題に対応し、シナリオの全コンポーネントを見直し、エラーが表示されなくなるまで妥当性確認を行います。

11. 変更がすべて終了したら、テストシナリオデザイナーで Save をクリックして、設定した内容を保存します。