LookupTableCustomFieldChange Element

  • Article

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 lookup table custom field to change with a status update and contains change information.

<LookupTableCustomFieldChange
  CustomFieldType = "Text"
  CustomFieldGuid = "Text"
  CustomFieldName = "Text"
  IsMultiValued = "True" | "False">
</LookupTableCustomFieldChange>

Attributes

Attribute

Description

CustomFieldType

Required Text. Specifies the type of custom field to change. 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 to change. 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 to change.

IsMultiValued

Required Boolean. Specifies whether the lookup table is multivalued.

Child Elements

LookupTableValue

Parent Elements

Assn

Occurrences

Minimum: 0

Maximum: Unbounded

Remarks

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

NoteNote

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.

Example

The following example uses the LookupTableCustomFieldChange element to update the value for the Health lookup table custom field to the value Blocked.

<Changes>
  <Proj ID="3f8568c2-66ed-46b8-93ba-cf104c734cef">
    <Assn ID="352eb69a-a915-4849-b9f0-3d26d0d6e0a8">
      <LookupTableCustomFieldChange IsMultiValued="false" CustomFieldType="Text" CustomFieldGuid="00004f6d-90a2-439a-8cc2-1c1ef6d2da4f" CustomFieldName="Health">
        <LookupTableValue Guid="0000eee0-9844-4de1-97c1-357d94cd8802">Blocked</LookupTableValue>
      </LookupTableCustomFieldChange>
    </Assn>
  </Proj>
</Changes>