Introduction to the SetAssignmentWorkData Schema
This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
The SetAssignmentWorkData Schema defines the XML elements used to construct a work status ChangeXML string. A work status ChangeXML string defines the fields to update in a work data statusing call, and specifies the new values for those fields.
SetAssignmentWorkData ChangeXML is used to make programmatic updates to assignment work data without requiring that the project be checked out. You can use a single ChangeXML string to define updates to multiple projects. For each project, you can specify one or more assignments to update.
Creating Work Status ChangeXML
You can write work status ChangeXML strings manually or programmatically. For an example of constructing a work status ChangeXML string programmatically, see SetAssignmentWorkData.
Updatable Fields
Work status ChangeXML can update specific assignment work data and related assignment fields by using a ChangeXML string. You can make both simple and timephased updates, however, not all fields are supported for both types of update.
You can perform more complex XML-based statusing updates by using the UpdateStatus method. For more information, see the ChangeList Schema Reference and the UpdateStatus method.
Table 1 lists the assignment fields that you can update with work data ChangeXML, as well as the data types and valid update types for those fields.
Table 1. Assignment fields to update with work data ChangeXML
Field Type |
Data Type |
Valid Change Type |
|---|---|---|
Actual Work |
Project work time unit (PWU). 1 PWU=1/1000 of a minute. 480,000 PWU=8 hours. |
Simple, Timephased |
Assignment-level value for the Health enterprise custom field |
Lookup table value GUID |
Simple, Timephased |
Comments |
String |
Simple, Timephased |
Overtime Work |
Project work time unit |
Timephased |
Remaining Work |
Project work time unit |
Simple, Timephased |
Total Work |
Project work time unit |
Simple |
Using Work Status ChangeXML
You pass the work status ChangeXML string to the SetAssignmentWorkData method as a parameter.
When capturing events, work status ChangeXML is provided by the following classes: