OutlineCode 元素

项目
04/04/2023

在项目中定义大纲代码和关联的值列表，或为资源或任务指定大纲代码元素的值。

<OutlineCode>
  ComplexTypeValue
</OutlineCode>

父元素

OutlineCodes、资源、任务

项目级别的子元素

元素	必需/可选	说明
Guid	必需	Microsoft Office Project 2007 中的新增功能。大纲代码的全局唯一标识符 (GUID) 。对应于关联的 ExtendedAttribute 值中的 Ltuid 元素。
FieldID	可选	大纲代码的字段 ID 号。字段编号对应于大纲代码 1、大纲代码 2、。 . . ，大纲代码 10，用于资源和任务。
FieldName	可选	自定义大纲代码的名称。
Alias	可选	大纲代码的别名。
PhoneticAlias	可选	包含平假名或片假名中的拼音发音信息，用于自定义大纲代码;仅在日语版本的 Project 中使用。
值	可选	大纲代码的值定义的集合。
企业	可选	指示大纲代码是否为企业自定义字段。
EnterpriseOutlineCodeAlias	可选	指大纲代码为其别名的企业自定义字段。
ResourceSubstitutionEnabled	可选	指示大纲代码是否与 Project 中的资源替换向导一起使用。资源替换向导仅用于企业自定义域。
LeafOnly	可选	指示为资源或任务中的大纲代码指定的值是否必须是叶值。
AllLevelsRequired	可选	指示新代码是否必须存在所有级别。不用于企业自定义域。
OnlyTableValuesAllowed	可选	指示大纲代码值是否必须来自关联的查找表。
面具	可选	大纲代码值列表的代码掩码集合。

任务和资源级别的子元素

元素	必需/可选	说明
FieldID	必需	大纲代码的字段 ID 号。字段编号对应于大纲代码 1、大纲代码 2、。 . . ，大纲代码 10，用于资源和任务。
ValueID	可选	与大纲代码定义关联的“值”列表中的本地 ID 号。 Project 2003 需要读取从 Project 2007 保存的 XML 文件。
ValueGUID	可选	Project 2007 中的新增功能。大纲代码值列表中的值的 GUID。 ValueGUID 与 Value 元素中的 FieldGUID 匹配。

出现次数

最小值：0

最大值：无限制

备注

带有相应代码掩码和值表的大纲代码在项目中的 OutlineCodes 集合中定义。每个大纲代码都有一个关联的 ExtendedAttribute，用于指定大纲代码字段类型和别名。

包含大纲代码值的资源或任务包括每个值的 OutlineCode 元素。在资源或任务中指定 OutlineCode 元素的值时，需要以下两个数据：

指向由 FieldID 元素指定的大纲代码定义的指针。
大纲代码值，该值由 ValueID 和 ValueGUID 指针指定，指向值列表中的 Value 元素。 ValueGUID 与值列表中的 FieldGUID 匹配。 Project 2007 忽略 ValueID 并使用 ValueGUID。

示例

在以下示例中，大纲代码定义中的 Guid 值对应于关联的 ExtendedAttribute 中的 Ltuid 值。大纲代码别名为 任务简单 OC ，用于 大纲代码 6 字段名称。 FieldID 188744106与 PjCustomField 枚举中的 pjCustomTaskOutlineCode6 枚举值匹配。还可以使用 Project Visual Basic 编辑器中的对象浏览器 (VBE) 查找 PjCustomField 枚举中的值。

大纲代码掩码定义一个级别字符 (Type = 3) ，长度 (长度 = 0) 。

任务中大纲代码的 ValueGUID 和 ValueID 都对应于任务简单 OC 大纲代码中的简单 2 值。

<Project xmlns="http://schemas.microsoft.com/project">
   . . .
   <OutlineCodes>
      <OutlineCode>
         <Guid>26F0CA77-38CC-40C7-933D-15F839F7DB82</Guid>
         <Enterprise>0</Enterprise>
         <ResourceSubstitutionEnabled>0</ResourceSubstitutionEnabled>
         <LeafOnly>0</LeafOnly>
         <AllLevelsRequired>0</AllLevelsRequired>
         <OnlyTableValuesAllowed>0</OnlyTableValuesAllowed>
         <Masks>
            <Mask>
               <Level>1</Level>
               <Type>3</Type>
               <Length>0</Length>
               <Separator>.</Separator>
            </Mask>
         </Masks>
         <Values>
            <Value>
               <ValueID>16</ValueID>
               <FieldGUID>985194AB-77BA-4545-BCE8-99761B5538D9</FieldGUID>
               <ParentValueID>0</ParentValueID>
               <Type>21</Type>
               <Value>Simple 1</Value>
            </Value>
            <Value>
               <ValueID>17</ValueID>
               <FieldGUID>6B0CC455-EE19-416A-8FD9-6209590B3ED7</FieldGUID>
               <ParentValueID>0</ParentValueID>
               <Type>21</Type>
               <Value>Simple 2</Value>
            </Value>
         </Values>
      </OutlineCode>
   </OutlineCodes>
   . . .
   <ExtendedAttributes>
      <ExtendedAttribute>
         <FieldID>188744106</FieldID>
         <FieldName>Outline Code6</FieldName>
         <Alias>Task Simple OC</Alias>
         <Ltuid>26F0CA77-38CC-40C7-933D-15F839F7DB82</Ltuid>
         <SecondaryPID>255869013</SecondaryPID>
      </ExtendedAttribute>
   </ExtendedAttributes>
   . . .
   <Tasks>
      <Task>
         . . .
         <OutlineCode>
            <FieldID>188744106</FieldID>
            <ValueID>17</ValueID>
            <ValueGUID>6B0CC455-EE19-416A-8FD9-6209590B3ED7</ValueGUID>
         </OutlineCode>
         . . .
      </Task>
   </Tasks>
   . . .
</Project>

另请参阅

通过