Skip to content

Latest commit

 

History

History
102 lines (82 loc) · 4.68 KB

EiffelTestCaseTriggeredEvent.md

File metadata and controls

102 lines (82 loc) · 4.68 KB

EiffelTestCaseTriggeredEvent (TCT)

The EiffelTestCaseTriggeredEvent declares that the execution of a test case has been triggered, but not yet started. This can either be declared stand-alone or as part of an activity or test suite, using either a CAUSE or a CONTEXT link type, respectively.

This event is used to communicate intent, and thereby serves a similar purpose to that of EiffelActivityTriggeredEvent. A triggered test case execution is expected to either be started (represented by EiffelTestCaseStartedEvent) or canceled (represented by EiffelTestCaseCanceledEvent). Consequently, any delay between triggering and execution can be assumed to imply queuing time (e.g. waiting for available test resources) and monitored as such.

Data Members

data.testCase

Type: Object
Required: Yes
Description: Identification of the test case to be executed.

data.testCase.tracker

Type: String
Required: No
Description: The name of the test case tracker - typically a test management system.

data.testCase.id

Type: String
Required: Yes
Description: The unique identity of the test case to be executed.

data.testCase.version

Type: String
Required: No
Description: The unique version of the identified test case to be executed. Where this property is not used it is assumed that test cases are not version controlled.

data.testCase.uri

Type: String
Required: No
Description: A location where a description of the test case can be retrieved. To the extent that multiple versions of the same test case co-exist, this property SHALL identify the exact version to be executed.

data.recipeId

Type: String
Required: No
Description: If triggering this test case execution was the result of an Execution Recipe, as defined by an EiffelTestExecutionRecipeCollectionCreatedEvent, this UUID SHALL match the relevant data.batches.recipes.id in that event.

data.triggers

Type: Object[]
Required: No
Description: The circumstances triggering the test case execution.

data.triggers.type

Type: String
Required: Yes
Legal values: MANUAL, EIFFEL_EVENT, SOURCE_CHANGE, TIMER, OTHER
Description: The type of trigger.
MANUAL signifies that the test case execution was manually triggered.
EIFFEL_EVENT signifies that the test case execution was triggered by one or more Eiffel events. These events should be represented via CAUSE links.
SOURCE_CHANGE signifies that the test case execution was triggered as a consequence of a detected source change not represented by Eiffel events.
TIMER signifies that the test case execution was triggered by a timer.
OTHER signifies any other triggering cause.

data.triggers.description

Type: String
Required: No
Description: A description of the trigger.

data.executionType

Type: String
Required: No
Legal values: MANUAL, SEMI_AUTOMATED, AUTOMATED, OTHER
Description: The type of execution (often related to, but ultimately separate from, data.triggers.type).

data.parameters

Type: Object[]
Required: No
Description: A list of parameters to be passed to the test case execution.

data.parameters.name

Type: String
Required: Yes
Description: The name of the parameter.

data.parameters.value

Type: String
Required: Yes
Description: The value of the parameter.

Version History

Version Introduced in Changes
1.0.0 edition-bordeaux Initial version.

Examples