Supported Project Fields and Field Information for Statusing ChangeXML

Applies to: Office 2010 | Project 2010 | Project Server 2010 | SharePoint Server 2010

In this article
Assignment Fields
Task Fields
Data Types
Change Types

Updates using Statusing methods with the changeXml parameter are supported only for specific assignment and task fields. Use the following tables to identify the assignment and task fields that can be updated using a changeXml parameter. These tables also contain the process identifier (PID) values, required data types, and valid change types for the supported fields.

• Table 1 lists information for supported assignment fields.

• Table 2 lists information for supported task fields.

• Table 3 describles data type formats.

• Table 4 describes the supported change types and the XML elements used to define them.

Note

In the AssnConstID class and the TaskConstID class, you can use the fields that are not specified for internal use to help create a changeXml parameter.

Assignment Fields

Table 1 lists the assignment fields that you can update with the changeXml parameter, as well as the PID values, data types, and valid change types for those fields.

Field Type	Field Name	PID Value	Data Type	Valid Change Type
Actual Finish	s_apid_actfinish_date	251658257	DateTime	Change
Actual Overtime Work	s_apid_actualovt_work	251658251	Project work time unit	Change, Period Change
Actual Start	s_apid_actstart_date	251658256	DateTime	Change
Actual Work	s_apid_actual_work	251658250	Project work time unit	Change, Period Change
Assignment Units	s_apid_assn_units	251658275	Integer, ranging from 1 to 100	Note Project Server 2010 ignores the assignment units change.
Comments	s_apid_submit_note	251658287	String	Change
Confirmed	s_apid_is_confirmed	251658295	Boolean	Change
Finish	s_apid_finish_date	251658253	DateTime	Change
Overtime Work	s_apid_ovt_work	251658247	Project work time unit	Change
Percent Work Complete	s_apid_pct_wrk_complete	251658274	Integer, ranging from 1 to 100	Change
Regular Work	s_apid_regular_work	251658282	Project work time unit	Change
Remaining Overtime Work	s_apid_remainingovt_work	251658249	Project work time unit	Change
Remaining Work	s_apid_remaining_work	251658248	Project work time unit	Change
Start	s_apid_start_date	251658252	DateTime	Change
Work	s_apid_sched_work	251658246	Project work time unit	Change

Task Fields

Table 2 lists the task fields that you can update with the changeXml parameter, as well as the PID values, data types, and valid change types for those fields.

Field Type	Field Name	PID Value	Data Type	Valid Change Type
Actual Work	s_tpid_actual_work	184549384	Project work time unit	Change
Deadline	s_tpid_deadline	184549394	DateTime	Change
Duration	s_tpid_dur_total	184549405	Project duration time unit	Change
Finish	s_tpid_finish_date	184549387	DateTime	Change
Overtime Work	s_tpid_ovt_work	184549381	Project work time unit	Change
Percent Complete	s_tpid_pct_complete	184549410	Integer, ranging from 0 to 100	Change
Percent Work Complete	s_tpid_pct_wrk_complete	184549411	Integer, ranging from 0 to 100	Change
Physical Percent Complete	s_tpid_phy_pct_complete	184549412	Integer, ranging from 0 to 100	Change
Regular Work	s_tpid_regular_work	184549415	Project work time unit	Change
Remaining Duration	s_tpid_dur_remaining	184549407	Project duration time unit	Change
Remaining Overtime Work	s_tpid_remainingovt_work	184549383	Project work time unit	Change
Remaining Work	s_tpid_remaining_work	184549382	Project work time unit	Change
Resume	s_tpid_resume_date	184549389	DateTime	Change
Start	s_tpid_start_date	184549386	DateTime	Change
Task Name	s_tpid_name	184549403	String	Change
Work	s_tpid_sched_work	184549380	Project work time unit	Change

Data Types

Table 3 lists the data types used in changeXml strings and the required formats for those data types.

Data Type	Data Format
Boolean	String data. Valid values are True and False.
DateTime	Date and time data, provided in the format YYYY-MM-DDTHH:MM:SS.
Integer	Integer data. Valid ranges of integer values vary according to field type.
Project work time unit (PWU)	Work duration data, in PWU. 1 PWU=1/1000 of a minute. 480,000 PWU=8 hours.
Project duration time unit (PTU)	Duration data, in Project duration time units. 1 PTU = 1/10 of a minute. 4800 PTU=8 hours.
String	String data.

Change Types

Table 4 lists the change types used in changeXml parameters for Statusing methods and the XML elements used to define the update for each change type.

Change Type	XML Elements
Assignment or task field	<Change>…</Change>
Timephased assignment field	<PeriodChange>…</PeriodChange>
Assignment custom field	<SimpleCustomFieldChange>…</SimpleCustomFieldChange>
Assignment lookup table value	<LookupTableCustomFieldChange>    <LookupTableValue>…</LookupTableValue> </LookupTableCustomFieldChange>

See Also

Reference

UpdateStatus

Concepts

Introduction to the ChangeList Schema and Statusing ChangeXML