解決程式匯入的驗證錯誤

發行項
2025-04-07

Azure DevOps Services

重要

匯入程式支援裝載的 XML 進程模型，可讓您透過更新進程範本的 WIT 定義來管理自訂專案。此功能僅適用於使用 Azure DevOps 數據匯入服務移轉至 Azure DevOps Services 的組織。

如果您使用繼承程式模型，您可以藉由建立繼承的進程，透過使用者介面自定義工作追蹤。如果您使用內部部署 XML 進程模型，您可以自訂程式範本：上傳或下載程式範本和自訂程式範本。

如需詳細資訊，請參閱自訂工作追蹤。

在程式匯入期間，系統會驗證此程式，以確保系統如預期般運作自定義程式。如果流程驗證失敗，您會收到錯誤訊息清單。

已成功匯入程式

如果您在嘗試匯入程式時收到驗證錯誤，請在重試匯入之前解決錯誤。每個錯誤都有連結，以深入瞭解特定驗證失敗，以及如何修正錯誤。套用您收到的訊息所提供的解決修正、壓縮更新的檔案，然後重試匯入作業。

如果您剛開始自定義，請檢閱提供的驗證規則。

先決條件

如需量身打造 Azure Boards 以符合特定業務需求的指引，請參閱關於設定和自定義 Azure Boards。

類別	要求
權限	- 若要建立、刪除或編輯程式：專案集合系統管理員群組或特定集合層級許可權的成員，建立進程、刪除程式、編輯程式，或將 [從組織刪除] 字段設定為 [允許 ]。如需詳細資訊，請參閱設定工作追蹤的許可權和存取權、自定義繼承的進程。 - 若要更新面板：Team Administrator 或 Project Administrators 群組的成員。
訪問	- 即使您有基本或較低存取權，如果有人授與您許可權來執行此動作，您仍然可以變更程式。 - 若要更新和更改您現有工作項目的類型，請作為項目成員執行此操作。
專案程式模型	- 針對包含專案的專案集合具有繼承流程模型。 - 如果將數據遷移至 Azure DevOps Services，請使用 Team Foundation Server 資料庫匯入服務。
知識	熟悉自定義和流程模型。

資訊訊息 - 不需要採取任何動作

TF402555：刪除欄位 [refName]。

您要匯入的程序不包含正在更新的程序中的具名字段，因此會在更新操作的過程中被移除。

案例範例

將自定義欄位新增至工作專案Bug.xml

<FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />

匯入程式
從Bug.xml移除欄位
匯入更新的程式

系統會顯示要刪除之欄位的相關信息訊息。
TF402555: Field MyCompany.CustomFields.Foo will be deleted

TF402591：現有進程 [processName] 中具有參考名稱 [refName] 的欄位無法從 '[name2]' 重新命名為 '[name1]'。

您匯入的程式包含重新命名的欄位，在目前進程中使用相同的 refname 欄位。

您無法重新命名功能變數名稱。

TF402598：刪除工作項目類型 [refName]。

您要更新的流程不包含目前流程中存在的具名 WIT。在更新現有進程的一部分時，系統會從目前的進程中刪除具名 WIT。

案例範例

建立名為「LSI」的新工作項目類型

<WORKITEMTYPE name="LSI" refname="My.LSI">

匯入程式
從處理程式中移除 LSI 工作項目類型
匯入更新的程式

系統會顯示有關刪除的資訊訊息。
TF402598: Work item type My.LSI will be deleted

TF402601：工作項目類型 [witName] 已從 [name2]* 重新命名為 [name1]。*

此流程包含已重新命名的 WIT。在現有過程中，WIT 會被重新命名。
您要更新的程式包含從目前進程中的名稱重新命名的 WIT。
在更新現有進程的過程中，系統會重新命名目前進程中的 WIT。所參考流程的現有專案中的所有工作項目也會重新命名。

案例範例

建立名為「LSI」的新工作項目類型

<WORKITEMTYPE name="LSI" refname="My.LSI">

匯入程式

將 LSI 工作項目類型重新命名為即時網站事件

<WORKITEMTYPE name="Live Site Incident" refname="My.LSI">

匯入更新的程式

系統會顯示要重新命名之 WIT 的相關信息訊息。
TF402601: Work item type My.LSI will be renamed to 'Live Site Incident' from 'LSI'

其他檔案錯誤

TF402586：剖析檔案時發生錯誤： [錯誤訊息]

格式不正確的 XML 語法可能會導致剖析檔案錯誤。遺漏結尾標記、遺漏引號、遺漏開啟或右括弧（< 或 >）可能會導致剖析檔案錯誤。

從錯誤訊息中，判斷並更正格式錯誤的 XML 來源。

TF402594：檔案違反架構，並出現下列錯誤： [錯誤訊息]

進程 zip 檔案中的每個 XML 檔案都必須符合指定的架構。架構違規錯誤是由於 XML 檔案內的自訂 XML 標籤或屬性所造成。讀取錯誤訊息以判斷架構違規的來源，並據以修正。

工作專案追蹤的 FORM 架構定義會將專案內的所有子項目定義為駱駝式大小寫，而所有其他元素則定義為所有大寫。如果您在驗證類型定義檔案時遇到錯誤，請檢查元素的案例結構。此外，開啟和結尾標記的案例結構必須符合 XML 語法的規則。

錯誤範例

自訂 XML 標籤：

  <WORKITEMTYPE name="Bug" refname="My.Bug">
    <FOO>Hello World</FOO>
    ...

新增至 XML 元素的額外屬性：

  <WORKITEMTYPE name="Bug" refname="My.Bug" foo="hello world">

VS412450：[fileName] 中的 Xml 架構驗證錯誤。 [錯誤訊息]

更正指定的檔案中的架構錯誤。

進程範本外掛程式錯誤

ProcessTemplate.xml 是定義整個進程和匯入以新增或更新進程的所有 XML 定義檔案的根檔案。此檔案包含建立項目時參考的所有外掛程式和工作組。每個工作組都會參考定義特定工作的次級 XML 檔案（通常位於子資料夾中）。一般而言，您會為每個外掛程式指定一個工作組。

ProcessTemplate.xml定義檔必須符合 ProcessTemplate XML 元素參考中所述的語法和規則。

VS412457：進程套件中找不到指定的檔案 '[fileName]'。

請更改處理壓縮檔以包含指定的檔案。

VS402452：進程範本未指定版本，或指定無效的版本。

若要指定版本，請編輯 ProcessTemplate.xml 檔案。

錯誤範例

ProcessTemplate.xml檔案會針對敏捷式進程指定相同的 version GUID，這是鎖定的進程。

<ProcessTemplate>
  <metadata>
    <name>Fabrikam Agile</name>
    <description>Use this template to support Fabrikam Agile planning methods.</description>
    <version type="ADCC42AB-9882-485E-A3ED-7678F01F66BC" major="7" minor="36" />

解決範例

指定了不同的 GUID。

<ProcessTemplate>
  <metadata>
    <name>Fabrikam Agile</name>
    <description>Use this template to support Fabrikam Agile planning methods.</description>
    <version type="7710F7A4-1F19-4054-9FBC-D94A5935221E" major="7" minor="1" />

VS412453：進程範本 zip 檔案不包含必要的外掛程式 [pluginName]。

ProcessTemplate.xml檔案內所列的所有檔案及其支援的外掛程式檔案都必須存在於進程 zip 檔案中。

使用搜尋工具來尋找進程檔案和資料夾集合內 filename=value 的所有實例。然後，更新外掛程式以移除遺漏的具名檔案，或將具名檔案新增至其所屬的進程資料夾。

 <taskList filename="WorkItem Tracking\WorkItems.xml" />

錯誤範例

WorkItemTracking 插件指定了fileName="WorkItem Tracking\TypeDefinitions\Epic.xml，但沒有新增到 WorkItem Tracking\TypeDefinitions 資料夾中。

     <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Epic.xml" />

解決範例

將Epic.xml檔案新增至 WorkItem Tracking\TypeDefinitions 資料夾。

VS412454：外掛程式 [pluginName] 包含若干 `taskList`{1}{2}。每個外掛程式只允許一個 `taskList` 。

