ServiceAssignment DTO v25

ServiceAssignment object which allows special assignments of person to a servicecall. This object is available for ressource planner only.

Field Name Type Required Constraint Reference Description
activity Identifier Optional Activity : 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25 Indicates which activity was generated out of this assignment.
businessProcessStepAssignments List<BusinessProcessStepAssignmentEmbeddedDTO_V25> Optional Inlined list of business process list assignments.
changelog String Optional length >= 1 Changelog contains information about every change made to the service call by different clients or the erp Example: [{ "usrname":"X/00004002", "date":"2012-01-20T13:49:37+01:00", "fld":"statusCode", "old":"0", "new":"-1" }, { "usrname":"X/00004002", "date":"2012-01-20T13:49:37+01:00", "fld":"statusName", "old":"Freigegeben", "new":"Closed" }]
code String Optional length >= 1 & length <= 255 System code of this object, normally this correlates to the erp id given by the source system.
confirmed Boolean Optional Is the service assignment in confirmed (by end user) state
endDateTime DateTime Optional Indicates if the end date time is fixed or can be changed.
endDateTimeFixed Boolean Optional Indicates if the end date time is fixed or can be changed.
object ObjectRef Optional Referenced objectId for this assignment, standard referencable objects are servicecalls. Type of the object specified in objectId, standard values are SERVICECALL.
objectGroup Identifier Optional ObjectGroup : 11, 12, 13, 14 Defines which persongroup this assignment belongs to (available technicians).
proposed Boolean Optional Is the service assignment in proposed state.
recurrencePattern String Optional length >= 1 & length <= 255
recurrencePatternLastChanged Long Optional The time-stamp of the latest change of the recurrence pattern field.
recurrenceSeriesId Identifier Optional GUID of the recurrence series the ServiceAssignment belongs to. It's just an identifier and not a reference to another object.
released Boolean Optional Is the service assignment in released state.
releasedDateTime DateTime Optional
remarks String Optional length >= 1 Remarks or notes related to this assignment, can be used for any string based content which contains necessary information.
sentToTechnicianDateTime DateTime Optional Indicates when the serviceassignment was sent to the technician the last time.
sourceActivity Identifier Optional Activity : 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25 Indicates activity to be used upon creating new activity for the given service assignment.
startDateTime DateTime Optional Start of the assignment.
startDateTimeFixed Boolean Optional Indicates if the start date time is fixed or can be changed.
state String Optional length >= 1 & length <= 255

Allowed values are defined into Enumerations having enumType = SERVICE_ASSIGNMENT_STATE.
For learning about Enumerations, please check this.
State of the Service Assignment
team Identifier Optional Team : 8, 9, 10
technician Identifier Optional Person : 15, 16, 17, 18, 19, 20 Defines which person this assignment belongs to (technician).
technicianFixed Boolean Optional Indicates if the assigned technician is fixed or can be changed.
travelTimeFromInMinutes Integer Optional Travel time (in minutes) from the customer site.
travelTimeToInMinutes Integer Optional Travel time (in minutes) to the customer site.
unit String Optional length >= 1 & length <= 255 All assignments with same value of this field belong to the same unit (group of assignments).