在 AXE 中撰寫測試

發行項
06/15/2023

TAEF 支援使用評定執行引擎 (AXE) 來執行的測試。

TAEF 中的 AXE 支援可讓 TAEF 執行 AXE 評估資訊清單。它主要是設計成將舊版測試以命令列 EXE 撰寫，包裝成 XML 型 AXE 評估資訊清單。如此一來，這些舊版測試就可以使用 TAEF 執行，而不需要將測試重寫為 TAEF 原生、受控或腳本測試。

AXE 測試版面配置

雖然一般 TAEF 測試檔案可以包含多個測試類別和測試，但 TAEF AXE 測試 (AXE 評定資訊清單所定義的測試) 只能包含單一測試，因為資訊清單會包裝單一可執行檔。因此，在 TAEF AXE 測試檔案中檢視測試時，您一律會看到測試檔案 (，這是您檢視) 的 AXE 評估資訊清單，包含單一測試類別和單一測試：

te Examples\AXE.Basic.Examples.manifest /list
Test Authoring and Execution Framework v2.7 Build 6.2.7918.0 (1320) For x64


        D:\enddev2.binaries.amd64chk\Test\CuE\TestExecution\Examples\AXE.Basic.Examples.manifest
            Basic
                Basic::Basic

AXE 測試也不支援任何設定或清除方法。

撰寫 AXE 測試

對於 AXE 測試，TAEF 會使用 AXE 評定資訊清單檔案格式。

最小 AXE 測試檔案

AXE 評定資訊清單架構的設計目的是為了支援複雜案例的複雜評定非常豐富的描述。不過，資訊清單也可以非常簡單，因為有幾個必要節點。下列範例顯示包含所有必要標記的最小資訊清單。

1<?xml version="1.0" encoding="utf-8"?>
2<AxeAssessmentManifest xmlns="http://www.microsoft.com/axe/assessment/manifest">
3  <VersionedId>
4    <Guid>{ABCBFDE6-D731-4030-9049-E7CAAB6A6EEE}</Guid>
5    <Version>
6      <Major>1</Major>
7      <Minor>0</Minor>
8      <Build>0</Build>
9      <Revision>0</Revision>
10    </Version>
11  </VersionedId>
12  <MinimumAxeVersionRequired>
13    <Version>
14      <Major>1</Major>
15      <Minor>0</Minor>
16      <Build>1</Build>
17      <Revision>0</Revision>
18    </Version>
19  </MinimumAxeVersionRequired>
20  <Description>
21    <ProgrammaticName>Basic</ProgrammaticName>
22    <DisplayName>Basic Examples</DisplayName>
23    <ToolTip>Sample Basic Examples Assessment Tooltip</ToolTip>
24  </Description>
25  <Meta>
26    <ExitValueMeaning> <ZeroIsSuccess/> </ExitValueMeaning>
27  </Meta>
28  <Execution>
29    <CreateProcess>
30      <ApplicationName>AssessmentSample.exe</ApplicationName>
31    </CreateProcess>
32  </Execution>
33</AxeAssessmentManifest>

AXE 測試評估檔案是 XML 檔案。因此，它會從第 1 行 (一般 XML 標頭開始) 。

第 2 行 會將 XML 檔案識別為 AXE 資訊清單。

第 3 - 10 行 會為測試提供可用來唯一識別測試的身分識別和版本。

第 12 - 19 行 指定解譯此資訊清單並執行測試所需的最小 AXE 版本。

第 20 - 24 行 會為測試提供人類可讀的名稱和簡短的工具提示描述。請注意，當您檢視測試屬性時，您的測試類別名稱和測試名稱會對應至 ProgramName 元素值：

D:\enddev2.binaries.amd64chk\WexTest\CuE\TestExecution>te Examples\AXE.Basic.Examples.manifest /list
Test Authoring and Execution Framework v2.7 Build 6.2.7918.0 (1320) For x64


        D:\enddev2.binaries.amd64chk\Test\CuE\TestExecution\Examples\AXE.Basic.Examples.manifest
            Basic
                Basic::Basic

人類可讀取的名稱會指派給 DisplayName 屬性。此指派是因為內部 TAEF 架構和設計所造成。