更正具名外掛程式的ProcessTemplate.xml檔案，以減少定義的元素數目 tasklist 。

錯誤範例

WorkItemTracking 外掛程式包含兩個 tasklist 語句。

    <group id="WorkItemTracking" description="Workitem definitions uploading." completionMessage="Work item tracking tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
      </dependencies>
      <taskList filename="WorkItem Tracking\WorkItems.xml" />
      <taskList filename="WorkItem Tracking\FabrikamWorkItems.xml" />
    </group>

解決範例

    <group id="WorkItemTracking" description="Workitem definitions uploading." completionMessage="Work item tracking tasks completed.">
      <dependencies>
        <dependency groupId="Classification" />
        <dependency groupId="Groups" />
      </dependencies>
      <taskList filename="WorkItem Tracking\FabrikamWorkItems.xml" />
    </group>

TF402575：您只能在程式中包含一個類別定義檔案。

錯誤範例

WorkItems.xml檔案包含兩個 CATEGORIES 語句。

  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
      <CATEGORIES fileName="WorkItem Tracking\Custom_Categories.xml" />
    </taskXml>
  </task>

解決範例

WorkItems.xml 檔案會更新為只包含一個 CATEGORIES 語句。

  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Custom_Categories.xml" />
    </taskXml>
  </task>

TF402576：您只能在程式中包含一個 ProcessConfiguration 定義檔案。

錯誤範例

WorkItems.xml檔案包含重複 ProjectConfiguration 的語句。

    <taskXml>
      <PROCESSCONFIGURATION>
        <ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
      </PROCESSCONFIGURATION>
    </taskXml>
    <taskXml>
      <PROCESSCONFIGURATION>
        <ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
      </PROCESSCONFIGURATION>
    </taskXml>

解決範例

WorkItems.xml 檔案會更新為只包含一個 ProjectConfiguration 語句。

    <taskXml>
      <PROCESSCONFIGURATION>
        <ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
      </PROCESSCONFIGURATION>
    </taskXml>

TF402587：遺漏必要的 ProcessConfiguration 檔案。

WorkItems.xml檔案會指定要上傳的 ProcessConfiguration 檔案。未指定檔案、包含過期規格、範本中遺漏指定的檔案，或資料夾/檔名不正確。

錯誤範例

指定的組態已過期，並指定進程資料夾中未包含的兩個檔案。

    <taskXml>
      <PROCESSCONFIGURATION>
        <CommonConfiguration fileName="WorkItem Tracking\Process\CommonConfiguration.xml"/> 
        <AgileConfiguration fileName="WorkItem Tracking\Process\AgileConfiguration.xml"/>
      </PROCESSCONFIGURATION>
    </taskXml>

解決範例

WorkItems.xml 檔案會被更新，以包含正確的組態 ProjectConfiguration 陳述。

    <taskXml>
      <PROCESSCONFIGURATION>
        <ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
      </PROCESSCONFIGURATION>
    </taskXml>

TF402577：欄位 [refName] 會指定易記名稱 [friendlyName] ，此名稱已在進程 [processNames] 中的字段 [refName] 使用中。

所有針對匯入至 Azure DevOps Services 之程式所指定之所有 WIT 定義的所有欄位定義，易記名稱都必須是唯一的。

具名進程包含 WIT，可定義使用易記名稱的欄位。

修改包含 [refName] 的進程 zip 檔案中的 WIT 定義，並指定不同的易記名稱，或使其符合使用中的現有欄位。

錯誤範例

UserStory WIT 定義包含 FIELD 具有易記名稱 Product 的 Fabrikam.Product.Family 元素。

      <FIELD name="Product" refname="Fabrikam.Product.Family" type="String" reportable="dimension">
        <HELPTEXT>Enter the name of the product family for this story or feature.</HELPTEXT>
      </FIELD>

不過，在現有的程式中，Fabrikam.Product.Versions 會使用易記名稱 Product。

      <FIELD name="Product" refname="Fabrikam.Product.Versions" type="String" reportable="dimension">
        <HELPTEXT>Enter the name of the product version for this story or feature.</HELPTEXT>
      </FIELD>

解決範例

更新 UserStory WIT 定義，以符合現有的欄位。

      <FIELD name="Product" refname="Fabrikam.Product.Versions" type="String" reportable="dimension">
        <HELPTEXT>Enter the name of the product version for this story or feature.</HELPTEXT>
      </FIELD>

TF402585：進程範本中缺少必要的 WorkItemTracking 外掛程式參考。

您必須在 ProcessTemplate.xml 檔案的 metadata 區段中指定 Microsoft.ProjectCreationWizard.WorkItemTracking 外掛程式：

錯誤範例

Microsoft.ProjectCreationWizard.WorkItemTracking外掛程式在 ProcessTemplate.xml 檔案的plugins區段中缺少。

   <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" />
    </plugins>

解決範例

   <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.Classification" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Reporting" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Portal" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.Groups" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.WorkItemTracking" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.VersionControl" wizardPage="true" />
      <plugin name="Microsoft.ProjectCreationWizard.TestManagement" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Build" wizardPage="false" />
      <plugin name="Microsoft.ProjectCreationWizard.Lab" wizardPage="false" />
    </plugins>

類別

Categories.xml定義檔必須符合 Categories XML 元素參考中所述的語法和規則。

TF402546：類別[categoryName]缺失於類別檔案中。

ProcessConfiguration.xml 檔案中參考的所有類別都必須定義在 Categories.xml 檔案中。此外，系統會要求Categories.xml檔案包含下列類別的定義：

錯誤類別
程式代碼檢閱要求類別
程式代碼檢閱回應類別
意見反應要求類別
意見反應回應類別
隱藏類型類別
需求類別
共用步驟類別
共用參數類別目錄
工作類別
測試案例類別
測試計劃類別
Test Suite 類別

更新您的Categories.xml檔案，以定義遺漏 的 [name] 類別。

錯誤範例

ProcessConfiguration 會參考 Epic 類別，但 Categories.xml 定義檔中缺少該類別。

解決範例

Epic 類別會新增至 Categories 檔案。

  <CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
    <DEFAULTWORKITEMTYPE name="Epic" />
  </CATEGORY>

TF402553：元素 [name] 會參考類別目錄 [categoryName] ，但類別檔案中未定義。

更新您的Categories.xml檔案，以定義遺漏 的 [categoryName] 類別。

TF402560：您已定義 [n] 類別。只允許[nn]。

檢閱您的 Categories.xml 檔案中所有 CATEGORY 元素語句，並判斷哪些項目可以刪除，以免超過允許的限制。然後，檢閱您的ProcessConfiguration.xml檔案，以取代參考已刪除類別的值。

TF402596：類別 [categoryName ] 不會定義工作項目類型 [witName]。

類別必須參考定義在 /WorkItem Tracking/TypeDefinitions 資料夾中的 WIT，並在 WorkItems.xml 外掛程式檔案中列為上傳任務。
檢閱您的Categories.xml檔案，以取得未包含在 /WorkItem Tracking/TypeDefinitions 資料夾中之 WIT 的參考。

錯誤範例

Microsoft.EpicCategory 參考的 WIT 名稱拼錯。

  <CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
    <DEFAULTWORKITEMTYPE name="EpicABC" />
  </CATEGORY>

解決範例

  <CATEGORY name="Epic Category" refname="Microsoft.EpicCategory">
    <DEFAULTWORKITEMTYPE name="Epic" />
  </CATEGORY>

TF402597：不支援自定義類別 [categoryName] ，因為 ProcessConfiguration 不會參考它。

您只能指定用來在 ProcessConfiguration 中設定敏捷式工具功能的自定義類別。
檢閱您的 ProcessConfiguration.xml 檔案，並判斷您是否遺漏添加對某類別的支援。否則，請從Categories.xml檔案中移除 [categoryName ]。

錯誤範例

ProcessConfiguration 不會參考 Microsoft.EpicCategory，不過是在 Categories.xml 定義檔中定義。

解決範例

