PICT データソース

このセクションに進む前に、TAEF の基本的な実行に慣れ、それを使用してテストを作成する方法を理解していることを確認してください。

PICT の背景と参照

PICT は、ペアワイズ独立組み合わせテストの略です。 PICT を使用すると、パラメーターごとにバリエーションを個別に指定できます。 たとえば、API テストが FileName と FileExtension の 2 つのパラメーターに依存している場合、FileName と FileExtension に渡す可能性のあるバリエーションは、次のように個別に考えられます。

FileName: a, z12390, Realllyreallyreallylonglonglonglonglonglonglonglonglonglong, normallength
FileExtension: txt, png, bat, doc, exe, bmp, wav

これで、リストに追加するバリエーションが増えると、上記 (4 X 7 = 28) の ブルートフォースの組み合わせ拡張 が 簡単に範囲外になる可能性 があることがわかります。このようなテストケースのシナリオでは、 PICT は、入力パラメーターに対する包括的な組み合わせカバレッジを取得するパラメーター結果のコンパクトなセットを生成することで、多くの値を追加できます。

TAEF での PICT サポート

TAEF では、PICT ベースのテストに対する組み込みのサポートが提供されます。

これを利用するには、通常と同様に、pict.exe 用の入力モデルファイルを記述します。上記の examples フォルダーの *.txt ファイルを参照してください。 PICT がモデルファイルで想定どおりに実行される場合は、まず次のようにコマンドプロンプトで試してみると便利な場合があります。

pict.exe <model file> [/e:<seed file>]

Pict.exe は、TAEF の最新リリース共有の残りのバイナリで使用できます。

PICT のモデルファイル (およびシードファイル) の作成が完了し、コマンドプロンプトで pict.exe に対して検証したので、テストをマークして、TAEF に PICT 駆動テストであることを知らせることができます。 TAEF で使用できるテーブルベースのデータドリブンテストに慣れている場合は、この方法が非常によく似ています。

ネイティブコード:

1     class PictExample
2     {
3         TEST_CLASS(PictExample)
4
5         BEGIN_TEST_METHOD(SimpleTest)
6             TEST_METHOD_PROPERTY(L"DataSource", L"pict:PictExample.txt")
7         END_TEST_METHOD()
8
9         BEGIN_TEST_METHOD(TestWithSeed)
10            TEST_METHOD_PROPERTY(L"DataSource", L"pict:TestWithSeed.txt")
11            TEST_METHOD_PROPERTY(L"Pict:SeedingFile", L"TestWithSeed.sed")
12            TEST_METHOD_PROPERTY(L"Pict:Timeout", L"00:01:30")
13        END_TEST_METHOD()
14
15        BEGIN_TEST_METHOD(TestWithFunction)
16            TEST_METHOD_PROPERTY(L"DataSource", L"pict:TestWithFunction.txt")
17        END_TEST_METHOD()
18    };

マネージドコード:

1     [TestClass]
2     public class CSharpPictExample
3     {
4         [TestMethod]
5         [DataSource("pict:ConstraintsTest.txt")]
6         [TestProperty("Pict:SeedingFile", "ConstraintsTest.seed")]
7         public void ConstraintsTest()
8         {
9             ...
10        }
11
12        [TestMethod]
13        [DataSource("pict:SumofSquareRoots.txt")]
14        public void SumOfSquareRoots()
15        {
16            ...
17        }
18
19        public TestContext TestContext
20        {
21            get { return m_testContext; }
22            set { m_testContext = value; }
23        }
24
25        private TestContext m_testContext;
26    }

上記の例に示すように、モデルファイルの名前をデータソースとして指定する必要があります。 モデルファイルの名前の前に "pict:" を付け 、テストメソッドの DataSource として指定する必要があります。 TAEF を使用する他のデータドリブンテストと同様に、マネージドテストの場合は、TestContext プロパティの取得メソッドと設定メソッドを指定し、クラス内に同じインスタンスのプライベートインスタンスを設定する必要があります。

コマンドオプションを PICT に渡す場合は、この目的でメタデータを使用できます。次の表を使用して、Pict.exe のコマンドオプションを TAEF メタデータにマップします。

