Create Custom Actions from scratch
If you want to create a new action from scratch, go to the Repository and switch to the All Objects tab.
Now click Add Item, a popup window will appear.
In that window you can choose wich type of item you want to create. Choose Action and give it a name and an optional description. You can change the name and the description later on if you want. When you have entered all needed informations, click Create.
Now open the newly created action by doubleclicking its name in the repository.
On this page you can edit your new action by adding other existing actions to it, like you would in a test case, and set input- and output parameters.
Create Custom Actions from existing Actions
To create a custom action, first select the test steps you need to achieve the desired action in your test case:
Then extract the actions into one test step that contains your selected actions using the Extract Action button:
On this dialog box, you can give your new custom action a Name and a Description. Click Close to finish. You can now add your action to any test case, like you would with any other action.
Changing Custom Actions
When selecting a custom action, click Open under Test Step Settings to go inside the custom action:
While inside your custom action, you can change the action just like you would in a test case. Additionally, you can set input and output parameters for your action under the settings tab.
Setting Input Parameters
By clicking New under Input Parameters, you open the Edit Input Parameter dialog box, where you set the properties of your new input parameter:
When adding a new input parameter, you have the following options:
|Name||Sets the name of the input parameter.|
|Description||The description of your input parameter.|
|Datatype||The datatype of the parameter.|
|Required/Optional||Sets if the parameter is required or can be left open.|
|Show as Password||Sets if the parameter is readable in cleartext or hidden.|
|Type||Sets if the parameter is used as an input for a Selenium or internal function (should normally be Default).|
When creating a new input parameter, you can choose the datatype enumeration. An enumeration is a predefined list of values. When using an enumeration, as an input parameter you can choose which value of the enumeration to use.
To create a new enumeration, choose Enumeration as the Datatype when creating a new input parameter and click New:
On the Edit Enumeration dialog box, you can add new Enumeration Entries to your enumeration.
Enumeration entries have two attributes:
- Caption – the name of the entry that is shown when selecting an entry
- Value – the actual value of the entry that is used in the test execution
Setting an Output Parameter
Setting an output parameter, works in a similar way to setting an input parameter. The difference is that you can only have one output parameter per action. To set an output parameter, click Set under Output Parameter.
For an output parameter you can set the following:
|Name||The name of the output parameter.|
|Description||The description of the output parameter.|
|Datatype||The datatype of the output parameter.|
|Required/Optional||Sets if the parameter is required to be set.|
After an output parameter has been set, this parameter needs to be returned manually by using the Set Return Value action.
To return a value from an action, you need use the Set Return Value in a test step.