新增 PortfolioBacklog 至 ProcessConfiguration 以參考 Microsoft.EpicCategory。

    <PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
      <States>
        <State value="New" type="Proposed" />
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="InProgress" />
        <State value="Closed" type="Complete" />
      </States>
      <Columns>
        <Column refname="System.WorkItemType" width="100" />
        <Column refname="System.Title" width="400" />
        <Column refname="System.State" width="100" />
        <Column refname="Microsoft.AzureDevOps.Scheduling.Effort" width="50" />
        <Column refname="Microsoft.AzureDevOps.Common.BusinessValue" width="50" />
        <Column refname="Microsoft.AzureDevOps.CMMI.RequirementType" width="100" />
        <Column refname="System.Tags" width="200" />
      </Columns>
      <AddPanel>
        <Fields>
          <Field refname="System.Title" />
        </Fields>
      </AddPanel>
    </PortfolioBacklog>

參考文章：

分類外掛程式的錯誤

Classification.xml定義檔必須符合分類外掛程式中所述的語法和規則。

TF402511：分類外掛程式包含重複的屬性名稱： [propertyName]。

錯誤範例

Classification.xml檔案在property name="MSPROJ"元素下包含第二個properties語句。

      <properties>
        <property name="MSPROJ" value="Classification\FileMapping.xml" isFile="true" />
        <property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
        <property name="Process Template" value="Fabrikam Agile"/>
      </properties>

解決範例

拿掉重複的語句。

      <properties>
        <property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
        <property name="Process Template" value="Fabrikam Agile"/>
      </properties>

TF402512：檔案 [fileName] 不存在。

Classification.xml檔案中指定的檔案不存在於指定的路徑中，或路徑拼錯。

錯誤範例

分類資料夾路徑拼錯。

       <properties>
        <property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
        <property name="Process Template" value="Agile"/>
      </properties>

解決範例

      <properties>
        <property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
        <property name="Process Template" value="Fabrikam Agile"/>
      </properties>

TF402513：分類外掛程式中的 [ pathName] 名稱不符合 TreePath 命名限制。

檢閱您指定的 Node 元素，並變更名稱以符合所支持的命名慣例。參考：新增和修改區域和迭代路徑。

錯誤範例

Path 名稱包含不允許的 # 字元。

        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
          <Children>
            <Node StructureType="ProjectLifecycle" Name="Sprint #1" />
            <Node StructureType="ProjectLifecycle" Name="Sprint #2" />
            <Node StructureType="ProjectLifecycle" Name="Sprint #3" />
          </Children>
        </Node>

解決範例

路徑名稱已更正。

        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
          <Children>
            <Node StructureType="ProjectLifecycle" Name="Sprint 1" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 2" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 3" />
          </Children>
        </Node>

TF402514：分類外掛程式中的節點結構類型 [structureTypeName] 不被支持。

屬性 StructureType 只允許下列值： ProjectModelHierarchy 和 ProjectLifecycle。
檢閱您指定的 Node 元素，並移除任何不支援的屬性。

錯誤範例

ProjectLifecycle 拼錯。

        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
          <Children>
            <Node StructureType="ProjectLifecycle" Name="Sprint 1" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 2" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 3" />
          </Children>
        </Node>

解決範例

拼錯的名稱已更正。

        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
          <Children>
            <Node StructureType="ProjectLifecycle" Name="Sprint 1" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 2" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 3" />
          </Children>
        </Node>

TF402515：分類外掛程式中的屬性屬性遺失或不受支援。

元素 property 只允許下列屬性： name 、 value 和 isFile。
檢閱您指定的property元素，並移除任何不支援的屬性。

錯誤範例

屬性 value 拼錯。

       <properties>
        <property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
        <property name="Process Template" value="Agile" />
      </properties>

解決範例

已更正拼錯的屬性。

      <properties>
        <property name="MSPROJ" value="Classification\Fabrikam_FileMapping.xml" isFile="true" />
        <property name="Process Template" value="Fabrikam Agile"/>
      </properties>

TF402516：分類外掛程式包含兩個以上的根層級節點，不受支援。

檢閱 Node 您指定的元素，並移除額外的根層級節點。

錯誤範例

Classification.xml檔案在容器元素Nodes底下包含Node StructureType="ProjectLifecycle"的第二個語句。

      <Nodes>
        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
          <Children>
            <Node StructureType="ProjectLifecycle" Name="Sprint 1" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 2" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 3" />
          </Children>
        </Node>
        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
        <Node StructureType="ProjectModelHierarchy" Name="Area" xmlns="" />
      </Nodes>

解決範例

拿掉第二個語句。

      <Nodes>
        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
          <Children>
            <Node StructureType="ProjectLifecycle" Name="Sprint 1" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 2" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 3" />
          </Children>
        </Node>
        <Node StructureType="ProjectModelHierarchy" Name="Area" xmlns="" />
      </Nodes>

TF402523：在 GroupsandPermissions 外掛程式中的區域或反覆項目路徑 '[pathName]' 在分類外掛程式中缺失。

將遺漏 的 [pathName] 新增至Classification.xml檔案，或從GroupsandPermissions.xml檔案中移除它。

錯誤範例

Classification.xml 檔案會指定衝刺，而不是迭代。

GroupsandPermissions.xmlteamSettings 指定迭代次數。

    <teamSettings areaPath="Area">
        <iterationPaths backlogPath="Iteration">
            <iterationPath path="Iteration 1" />
            <iterationPath path="Iteration 2" />
            <iterationPath path="Iteration 3" />
        </iterationPaths>
    </teamSettings>

不過，Classification.xml會指定短期衝刺。

        <Node StructureType="ProjectLifecycle" Name="Iteration" xmlns="">
          <Children>
            <Node StructureType="ProjectLifecycle" Name="Sprint 1" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 2" />
            <Node StructureType="ProjectLifecycle" Name="Sprint 3" />
          </Children>
        </Node>

解決範例

更新GroupsandPermissions.xml，以便使用衝刺階段。

    <teamSettings areaPath="Area">
        <iterationPaths backlogPath="Iteration">
            <iterationPath path="Sprint 1" />
            <iterationPath path="Sprint 2" />
            <iterationPath path="Sprint 3" />
        </iterationPaths>
    </teamSettings>

連結類型

注意

目前匯入程式不支援自定義連結類型。

TF402561：您已定義 [n] 自定義連結類型。只允許[nn]。

檢閱您的 WorkItems.xml 外掛程式檔案中所有的 LINKTYPE 元素語句。拿掉與自定義連結類型相關聯的語句，以免超過允許的限制。然後，從LinkTypes資料夾移除對應的連結類型定義檔。

此外，請移除您新增至 WIT 定義中的在FORM 區段下的LinksControlOptions 區段內的自訂連結類型的任何參考。

TF402583：自定義連結類型 [name] 無效，因為不支援自定義連結類型。

請檢閱您的 WorkItems.xml 外掛程式檔案中所有 LINKTYPE 元素語句。拿掉任何指定自定義連結類型的語句。然後，從LinkTypes資料夾移除對應的連結類型定義檔。

WorkItems.xml外掛程式檔案內的下列 LINKTYPE 元素語句有效：

      <LINKTYPES>
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\Affects.xml" />
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
        <LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedParameterLink.xml" />
      </LINKTYPES>

全域清單

注意

目前匯入程式功能不支援全域清單。

TF402564：您已定義 [n] 全域清單。只允許[nn]。

自定義程式範本中定義的一或多個 WIT 包含 GLOBALLIST 元素。搜尋您的 WIT 定義檔案，並將任何 GLOBALLIST 元素取代為 ALLOWEDVALUES 或 SUGGESTEDVALUES 元素。如需參考語法，請參閱定義挑選清單。

TF402565：您在全域清單 [globalListName] 中定義了 [n] 項目。最多允許 [nn]。

具名 GLOBALLIST 元素包含的項目超過准許的數量。請減少 GLOBALLIST 元素中包含的清單項目數，或將整體清單分割成兩個或更多的元素，從而確保每個清單都不超過允許的最大項目數。

如需參考語法，請參閱定義挑選清單。

進程組態

ProcessConfiguration.xml定義檔必須符合 ProcessConfiguration XML 元素參考中所述的語法和規則。

TF402543：元素 [elementName] 需要將一個工作流程狀態對應至 metastate [metastateName]。

更新 ProcessConfiguration.xml 檔案中指定元素內的 States 區段，以提供缺失的元狀態對應或移除多餘的對應。

