ExtendedAttribute 元素

项目
04/04/2023

扩展属性表示 Microsoft Office Project 中的自定义字段或大纲代码。扩展属性可以是本地自定义字段或大纲代码，也可以是企业自定义字段。定义取决于扩展属性是在 ExtendedAttributes 集合中还是在 Task、Resource 或 Assignment 中定义的。一般情况下，可以有无限数量的扩展属性，但受限于“备注”部分中所述的限制。

<ExtendedAttribute>
  ComplexTypeValue
</ExtendedAttribute>

父元素

ExtendedAttributes， Task， Resource， Assignment

ExtendedAttributes 集合的子元素

元素	必需/可选	说明
FieldID	可选	对应于本地自定义字段 (Text1、Text2 等) 的枚举值。 FieldID 在多个项目中并不唯一。
FieldName	可选	自定义字段的名称。
CFType	可选	Project 2007 中的新增功能。自定义字段类型 (成本、日期、工期、完成时间、标志、数字、开始或文本) 。
Guid	可选	Project 2007 中的新增功能。自定义字段的 GUID。
ElemType	可选	Project 2007 中的新增功能。与自定义域关联的实体 (任务、资源或工作分配) 的类型。
MaxMultiValues	可选	Project 2007 中的新增功能。可以在自定义字段值列表中选择的最大值数
UserDef	可选	Project 2007 中的新增功能。指示自定义字段是否为用户定义的。
Alias	可选	自定义字段的别名。
SecondaryPID	可选	Project 2007 中的新增功能。辅助项目标识符 (PID) 用于工作分配下拉的自定义域。
AutoRollDown	可选	Project 2007 中的新增功能。指示是否启用将自定义字段值自动向下滚动到工作分配级别。
DefaultGuid	可选	Project 2007 中的新增功能。指定默认查阅表项的 GUID。
Ltuid	可选	Project 2007 中的新增功能。与自定义字段关联的查阅表的 GUID。
PhoneticAlias	可选	包含平假名或片假名中扩展属性的拼音信息;仅在日语版本的 Project 中使用。
RollupType	可选	指示用于计算摘要任务的汇总的方法。
CalculationType	可选	指示是否为任务和组摘要行计算汇总。
Formula	可选	Project 用于填充自定义字段的公式。
RestrictValues	可选	指示文件中是否只允许列表中的值。
ValuelistSortOrder	可选	Project 2007 中的新增功能。指示值列表的排序方式 (降序或升序) 。
AppendNewValues	可选	指示是否自动将添加到项目的新值添加到列表中。
Default	可选	指列表中默认值的 ID;如果没有默认设置，则不使用。
ValueList	可选	扩展属性值的集合。

任务、资源或工作分配的子元素

元素	必需/可选	说明
FieldID 元素	可选	扩展属性的字段 ID。
Value 元素	可选	扩展属性的实际值。
DurationFormat 元素	可选	扩展属性的持续时间格式的枚举 (天、周、月等) 。
ValueGUID	可选	Project 2007 中的新增功能。自定义字段值列表中的值的 GUID。对于多值自定义字段，ValueGUID 与 Value 元素中的 FieldGUID 匹配。

出现次数

最小值：0

最大值：无限制

备注

在任务、资源或工作分配中指定 ExtendedAttribute 的值时，需要以下两条数据：

指向 FieldID 元素指定的扩展属性定义的指针。
自定义字段值，该值由 Value 元素或 ValueGUID 指针指定，指向值列表中的 Value 元素。 ValueGUID 与值列表中的 FieldGUID 匹配。

如果自定义字段的类型为 Duration，则该值需要 DurationFormat 元素。如果自定义字段是由公式计算的，ValueGUID 将显示以下内容： <ValueGUID>00000000-0000-0000-0000-00000000000</ValueGUID>

注意

加载存储为 XML 数据的项目时，Microsoft Office Project 最多可识别 5000 个 ValueList 元素。将忽略所有其他项。

示例

FieldName 值对应于 FieldID 元素中的 PjCustomField 枚举值。例如，信息本地自定义字段的 FieldID 188743731与 PjCustomField 枚举中的 pjCustomTaskText1 值匹配。

注意

PjCustomField 文档中当前缺少 FieldID 205521019。但是，可以在 Project Visual Basic 编辑器的“对象浏览器”中找到 (VBE) ，值为 pjCustomResourceCost1。

<ExtendedAttributes>
   <ExtendedAttribute>
      <FieldID>188743731</FieldID>
      <FieldName>Text1</FieldName>
      <Alias>Information</Alias>
      <Ltuid>6F76DA0E-4294-467A-9A66-5E2909578CE8</Ltuid>
      <SecondaryPID>255869028</SecondaryPID>
      <DefaultGuid>D2C35FC6-639A-4F88-A1FF-987F432F3A9D</DefaultGuid>
   </ExtendedAttribute>
   <ExtendedAttribute>
      <FieldID>205521019</FieldID>
      <FieldName>Cost1</FieldName>
      <Alias>Extra Cost</Alias>
      <Ltuid>06AC981F-E8E6-4F20-A26F-8A408A36660B</Ltuid>
      <SecondaryPID>255852663</SecondaryPID>
      <AutoRollDown>1</AutoRollDown>
   </ExtendedAttribute>
</ExtendedAttributes>
. . .
<Tasks>
   <Task>
      <UID>1</UID>
      <ID>1</ID>
      <Name>T1</Name>
      . . .
      <ExtendedAttribute>
         <FieldID>188743731</FieldID>
         <Value>Info 1</Value>
         <ValueGUID>D2C35FC6-639A-4F88-A1FF-987F432F3A9D</ValueGUID>
      </ExtendedAttribute>
   </Task>
   </Task>
</Tasks>
. . .
<Resources>
   <Resource>
      <UID>1</UID>
      <ID>1</ID>
      <Name>R1</Name>
      . . .
      <ExtendedAttribute>
         <FieldID>205521019</FieldID>
         <Value>3000</Value>
         <ValueGUID>1EBF58AF-8EF0-400C-8E36-78628FF0E21C</ValueGUID>
      </ExtendedAttribute>
   </Resource>
</Resources>

另请参阅

通过