Create a test set release gate action

You can create a test set release gate action at any stage in a lifecycle.

To create a test set release gate action:

1. Navigate to Release Automation > Release Pipeline.
2. Select the design type (topology or sequenced) from the drop-down list in the left pane. (Topology Designs is selected by default).
3. Select the application and the version for which you want to create a test set release gate action.
4. Click the gear icon next to the stage where you want to create the test set action and click Configure Gate Actions.
5. Click Add Action > Execute Test Set to create a test set action.

6. In the Execute Test Set dialog box, in General tab, fill in the following fields:

   Field	Description
   Display Name	Name of the test set action
   Description	Description of the test set action
   Select Deployment	Select the deploy action that you need to associate with the test set action. All the deploy actions that have been created for the selected package are displayed. If you do not select a deploy action here, then you will be able to map a constant value or a context property in the Parameters tab. Whereas if you select a deploy action, you will have an additional option to map a component property.

   In the Success and Failure Configuration area, select the check boxes as applicable:

   Check box	Description
   Notify on Success	Select this check box for a notification message to be sent if the test set action executes successfully. The notification message is sent to the user who initiated the promotion request.
   Notify on Failure	Select this check box to receive a notification email if the test set action fails to execute successfully. The notification message is sent to the user who initiated the promotion request.
   Reject on Failure (Blocking)	Select this check box to reject the package if the test set action fails to execute successfully.
   Ignore on Failure	Select the check box to mark the specified action optional (non-blocking). The execution will move to the next release gate action even if the action fails to execute successfully.

   You can select more than one check box. However, for the Reject on Failure and the Ignore on Failure options, you can select only one of them at the same time.

7. Click Next.

   1. In the Execute Test Set dialog box, select the ALM provider instance.

      If only one ALM provider instance is configured in Codar, then it is loaded by default. Whereas, if more than one ALM provider instances are configured, you need to select one. Codar lists the test sets available in the selected ALM provider instance.

      Note You can create test set action only if you have an ALM provider instance with right configurations.

      In the list, you will find all types of test sets, i.e., Performance, Default and Functional test sets that are available in the selected ALM provider instance. However, test set action execution is supported only for Functional test sets. So, while creating a test set action, you must select functional test sets only.

   2. At this point, you can decide whether to proceed by associating an AUT environment with the test set action, or not.
      
      To map an AUT environment with this test set action, check Selected Test Set requires AUT Environment parameters check-box. Click Next button. You are navigated to the next step where you can select the AUT Environment.
      
      In order to proceed without mapping an AUT environment, uncheck Selected Test Set requires AUT Environment parameters check-box. You can skip AUT Environment selection step and directly click Add Action button to add the test set action.
8. Click Next.
9. The Parameters dialog box displays the list of input parameters present in the environment. You need to map these parameters to the context property or constant value present in the design. To map the parameters:
   1. Select the gear icon next to the parameter you want to map to and click Edit.

   2. In the Edit Parameter Mapping dialog box, fill in the following fields:

      Field	Description
      Display Name	Name of the parameter. You can change the default name to a name of your choice.
      Description	Description of the parameter
      Mapping Type	Object that you want to map the parameter to. You can either map the parameter to a component property, context property or constant value. If you select Context Property as the Mapping Type, you must select any of the following Context properties from the Value field. If you select Constant Value as the Mapping Type, you ,must provide a constant value in the Value field. If you have selected a deploy action in the General tab, then you can also select mapping type Component Property. If you select Component Property, then you must also select the components and the component property. If a deploy action is not associated with this test set action, then you can map a either a constant value or a context property only. Whereas if a deploy action is associated with it, then you will have an additional option to map a component property. Select 'Release Gate Action' to map the output parameters of one release gate action as input parameters to the next release gate action. Note: The release gate action being mapped to another release gate action must be such that it generates output parameters upon successful execution.
      Components	Displayed only if you selected Component Property or Package Property in the Mapping Type field. Select the component that you want to map the parameter to. All the components that are displayed are a part of the Codar design.
      Component Property	Displayed only if you selected Component Property or Package Property in the Mapping Type field. Select the component property for the component you selected. This is a dynamic list whose values change depending on the component you selected. The value of the property is obtained from the deployed instance selected for this test set action. This option only lists concrete components for partial designs. Note For Mapping Type as 'Package Property', the system picks up the updated value of a package property for the selected Component.
      Gate Actions	Displayed only if you selected Release Gate Actions in the Mapping Type field. Select the gate action you want to map to this gate action.
      Gate Action Properties	Displayed only if you selected Release Gate Actions in the Mapping Type field. Select the gate action property to be mapped to this gate action.

      Mapping of parameters marked with an asterisk is mandatory. If you do not map such parameters, an error message is displayed when you try to add a test set action.
      

   You can also unmap a parameter that is already mapped to a component. To unmap a parameter from a component, select the gear icon next to the parameter and click Unmap.

   1. Click Save.
10. Click Add Action.

The action that you added is listed in the 'Configure Gate Actions for <lifecycle stage> ' dialog box.