解決程式匯入的驗證錯誤

發行項
01/10/2024

Azure DevOps Services

重要

匯入程式支援裝載的 XML 進程模型，可讓您透過更新進程範本的 WIT 定義來管理自訂專案。此功能僅適用於已使用 Azure DevOps 數據匯入服務移轉至 Azure DevOps Services 的組織。如果您有關於 Azure DevOps Services 程式自定義的任何問題，請與我們連絡。

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

若要深入瞭解程式模型，請參閱自定義工作追蹤。

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

Process successfully imported

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

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

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

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]'。

更正進程 zip 套件以包含具名檔案。

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 外掛程式參考。

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

錯誤範例

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：類別檔案中遺漏 Category [categoryName]。

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

Bug 類別
程式代碼檢閱要求類別
程式代碼檢閱回應類別
意見反應要求類別
意見反應回應類別
隱藏類型類別目錄
需求類別
共用步驟類別
共用參數類別目錄
工作類別
測試案例類別
測試計劃類別
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]。

檢閱所有元素語句的 CATEGORY Categories.xml 檔案，並判斷您可以刪除哪些專案，以免超過允許的限制。然後，檢閱您的 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.VSTS.Scheduling.Effort" width="50" />
        <Column refname="Microsoft.VSTS.Common.BusinessValue" width="50" />
        <Column refname="Microsoft.VSTS.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 檔案包含容器專案底下properties的第二property name="MSPROJ"個語句。

      <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：不支持分類外掛程式中的 Node StructureType [structureTypeName]。

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

錯誤範例

ProjectLifecycle 拼錯了。

        <Node StructureType="ProjectLifecylce" 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" vaule="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]。

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

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

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

檢閱所有 LINKTYPE 元素語句的 WorkItems.xml 外掛程式檔案。拿掉任何指定自定義連結類型的語句。然後，從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]。

States更新 ProcessConfiguration.xml 檔案中具名元素內的區段，以提供遺漏的中繼州對應或移除額外的對應。

錯誤範例

ProcessConfiguration.xml RequirementBacklog 元素遺漏的 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]。

States更新 ProcessConfiguration.xml 檔案中具名元素內的區段，以提供遺漏的中繼日期對應。

錯誤範例

ProcessConfiguration.xml RequirementBacklog 元素遺漏的 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 元素包含的兩個 metastate 對應 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。

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

錯誤範例

ProcessConfiguration.xml RequirementBacklog 元素會 value="Committed"指定，不過 UserStory.xml 不會將 Committed 定義為 State。

<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 >

解決範例

State已移除 Committed 的專案。

<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]。

STATES檢閱 ProcessConfiguration.xml 檔案中的區段，以取得具名元素，並確定錯誤訊息中列出的每個 sate 都存在，並對應至 metastate。

錯誤範例

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

<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]。

STATES檢閱 ProcessConfiguration.xml 檔案中的區段，以取得具名元素，並移除或更正具名 metastate。

錯誤範例

ProcessConfiguration.xml RequirementBacklog 元素包含的拼錯中繼日期對應 type=Proposed"。

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="Story">
   <States>
      <State value="New" type="Propsed" />
      <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 元素。

檢閱必要TypeField元素的 ProcessConfiguration XML 元素參考。

範例

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

<TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.BacklogPriority" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
    <TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
    <TypeField refname="Microsoft.VSTS.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.VSTS.Common.BusinessValue" width="50" />
      <Column refname="Microsoft.VSTS.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 檔案，以從 PortfolioBacklogs 區段移除額外的PortfolioBacklog元素。

如需詳細資訊，請檢閱 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：必須設定 Project Process 設定才能使用此功能。

這是由來自 TFS 2010 或舊版的範本所造成，在 Project Process 設定存在之前。請嘗試在升級后執行設定功能以解析，或將 ProcessConfiguration XML 檔案新增至進程範本。

工作項目類型

TF402570：您已定義 [n] 工作項目類型。最多允許 [witLimit]。

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

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

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

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

錯誤範例

<WORKITEMTYPE name="Bug">

解決範例

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

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

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

refname編輯具名 WIT 的屬性。

錯誤範例

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

解決範例

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

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

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

refname編輯具名 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 區段。大部分的系統欄位都不允許指定規則。

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

名稱	允許的規則
System.Title	`REQUIRED`, `DEFAULT`
System.Description	`REQUIRED`, `DEFAULT`
System.AssignedTo	`REQUIRED`、、 `DEFAULT`、 `ALLOWEXISTINGVALUEVALIDUSER`
System.ChangedBy	`REQUIRED`、、 `DEFAULT`、 `ALLOWEXISTINGVALUEVALIDUSER`

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

