Creation

ChangeRequestHandler.create_change_request has the following parameters and return value:

Parameters

• title - The title of the change request

• description - The description of the change request

• assignment_group - The group to which the change request is to be assigned. This is optional if SNOW_ASSIGNMENT_GROUP django settings is available, else, it is mandatory

• payload (Optional) - The payload for creating the Change Request.

Returns

ChangeRequest model - The model created from the created Change Order.

Example

from django_snow.helpers import ChangeRequestHandler

def change_data(self):
    co_handler = ChangeRequestHandler()
    change_request = co_handler.create_change_request('Title', 'Description', 'assignment_group')

Updating

ChangeRequestHandler.update_change_request method signature:

Parameters

• change_request - The ChangeRequest Model

• payload - The payload to pass to the ServiceNow REST API.

Example

from django_snow.models import ChangeRequest
from django_snow.helpers import ChangeRequestHandler

def change_data(self):
    change_request = ChangeRequest.objects.filter(...)
    co_handler = ChangeRequestHandler()

    payload = {
                'description': 'updated description',
                'state': ChangeRequest.TICKET_STATE_IN_PROGRESS
              }

    co_handler.update_change_request(change_request, payload)

Closing

ChangeRequestHandler.close_change_request has the following signature:

Parameters

• change_request - The ChangeRequest Model representing the Change Order to be closed.

Example

from django_snow.models import ChangeRequest
from django_snow.helpers import ChangeRequestHandler

def change_data(self):
    change_request = ChangeRequest.objects.filter(...)
    co_handler = ChangeRequestHandler()

    co_handler.close_change_request(change_request)

Closing with error

ChangeRequestHandler.close_change_request_with_error method signature:

Parameters

• change_request - The ChangeRequest Model representing the Change Order to be closed with error

• payload - The payload to pass to the ServiceNow REST API.

Example

from django_snow.models import ChangeRequest
from django_snow.helpers import ChangeRequestHandler

def change_data(self):
    change_request = ChangeRequest.objects.filter(...)
    co_handler = ChangeRequestHandler()

    payload = {
                'description': 'updated description',
                'title': 'foo'
              }

    co_handler.close_change_request_with_error(change_request, payload)

ChangeRequest

The ChangeRequest model has the following attributes:

• sys_id - The sys_id of the Change Request.

• number - Change Request Number.

• title - The title of the Change Request a.k.a short_description.

• description - Description for the change request

• assignment_group_guid - The GUID of the group to which the Change Request is assigned to

• state - The State of the Change Request. Can be any one of the following ChangeRequest’s constants:

  • TICKET_STATE_OPEN - ‘1’

  • TICKET_STATE_IN_PROGRESS - ‘2’

  • TICKET_STATE_COMPLETE - ‘3’

  • TICKET_STATE_COMPLETE_WITH_ERRORS - ‘4’