Get-BeTestresults
Gets detailled test results of a specific run.
Get-BeTestresults
-Connection <Connection>
-RunId <Int64>
[-Search <String>]
[-Status <String[]>]
[-Skip <Integer>]
[-Take <Integer>]
Description
The Get-BeTestresults cmdlet returns a list of detailed test results of a specific run.
The test results can be filtered by a search-query or by a list of specific status. The list can also be limited in size by the Skip and Take parameters.
Example
Example 1: Getting all test results of a run
The following example shows how to print out a list of all tes results of a specific run.
# Get detailed testresults of the last Suite-Run $testresults = Get-BeTestresults -RunId $lastRunId -Take 100 -Connection $connection $testresults
Example 2: Getting the test results of a specific test case
The following example shows how to use the search-parameter to get the test results of a specific test case.
# Get detailed testresults of one specific test of the last Suite-Run $testresults = Get-BeTestresults -RunId $lastRunId -Search "#15" -Take 1 -Connection $connection $testresults
Parameters
-Connection
Pass the connection-object returned by the Connect-BeInstance cmdlet.
| Type: | Connection |
| Mandatory: | Yes |
| Position: | Named |
| Default Value: | None |
-RunId
The ID of the run whose test results should be returned.
| Type: | Int64 |
| Mandatory: | Yes |
| Position: | Named |
| Default Value: | None |
-Search
An optional search query to filter the test results. You may use #15 to find the test results of the test case number 15.
| Type: | String |
| Mandatory: | No |
| Position: | Named |
| Default Value: | None |
-Status
The optional status parameter allows to limit the test results to the ones that have a specific status. You can specifiy either one or multiple status at once.
| Type: | String[] |
| Mandatory: | No |
| Position: | Named |
| Default Value: | All possible status: “SUCCESS”, “FAILED”, “EXECUTING”, “NOTEVALUATED”, “DIFFERENTDIMENSIONALITY”, “CANCELED”, “NOTENOUGHPROBES”, “EXCEPTION” |
-Skip
The amount of records that should be skipped from the result.
| Type: | Integer |
| Mandatory: | No |
| Position: | Named |
| Default Value: | 0 |
-Skip
The amount of records that should be returned.
| Type: | Int64 |
| Mandatory: | No |
| Position: | Named |
| Default Value: | 10 |
Output
The cmdlet outputs a GetTestresultsResult-object that contains the following attributes.
| Name | Data Type | Description |
|---|---|---|
| Items | List | A list of TestresultItem-objects that are explained in detail below. |
| Total | Int64 | The total amount of available test results. |
| Skip | Int64 | The amount of test results that were skipped in the result. |
| Take | Int64 | The amount of test results returned by the cmdlet. |
The TestresultItem-object contains the following attributes.
| Name | Data Type | Description |
|---|---|---|
| TestResultId | Int64 | The ID of the test result. |
| RunId | List | The ID of the test suite run that produced the test result. |
| TestId | Integer | The ID of the test case. |
| TestName | String | The name of the test case. |
| TestDescription | String | The description of the test case. |
| MethodId | String | The ID of the test method used. |
| MethodUniqueName | String | The unique name of the test method. |
| Status | String | The status of the test result. – Executing – Success – Failed – NotEvaluated – DifferentDimensionality – Canceled – NotEnoughProbes – Exception |
| HasPayloadXml | Boolean | Is true if the test result has an attached payload XML file. |
| ExecutionSequence | Integer | When a test case was run multiple times (multi-instances), this parameter returns the order of the instances. |
| CreatedAt | DateTime | The point in time when the test result was created. |