錯誤範例

RequirementBacklog 元素在 ProcessConfiguration.xml 中遺漏了type="Proposed"的中繼狀態對應。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
   <States>
      <State value="Committed" type="InProgress" />
      <State value="Done" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

解決範例

已新增遺漏的中介狀態映射。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
   <States>
      <State value="New" type="Proposed" />
      <State value="Committed" type="InProgress" />
      <State value="Done" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

TF402547：元素 [elementName] 要求工作項目類型 [witName] 至少將一個狀態對應至 metastate [metastateName]。

檢閱 WORKFLOW 為具名 WIT 定義的狀態，然後更新 States ProcessConfiguration.xml 檔案中具名元素內的部分，以提供具名 WIT 的遺漏中繼狀態對應。

TF402548：元素 [elementName] 需要您將至少一個狀態對應至 metastate [metastateName]。

若要提供遺漏的 metastate 對應，請更新 ProcessConfiguration.xml 檔案中具名元素內的 States 區段。

錯誤範例

ProcessConfiguration.xmlRequirementBacklog元素遺漏了type="InProgress"的中繼狀態對應。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
   <States>
      <State value="New" type="Proposed" />
      <State value="Done" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

解決範例

已新增遺漏的元狀態映射。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
   <States>
      <State value="New" type="Proposed" />
      <State value="Committed" type="InProgress" />
      <State value="Done" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

TF402550：元素 [elementName] 包含工作流程狀態 [stateName] 的多個中繼狀態對應。

Metastate 值無法對應至一個以上的工作流程狀態。

錯誤範例

ProcessConfiguration.xml 檔案中的RequirementBacklog元素包含兩個value="Active"的元狀態對應。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="Active" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

解決範例

Metastate 對應已修正。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

TF402551：工作專案類型 [witName] 不會定義工作流程狀態 [stateName]，這是必要的，因為 ProcessConfiguration 會將它對應至元素 [elementName] 的 metastate。

若要新增遺漏的 STATE 和 TRANSITION 元素，請更正 ProcessConfiguration.xml 檔案或命名為 WIT 的 WORKFLOW 區段。

錯誤範例

RequirementBacklog ProcessConfiguration.xml 元素指定了value="Committed"，然而 UserStory.xml 不會將認可定義為狀態。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="New" type="Proposed" />
      <State value="Committed" type="InProgress" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

解決範例

已移除 Committed 的State元素。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

TF402552：元素 [elementName] 需要針對工作專案類型 [witName]，您必須對應剛好一個狀態至 metastate [metastateName] 的下列狀態：[stateNames]。

請檢查ProcessConfiguration.xml檔案中具名元素的STATES區段，並確保錯誤訊息中列出的每個狀態都存在且映射到一個超狀態。

錯誤範例

ProcessConfiguration.xml 的 RequirementBacklog 元素缺少在 User Story 工作項目類型上的狀態 New。它應該位於對應至 STATES的type=Proposed"清單中。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

解決範例

Metastate 對應已修正。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

TF402554：元素 [elementName] 指定不支援的 metastate [metastateName]。

檢閱ProcessConfiguration.xml檔案中的STATES區段，針對具名元素進行移除或更正其 metastate。

錯誤範例

RequirementBacklog 元素在 ProcessConfiguration.xml 中包含一個拼錯的中繼狀態對應type=Proposed"。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

解決範例

Metastate 對應已修正。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
   </States>
 . . .
</RequirementBacklog >

TF402571：進程組態中遺漏必要的元素 [elementName]。

編輯ProcessConfiguration.xml檔案，以新增遺漏的具名元素。

請檢閱 ProcessConfiguration XML 元素參考以查看所需的元素。

TF402572：在進程範本套件中找不到指定的檔案。

zip 檔案中遺漏了外掛程式檔案中指定上傳的檔案。檢閱針對上傳指定的所有檔案，並確定它們已包含在進程 zip 檔案中。

請參閱 ProcessConfiguration XML 元素參考，以了解必要的元素。

TF402574：ProcessConfiguration 未指定必要的 `TypeField`[typeField]。

編輯ProcessConfiguration.xml檔案，以新增遺漏的具名 TypeField 元素。

檢閱ProcessConfiguration XML 元素參考以確保必需的TypeField元素。

範例

Scrum 進程會指定下列 TypeField 元素。如果遺漏上述任何元素，您會收到錯誤TF402574。

<TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.AzureDevOps.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.AzureDevOps.Common.BacklogPriority" type="Order" />
    <TypeField refname="Microsoft.AzureDevOps.Scheduling.Effort" type="Effort" />
    <TypeField refname="Microsoft.AzureDevOps.Common.Activity" type="Activity" />
    <TypeField refname="Microsoft.AzureDevOps.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
    <TypeField refname="Microsoft.AzureDevOps.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
    <TypeField refname="Microsoft.AzureDevOps.Feedback.ApplicationType" type="ApplicationType">
        <TypeFieldValues>
            <TypeFieldValue value="Web application" type="WebApp" />
            <TypeFieldValue value="Remote machine" type="RemoteMachine" />
            <TypeFieldValue value="Client application" type="ClientApp" />
        </TypeFieldValues>
    </TypeField>
</TypeFields>

TF402588：數個組合待辦項目[待辦項目名稱]已將[待辦項目名稱]定義為其父項。父待辦專案可能只有一個子待辦專案。

只有一個子組合待辦專案可以對應至單一父代待辦專案。

編輯 ProcessConfiguration 以更正父子待辦項目規格。

錯誤範例

  <PortfolioBacklog category="Microsoft.EpicCategory" parent="Microsoft.InitiativeCategory" pluralName="Epics" singularName="Epic">
    ...
  </PortfolioBacklog>

  <PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.InitiativeCategory" pluralName="Features" singularName="Feature">
    ...
  </PortfolioBacklog>

解決範例

若要指向 Epic 待辦專案，請變更功能待辦清單的父項目。

  <PortfolioBacklog category="Microsoft.EpicCategory" parent="Microsoft.InitiativeCategory" pluralName="Epics" singularName="Epic">
    ...
  </PortfolioBacklog>

  <PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.EpicCategory" pluralName="Features" singularName="Feature">
    ...
  </PortfolioBacklog>

TF402589：組合待辦專案 [待辦專案名稱] 參考未定義的父組合待辦專案 [待辦專案名稱]。

ProcessConfiguration.xml 定義中包含一個 parent 值，其參考了一個未定義的組合待辦工作項目。

錯誤範例

  <PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.EpicCategory" pluralName="Features" singularName="Feature">

解決範例

將 Epic PortfolioBacklog 新增至ProcessConfiguration.xml檔案。

  <PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
    <Columns>
      <Column refname="System.WorkItemType" width="100" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.AzureDevOps.Common.BusinessValue" width="50" />
      <Column refname="Microsoft.AzureDevOps.CMMI.RequirementType" width="100" />
      <Column refname="System.Tags" width="200" />
    </Columns>
  </PortfolioBacklog>

TF402590：數個組合待辦專案 [待辦專案 1，待辦專案 2] 不會定義其父項。

只有一個組合待辦專案，最上層待辦專案，可能未父系。所有其他待辦項目都必須包含 parent="Microsoft.FooCategory" 屬性和值。

解決範例

  <PortfolioBacklog category="Microsoft.FeatureCategory" parent="Microsoft.EpicCategory" pluralName="Features" singularName="Feature">

402595：定義太多投資組合待辦事項。最多允許5個。

編輯ProcessConfiguration.xml檔案，以從 PortfolioBacklog 區段移除額外的PortfolioBacklogs元素。

如需詳細資訊，請檢閱 ProcessConfiguration XML 元素參考。

TF400506：這個項目會定義代表 Bug 或瑕疵的工作項目狀態。

當區 BugWorkItems 段設定錯誤時，就會發生此錯誤。針對中包含的 Microsoft.BugCategory 工作項目類型所定義的每個狀態，都必須存在於區段中定義的 BugWorkItems 一組 State 值中。例如，如果針對 Bug 工作專案類型所定義的工作項目類型定義下列狀態—新增、核准、認可、完成]， BugWorkItems 則區段應該設定如下：

  <BugWorkItems category="Microsoft.BugCategory" pluralName="Bugs" singularName="Bug">
    <States>
    <States>
      <State value="New" type="Proposed" />
      <State value="Approved" type="Proposed" />
      <State value="Committed" type="InProgress" />
      <State value="Done" type="Complete" />
    </States>
  </BugWorkItems>