Te Examples\AXE.Basic.Examples.manifest /listproperties
Test Authoring and Execution Framework v2.7 Build 6.2.7918.0 (1320) For x64


        D:\enddev2.binaries.amd64chk\Test\CuE\TestExecution\Examples\AXE.Basic.Examples.manifest
                Property[TaefTestType] =  AxeAssessment

            Basic
                Basic::Basic
                        Property[DisplayName] =  Basic Examples
                        Property[ProgrammaticName] =  Basic
                        Property[RunAs] =  Elevated
                        Property[ToolTip] =  Sample Basic Examples Assessment Tooltip

此評估會包裝名為 AssessmentSample.exe的簡單和現有測試 EXE。 AssessmentSample.exe 使用一般慣例傳回零的處理常式結束代碼，以便成功，以及失敗的非零值。

第 25 - 27 行 告訴 AXE 和 TAEF 結束值表示測試成功，而任何其他值表示失敗。

最後， 第 28 - 32 行 會指示 AXE 使用 WIN32 API CreateProcess () 來執行 AssessmentSample.exe。

在 AXE 測試檔案中使用中繼資料

如同任何其他 TAEF 測試，您也可以將中繼資料套用至 TAEF AXE 測試。請考慮如下所示的範例。

1<?xml version="1.0" encoding="utf-8"?>
2<AxeAssessmentManifest xmlns="http://www.microsoft.com/axe/assessment/manifest">
3  <VersionedId>
4    <Guid>{F310F3F6-F786-4118-8A18-BC020C7D2521}</Guid>
5    <Version>
6      <Major>1</Major>
7      <Minor>0</Minor>
8      <Build>0</Build>
9      <Revision>0</Revision>
10    </Version>
11  </VersionedId>
12  <MinimumAxeVersionRequired>
13    <Version>
14      <Major>1</Major>
15      <Minor>0</Minor>
16      <Build>1</Build>
17      <Revision>0</Revision>
18    </Version>
19  </MinimumAxeVersionRequired>
20  <Description>
21    <ProgrammaticName>CustomMetadataExamples</ProgrammaticName>
22    <DisplayName>Custom Metadata Examples</DisplayName>
23    <ToolTip>Sample Custom Metadata Examples Assessment Tooltip</ToolTip>
24  </Description>
25  <Properties>
26    <Owner>Someone</Owner>
27    <Priority>1</Priority>
28    <Parallel>false</Parallel>
29  </Properties>
30  <Meta>
31    <ExitValueMeaning> <ZeroIsSuccess/> </ExitValueMeaning>
32  </Meta>
33  <Execution>
34    <CreateProcess>
35      <ApplicationName>AssessmentSample.exe</ApplicationName>
36    </CreateProcess>
37  </Execution>
38</AxeAssessmentManifest>

第 25 - 29 行 示範 TAEF 標準和自訂中繼資料如何套用至 AXE 測試。 在 AxeAssessmentManifest XML 節點下是[屬性] 節點。 [屬性] 節點底下的單一層級 XML 標籤會辨識為中繼資料 (屬性) 。屬性下的所有單一層級 XML 標籤都會解譯為屬性名稱，而且其文字值會解譯為屬性值。在上述範例中， 擁有者 會解譯為屬性名稱， 而 Someone 會解譯為屬性值。這些元素中沒有文字的 XML 標記會解譯為值等於空字串的專案 (，< 例如 SimpleTagWithNoText/ >) 。在 [屬性 ] 底下的多層級 XML 標籤會忽略 (例如多層級標籤，例如，

<VerifyOSVersion>
    <Major>6</Major>
    <Minor>0</Minor>
    <Build>0</Build>
</VerifyOSVersion>

將會忽略) 。類似于任何其他 TAEF 測試，您可以使用 /listProperties 選項來顯示 TAEF 中繼資料：

te Examples\AXE.CustomMetadata.Examples.manifest /listProperties
Test Authoring and Execution Framework v2.7 Build 6.2.7918.0 (1320) For x64

        D:\enddev2.binaries.amd64chk\Test\CuE\TestExecution\Examples\AXE.CustomMetadata.Examples.manifest
                Property[TaefTestType] =  AxeAssessment

            CustomMetadataExamples
                CustomMetadataExamples::CustomMetadataExamples
                        Property[DisplayName] =  Custom Metadata Examples
                        Property[Owner] =  Someone
                        Property[Parallel] =  false
                        Property[Priority] =  1
                        Property[ProgrammaticName] =  CustomMetadataExamples
                        Property[RunAs] =  Elevated
                        Property[ToolTip] =  Sample Custom Metadata Examples Assessment Tooltip

