OutlineCode 元素

發行項
04/04/2023

在專案中定義大綱代碼和相關聯的值清單，或指定資源或任務的大綱代碼專案的值。

<OutlineCode>
  ComplexTypeValue
</OutlineCode>

父項目

OutlineCodes、 Resource、 Task

專案層級的子專案

元素	必要/選用	描述
Guid	必要	Microsoft Office Project 2007 的新功能。大綱代碼的 GUID) (全域唯一識別碼。對應至相關聯 ExtendedAttribute 值中的 Ltuid 元素。
FieldID	選用	大綱代碼的欄位識別碼。域號對應至大綱代碼1、大綱代碼2、。 . . ，大綱代碼10，適用于資源和工作。
FieldName	選用	自訂大綱代碼的名稱。
Alias	選用	大綱代碼的別名。
PhoneticAlias	選用	在平假名或片假名中包含自訂大綱代碼的注音發音資訊;僅用於 Project 的日文版本。
值	選用	大綱代碼之值定義的集合。
企業	選用	指出大綱代碼是否為企業自訂欄位。
EnterpriseOutlineCodeAlias	選用	是指大綱代碼為別名的企業自訂欄位。
ResourceSubstitutionEnabled	選用	指出大綱代碼是否與 Project 中的 [資源替代精靈] 搭配使用。 [資源替代精靈] 僅用於企業自訂欄位。
LeafOnly	選用	指出在資源或工作中為大綱代碼指定的值是否必須是分葉值。
AllLevelsRequired	選用	指出新的程式碼是否必須具有所有層級。不用於企業自訂欄位。
OnlyTableValuesAllowed	選用	指出大綱代碼值是否必須來自相關聯的查閱表格。
面具	選用	大綱代碼值清單的程式碼遮罩集合。

工作和資源層級的子專案

元素	必要/選用	描述
FieldID	必要	大綱代碼的欄位識別碼。域號對應至大綱代碼1、大綱代碼2、。 . . ，大綱代碼10，適用于資源和工作。
ValueID	選用	與大綱代碼定義相關聯之 [值] 清單中的本機識別碼。需要 Project 2003 才能讀取從 Project 2007 儲存的 XML 檔案。
ValueGUID	選用	Project 2007 的新功能。大綱代碼值清單中值的 GUID。 ValueGUID 符合 Value 元素中的 FieldGUID。

Occurrences

最小值：0

最大值：未系結

註解

大綱代碼，具有對應的程式碼遮罩和值資料表，是在專案中 OutlineCodes 的集合中定義。每個大綱代碼都有相關聯的 ExtendedAttribute，指定大綱代碼欄位類型和別名。

包含大綱代碼值的資源或工作包含每個值的 OutlineCode 元素。需要下列兩個數據片段，才能指定資源或工作中 OutlineCode 元素的值：

FieldID 專案所指定的大綱代碼定義指標。
大綱代碼值，由 ValueID 和 ValueGUID 指標指定，指向值清單中的 Value 元素。 ValueGUID 符合值清單中的 FieldGUID。 Project 2007 會忽略 ValueID 並使用 ValueGUID。

範例

在下列範例中，大綱代碼定義中的 Guid 值會對應至相關聯 ExtendedAttribute 中的 Ltuid 值。大綱代碼別名是大綱代碼 6功能變數名稱的工作簡單 OC。 FieldID 188744106符合 PjCustomField 列舉中的 pjCustomTaskOutlineCode6 列舉值。您也可以使用 Project Visual Basic 編輯器中的 [物件瀏覽器] (VBE) 來尋找 PjCustomField 列舉中的值。

大綱代碼遮罩會定義一個字元層級 (類型 = 3) ，任何長度 (長度 = 0) 。

工作中大綱代碼的 ValueGUID 和 ValueID 都對應到任務簡單 OC大綱代碼中的Simple 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>

另請參閱

共用方式為