如需詳細資訊，請參閱 ProcessConfiguration XML 元素參考。

TF400507：每個工作專案類型都必須支援符合其中一個已定義狀態的初始狀態值，即 "BugWorkItems"。

當包含在Microsoft.BugCategory的工作項目類型指定的初始狀態不在ProcessConfiguration XML檔案的BugWorkItems區段中時，就會發生此錯誤。修正具名工作項目類型的 XML 定義工作流程狀態，或更新 BugWorkItems 區段以包含遺漏狀態。

如需詳細資訊，請參閱 ProcessConfiguration XML 元素參考。

TF400572：必須設定專案進程設定，才能使用此功能。

此錯誤源自於項目進程設定存在之前舊的範本。請嘗試在升級后執行設定功能以解析，或將 ProcessConfiguration XML 檔案新增至進程範本。

工作項目類型

TF402570：您已定義 [n] 工作項目類型。允許的最大數量為 [witLimit]。

您已定義允許在流程中使用的更多 WIT。檢閱您的WorkItems.xml檔案，並減少它所包含的語句數目 WORKITEMTYPE ，並從處理程式中移除相關聯的 WIT 定義檔。

TF402573：工作項目類型 WIT 未指定必要的 `refname` 屬性。

工作專案類型（Bug、用戶劇本、工作等）需要 refname 屬性。 refname 值必須是唯一的，而且不能包含任何保留的命名空間。名稱空間-System.XXX 和 Microsoft.AzureDevOps.XXX 是由 Azure DevOps 保留的。

如需詳細資訊，請參閱所有 WITD XML 元素參考以取得詳細資訊。

錯誤範例

<WORKITEMTYPE name="Bug">

解決範例

<WORKITEMTYPE name="Bug" refname="MyCompany.Bug">

TF402599：工作項目類型 refname [refName] 無效，因為它使用不允許的命名空間 [namespace]。

自訂欄位和 WIT 的參考名稱無法使用保留命名空間：系統。XXX 和 Microsoft.AzureDevOps。XXX。

編輯具名 WIT 的 refname 屬性。

錯誤範例

<FIELD name="Custom Field" refname="Microsoft.AzureDevOps.CustomField" type="String" />

解決範例

<FIELD name="Custom Field" refname="*CustomNamespace.CustomField*" type="String" />

TF402600：工作項目類型參考名稱 [refName] 無效。工作項目類型參考名稱必須只包含字母、無空格，以及至少一個句點（.）

WIT 參考名稱必須遵守已建立的命名慣例：只有字母、沒有空格，以及至少一個句點（.）

編輯已命名的 WIT 屬性，以滿足命名需求。

錯誤範例

<WORKITEMTYPE name="Bug" refname="MyCompanyBug32">

解決範例

<WORKITEMTYPE name="Bug" refname="MyCompany.Bug">

工作項目欄位

TF402538：不支援字段規則 [ruleName]。

編輯 WIT 定義以移除具名規則。匯入至 Azure DevOps 不支援下列規則：不支援MATCH、CANNOTLOSEVALUE、PROHIBITEDVALUES和NOTSAMEAS。

TF402539：欄位 [refName] 只允許下列規則：[ruleNames]。

編輯命名欄位的 WIT 定義，並移除任何不被允許的規則。 FIELDS檢閱和 WORKFLOW 區段。大部分的系統欄位都不允許指定規則。

與系統欄位搭配使用的有效規則

名稱	允許的規則
系統標題	`REQUIRED`, `DEFAULT`
System.Description	`REQUIRED`, `DEFAULT`
系統.分配至	`REQUIRED`、、 `DEFAULT`、 `ALLOWEXISTINGVALUEVALIDUSER`
System.ChangedBy	`REQUIRED`、、 `DEFAULT`、 `ALLOWEXISTINGVALUEVALIDUSER`

TF402540：工作專案類型 [witName] 無效，因為它指定全域清單 [GLOBALLIST]。不支援全域列表。

Azure DevOps 不支援全域清單。將所有 WIT 定義檔案中的所有 GLOBALLIST 元素替換為 ALLOWEDVALUES 和 LISTITEM 元素。參考：定義挑選清單。

錯誤範例

<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
  <ALLOWEDVALUES>
    <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

解決範例

<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
  <ALLOWEDVALUES>
    <LISTITEM value="Architecture" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Development" />
    <LISTITEM value="Release Management" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Test" />
  </ALLOWEDVALUES>
</FIELD>

TF402541：工作項目類型 [witName] 無效，因為它參考全域清單 [globalListName]。不支援全域清單。

Azure DevOps 不支援全域清單。將所有 WIT 定義檔案中的 GLOBALLIST 元素取代為 ALLOWEDVALUES 和 LISTITEM 元素。參考：定義挑選清單。

錯誤範例

<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
  <ALLOWEDVALUES>
    <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

解決範例

<FIELD name="CustomField" refname="MyCompany.CustomField" type="String">
  <ALLOWEDVALUES>
    <LISTITEM value="Architecture" />
    <LISTITEM value="Requirements" />
    <LISTITEM value="Development" />
    <LISTITEM value="Release Management" />
    <LISTITEM value="Project Management" />
    <LISTITEM value="Test" />
  </ALLOWEDVALUES>
</FIELD>

TF402542：自定義欄位 refname [refName] 無效，因為它使用不允許的命名空間 [namespace]。

在 Azure DevOps 中，namespaces-System.XXX 和 Microsoft.AzureDevOps.XXX 是保留的。自訂欄位和類型的參考名稱無法使用這些命名空間。

若要修正此錯誤，請在 WIT 定義檔案中，將出現的具名欄位的refname屬性重新命名。

錯誤範例

<FIELD name="CustomField" refname="System.CustomField" type="String" />

  - OR - 

<FIELD name="CustomField" refname="Microsoft.AzureDevOps.CustomField" type="String" />

解決範例

<FIELD name="CustomField" refname="MyCompany.CustomField" type="String" />

TF402544：工作項目類型 [witName] 中定義的欄位 [refName]，需要包含`ALLOWEDVALUES`值的規則，以支援 ProcessConfiguration 中指定的元素 [elementName]。

編輯指定 WIT 中的指定欄位以提供遺漏的 ALLOWEDVALUES 規則，參考指定元素以取得更多詳細內容。

ProcessConfiguration.xml 檔案元素 TypeField refname="Microsoft.AzureDevOps.Common.Activity" type="Activity" 需要在所有屬於工作類別的 WIT 中，為 Microsoft.AzureDevOps.Common.Activity 欄位設定一個選擇清單。

<TypeField refname="Microsoft.AzureDevOps.Common.Activity" type="Activity" />

如果您將錯誤新增至工作類別，請確定 Bug.xml 檔案包含命名欄位，並指定與 Task.xml 檔案中定義相同的選項列表。

錯誤範例

Bug.xml已定義欄位，但未定義選擇清單。

      <FIELD name="Activity" refname="Microsoft.AzureDevOps.Common.Activity" type="String" reportable="dimension">
        <HELPTEXT>Type of work involved</HELPTEXT>
      </FIELD>

解決範例

更正Bug.xml

      <FIELD name="Activity" refname="Microsoft.AzureDevOps.Common.Activity" type="String" reportable="dimension">
        <HELPTEXT>Type of work involved</HELPTEXT>
        <SUGGESTEDVALUES>
          <LISTITEM value="Development"/>
          <LISTITEM value="Testing"/>
          <LISTITEM value="Requirements"/>
          <LISTITEM value="Design"/>
          <LISTITEM value="Deployment"/>
          <LISTITEM value="Documentation"/>
        </SUGGESTEDVALUES>
      </FIELD>

TF402545：元素 [elementName] 需要您在工作項目類型 [witName] 的定義中包含字段* [fieldName]。*