VSTS 不支援全域清單。將所有項目實例 GLOBALLIST 取代為 ALLOWEDVALUES 所有 WIT 定義檔案中的和 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]。不支援全域清單。

VSTS 不支援全域清單。將所有項目實例 GLOBALLIST 取代為 ALLOWEDVALUES 所有 WIT 定義檔案中的和 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]。

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

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

錯誤範例

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

  - OR - 

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

解決範例

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

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

編輯具名 WIT 中的具名字段以提供遺漏 ALLOWEDVALUES 的規則，並參考具名元素以取得詳細數據。

ProcessConfiguration.xml 檔案元素 TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity"需要針對屬於工作類別目錄的所有 WIT 中的 Microsoft.VSTS.Common.Activity 欄位定義選擇清單。

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

如果您已將 Bug 新增至工作類別目錄，您必須確定 Bug.xml 檔案包含具名字段，並指定與 Task.xml 檔案中定義相同的選擇清單。

錯誤範例

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

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

解決範例

更正的 Bug.xml

      <FIELD name="Activity" refname="Microsoft.VSTS.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]。*

針對您在 ProcessConfiguration.xml 檔案區段內指定的每個 field ，您應該在具名 WIT 定義中包含AddPanel對應的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 中，您使用建立。TypeFieldTypeFieldValues 在您的工作項目類型中，您必須參考相同的 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.VSTS.Feedback.ApplicationType 字段。

  <FIELD name="Application Type" refname="Microsoft.VSTS.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.VSTS。XXX 欄位具有必要的名稱和類型值。

欄位	名稱	類型
System.Id	ID	整數
System.Title	標題	String
Microsoft.VSTS.Scheduling.StoryPoints	故事點數	雙重
Microsoft.VSTS.Scheduling.RemainingWork	剩餘工時	雙重
Microsoft.VSTS.Scheduling.OriginalEstimate	原始估計值	雙重
Microsoft.VSTS.Scheduling.CompletedWork	完成的工作	雙重

錯誤範例

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

在 Bug.xml 中，易記功能變數名稱已變更為「我的重現步驟」。

  <FIELD name="My Repro Steps" refname="Microsoft.VSTS.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.VSTS.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>

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

解決方法

確定相同 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.VSTS。XXX 命名空間欄位以及自訂欄位。

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

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

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

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

TF402568：您已針對工作項目類型 [witName] 定義 [n] 字段`syncnamechanges="true"`。最多允許 64 個。

針對具名 WIT 定義的欄位 syncnamechanges="true" 數目超過允許的限制。這包括 System。XXX 和 Microsoft.VSTS。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 區段，以取得和 "not" 屬性的存在"for"，並加以移除。

錯誤範例

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

解決範例

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

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

大部分的 System 和 Microsoft.VSTS 欄位都不支持規則。如需支援欄位規則的完整清單，請參閱規則和規則評估。

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

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

保留命名空間-系統中 VSTS 定義的所有欄位。XXX 和 Microsoft.VSTS。不得改變 XXX-。如果您想要在這些挑選清單欄位中有不同的值清單，請定義您自己的自訂欄位。

錯誤範例

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

      <FIELD name="Priority" refname="Microsoft.VSTS.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.VSTS.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'，因為父元素的 con 帳篷模式 l 是空的。

錯誤範例

  <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 Services 的進程上指定相同的易記名稱 <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>

測試管理外掛程式錯誤

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

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

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

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

更正 TestManagement.xml 檔案中具名的工作。

錯誤範例

元素 TestResolutionStates 拼錯。

    <taskXml>
      <TestResolutionSattes 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：類別檔案中遺漏 Category [categoryName]。

錯誤範例

解決範例

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

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

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

錯誤範例

解決範例

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

錯誤範例

解決範例

分類外掛程式錯誤

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

錯誤範例

解決範例

TF402512：檔案 [fileName] 不存在。

錯誤範例

解決範例

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

錯誤範例

解決範例

TF402514：不支持分類外掛程式中的 Node StructureType [structureTypeName]。

錯誤範例

解決範例

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

錯誤範例

解決範例

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

錯誤範例

解決範例

TF402523：GroupsandPermissions 外掛程式中的區域或反復項目路徑 '[pathName]' 遺漏了分類外掛程式。

錯誤範例

解決範例

連結類型

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

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

全域清單

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

TF402565：您已在全域清單 [globalListName] 中定義 [n] 專案。 最多允許 [nn]。

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：數個組合待辦專案 [待辦專案名稱] 已將 [待辦專案名稱] 定義為其父項。父待辦專案可能只有一個子待辦專案。

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

402595：定義太多組合待辦專案。最多允許5個。

TF400572：必須設定 Project Process 設定才能使用此功能。

TF402570：您已定義 [n] 工作項目類型。最多允許 [witLimit]。

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

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

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

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

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

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