SNOW JSON API access
This module provides Python libraries and scripts to interact with Service Now. This was designed to work with a specific instance of SNOW (FNAL), but these scripts and libraries will probably work with other sites, so it's worth sharing.
Create: snow-incident-create, snow-ritm-create
Create Incidents and Requests/Requested Items, respectfully. These work directly with the REST API.
Read: snow-incident-list, snow-ritm-list, snow-tkt, snow-tkt-list
Scripts to search and list Incident and Requested Items, respectfully. snow-tkt-list calls both.
snow-tkt takes a ticket name and prints information about that ticket on STDOUT.
Update: many scripts
Most of these do what they say on the tin:
- snow-tkt-assign - assign a ticket to a user and/or group
- snow-tkt-journal - record a journal entry or comment to a ticket
- snow-tkt-pending - set a ticket to status pending (mostly for RITMs)
- snow-tkt-resolve - resolve a ticket
- snow-tkt-unassign - assign a ticket back to the Help Desk
Delete: No Such Thing
Data doesn't generally get removed from SNOW, at least not by users.
Creates and caches the connections to SNOW; caches searches; provides the
CRUD interface that the various scripts depend on; provides tools for
user/group searches; abstracts out the various ticket types (Incidents,
Requests, Tasks, Requested Items, etc); and works with a central
configuration file (
/etc/snow/config.yaml) so that we can abstract
server/authentication data away from the user.
This mostly provides template functions for the various
Incident): printing functions, mapping some functions
to field names, etc.
pyfnalsnow.Incident, pyfnalsnow.Request, pyfnalsnow.RITM
Functions that must be customized per-table are stored here; for instance, RITMs must change state several times to get to a pending or resolved state.
This script requires pysnow. I would probably just update it directly except that I don't know for sure what changes we have made locally that don't apply to the "default" instance.
To make this work on RHEL6 and a modern
pysnow you probably want to
install oauthlib 2.0.7:
pip install oauthlib==2.0.7.
/etc/snow/config.yaml looks something like:
servicenow: username: '(USERNAME)' url: 'https://(SITENAME).service-now.com/' password: '(PASSWORD)' instance: '(INSTANCE)' ritm_template: priority: '3' u_categorization: 'Hardware -- Worker Node -- No Item Available' urgency: '3'
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size pyfnalsnow-1.3.1-py3-none-any.whl (13.2 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size pyfnalsnow-1.3.1.tar.gz (10.8 kB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for pyfnalsnow-1.3.1-py3-none-any.whl