Get-BeSuiteRunStatistics

Gets statistics about the last runs of a specific suite.

Get-BeSuiteRunStatistics
    -Connection <Connection>
    -SuiteId <Integer>
    [-Skip <Integer>]
    [-Take <Integer>]

Description

The Get-BeSuiteRunStatistics cmdlet returns a list of statistic-objects about the last runs of a specific test suite.

Use the optional parameters Skip and Take to define which suite runs should be returned. E.g. if using -Take 1, the very last suite run stats get returned.

Example

The following example shows how to return the very last suite run stats.

$suiteId = 1

# Get statistics about the last Suite-Run
$runStats = Get-BeSuiteRunStatistics -SuiteId $suiteId -Take 1 -Connection $connection
$runStat = $runStats.items[0]

# Write some statistics about the last run to the console
Write-Host ("Run-ID:           " + $runStat.runId)
Write-Host ("Tests run:        " + $runStat.totalCount)
Write-Host ("Tests succeeded:  " + $runStat.succeededCount)
Write-Host ("Tests failed:     " + $runStat.failedCount)
Write-Host ("Tests excepted:   " + $runStat.exceptionsCount)
Write-Host ("Success-Rate:     " + ($runStat.succeededCount / $runStat.totalCount * 100) + "%")

Parameters

-Connection

Pass the connection-object returned by the Connect-BeInstance cmdlet.

Type:Connection
Mandatory:Yes
Position:Named
Default Value:None

-SuiteId

The ID of the suite whose last runs should be returned.

Type:Integer
Mandatory:Yes
Position:Named
Default Value:None

-Skip

The amount of records that should be skipped from the result. e.g. using -Skip 3 means that the last three runs will not be returned.

Type:Integer
Mandatory:No
Position:Named
Default Value:0

-Skip

The amount of records that should be returned.

Type:Integer
Mandatory:No
Position:Named
Default Value:10

Output

The cmdlet outputs a SuiteRunStatisticsResult-object that contains the following attributes.

NameData TypeDescription
ItemsListA list of TestResultsScopedItem-objects that are explained in detail below.
TotalInt64The total amount of available suite run stats.
SkipInt64The amount of stats that were skipped in the result.
TakeInt64The amount of stats returned by the cmdlet.

The TestResultsScopedItem-object contains the following attributes.

NameData TypeDescription
RunIdListThe ID of the test suite run that produced the test results.
TimestampDateTimeThe point in time when the suite run finished.
StatusStringThe completion status of the suite run. Either Succeeded, Failed or Canceled.
SucceededCountIntegerThe amount of test case instances that succeeded.
FailedCountIntegerThe amount of test case instances that failed.
ExceptionsCountIntegerThe amount of test case instances that threw an exception.
NotEnoughProbesCountIntegerThe amount of test case instances that had not enough probes to evaluate the testing algorithm.
DifferentDimensionalityCountIntegerThe amount of test case instances that failed due to a dimensionality divergence.
NotEvaluatedCountIntegerThe amount of test case instances that couldn’t be evaluated.
ExecutingCountIntegerThe amount of test case instances that are still executing.
TotalCountIntegerThe total amount of test case instances within the suite run.
Table of Contents