Request a catalog item

Request a ServiceNow catalog item using OneFuse

2 minute read

Prerequisites

Create a ServiceNow Catalog Item Policy.
A ServiceNow Admin has configured the associated ServiceNow Catalog Item for their ServiceNow end-users.

Execute OneFuse ServiceNow Connector via ServiceNow

Log in to ServiceNow.
Find the Service Catalog created via the OneFuse ServiceNow Catalog Item Policy.
Select the Service Catalog to request it.
Fill out the Service Catalog Inputs, if any.
Select Order Now.
Select the Request Number to track the status.
Once the request succeeds, track the deployment in ServiceNow.

The Service Catalog will request the ServiceNow Flow: Execute OneFuse Connector Policy Wrapper, which calls Subflow: Execute OneFuse Connector Policy.

The flow will mark the request as Closed Complete if it was successful and Closed Incomplete if it failed.

Accessible properties after ordering the ServiceNow Catalog

The following example shows properties that are automatically calculated and generated to be accessible in OneFuse Child Policies and in Upstream Providers.

"oneFuse": {
  "serviceNow": {
    "instance": {
      "name": "<servicenow-instance-name>",
      "url": "<servicenow-instance-url>",
      "release": "<servicenow-instance-release-name>",
      "version": "<servicenow-instance-version>",
      "fullVersion": "<servicenow-instance-full-version>",
      "buildTag": "<servicenow-instance-build-tag>",
      "userName": "<servicenow-instance-onefuse-service-account-username>",
      "userId": "<servicenow-instance-onefuse-service-account-user-id>"
    },
    "connector": {
      "version": "<onefuse-servicenow-connector-version-number>",
      "requestNumber": "<servicenow-connector-catalog-item-requestNumber>",
      "requestId": "<servicenow-connector-catalog-item-requestId>",
      "catalogItemName": "<servicenow-connector-catalog-item-name>",
      "catalogItemId": "<servicenow-connector-catalog-item-id>",
      "configurationItemId": "<servicenow-connector-configuration-item-id>",
      "inputs": {
          <inputs to OneFuse Child Policy>
      }
    }
  }
}

{# Example #}
{{ oneFuse.serviceNow.connector.requestNumber }}
=> REQ0010145

Next steps

Now that you have executed a ServiceNow Catalog Item Policy, track ServiceNow Connector deployments.