SimpleCustomFieldChange Element

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 custom field to change with a status update and contains the new value for that field.

<SimpleCustomFieldChange
  CustomFieldType="Text"
  CustomFieldGuid=" Text"
  CustomFieldName="Text"
  ChangeNumber="Integer" >
        UpdateValue
</SimpleCustomFieldChange>

Attributes

Attribute

Description

CustomFieldType

Required Text. Specifies the type of the custom field. Following are the possible custom field types.

  • Cost

  • Date

  • StartDate

  • FinishDate

  • Duration

  • Flag

  • None (no custom field)

  • Number

  • Text

  • OutlineCode

CustomFieldGuid

Required Text. Specifies the globally unique identifier (GUID) of the assignment custom field. Values must be in the form "HHHHHHHH-HHHH-HHHH-HHHH-HHHHHHHHHHHH" where "H" represents a hexadecimal digit between "0" and "F".

CustomFieldName

Required Text. Specifies the name of the custom field.

ChangeNumber

Optional Integer. Used to track changes. The value is -1 if custom field type 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 custom field to.

Note

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

Remarks

The assignment custom field GUID is defined in the MD_PROP_UID_SECONDARY field of the MS_CUSTOM_FIELDS table.

Note

The GUID in the MD_PROP_UID field of the MS_CUSTOM_FIELDS table specifies the task custom field GUID, which is shared across all assignments for that task. Using the GUID from the MD_PROP_UID field will result in ChangeXML that returns a StatusingSetDataValueInvalid error.

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

Example

The following example uses the SimpleCustomFieldChange element to update the assignment custom field named Team Name to the value My Team, where changes are not tracked.

<Changes>
  <Proj ID="a47faeab-0f72-455a-b629-d62faf5fece6">
    <Assn ID="6c9888a8-a782-47ac-a905-e84ad1fe0fb2">
      <SimpleCustomFieldChange CustomFieldType="Text" CustomFieldGuid="0000d9e8-4fe4-4af5-bdd1-f9e262061f2b" CustomFieldName="Team Name">My Team</SimpleCustomFieldChange>
    </Assn>
  </Proj>
</Changes>