AXE 測試中繼資料支援限制

注意

並非所有 TAEF 標準測試中繼資料都可與 TAEF AXE 測試搭配使用。

所有以修改進程執行環境為目標的中繼資料，例如 ActivationCoNtext 和 ThreadingModel，都不適用於 AXE 測試。 AXE 不會使用 TAEF 的程式來執行測試，但會建立新的進程，在其中執行 AXE 測試檔案所指定的可執行程式， (AXE 評估資訊清單) 。基於相同的原因，資料驅動 TAEF 測試 (DataSource 屬性) 不適用於 AXE TAEF 測試。
同樣地，由於 TAEF AXE 測試檔案只能封裝單一測試，因此修改測試與 ExecutionGroup等其他測試相關之測試行為的 TAEF 中繼資料也無法運作。
由於 AXE 架構，AXE 只能執行提升許可權的進程。因此，如您在上述 TAEF AXE 測試的屬性中看到，每個 TAEF AXE 測試都會套用 Property[RunAs] = Elevated 。

具有執行時間參數的 AXE 測試檔案

TAEF AXE 測試也支援執行時間參數。若要搭配 AXE 測試使用 TAEF 的執行時間參數，必須將傳遞至可執行程式的參數名稱定義在 AXE 測試檔案中。

此檔超出本檔的範圍，可描述所有詳細資料中的所有可能 AXE 資訊清單參數功能。如需該資訊，請參閱 AXE 評估檔。本檔只會涵蓋最常見的實用參數應用程式。

下列範例顯示更複雜的 AXE 評估資訊清單。

1<?xml version="1.0" encoding="utf-8"?>
2<AxeAssessmentManifest xmlns="http://www.microsoft.com/axe/assessment/manifest">
3  <VersionedId>
4    <Guid>{B63B2FFF-EDEB-41FB-92EA-529CE4A46D20}</Guid>
5    <Version>
6      <Major>1</Major>
7      <Minor>0</Minor>
8      <Build>0</Build>
9      <Revision>0</Revision>
10    </Version>
11  </VersionedId>
12  <MinimumAxeVersionRequired>
13    <Version>
14      <Major>1</Major>
15      <Minor>0</Minor>
16      <Build>1</Build>
17      <Revision>0</Revision>
18    </Version>
19  </MinimumAxeVersionRequired>
20  <Description>
21    <ProgrammaticName>ExplicitRuntimeParameters</ProgrammaticName>
22    <DisplayName>Explicit Runtime Parameters</DisplayName>
23    <ToolTip>Sample Explicit Runtime Parameters Assessment Tooltip</ToolTip>
24  </Description>
25  <ParameterDefinitions>
26    <ParameterDefinition>
27      <Description>
28        <ProgrammaticName>SimpleParameter</ProgrammaticName>
29        <DisplayName>Simple parameter</DisplayName>
30        <ToolTip>The is an example of a simple parameter.</ToolTip>
31      </Description>
32      <Type>
33        <String></String>
34      </Type>
35      <CommandLineFormat>{0}</CommandLineFormat>
36    </ParameterDefinition>
37    <ParameterDefinition>
38      <Description>
39        <ProgrammaticName>RequiredParameterWithoutDefaultValue</ProgrammaticName>
40        <DisplayName>Required parameter without a default value.</DisplayName>
41        <ToolTip>The is an example of a required parameter Without a default value.</ToolTip>
42      </Description>
43      <Required>True</Required>
44      <Type>
45        <Int></Int>
46      </Type>
47      <CommandLineFormat>{0}</CommandLineFormat>
48    </ParameterDefinition>
49    <ParameterDefinition>
50      <Description>
51        <ProgrammaticName>RequiredParameterWithDefaultValue</ProgrammaticName>
52        <DisplayName>Required parameter with a default value</DisplayName>
53        <ToolTip>The is an example of a required parameter With a default value.</ToolTip>
54      </Description>
55      <Required></Required>
56      <DefaultValue>"%AssessmentResultsPath%"</DefaultValue>
57      <Type>
58        <String></String>
59      </Type>
60      <CommandLineFormat>/RequiredParameterWithDefaultValue={0}</CommandLineFormat>
61    </ParameterDefinition>
62  </ParameterDefinitions>
63  <Meta>
64    <ExitValueMeaning> <ZeroIsSuccess/> </ExitValueMeaning>
65  </Meta>
66  <Execution>
67    <CreateProcess>
68      <ApplicationName>AssessmentSample.exe</ApplicationName>
69    </CreateProcess>
70  </Execution>
71</AxeAssessmentManifest>