您應該在具名的 WIT 定義中，為每個您在 ProcessConfiguration.xml 檔案的 AddPanel 區段內指定的 field，包含對應的 FIELD 元素。
您也應該在具名 WIT 的區段中包含 Control 元素 FORM 。

錯誤範例

ProcessConfiguration.xml指定兩個自定義欄位。不過，這些欄位並未定義在UserStory.xml檔案中。

<AddPanel>
   <Fields>
      <Field refname="System.Title" />
      <Field refname="Fabrikam.Product" />
      <Field refname="Fabrikam.Technology" />
   </Fields>
</AddPanel>

解決範例

缺失的FIELD元件已新增到 UserStory.xml 檔案中。

      <FIELD name="Product" refname="Fabrikam.Product" type="String" reportable="dimension">
     <FIELD name="Technology" refname="Fabrikam.Technology" type="String" reportable="dimension">

若要支援 ProcessConfiguration 元素 [elementName]，工作專案類型 [witName] 必須定義 TypeField [typeField ] （field refname [refName]）。

在您創建的 ProcessConfiguration 中，使用 TypeFieldValues 建立了一個 TypeField。在您的工作項目類型中，請參考相同的 TypeField。

錯誤範例

ProcessConfiguration.xml

  <TypeField refname="Custom.ApplicationType" type="ApplicationType">
    <TypeFieldValues>
      <TypeFieldValue value="Web application" type="WebApp" />
      <TypeFieldValue value="Remote machine" type="RemoteMachine" />
      <TypeFieldValue value="Client application" type="ClientApp" />
    </TypeFieldValues>
  </TypeField>

FeedbackRequest.xml 應使用 Custom.ApplicationType 字段，但卻在使用 Microsoft.AzureDevOps.Feedback.ApplicationType 字段。

  <FIELD name="Application Type" refname="Microsoft.AzureDevOps.Feedback.ApplicationType" type="String">
    ...
  </FIELD>

解決範例

FeedbackRequest.xml

  <FIELD name="Application Type" refname="Custom.ApplicationType" type="String">
    ...
  </FIELD>

TF402556：若要妥善定義字段 [refName] ，您必須將其命名為 [fieldName]，並將其類型設定為 [fieldType]。提供的 [refName] 為 [fieldName]，且類型為 [fieldType]。

如果您是在內部部署伺服器並執行 tfsMigrator，則當程式過期且系統欄位未正確定義時，就會產生此錯誤。在大部分情況下，請使用 witadmin /changefield 命令來正確重新命名字段。

保留欄位的範例

保留的系統。XXX 和 Microsoft.AzureDevOps。XXX 欄位需要 name 和 type 值。

欄位	名稱	類型
System.Id	身分證	整數
系統標題	標題	字串
Microsoft.AzureDevOps.Scheduling.StoryPoints	故事點數	雙重
Microsoft.AzureDevOps.Scheduling.RemainingWork	剩餘工時	雙重
Microsoft.AzureDevOps.Scheduling.OriginalEstimate	原始估計值	雙重
Microsoft.AzureDevOps.Scheduling.已完成工作	完成的工作	雙重

錯誤範例

TF402556：若要妥善定義字段 Microsoft.AzureDevOps.TCM.ReproSteps，您必須將它命名為 [重現步驟]，並將其類型設定為 HTML。提供的 Microsoft.AzureDevOps.TCM.ReproSteps 是 My Repro Steps，類型為 HTML。

在 Bug.xml中，友善欄位名稱更改為「我的重現步驟」。

  <FIELD name="My Repro Steps" refname="Microsoft.AzureDevOps.TCM.ReproSteps" type="HTML">
    <HELPTEXT>How to see the bug. End by contrasting expected with actual behavior.</HELPTEXT>
  </FIELD>

解決範例

Bug.xml

  <FIELD name="Repro Steps" refname="Microsoft.AzureDevOps.TCM.ReproSteps" type="HTML">
    <HELPTEXT>How to see the bug. End by contrasting expected with actual behavior.</HELPTEXT>
  </FIELD>

TF402557：下列工作項目類型中字段 [refName] 的定義不一致： [witName]。請確定欄位的所有參考都有相同的 RefName、 Name 和 Type。

FIELD 具有相同易記名稱之欄位的元素定義在 WIT 之間必須一致。檢查以確定 refname、 name、和 type 屬性在命名字段的每個 WIT 定義中都相同。

錯誤範例

Bug.xml

  <FIELD name="Hair Color" refname="MyCompany.CustomFields.HairColor" type="String" reportable="dimension" />

UserStory.xml

  <FIELD name="Hair Color 2" refname="MyCompany.CustomFields.HairColor" type="Double" reportable="dimension" />

請注意， name 和 type 屬性與 Bug.xml 工作項目類型不同。

解決範例

Bug.xml

  <FIELD name="Hair Color" refname="MyCompany.CustomFields.HairColor" type="String" reportable="dimension" />

UserStory.xml

  <FIELD name="Hair Color" refname="MyCompany.CustomFields.HairColor" type="String" reportable="dimension" />

TF402558：欄位 [refName] 的定義與下列範本中欄位的現有定義不一致：[templateNames]。

在您要匯入至 Azure DevOps Services 的程式中，一致地定義字段。系統不允許您匯入進程，其中包含 FIELD 在進程 A 中以一種方式定義的元素，以及在進程 B 中以另一種方式定義。所有 FIELD 元素屬性都必須相符。

範例

處理 A，Bug.xml

  <FIELDS>  
    ...   
    <FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
    ...
  </FIELDS>

進程 B，Bug.xml

  <FIELDS>  
    ...   
    <FIELD name="Bar" refname="MyCompany.CustomFields.Foo" type="Double" reportable="dimension" />
    ...
  </FIELDS>

請注意，不同的值是如何為 name 和 type 屬性指定的。

解決方法

確保相同的 refname 的欄位在所有已匯入或計劃匯入至 Azure DevOps Services 的程序中都定義一致。

TF402559：字段 [refName] 的定義與現有的欄位不一致。 `type`是 [typeName]，但應該是 [typeName]。

編輯包含具名字段的 WIT 檔案，以確保所有 WIT 的指定 type 屬性值都一致。

TF402562：您已為工作項目類型 [witName] 定義 [n] 字段。只允許[fieldLimit]個項目。

您已為工作項目類型 [witName] 定義 [n] 字段。只允許 [fieldLimit]。 在單一 WIT 內，您只能指定指定的欄位數目。

編輯具名 WIT 並移除額外的自定義欄位，以減少允許限制內的欄位總數。

TF402563：您已為所有工作項目類型定義 [n] 字段總計。允許的只有[fieldLimit]。

您已針對流程中定義的所有 WIT 定義了 [n] 欄位。只允許 [fieldLimit] ，其中包含 System。XXX 和 Microsoft.AzureDevOps。XXX 命名空間欄位和自訂欄位。

檢閱 FIELDS 和 WORKFLOW 區段，並判斷要移除的自定義欄位。

TF402566：您已定義工作項目類型 [witName] 的 [n] 字段規則。允許的最大值為 [ruleLimit]。

您已為具名 WIT 定義 [n] 欄位規則，超過任何一個 WIT 允許的欄位規則數目。

請編輯指定的 WIT，並移除多餘的欄位規則，以使欄位總數維持在允許的限制內。

TF402568：您已為工作項目類型 [witName] 定義了 [n] 個欄位`syncnamechanges="true"`。最多允許 64 個。

針對具名 WIT 定義的欄位 syncnamechanges="true" 數目超過允許的限制，其中包括 System。XXX 和 Microsoft.AzureDevOps。XXX 命名空間欄位和自訂欄位。

檢閱 FIELDS 具名 WIT 的區段，並判斷要移除或修改的自定義欄位。

範例

  <FIELD name="Assigned To" refname="System.AssignedTo" type="String" reportable="dimension" syncnamechanges="true" >
    ...
  </FIELD>

TF402569：您在工作項目類型 [witName] 中定義欄位 [fieldName] 的 [n] 值。最多允許[listLimit]。

針對具名 WIT 中具名字段定義的元素數目 LISTITEM 超過允許的限制。

編輯具名 WIT 以減少元素數目LISTITEM ，以免超過允許的最大值。

