Catalog item policies

Create and manage ServiceNow Catalog Item policies in OneFuse

3 minute read

Prerequisites

Create a Module Credential using a ServiceNow user that has the role x_sovla_onefuse.admin.
Create a ServiceNow Endpoint. If applicable, configure ServiceNow proxy support.
OneFuse policies: when using the OneFuse Aria Automation Module, it is recommended that the Aria Automation 8 Policy executes successfully with the ServiceNow CMDB policy attached to the vRA Cloud Template.

Create a ServiceNow Catalog Item Policy

In OneFuse, select ServiceNow Connector from Home, or select Modules > ServiceNow Connector from the left navigation menu.
Find the ServiceNow Catalog Item Policies table.
Select Create.
Fill out the ServiceNow Catalog Item Policy form.

Update a ServiceNow Catalog Item Policy

Note the following limitations when updating a policy:

Updating the ServiceNow Catalog Item Policy name will not change the name of the correlated ServiceNow Catalog Item.
The OneFuse Module type cannot be changed.
ServiceNow Catalog Item Inputs must be managed in ServiceNow.

Links are displayed in Update/View mode of the form to Edit the Catalog Item and View the Order Form in ServiceNow.

In OneFuse, select ServiceNow Connector from Home, or select Modules > ServiceNow Connector from the left navigation menu.
Find the policy to update and select the edit button.
Edit the information on the ServiceNow Catalog Item Policy form.
Select Update.

Delete a ServiceNow Catalog Item Policy

Deleting a ServiceNow Catalog Item Policy will only occur when there are no associated OneFuse ServiceNow Connector Deployments for the policy.

In OneFuse, select ServiceNow Connector from Home, or select Modules > ServiceNow Connector from the left navigation menu.
Find the policy and select the delete button.
Select Delete to confirm.

ServiceNow Catalog Item Policy form fields

General

Field	Description
ServiceNow Catalog Item Policy Name	Required. Enter a name for the ServiceNow Catalog Item Policy.
Description	Optional description for the ServiceNow Catalog Item Policy.
ServiceNow Endpoint	Required. Select the ServiceNow Endpoint for this policy. Begin typing to filter.

Child Policy

Field	Description
Module Type	Select the OneFuse Module Type that this ServiceNow Catalog Item request will invoke.
Child Policy	Select the OneFuse Policy for the Module Type.
Child Policy Template	Required. Enter the Child Policy Template that will be invoked when the policy is executed. See samples below. Templated variables in the Child Policy Template are auto-generated into the Input(s) table.

Sample template for OneFuse Aria Automation Module:

// Example with a OneFuse vRealize Automation Module Policy
{
  "deploymentName": "{{deploymentName}}",
  "templateProperties": {
    "deploymentOwner": "{{deploymentOwner}}"
  }
}

Sample template for OneFuse Ansible Tower Module:

The following logic is required for hosts to parse the field value type correctly.

{%- set hostslist=[] -%}
{%- for hostkey in hosts.replace(' ', '').split(',') -%}
{%- if hostkey -%}{{ hostslist.append(hostkey) or '' }}{%- endif -%}
{%- endfor -%}
{
  "limit": "{{limit}}",
  "hosts": {{hostslist|tojson}},
  "templateProperties": {}
}

ServiceNow Catalog Item

Field	Description
ServiceNow Catalog Name	Select the desired ServiceNow Catalog by name for this Catalog Item.
ServiceNow Category Name	Select the desired ServiceNow Category by name for this Catalog Item.
Input(s)	Enter at least one input for this policy. Inputs are automatically pre-populated with any templated field defined in the Child Policy Template, and are passed to the Child Policy Template on execution. Multiple ServiceNow Catalog Items can reference the same policy; inputs are mapped to ServiceNow Catalog Item inputs at the Catalog Item level. Fields: Name: alphanumeric and underscores only; Label: editable friendly label; Required: whether a value must be provided during execution.

To add new inputs, add the templated variable to the Child Policy Template and select Sync on the Input(s) table.

The Sync action is destructive and will reset inputs to match the variables defined in the Child Policy Template.

Next steps

Now that you have created a ServiceNow Catalog Item Policy, request a Catalog Item in ServiceNow.