Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

Version 1 Next »

5.4.0

A pass-through API to ServiceScheduling (when configured) which allows the ServiceScheduling's "Update Job Start Time" API to be called.

Description

Subject to the rules for the options, changes to the job’s start time, arrival time and finish time, as well as any changes to its dispatch status, will be dispatched and, if the job is in jeopardy, the jeopardy conditions will appear on the Gantt jeopardy report in the normal way. For example: if a job is earmarked, its start time is changed by JobChangeStartTimeRequest (with SP_OptJobSetStatusBack set) so that it then falls outside the inform lead time, the job will subsequently be unearmarked. Alternatively, if a job’s completion time is made later in time and if it then overlaps another job, this will be reported as being in jeopardy.

Changes to the job’s start time, arrival time and finish time, as well as any changes to its dispatch status will subsequently become visible on the Gantt chart.

In this context, the ServiceScheduling "Update Job Start Time" API is the sp:JobChangeStartTimeRequest API.

On this page:

Related pages:

Resource URL Summary

Pass Through Call to ServiceScheduling's "Update Job Start Time" API

PUT /up/v5/rest/scheduling/ChangeJobStartTime

HTTP Headers

This API uses the standard ServiceBroker HTTP Headers.

API Specifics

Pass Through Call to ServiceScheduling's "Update Job Start Time" API

This RESTified API will perform a pass-through call to the ServiceScheduling sub-system's "Update Job Start Time" API (when configured).

URL

PUT /up/v5/rest/scheduling/ChangeJobStartTime

HTTP Request Body

This request requires a JSON object supplied in the HTTP request body, which defines the parameters that will be passed through to the ServiceScheduling "Update Job Start Time" APi.

UpdateJobStartTime Object Format

UpdateJobStartTime JSON 
{
    "Id": "JobId",
    "ChangeTime": "DateTime",
    "Options": {
        "SetStatusBack": false
    }
}

UpdateJobStartTime Object Properties

PropertyTypeLengthDescriptionReq?
Id

string

SS: JobID (string)

SS: 50 

Pass through parameter to the ServiceScheduling "Update Job Start Time" API. 

The identifier of the job to be updated. The error SP_JOBID_INVALID (1) will be returned if the supplied JobID does not exist in the ServicePower database.

SS Field: jobID

Yes

ChangeTime

string

SS: spDateTime (string)

SS: 16

Pass through parameter to the ServiceScheduling "Update Job Start Time" API. 

The job's new start date-time.

SS Field: startTime

Yes

Optionsobject

Pass through parameter to the ServiceScheduling "Update Job Start Time" API. 

PropertyTypeDescriptionReq?
setStatusBackBooleanSS Field: options.setStatusBackNo
fixJobBoolean

If FixJob is set the job is marked as Fixed. If, also, the job’s status is (now) Tentative, then it is positioned exactly at the times specified.

If FixJob is not set, the job’s new Start/Arrival/Finish time will determine the sequence position

No
allowSpanDaysBooleanIf the new position of the job would span a day, the call will fail and return SP_WOULD_SPAN_DAYS (374), unless AllowSpanDays is setNo

No

HTTP Response

Success

On success, a JSON-formatted version of the ServiceScheduling "Update Job Start Time" API response will be returned.

{
	"Success": true,
	"Code": "0",
	"Message": "",
	"Payload": {
    	"result": {
      		"type": "OK",
      		"code": "0"
    	}
  	}
}

Error

On error, a JSON-formatted version of the ServiceScheduling "Update Job Start Time" API response will be returned.

{
    "Success": false,
    "Code": 9,
    "Payload": {
        "returnCode": {
            "type": "Error",
            "code": "SCH Error Code"
        }
    }
}

Return Codes

In addition to the Standard Return Codes, the possible Return Codes from this API are:

 Click here to expand...
  • SP_OK (0)
  • SP_JOBID_INVALID (1)
  • SP_DURATION_INVALID (12)
  • SP_END_NOT_GT_START_TIME (31)
  • SP_OUTSIDE_HORIZON (53)
  • SP_OPTIONS_INVALID (80)
  • SP_UNRESOURCED_JOB (148)
  • SP_OUTSIDE_FRU_POSTING (264)
  • SP_OK_WITH_OVERLAPS (373)
  • SP_WOULD_SPAN_DAYS (374)
  • SP_DST_TIME_INVALID (379)
  • SP_START_MOVED_TOO_FAR (386)
  • SP_ARRIVES_ON_ANOTHER_DAY (387)
  • SP_JOB_TOO_LONG (388)
  • SP_DATETIME_INVALID (538)

Note:

SP_DURATION_INVALID (12) is returned if the job’s new Finish time would be the same as or before its Arrival time.

SP_END_NOT_GT_START_TIME (31) is returned if:

    • the job’s Arrival time would be earlier than its Start time, or
    • the job’s Finish time would be earlier than its Start time
  • No labels