14.1 Update Standard Activity SOAP API
- Billy Sewell (Unlicensed)
- Jason Andrew
The sp:ActUpdateRequest
API method can be used to update standard activities.
Description
The sp:ActUpdateRequest
allows standard activities to be updated.
Definition
The definition of this API is:
Web Service | Type | Description | Req? | Val? | ||
|
|
|
|
| ||
|
|
| is the unique identifier of the standard activity to be updated. This is the ID generated by ServiceOptimizer when it was created by a call to EmpAddActRequest and returned in Act.ActNo. | |||
|
|
| If the activity type field is to remain unchanged by this call, the value SP_IntNoUpdate should be supplied, or the field should not be supplied at all for web service. | |||
|
|
| If either of these fields is to remain unchanged, the value supplied should be SP_StrNoUpdate, or the field should not be supplied at all for web service. |
|
| |
|
|
| Act.ExpectedEnd is optional (to allow indefinite standard activities), i.e. it can be set to NULL by supplying an empty string (“”). |
|
| |
|
|
| is the new value of the activity’s location. If existing type is not set then an attempt to change this will result in return code SP_ACT_LOC_TYPE_INVALID (152). Similarly, if existing type is set and an attempt is made to change it to not set then this will result in the same return code. If Supplied is supplied, a valid postal code must be supplied in Act.EndPostcode (below). If the location of the activity is to remain unchanged the field should not be supplied at all. | M |
| |
|
|
| is ignored unless the supplied value of Act.EndLocType (above) is Supplied, in which case it’s the postal code of the activity’s new location |
| ||
|
|
| is the new value of the user annotation. If SP_StrNoUpdate is supplied (or the field should not be supplied at all for web service), then the existing Notes field remains unchanged. Supplying an empty string (“”) will effectively remove an existing Notes field. |
|
| |
|
|
| is ignored if neither expectedStart or expectedEnd is supplied. Defaults to Employee TZ if nothing specified. |
| ||
|
|
| SP_SA_DISPATCH_CANNOT_CHANGE (668)will be returned if set differently to existing value. |
|
| |
|
|
| SP_SA_TRAVELMODE_CANNOT_CHANGE (669)will be returned if set differently to existing value. |
|
| |
|
|
| The number of minutes the standard activity is expected to last. expectedEnd and expectedDuration cannot both be populated – if both are then SP_SA_CONFLICTING_END (665) will be returned. |
|
| |
|
|
| Please refer to section 4.2.4for defintions and settings values |
|
| |
|
|
|
|
|
| |
|
|
|
|
|
| |
|
|
|
|
|
| |
|
|
|
|
|
| |
|
|
|
|
|
| |
|
|
|
|
|
| |
|
|
|
|
|
| |
|
|
|
|
|
| |
|
|
|
|
|
Return Structure
The API returns the standard return structure.
Return Codes
In addition to the Standard Return Codes, the possible Return Codes from this API are:
SP_POSTCODE_INVALID (3)
SP_DURATION_INVALID (12)
SP_END_NOT_GT_START_TIME (31)
SP_OUTSIDE_HORIZON (53)
SP_START_TIME_INVALID (62)
SP_END_TIME_INVALID (63)
SP_OPTIONS_INVALID (80)
SP_NO_REG_TO_RU_MAPPING (115)
SP_ACTIVITY_TYPE_INVALID (120)
SP_ACTIVITY_NOTES_INVALID (123)
SP_ACTIVITY_NO_INVALID (131)
SP_OVERLAPPED_JOBS (132)
SP_ACT_LOC_TYPE_INVALID (152)
SP_OPTION_COMBINATION_INVALID (159)
SP_OVERLAPPED_STDACTS (160)
SP_POSTING_HAS_ENDDATE (285)
SP_SPANS_POSTINGS (286)
SP_WOULD_BREAK_ACCESS_HOURS (371)
SP_OK_WITH_OVERLAPS (373)
SP_DST_TIME_INVALID (379)
SP_FROZEN_DAY (585)
SP_OK_CAPACITY_EXCEEDED (640)
SP_SA_CONFLICTING_END (665)
SP_SA_DISPATCH_CANNOT_CHANGE (668)
SP_SA_TRAVELMODE_CANNOT_CHANGE (669)
SP_SA_DISPATCH_INVALID (670)
SP_SA_LOCATIONTYPE_MISSING_POSTCODE (673)