Service Assignment DTO v24

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

Field Name Type Category Constraint Reference Description
activity Identifier Optional Activity : 13, 14, 15, 16, 17 Indicates which activity was generated out of this assignment.
businessProcessStepAssignments List<Business ProcessStep Assignment EmbeddedDTO_v24> Optional Inlined list of business process list assignments.
changelog String Optional length >= 1 & length <= 2147483647 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 <= 512 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 >= 0 & length <= 1024
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 & length <= 2147483647 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 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 >= 0 & 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
technician Identifier Optional Person : 15, 16, 17, 18, 19 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 >= 0 & length <= 255 All assignments with same value of this field belong to the same unit (group of assignments).

ServiceAssignmentDTO_v24.BusinessProcessStepAssignmentEmbeddedDTO_v24


Field Name Type Category Constraint Reference Description
completed boolean Required Indicates if this assignment is done, not done.
createDateTime DateTime Required TODO: only for backward comatibility. remove it after removing BusinessProcessStepAssignmentDTO_v8
id Identifier Required TODO: only for backward comatibility. remove it after removing BusinessProcessStepAssignmentDTO_v8
step Identifier Required BusinessProcessStepDefinition : 12, 13, 14, 15 BusinessProcessStepDefinition which this assignment relates to.