A resource action is an XaaS workflow that service catalog users can run on provisioned catalog items. As an XaaS architect, you can create resource actions to define the operations that consumers can perform on the provisioned items.

About this task

By creating a resource action, you associate a vRealize Orchestrator workflow as a post-provisioning operation. During this process, you can edit the default submission and read-only forms. See Designing a Resource Action Form.

Prerequisites

  • Log in to the vRealize Automation console as an XaaS architect.

  • Create a custom resource corresponding to the input parameter of the resource action.

Procedure

  1. Select Design > XaaS > Resource Actions.
  2. Click the New icon (Add).
  3. Navigate through the vRealize Orchestrator workflow library and select a workflow.

    You can see the name and description of the selected workflow, and the input and output parameters as they are defined in vRealize Orchestrator.

  4. Click Next.
  5. Select the custom resource that you previously created from the Resource type drop-down menu.
  6. Select the input parameter for the resource action from the Input parameter drop-down menu.
  7. Click Next.
  8. Enter a name and, optionally, a description.

    The Name and Description text boxes are prepopulated with the name and description of the workflow as they are defined in vRealize Orchestrator.

  9. (Optional) : If you do not want to prompt consumers to enter a description and reason for requesting this resource action, select the Hide catalog request information page check box.
  10. Enter a version.

    The version supports integers only. The supported format extends to major.minor.micro-revision.

  11. (Optional) : Select the type of the action.

    Option

    Description

    Disposal

    The input parameter of the resource action workflow is disposed and the item is removed from the Items tab. For example, the resource action is for deleting a provisioned machine.

    Provisioning

    The resource action is for provisioning. For example, the resource action is for copying a catalog item.

    From the drop-down menu, select an output parameter. You can select a custom resource that you previously created so that when the consumers request this resource action, the provisioned items are added on the Items tab. If you have only the No provisioning option, either the resource action is not for provisioning, or you did not create a proper custom resource for the output parameter, and you cannot proceed.

    Depending on the action workflow, you can select one, both, or none of the options.

  12. Select the conditions under which the resource action is available to users, and click Next.
  13. (Optional) : Edit the form of the resource action on the Form tab.

    The form of the resource action maps the vRealize Orchestrator workflow presentation. You can change the form by deleting, editing, and rearranging the elements. You can also add a new form and form pages and drag the necessary elements to the new form and form page.

    Option

    Action

    Add a form

    Click the New Form icon (Add a new element) next to the form name, provide the required information, and click Submit.

    Edit a form

    Click the Edit icon (Edit a field or a text box in a form page) next to the form name, make the necessary changes, and click Submit.

    Regenerate the workflow presentation

    Click the Rebuild icon (Regenerate a workflow) next to the form name and click OK.

    Delete a form

    Click the Delete icon (Delete a field or a text box from the form page) next to the form name, and in the confirmation dialog box click OK.

    Add a form page

    Click the New Page icon (Add a new element) next to the form page name, provide the required information, and click Submit.

    Edit a form page

    Click the Edit icon (Edit a field or a text box in a form page) next to the form page name, make the necessary changes, and click Submit.

    Delete a form page

    Click the Delete icon (Delete a field or a text box from the form page) next to the form name, and in the confirmation dialog box click OK.

    Add an element to the form page

    Drag an element from the New Fields pane on the left to the pane on the right. You can then provide the required information and click Submit.

    Edit an element

    Click the Edit icon (Edit a field or a text box in a form page) next to the element to edit, make the necessary changes, and click Submit.

    Delete an element

    Click the Delete icon (Delete a field or a text box from the form page) next to the element to delete, and in the confirmation dialog box click OK.

  14. Click Finish.

Results

You created a resource action and you can see it listed on the Resource Actions page.

What to do next

Publish the resource action. See Publish a Resource Action.