第 25 - 62 行 是描述 TAEF 和 AXE 用來將資料傳遞至評定可執行檔的參數定義。

最簡單的參數定義位於 第 26 - 36 行。它包含與資訊清單的[描述] 區段完全相同的強制 Description 區段，如上所述。然後，您會看到定義參數資料類型的 Type 標籤。 (如需所有支援的資料類型，請參閱 AXE 評估檔。)

選擇性 的 CommandLineFormat 區段描述評估參數的格式如何針對評定命令列進行格式化。此 XML 節點必須包含有效的 .NET 格式字串的非空白字串。評估參數值將是傳遞至格式器的唯一物件。這表示格式字串必須包含一個且只有一個索引為零的複合格式專案。某些範例包括：-input {0} 、/affinity：0x{0、X}或 -InputFile=「 {0} 」。

下一個參數是在 第 37 - 48 行 上定義，而且是必要參數。其定義與上一個參數的唯一差異是選擇性的 Required 標籤。此標籤表示 AXE 預期使用者在 AXE 測試執行期間傳遞此參數。如果省略此參數，則會使用參數資料類型的預設值 (，例如 INT 的零、String 的空字串等等) 。

最後，範例中的最後一個參數會指定選擇性 的 DefaultValue 標籤，其描述參數的預設值。如果這個節點是空白的，則會使用參數資料類型的預設值做為預設值。上述範例使用「%AssessmentResultsPath%」，這是評估開始執行時由 AXE 設定的環境變數。同樣地，如需所有支援的 AXE 環境變數，請參閱 AXE 評估檔。

參數會以定義的反向順序傳遞至可執行檔 - 最後一個檔案中定義的參數會先傳遞至可執行檔。

您可以使用/p命令列選項) ，執行 TAEF AXE執行時間參數測試作為任何其他使用執行時間參數的 TAEF 測試 (：

te AXE.ExplicitRuntimeParameters.Examples.manifest /p:SimpleParameter=Test1 /p:RequiredParameterWithoutDefaultValue=10
Test Authoring and Execution Framework v2.7 Build 6.2.7918.0 (1320) For x64

ExplicitRuntimeParameters::ExplicitRuntimeParameters
AssessmentSample.exe is simple application for AXE assessment demo.
It just echoes the arguments passed to it to the console.

Parameters passed from the command line:
Argument[0]=AssessmentSample.exe
Argument[1]=10
Argument[2]=/RequiredParameterWithDefaultValue=C:\Results\JobResults_DEVRH_2011-0129_0250-12.394\0
Argument[3]=Test1

FileName: C:\Results\JobResults_DEVRH_2011-0129_0250-12.394\JobResults_DEVRH_2011-0129_0250-12.394.xml
Saved output file to: D:\enddev2.binaries.amd64chk\Test\CuE\TestExecution\WexLogFileOutput\
000001_~ExplicitRuntimeParameters_JobResults_DEVRH_2011-0129_0250-12.394.xml
EndGroup: ExplicitRuntimeParameters::ExplicitRuntimeParameters [Passed]

AXE 測試跨電腦執行

對於跨電腦執行案例，TAEF 會嘗試判斷需要部署的測試相依性，以及測試以成功執行測試。如果是 AXE 測試檔案，TAEF 會將位於相同資料夾中的所有檔案與 TAEF AXE 測試複製到遠端電腦以供執行。

目前不支援跨電腦對 Arm 平臺執行 AXE 測試。

TAEF AXE 支援相依性

AXE 未隨附于 Windows。若要能夠執行 AXE 測試，您必須將 axecore.dll 和 Microsoft.Assessment.dll 複製到 TAEF 或 TAEF AXE 測試目錄。

共用方式為