Tasks for manipulating ServiceNow records

1. Description
2. Setup - The basics of getting started with servicenow_tasks
3. Usage - Configuration options and additional functionality

servicenow_tasks provides a series of tasks to interact with a ServiceNow Instance. The 4 main tasks included with this module:

• create_record - Create a ServiceNow record
• get_record - Get a ServiceNow record(s)
• update_record - Update a ServiceNow record
• delete_record - Delete a ServiceNow record

These tasks have been tested with an Orlando developer instance.

The puppetlabs-ruby_task_helper module must be installed

Tasks can be executed via Bolt by supplying a basic inventory file. For example, if you're using Bolt 1.x, this would look something like:

nodes:
  - name: dev84270.service-now.com
    config:
      transport: remote
      remote:
        user: admin
        password: "XHxH2tmZ69*Vbh"
        oauth_token: vXpDyYklhkNxwQ5ktr7WmTinZwq4-g-RSXtCVA5Y6JDKWU8-OBC3GUHbQIcWZyp1z1dKHK4_3-O8NQTzkWVCJw

Bolt 1.x inventory entry

If you're using Bolt 2.x, then this would look something like:

targets:
  - uri: dev84270.service-now.com
    config:
      transport: remote
      remote:
        user: admin
        password: "XHxH2tmZ69*Vbh"
        oauth_token: vXpDyYklhkNxwQ5ktr7WmTinZwq4-g-RSXtCVA5Y6JDKWU8-OBC3GUHbQIcWZyp1z1dKHK4_3-O8NQTzkWVCJw

Bolt 2.x inventory entry

Tasks can also be executed via puppet by specifying user/password or oauth_token, and instance parameters. Credentials specified via parameters will take precedence over any in an inventory file.

OAuth authentication will be used over a user/password if an oauth token is provided in either the inventory file or passsed as a parameter.

To get a record from the incident table with sys_id = 3Db9b91557db00101096dde37a48961976

bolt task run --nodes dev84270.service-now.com servicenow_tasks::get_record table=incident sys_id=3Db9b91557db00101096dde37a48961976

or without an inventory file,

bolt task run --nodes dev84270.service-now.com servicenow_tasks::get_record user=my_username password=my_password instance=my_instance table=incident sys_id=3Db9b91557db00101096dde37a48961976

Further example usage is provided via bolt task show