Service Now: Requested Items

Summary

This module contains actions related to ServiceNow Requested Items.

Actions

service_now.requested_items.

get_by_number

Get a requested item by its number.

Minimum Plugin Version: 4.0.0

Input

• access_details: an AccessDetails Dictionary

• number: the requested item number to search for

Output

A single RequestedItem Dictionary.

Requested Item Numbers

ServiceNow requested item numbers are not unique by default, but for simplicity this action assumes they are.

If you do have shared requested item numbers, you can use the search action to get multiples.

Example

- service_now.requested_items.get_by_number:
    number: TEST-REQUESTED-ITEM
  load:
    access_details: service_now_api_info
  save: test_requested_item

service_now.requested_items.

get_by_number_interactive

Interactively search for a requested item using the number field.

Minimum Plugin Version: 4.0.0

Input

• access_details: an AccessDetails Dictionary

Output

A RequestedItem Dictionary.

Example

- service_now.requested_items.get_by_number_interactive:
  load:
    access_details: service_now_api_info
  save: requested_item

service_now.requested_items.

search

Search for requested items. 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: 4.0.0

Input

• access_details: an AccessDetails Dictionary

• search_params: a dictionary containing Requested Item fields and values

Output

A list of RequestedItem Dictionaries.

Example

Searching for all active requested items.

- service_now.requested_items.search:
    active: true
  load:
    access_details: service_now_api_info
  save: active_requested_items

service_now.requested_items.

update

Update a requested item using one or more sets of fields & values.

Minimum Plugin Version: 4.0.0

Input

• access_details: an AccessDetails Dictionary

• sys_id: the sys_id of the requested item to update

• update_data: a dictionary containing Requested Item Dictionary fields and values

Output

The updated requested item as a RequestedItem Dictionary.

Example

Resolving requested item TEST-REQUESTED-ITEM with a comment and note.

- service_now.requested_items.update:
    number: TEST-REQUESTED-ITEM
    state: 6
    close_notes: Resolved via PPA
    comments: Resolving a requested item from a PPA task
  load:
    access_details: service_now_api_info
    sys_id: requested_item.sys_id
  save: resolved_requested_item