Skip to main content

Create a URL action in Actions Menu

To create a URL Action in the Actions Menu, do the following:

  1. Within APEX AIOps Incident Management, navigate to Correlate & Automate > Actions Menu.

    You can also navigate to the Actions Menu from the Incidents view or the Alerts view by doing the following:

    1. From the Incidents or Alerts view, select an incident or an alert.

    2. Click the Actions button in the top left:

      1. If you are viewing incidents, select Incident Actions > Configure Actions.

      2. If you are viewing alerts, select Alert Actions > Configure Actions.

  2. Select Incident Actions or Alert Actions.

  3. Click Add Incident Action or Add Alert Action.

  4. Provide a unique name for the action. Optionally, provide a description.

  5. Under Actions, select URL Action.

  6. Fill out the Endpoint section:

    1. For Request Type, select either "POST" or "GET" depending on your business needs.

    2. For Response Display, select "Popup" to display the results of the request in the UI. Select "None" if you don't want to display anything.

    3. For URL, enter the URL against which the request will be made. Make sure the URL begins with http:// or https://.

    4. (Optional) For Base URL, click Add Base URL. Specify a URL to bypass Cross Origin Resource Sharing (CORS) restrictions, which occurs when a server cannot serve a request from another domain. Make sure the URL begins with http:// or https://.

    5. For Headers, click Add Header to include key value pairs of data that you wish to send in your HTTP request.

  7. Fill out the Payload Body section:

    1. If you have specified a request type of "POST" in the previous Endpoint section, enter the payload body that you wish to POST to your external system. For example:

      {
        "description": "${description}",
        "moogsoft_id": 11,
        "updateType": "create",
        "severity": "${severity}",
        "priority": "P3"
      }
      
  8. Configure Prompt Variables. Variables entered into the URL, header, or body of the Payload Body section will appear in the list as prompt variables. Create new variables using substitution syntax. For example: ${variable}.

    1. Select a prompt variable from the list to edit the following properties:

      • Display Name: The name of the variable that the user will be prompted to enter a value for.

      • Variable Type: Select "String," "Number," or "Selection List."

        Selecting "String" or "Number" will enable you to specify the following additional parameters:

        • Default Value: A default value to be utilized in the event that the user prompt receives no input.

        • Minimum and Maximum Length or Value: A minimum and maximum length of string input in the case of “String” variable type and a minimum and maximum value in the case of “Number” variable type.

        Selecting "Selection List" will allow you to to add predefined values for the user to select from. To add new values, click Add List Item and specify the following parameters:

        • List Item Type: The type of the list item. Select either "STRING" or "NUMBER."

        • List Item Value: The predefined value that you wish to offer to the user. Make sure that the value matches the corresponding "List Item Type."

    2. Click Confirm to save the prompt variable.

  9. Click Save at the top of the page to save your action.