SimpleCustomFieldChange Element

Статья
05/05/2014

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.

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">
        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.

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.

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.

<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>

Поделиться через