Alert Context
Each triggered alert has an alert-context that consists of various information about the alert and the event that triggered the alert. The following information is availble.
Event
The following information about the event-trigger is available:
Event | One of the following events that triggered the alert. The Events-Enumeration contains the following members: ExecutionStarted The execution of a single testcase or a full testsuite has started. ExecutionFinished The execution of a single testcase or a full testsuite has finished. It doesn’t matter whether the result was positive or negative. | Enum |
EventGroup | Category of the event that triggered the alert. The EventGroups-Enumeration contains the following members: Execution This alert was triggered by any alert regarding test case or suite executions. Issues This alert was triggered by any alert regarding issues. | Enum |
EventScope | One of the following values indicate in wich context the alert was triggered. The EventScopes-Enumeration contains the following members: Suite The alert was triggered by a testsuite execution. TestInSuite The alert was triggered by a testcase that was run as part of a full testsuite. TestStandalone The alert was triggered by a testcase that was run standalone (not as part of a testsuite). | Enum |
Environment
Use the Environment-Object to access properties about the BiG EVAL environment or instance.
Environment.DisplayName | Displayname of the BiG EVAL instance that is also displayed in the header-bar of the user interface. | String |
Environment.FrontendUrl | The URL of the BiG EVAL frontend. | String |
Execution (Run)
Each testcase- or testsuite-execution owns a Run-object that provides information about the execution-context.
Run.RunId | ID of the Run. | Int64 |
Run.StartedAt | The point in time when the run started. | DateTime |
Run.FinishedAt | The point in time when the run finished. This property only contains a value in case of an ExecutionFinished-Event. | DateTime (nullable) |
Testcase
When the alert was triggered in the context of a single testcase, the Testcase-Property provides the following information.
TestId | ID of the testcase. | Int32 |
Test.TestId | ID of the testcase. | Int32 |
Test.Name | Name of the testcase. | String |
Test.Description | Description of the testcase. | String |
Test.MethodUniqueName | Unique name of the testmethod used in the testcase. | String |
Testsuite
When the alert was triggered in the context of a testsuite, the Testsuite-Property provides the following information.
SuiteId | ID of the testsuite. | Int32 |
Suite.SuiteId | ID of the testsuite. | Int32 |
Suite.Name | Name of the testsuite. | String |
Suite.Description | Description of the testsuite. | String |
Statistics
Each alert-context has a statistics-object that provides the following information.
Statistics.SuccessRate | The successrate of the testcases run. | Single |
Statistics.ExecutedCount | The number of testcases that were run. | Int32 |
Statistics.SuccessfulCount | The number of testcases that were successful. | Int32 |
Statistics.FailedCount | The number of testcases that failed. | Int32 |
Statistics.ErrorCount | The number of testcases that had an error/exception when running. | Int32 |
Testresult
When the event is one of the finishing events, basic testresult information is available.
TestResultId | ID of the testresult. | Int64 |
Outcome | Property that allows more detailed access to the testcase or suite outcome. The Outcome-Enumeration contains the following values: Successful True if the suite or the standalone test execution succeeded. Failed True if the suite or the standalone test execution failed. Excepted True if the suite or the standalone test execution resulted in an exception. | Enum |
Successful | This property is True if a single testcase or all testcases of a testsuite were successful. | Boolean |
Failed | This property is True if a single testcase or at least one testcase of a testsuite failed. | Boolean |
TestResultComment | The comment that may was set in the control-script of the test case. | String |
TestResultMessage | A message that was probably set by the test algorithm. | String |
TestResultMessageId | The ID of a message that was probably set by the test algorithm. | String |
TestResultException | If the test resulted in an exception, the exception message is available here. | String |
TestResultParameter | Use this block helper to output the value of a parameter like this: {{TestResultParameter ‘MyParameterName’}} | String |
Issues
If the event is one out of the Issues-EventGroup, then the following information is available.
Issue | If just one issue is affected by the event, information about that issue is available in this property. | Issue-Object |
Issues | If multiple issues were affected by the event, a list of these issues is available in this property. | List<Issue> |
One single Issue-Object contains the following properties.
IssueId | ID of the issue. | Int64 |
Identifier | Unique identifier of the issue that allows a test case to identify the issue where test results should be attached to. | String |
Title | The title of the issue. | String |
Description | The description of the issue. | String |
Status | The current status of the issue. Could be: NEW ANALYSIS WORKING RETEST DONE REMOVED | String |
Priority | The current priority of the issue. Could be: URGENT IMPORTANT MEDIUM LOW | String |
OwnedBy | The current owner of the issue. For properties see the table below. | User-Object |
CreatedByUser | The user that created the issue. For properties see the table below. | User-Object |
AssignedToUser | The current assignee of the issue who is working on it. For properties see the table below. | User-Object |
DeletedByUser | The user who deleted the issue if it’s a deleted-event. For properties see the table below. | User-Object |
One single User-Object contains the following properties.
Id | ID of the user. | String |
UserName | Username of the user. | String |
Firstname | The first name of the user. | String |
Lastname | The last name of the user. | String |
Fullname | The combination of first and last name of the user. | String |
The email-address of the user. | String |