範例

  <FIELD name="Favorite Color" refname="MyCompany.CustomFields.FavColor" type="String" reportable="dimension">
    <ALLOWEDVALUES>
      <LISTITEM value="Color1" />
      <LISTITEM value="Color2" />
      <LISTITEM value="Color3" />
      . . . 
    </ALLOWEDVALUES>
  </FIELD>

請注意 Bug 和用戶劇本 refname 值不同。

TF402584：不支援欄位規則屬性「for」或「not」。

"for"任何匯入至 Azure DevOps Services 的欄位規則都不支援和 "not" 屬性。
檢查FIELDS和WORKFLOW區段，檢查是否存在"for"和"not"屬性，並將其移除。

錯誤範例

<FIELD name="Title">
  <READONLY for="Dev Team" not="Test Team" />
</FIELD>

解決範例

<FIELD name="Title">
  <READONLY />
</FIELD>

TF402593：欄位[fieldName] 不支援欄位規則。

大部分的 System 和 Microsoft.AzureDevOps 字段都不支持規則。如需詳細資訊，請參閱規則和規則評估。

編輯包含具名字段的工作項目類型定義檔，並移除為其指定的欄位規則。

TF402602：字段 [refName] 必須只有這些值 [values]。

不要改變保留欄位：請勿改變保留命名空間 System.*XXX* 和 Microsoft.AzureDevOps.*XXX*中定義的任何欄位。
定義自訂欄位：若要在挑選清單欄位中有不同的值清單，請定義您自己的自定義欄位。

錯誤範例

Bug.xml已定義優先順序欄位，但值清單與預期值不同。

    <FIELD name="Priority" refname="Microsoft.AzureDevOps.Common.Priority" type="Integer" reportable="dimension">
        <ALLOWEDVALUES expanditems="true">
        <LISTITEM value="0"/>
        <LISTITEM value="1"/>
        <LISTITEM value="2"/>
        </ALLOWEDVALUES>
        <DEFAULT from="value" value="2" />
    </FIELD>

解決範例

已更正的 Bug.xml 文件已包含新欄位

      <FIELD name="Priority" refname="Microsoft.AzureDevOps.Common.Priority" type="Integer" reportable="dimension">
        <HELPTEXT>Business importance. 1=must fix; 4=unimportant.</HELPTEXT>
        <ALLOWEDVALUES expanditems="true">
          <LISTITEM value="1"/>
          <LISTITEM value="2"/>
          <LISTITEM value="3"/>
          <LISTITEM value="4"/>
        </ALLOWEDVALUES>
        <DEFAULT from="value" value="2" />
      </FIELD>

      <FIELD name="Custom Priority" refname="Custom.Priority" type="Integer" reportable="dimension">
        <HELPTEXT>Business importance. 1=must fix; 4=unimportant.</HELPTEXT>
        <ALLOWEDVALUES expanditems="true">
          <LISTITEM value="0"/>
          <LISTITEM value="1"/>
          <LISTITEM value="2"/>
        </ALLOWEDVALUES>
        <DEFAULT from="value" value="2" />
      </FIELD>

VS402504：找不到使用者或群組 [專案]\組名。確認工作項目類型定義中使用的使用者和群組存在。

不支援自定義專案範圍群組。您只能參考帳戶層級的範圍群組。

錯誤範例

Bug.xml參考專案範圍群組。

... "[project]\Organization Leaders"

解決範例

建立新的帳戶（集合）層級群組「組織領導者」，並在 XML 中據以參考。

... "[global]\Organization Leaders"

注意

剛建立的全域群組可能需要一些時間，才能在匯入程式找到它。

TF237094：欄位名稱 '[fieldName]' 已被欄位 '[refName]' 使用，因此無法供其他欄位 '[refName]' 使用。

功能變數名稱已存在於不同欄位上具有相同名稱。變更功能變數名稱。

錯誤範例

TF237094: Field name 'External ID' is used by the field 'Custom.ExistingField.ExternalID', so it cannot be used by the field 'Custom.NewField.ExternalID'.

解決範例

變更 Custom.NewField.ExternalID 的功能變數名稱

<FIELD name="External ID" refname="Custom.NewField.ExternalID" type="string" reportable="dimension" />

工作專案配置

VS403104：工作項目類型 [witName] 會參考所有版面配置中未包含的必要欄位 [refName ]。

如果您在<Layout> 節點中參考的工作項目類型具有必填欄位，但在<WebLayout> 中沒有，則會產生此警告。 <WebLayout>用來修改新表單的配置。如需詳細資訊，請參閱 WebLayout xml 參考。

VS403073：Group 和 `<Group Name>`：違反規則，群組只能包含標籤的單一 HTML 或 WebPage 控制件。

在新窗體配置中，群組只能包含一個 HTMLFieldControl 或 WebPageControl。

錯誤範例

<Section>
    <Group Label="Description:">
        <Control Label="Reason For Request:" Type="HtmlFieldControl" FieldName="System.Description" />
        <Control Label="Business Case For Request:" Type="HtmlFieldControl" FieldName="MB.BusinessCase" />
    </Group>
</Section>

若要解決此錯誤，請建立兩個不同的群組，每個群組各包含一個控件。

解決範例

<Section>
    <Group Label="Reason for Request">
        <Control Label="Reason For Request:" Type="HtmlFieldControl" FieldName="System.Description" />       
    </Group>
    <Group Label="Business Case">
        <Control Label="Business Case For Request" Type="HtmlFieldControl" FieldName="Custom.BusinessCase" />       
    </Group>
</Section>

TF402594：檔案違反架構，發生下列錯誤：元素 'Control' 不能包含子元素 'Link'，因為父元素的內容模型是空的。

錯誤範例

  <Control Type="FieldControl" FieldName="customfield.foo" Label="Foo" LabelPosition="Left">
    <Link UrlRoot="http://www.visualstudio.microsoft.com/team-services/" />
  </Control>

解決範例

  <Control Type="FieldControl" FieldName="System.Title" LabelPosition="Left" Label="Title 1"  
    <LabelText>  
        <Text>  
          <Link UrlRoot="http://www.visualstudio.microsoft.com/team-services/" />  
              Title 2  
        </Text>  
    </LabelText>  
  </Control>

工作流程定義

TF402567：您為工作項目類型 [witName] 定義 [n] 工作流程狀態。允許的最大數量為 [stateLimit]。

您已為具名 WIT 定義 [n] 工作流程狀態，超過任何一個 WIT 允許的工作流程狀態數目。

若要減少允許限制內的狀態總數，請編輯 WORKFLOW 具名 WIT 的區段，並移除額外的 STATE 元素。

TF402578：欄位 [refName] 指定的易記名稱 [friendlyName] 已經由欄位 [refName] 使用。友好名稱在所有欄位定義中都必須是唯一的。

欄位名稱在工作項目類型內必須是唯一的。

錯誤範例

  <FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
  <FIELD name="Foo" refname="MyCompany.CustomFields.Bar" type="String" reportable="dimension" />

請注意，有兩個名為 <FIELD name="Foo" 的欄位。

解決範例

  <FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
  <FIELD name="Bar" refname="MyCompany.CustomFields.Bar" type="String" reportable="dimension" />

TF402579：名稱[friendlyName] 在下列工作項目類型的不同欄位上被多次使用：[witNames]。欄位的名稱在整個專案集合中必須是唯一的。

參考相同 refname="MyCompany.FieldName" 欄位的欄位必須具有相同的易記名稱 FIELD name="fieldname" 值。

錯誤範例

處理 A，Bug.xml

  <FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />

進程 B，Bug.xml

  <FIELD name="Bar" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />

由於這兩個字段共用相同的參考名稱， refname="MyCompany.CustomFields.Foo"因此它們也必須在所有匯入或匯入至 Azure DevOps 的進程上指定相同的易記名稱 <FIELD name="Foo" 。

TF402580：您只能將名稱 [witName] 用於單一工作項目類型。

WIT 易記名稱 WORKITEMTYPE name="Name" 在流程中必須是唯一的。

錯誤範例

我的工作項目A.xml

  <WORKITEMTYPE name="My Work Item" refname="My.MyWorkItemA">