pict.exe コマンド構文	ネイティブ TAEF メタデータ構文	マネージド TAEF メタデータ構文
/o:3	TEST_METHOD_PROPERTY(L"Pict:Order", L"3")	[TestProperty("Pict:Order", "3")]
/d:,	TEST_METHOD_PROPERTY(L"Pict:ValueSeparator", L",")	[TestProperty("Pict:ValueSeparator", ",")]
/a:		TEST_METHOD_PROPERTY(L"Pict:AliasSeparator", L"
/n:~	TEST_METHOD_PROPERTY(L"Pict:NegativeValuePrefix", L"~")	[TestProperty("Pict:NegativeValuePrefix", "~")]
/e:test.seed	TEST_METHOD_PROPERTY(L"Pict:SeedingFile", L"test.seed")	[TestProperty("Pict:SeedingFile", "test.seed")]
/r	TEST_METHOD_PROPERTY(L"Pict:Random", L"true")	[TestProperty("Pict:Random", "true")]
/r:33	TEST_METHOD_PROPERTY(L"Pict:RandomSeed", L"33")	[TestProperty("Pict:RandomSeed", "33")]
/c	TEST_METHOD_PROPERTY(L"Pict:CaseSensitive", L"true")	[TestProperty("Pict:CaseSensitive", "true")]

上記のメタデータは、コマンドプロンプト、DataSource プロパティ、またはテスト、クラス、またはモジュールレベルのメタデータとして、優先順位を指定して設定できます。コマンドプロンプトで設定するには、次の構文を使用します。

te.exe <test dll> /Pict:Order=3 /Pict:SeedingFile=test.seed

DataSource プロパティでメタデータを設定するには、モデルファイル名に疑問符文字 (?) を追加し、アンパサンドで区切られたメタデータ名 = メタデータ値のペアのセットを追加します。このメソッドを使用する場合、メタデータ名の "Pict:" プレフィックスは省略可能です。次に例を示します。

TEST_METHOD_PROPERTY(L"DataSource", L"Pict:model.txt?Order=3&CaseSensitive=true&Random=true")

TAEF はバックグラウンドで、入力モデルファイルとコマンドオプションを PICT に提供し、結果を取得します。 PICT でエラーまたは警告が生成された場合は、TAEF によって警告としてログに記録されます。 PICT が生成する結果の出力行ごとに、TAEF は問題のあるテストを再度呼び出します。

"Pict:RandomSeed" の値を設定すると、"Pict:Random" の既定値が false から true に変更されます。これにより、明示的に "Pict:Random" を false に設定して、TAEF で "Pict:RandomSeed" を無視させることができます。

PICT.exe がモデルファイルとシードファイル入力で実行できる既定のタイムアウトは 5 分です。 モデルファイルが複雑で、PICT.exe が結果を返すために 5 分を超える時間が必要な場合は、上記の CPP の例に示すように 、"Pict:Timeout" メタデータを指定することで、このタイムアウトをオーバーライドできます。この例では、標準の TAEF タイムアウト形式で 1.5 分のタイムアウトが指定されています。他の PICT メタデータと同様に、"Pict:Timeout" メタデータは継承されるため、クラスまたはモジュール全体に対して指定できます。

TAEF を使用したテーブルベースのデータドリブンテストの場合と同じ方法で、テストメソッドおよび関連するセットアップおよびクリーンアップメソッドから特定の呼び出し中にデータ値にアクセスできます。ネイティブコードには TestData クラスを使用し、マネージドコードには TestContext を使用します。

ネイティブコード:

1     void PictExample::SimpleTest()
2     {
3         String valueA;
4         if (SUCCEEDED(TestData::TryGetValue(L"A", valueA)))
5         {
6           Log::Comment(L"A retrieved was " + valueA);
7         }
8
9         String valueB;
10        if (SUCCEEDED(TestData::TryGetValue(L"B", valueB)))
11        {
12            Log::Comment(L"B retrieved was " + valueB);
13        }
14
15        String valueC;
16        if (SUCCEEDED(TestData::TryGetValue(L"C", valueC)))
17        {
18            Log::Comment(L"C retrieved was " + valueC);
19        }
20
21        unsigned int index;
22        if (SUCCEEDED(TestData::TryGetValue(L"index", index)))
23        {
24            Log::Comment(String().Format(L"At index %d", index));
25        }
26    }

マネージドコード:

1      [TestClass]
2      public class CSharpPictExample
3      {
4          [TestMethod]
5          [DataSource("pict:ConstraintsTest.txt")]
6          public void ConstraintsTest()
7          {
8              Log.Comment("A is " + m_testContext.DataRow["A"]);
9              Log.Comment("B is " + m_testContext.DataRow["B"]);
10             Log.Comment("C is " + m_testContext.DataRow["C"]);
11             Log.Comment("D is " + m_testContext.DataRow["D"]);
12
13             UInt32 index = (UInt32)m_testContext.DataRow["Index"];
14             Log.Comment("At index " + index.ToString());
15        }
16
17        [TestMethod]
18        [DataSource("pict:SumofSquareRoots.txt")]
19        public void SumOfSquareRoots()
20        {
21             Log.Comment("A is " + m_testContext.DataRow["A"]);
22             Log.Comment("B is " + m_testContext.DataRow["B"]);
23
24             UInt32 index = (UInt32)m_testContext.DataRow["Index"];
25             Log.Comment("At index " + index.ToString());
26        }
27
28        public TestContext TestContext
29        {
30             get { return m_testContext; }
31             set { m_testContext = value; }
32        }
33
34        private TestContext m_testContext;
35    }

TAEF のデータドリブンテストと同様に、"Index" は予約されており、パラメーター名として使用しないでください。インデックスはテストメソッド呼び出しのインデックスを暗黙的に参照し、テストで必要な場合はテストメソッドからアクセスできます。

PICT ベースのテストの場合、すべてのパラメーターのデータ型は WEX::Common::String (ネイティブ)、String(マネージド) または VT_BSTR(スクリプト) であると見なされることにも注意してください。変換と解釈はユーザーに任されます。

これで、TAEF を使用した PICT ベースのテストの作成が完了しました。コマンドプロンプトから呼び出し、TAEF が提供するすべてのコマンド機能を適用できます。 例: /list を使用して、PICT 出力をデータとして使用して生成されるすべてのテストメソッドの一覧を取得し、 /listproperties を使用して、テストメソッド名の一覧と、それらが関連付けられているメタデータとデータ値を取得します。等。開始する前に注意すべき重要な点 は、pict.exe がパスにあることを確認することです。

次に例をいくつか示します。

te Examples\CPP.Pict.Example.dll /list /name:*SimpleTest*
Test Authoring and Execution Framework v2.9.3k for x86
        f:\ Examples\CPP.Pict.Example.dll
            WEX::TestExecution::Examples::PictExample
                WEX::TestExecution::Examples::PictExample::SimpleTest#0
                WEX::TestExecution::Examples::PictExample::SimpleTest#1
                WEX::TestExecution::Examples::PictExample::SimpleTest#2
                WEX::TestExecution::Examples::PictExample::SimpleTest#3
                WEX::TestExecution::Examples::PictExample::SimpleTest#4
                WEX::TestExecution::Examples::PictExample::SimpleTest#5
                WEX::TestExecution::Examples::PictExample::SimpleTest#6
                WEX::TestExecution::Examples::PictExample::SimpleTest#7
                WEX::TestExecution::Examples::PictExample::SimpleTest#8
                WEX::TestExecution::Examples::PictExample::SimpleTest#9
                WEX::TestExecution::Examples::PictExample::SimpleTest#10
                WEX::TestExecution::Examples::PictExample::SimpleTest#11
                WEX::TestExecution::Examples::PictExample::SimpleTest#12
                WEX::TestExecution::Examples::PictExample::SimpleTest#13
                WEX::TestExecution::Examples::PictExample::SimpleTest#14
                WEX::TestExecution::Examples::PictExample::SimpleTest#15
                WEX::TestExecution::Examples::PictExample::SimpleTest#16
                WEX::TestExecution::Examples::PictExample::SimpleTest#17
                WEX::TestExecution::Examples::PictExample::SimpleTest#18
                WEX::TestExecution::Examples::PictExample::SimpleTest#19
                WEX::TestExecution::Examples::PictExample::SimpleTest#20
                WEX::TestExecution::Examples::PictExample::SimpleTest#21
                WEX::TestExecution::Examples::PictExample::SimpleTest#22
                WEX::TestExecution::Examples::PictExample::SimpleTest#23

選択条件 (/select と /name) の詳細については、選択 Wiki ページを参照してください。

te Examples\Csharp.Pict.Example.dll /listproperties /select:"@Name='*SumofSquare*'
                    and @Data:index>10
Test Authoring and Execution Framework v2.9.3k for x86
        f:\ Examples\CSharp.Pict.Example.dll
            WEX.Examples.CSharpPictExample
                WEX.Examples.CSharpPictExample.SumOfSquareRoots#11
                        Property[DataSource] = pict:SumofSquareRoots.txt
                        Data[a] = 1
                        Data[b] = ~-1
                WEX.Examples.CSharpPictExample.SumOfSquareRoots#12
                        Property[DataSource] = pict:SumofSquareRoots.txt
                        Data[a] = 2
                        Data[b] = ~-1

上の例は、インデックスを使用して選択する方法を示しています。データ値に基づいて選択することもできます。

te Examples\Csharp.Pict.Example.dll /listproperties /select:"@Name='*SumofSquare*'
                    and (@Data:A='1' and @Data:B='1')"
Test Authoring and Execution Framework v2.9.3k for x86
        f:\ Examples\CSharp.Pict.Example.dll
            WEX.Examples.CSharpPictExample
                WEX.Examples.CSharpPictExample.SumOfSquareRoots#8
                        Property[DataSource] = pict:SumofSquareRoots.txt
                        Data[a] = 1
                        Data[b] = 1

PICT の結果キャッシュ

一部のモデルファイルは非常に複雑になり、Pict.exeによって処理されるのに長い時間が必要になる場合があります。 TAEF は、Te.exeの特定の実行中に結果をキャッシュすることで、結果の処理時間を軽減しようとします。同じ実行実行の後続のテストで同じモデルとシードファイルの組み合わせを参照する場合、TAEF はキャッシュされた結果を使用します。既定では、各実行の最後に、キャッシュされた結果が削除されます。

後続の実行でキャッシュされた結果を引き続き利用する場合は、実行中にコマンドプロンプトで "/persistPictResults" オプションを指定できます。コマンドに "/persistPictResults" を指定すると、最初の実行は実際には pict.exe 実行され、時間がかかる場合がありますが、後続のすべての実行では、モデルとシードファイルが変更されていない場合にキャッシュされた結果が使用されます。注: 後続の実行では、引き続き "/persistPictResults" を指定する必要があります。指定しない後続の実行では、その実行の最後にキャッシュされた結果が削除されます。

PICT の結果を保持し、キャッシュされたデータを既定で使用する場合は、次に示すようにte_cmd環境変数の一部として設定し、実行時に指定する必要がなくなります。 te_cmd の詳細については、「テストの実行」を参照してください。

set te_cmd = /persistPictResults

キャッシュされた結果ファイルは、Te.exe にアクセス権がある場合は %temp% ディレクトリ内の "TAEF-PICT" という名前のフォルダーに、そうでない場合は、Te.exe が起動された現在の実行ディレクトリに格納されます。結果が不整合な状態になる可能性があるのは、実行中に Ctrl + C キーを押した場合だけです。このような場合、TAEF はキャッシュされた結果の削除を試みますが、削除できない場合は、その結果に対するエラーが表示されます。このエラーにより、キャッシュされた結果の場所を削除するように求められます。これを行わないと、後続のテストで未定義または誤った動作が発生する可能性があります。

TAEF の組み込みの PICT サポートにより、PICT の機能とテスト自動化の TAEF の機能の両方を最大限に活用できるようになりました。

リソースとしてのデータソース

テストモジュールにリソースとしてPICTモデルとシードファイルを追加することができます。

ネイティブコードでは、これは、DataSource メタデータ内のファイル名ではなくリソース名を指定することによって行われます。次に例を示します。

BEGIN_TEST_METHOD(ResourceNameDataSource)
    TEST_METHOD_PROPERTY(L"DataSource", L"Pict:MyModelResourceName?SeedingFile=MySeedingResourceName")
END_TEST_METHOD()

"MyModelResourceName" と "MySeedingResourceName" は、.rc ファイルで定義されているリソース名です。テーブルデータソースのリソースの種類が DATASOURCE_XML である必要があるのとは異なり、ここではリソースの種類は DATAFILE である必要があります。

MyModelResourceName DATAFILE "model.txt"
MySeedingResourceName DATAFILE "seed.txt"

DataSource メタデータ値は、モデルがファイルであった場合と同じままです。ネイティブコードでも同様に、リソース名をファイル名と同じにすることができます。 TAEF はまず、DataSource 名を持つ実際のファイルの存在を探します。ファイルが見つからない場合は、テストモジュールのリソースを調べることで続行します。リソースに格納されている DataSource を変更するには再コンパイルが必要であるため、開発時に DataSource ファイルをテスト dll と同じ場所にコピーし(リソース名にファイル名と同じ名前を付ける)、この設計を活用できます。テストが完了したら、ファイルをコードディレクトリに移動 (コピーしない) し、再コンパイルしてリソースを埋め込みます。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-07-18