@itentialopensource/servicenow-create-change-request

ServiceNow Create Change Request

Table of Contents

• Overview
  • Operations Manager and JSON-Form
  • Main Workflow
  • Error Handling
• Installation Prerequisites
• Requirements
• Features
• How to Install
• How to Run
  • Input variables
• Additional Information

Overview

This pre-built integrates with the ServiceNow Open Source Adapter to create a Change Request in the change_request table in ServiceNow.

Operations Manager and JSON-Form

This workflow has an Operations Manager Item that calls a workflow. The Ops Manager Item uses a JSON-Form to specify common fields populated when a Change Request is created. The workflow the Ops Manager Item calls queries data from the formData job variable.

Main Workflow

The main workflow in this pre-built is the ServiceNow Create Change workflow, which takes in several input variables required to create a change.

Estimated Run Time: 30 seconds

Error Handling

If any task in the workflow fails to perform its expected function, the taskError job variable will hold the error message. If you are using any workflow in this pre-built as a childJob, you can use the eval task in Workflow Engine to check if the value of taskError is empty. If it is not empty, then the ServiceNow change that was created encountered an error.

Installation Prerequisites

Users must satisfy the following pre-requisites:

• Itential Automation Platform
  • ^2021.2
• ServiceNow Open Source Adapter
  • ^2.2.0

Requirements

This pre-built requires the following:

• A ServiceNow Open Source Adapter.
• A ServiceNow account that has write access to the change_request table.

Features

The main benefits and features of the pre-built are outlined below.

• Provide the fields required to create a ServiceNow Change.
• Query the Change Number after the Change is created.

How to Install

To install the pre-built:

• Verify you are running a supported version of the Itential Automation Platform (IAP) as listed above in the Requirements section in order to install the pre-built.
• The pre-built can be installed from within Pre-builts catalog. Simply search for the name of your desired pre-built and click the install button.

How to Run

Use the following to run the pre-built:

• Run the Operations Manager Item ServiceNow Create Change Request or call ServiceNow Create Change from your workflow as a childJob.

Input Variables

Example

  {
    "short_description": "a short description",
    "description": "a longer description \n can be multiline",
    "start_date": "2099-04-29 13:05:12",
    "end_date": "2099-04-30 13:05:12",
    "assigned_to": "Ldap Username",
    "cmdb_ci": "ci name",
    "implementation_plan": "plan \n can be multiline",
    "test_plan": "plan \n can be multiline",
    "backout_plan": "plan \n can be multiline",
  }

##Additional Information

Please use your Itential Customer Success account if you need support when using this pre-built.