我的工作項目B.xml

  <WORKITEMTYPE name="My Work Item" refname="My.MyWorkItemB">

請注意，WORKITEMTYPE name= 在這兩個工作項目類型中是相同的。

解決範例

我的工作專案A.xml

  <WORKITEMTYPE name="My Work Item A" refname="My.MyWorkItemA">

我的工作項目B.xml

  <WORKITEMTYPE name="My Work Item B" refname="My.MyWorkItemB">

TF402581：您只能將 refname [refName] 用於單一工作項目類型。

WIT 參考名稱 refname="value" 在程式中必須是唯一的。

錯誤範例

Bug.xml

  <WORKITEMTYPE name="Bug" refname="MyCompany.Name">

UserStory.xml

  <WORKITEMTYPE name="User Story" refname="MyCompany.Name">

兩個 refname 值都等於 “MyCompany.Name”

解決範例

Bug.xml

  <WORKITEMTYPE name="Bug" refname="MyCompany.Bug">

UserStory.xml

  <WORKITEMTYPE name="User Story" refname="MyCompany.UserStory">

TF402582：工作項目類型 [witName] 包含不支援的自定義控件 [controlName]。

Azure DevOps Services 不支援自定義控件。檢閱 FORM 具名 WIT 的區段，並移除已定義的任何自定義控件。

錯誤範例

Type="OneViewMultiValueControl" 指定自定義控制件。將這個自定義控件移除或取代為支援的控制件。

    <Group Label="Engineering Alignment">
        <Column PercentWidth="100">
            <Control FieldName="Fabrikam.Content.Product" Type="FieldControl" Label="Product" LabelPosition="Left" />
            <Control FieldName="Fabrikam.Content.Release" Type="FieldControl" Label="Milestone" LabelPosition="Left" />
            <Control FieldName="Fabrikam.Content.Technology" Type="FabrikamMultiValueControl" Label="Technology" LabelPosition="Left" />
        </Column>
    </Group>

測試管理外掛程式錯誤

位於 [測試管理] 資料夾中的TestManagement.xml檔案必須符合定義Test Manager 初始設定中所述的語法和規則。

TF402533：TestManagement 外掛程式中的元素 '[elementName]' 遺漏屬性 `'fileName'` 。

將遺漏的屬性新增至TestManagement.xml檔案中的具名元素。

TF402534：TestManagement 外掛程式包含不支援的工作 '[taskName]'

更正TestManagement.xml檔案中已指定的工作。

錯誤範例

元素 TestResolutionStates 拼寫錯誤。

    <taskXml>
      <TestResolutionStates fileName="Test Management\TestResolutionState.xml" />
    </taskXml>

解決範例

更正拼字錯誤。

    <taskXml>
      <TestResolutionStates fileName="Test Management\TestResolutionState.xml" />
    </taskXml>

共用方式為

解決程式匯入的驗證錯誤

先決條件

資訊訊息 - 不需要採取任何動作

TF402555：刪除欄位 [refName]。

案例範例

TF402591：現有進程 [processName] 中具有參考名稱 [refName] 的欄位無法從 '[name2]' 重新命名為 '[name1]'。

TF402598：刪除工作項目類型 [refName]。

案例範例

TF402601：工作項目類型 [witName] 已從 [name2] 重新命名為 [name1]。

案例範例

其他檔案錯誤

TF402586：剖析檔案時發生錯誤： [錯誤訊息]

TF402594：檔案違反架構，並出現下列錯誤： [錯誤訊息]

錯誤範例

VS412450：[fileName] 中的 Xml 架構驗證錯誤。 [錯誤訊息]

進程範本外掛程式錯誤

VS412457：進程套件中找不到指定的檔案 '[fileName]'。

VS402452：進程範本未指定版本，或指定無效的版本。

錯誤範例

解決範例

VS412453：進程範本 zip 檔案不包含必要的外掛程式 [pluginName]。

錯誤範例

解決範例

VS412454：外掛程式 [pluginName] 包含若干 taskList{1}{2}。 每個外掛程式只允許一個 taskList 。

錯誤範例

解決範例

TF402575：您只能在程式中包含一個類別定義檔案。

錯誤範例

解決範例

TF402576：您只能在程式中包含一個 ProcessConfiguration 定義檔案。

錯誤範例

解決範例

TF402587：遺漏必要的 ProcessConfiguration 檔案。

錯誤範例

解決範例

TF402577： 欄位 [refName] 會指定易記名稱 [friendlyName] ，此名稱已在進程 [processNames] 中的字段 [refName] 使用中。

錯誤範例

解決範例

TF402585：進程範本中缺少必要的 WorkItemTracking 外掛程式參考。

錯誤範例

解決範例

類別

TF402546：類別[categoryName]缺失於類別檔案中。

錯誤範例

解決範例

TF402553：元素 [name] 會參考類別 目錄 [categoryName] ，但類別檔案中未定義。

TF402560：您已定義 [n] 類別。 只允許[nn]。

TF402596：類別 [categoryName ] 不會定義工作項目類型 [witName]。

錯誤範例

解決範例

TF402597：不支援自定義類別 [categoryName] ，因為 ProcessConfiguration 不會參考它。

錯誤範例

解決範例

分類外掛程式的錯誤

TF402511：分類外掛程式包含重複的屬性名稱： [propertyName]。

錯誤範例

解決範例

TF402512：檔案 [fileName] 不存在。

錯誤範例

解決範例

TF402513：分類外掛程式中的 [ pathName] 名稱不符合 TreePath 命名限制。

錯誤範例

解決範例

TF402514：分類外掛程式中的節點結構類型 [structureTypeName] 不被支持。

錯誤範例

解決範例

TF402515：分類外掛程式中的屬性屬性遺失或不受支援。

錯誤範例

解決範例

TF402516：分類外掛程式包含兩個以上的根層級節點，不受支援。

錯誤範例

解決範例

TF402523：在 GroupsandPermissions 外掛程式中的區域或反覆項目路徑 '[pathName]' 在分類外掛程式中缺失。

錯誤範例

解決範例

連結類型

TF402561：您已定義 [n] 自定義連結類型。 只允許[nn]。

TF402583：自定義連結類型 [name] 無效，因為不支援自定義連結類型。

全域清單

TF402601：工作項目類型 [witName] 已從 [name2]* 重新命名為 [name1]。*

VS412454：外掛程式 [pluginName] 包含若干 `taskList`{1}{2}。每個外掛程式只允許一個 `taskList` 。

TF402577：欄位 [refName] 會指定易記名稱 [friendlyName] ，此名稱已在進程 [processNames] 中的字段 [refName] 使用中。

TF402553：元素 [name] 會參考類別目錄 [categoryName] ，但類別檔案中未定義。

TF402560：您已定義 [n] 類別。只允許[nn]。

TF402561：您已定義 [n] 自定義連結類型。只允許[nn]。

TF402564：您已定義 [n] 全域清單。只允許[nn]。

TF402565：您在全域清單 [globalListName] 中定義了 [n] 項目。最多允許 [nn]。

TF402574：ProcessConfiguration 未指定必要的 `TypeField`[typeField]。

TF402588：數個組合待辦項目[待辦項目名稱]已將[待辦項目名稱]定義為其父項。父待辦專案可能只有一個子待辦專案。

402595：定義太多投資組合待辦事項。最多允許5個。

TF402570：您已定義 [n] 工作項目類型。允許的最大數量為 [witLimit]。

TF402573：工作項目類型 WIT 未指定必要的 `refname` 屬性。

TF402600：工作項目類型參考名稱 [refName] 無效。工作項目類型參考名稱必須只包含字母、無空格，以及至少一個句點（.）

TF402540：工作專案類型 [witName] 無效，因為它指定全域清單 [GLOBALLIST]。不支援全域列表。

TF402541：工作項目類型 [witName] 無效，因為它參考全域清單 [globalListName]。不支援全域清單。

TF402544：工作項目類型 [witName] 中定義的欄位 [refName]，需要包含`ALLOWEDVALUES`值的規則，以支援 ProcessConfiguration 中指定的元素 [elementName]。

TF402545：元素 [elementName] 需要您在工作項目類型 [witName] 的定義中包含字段* [fieldName]。*