What is a Run Property
Run Properties are a set of properties that can be passed during test execution. This allows user to supply run-level variable information at the time test is executed. It is similar to passing command-line information to an executable program.
Run Properties are defined at the project level. When you define a Run Property, you just define the specification. Value is provided when a test is running (in the Run modal).
Consider a scenario where the IP address of a back-end service is changing every time the service is deployed. User needs to pass this information at the time the test is executing. You can define this as a Run Property making this possible.
Define Run Property
- Navigate to Resources > Run Properties.
- Click on '+' and provide a meaningful name
- Select the type of field. Depending on the need, you have a choice of different field types to choose from.
- Indicate if this is a mandatory field or not. Blank values are not allowed in case the field is marked as mandatory.
- Provide help text that will be presented to the user when running the test. Describe what this field is meant for.
Field Types supported for Run Property
Following field types are supported:
- List: Select from a given list of items
- Multi List: Allows selecting 1 or more values
- Text: Free form text
- Date: date field
- Masked Input: Hidden text, which is encrypted.
- User List: List of current users in the project
- True/False: Boolean value
Using Run Properties
Here is a summary of use case for Run Properties. References to Scenario and Action Parameters made in this section, are not yet covered. Quickly browse through this section, further details will be clear in subsequent chapters.
Run Properties can be used for overriding an Action Parameter from a given scenario. If there is information in your test logic, which should be supplied at run-time, you first define it as an Action Parameter. And when you use that Action in a Scenario, override the parameter with a Run Property.
ACCELQ does not permit using Run Property directly in the Action logic in order to ensure that action logic is not tightly coupled with runtime decisions.
You are prompted to enter values for all relevant Run Properties when you are running a Scenario or Test Suite. When you run a suite, system automatically detects all the run properties required for all member scenarios and presents a screen.
In addition, if you are running the job from CI tools, you can supply this information from the CI plugin.
Summary of Run Properties
Remember following points about Run Parameters:
- Allows user to supply data at the time of execution
- Used when data value needs to be decided at Test Run level
- Same value is used for the entire test run