Share via

PeriodChange Element

  • Article

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

In this article
Attributes
Child Elements
Parent Elements
Occurrences
Text Value

Specifies the field to change with a timephased status update and contains the new value for that field.

<PeriodChange
  PID="Integer"
  Start="dateTime"
  End="dateTime" 
  ChangeNumber=="Integer" >
    UpdateValue
</PeriodChange>

Attributes

Attribute

Description

PID

Required Integer. Specifies the Project identifier (PID) of the field to change.

Start

Required dateTime. The value for the beginning of the timephased period.

End

Required dateTime. The value for the end of the timephased period.

ChangeNumber

Optional Integer. Used to track changes. The value is -1 if period changes are not tracked.

Child Elements

None

Parent Elements

Assn

Occurrences

Minimum: 0

Maximum: Unbounded

Text Value

A text value is required. This text specifies the value to update the field to.

Note

The text value must match the data type required by the specified field.

Remarks

For information about updatable assignment fields, PIDs, and required data types, see Supported Project Fields and Field Information for Statusing ChangeXML.

Example

The following example specifies multiple timephased status updates for a single assignment, where changes are not tracked. Three PeriodChange elements specify timephased updates to the Actual Work field. These updates use Project Time Unit values to add 4, 2, and 6 hours of actual work to the assignment with the times specified by the Start and End attributes of the PeriodChange elements.

<Changes>
  <Proj ID="a47faeab-0f72-455a-b629-d62faf5fece6">
    <Assn ID="6c9888a8-a782-47ac-a905-e84ad1fe0fb2">
      <PeriodChange PID="251658250" Start="2006-10-27T08:00:10" End="2006-10-27T12:00:10">240000</PeriodChange>
      <PeriodChange PID="251658250" Start="2006-10-28T08:00:10" End="2006-10-28T10:00:10">120000</PeriodChange>
      <PeriodChange PID="251658250" Start="2006-10-29T08:00:10" End="2006-10-29T14:00:10">360000</PeriodChange>
    </Assn>
  </Proj>
</Changes>