Service Now: Users

Summary

This module contains actions related to ServiceNow System Users.

Actions

service_now.users.

by_sys_id

Get a user by sys_id.

Commonly used to resolve the opened_by, caller_id, & closed_by keys in:

• Incident Dictionaries
• RequestedItem Dictionaries

Minimum Plugin Version: 1.0.0

Input

• access_details: an AccessDetails Dictionary

• sys_id: the sys_id of the user

Output

A User Dictionary.

Example

- service_now.users.get_by_sys_id:
  load:
    access_details: service_now_api_info
    sys_id: incident.caller_id
  save: caller

service_now.users.

search

Search for users. Supports multiple search fields and values.

Advanced search techniques & filters are not supported yet.

Each supplied field & value will be converted to field=value in the search query.

Minimum Plugin Version: 2.0.0

Input

• access_details: an AccessDetails Dictionary

• search_params: a dictionary containing User fields and values

Output

A list of User Dictionaries.

Example

- service_now.users.search:
    user_name: John Smith
  load:
    access_details: service_now_api_info
  save: user