次の方法で共有


プロセス インポートの検証エラーを解決する

Azure DevOps Services

重要

インポート プロセスでは、ホストされた XML プロセス モデルがサポートされています。これにより、プロセス テンプレートの WIT 定義を更新してカスタマイズを管理できます。 この機能は、Azure DevOps データ インポート サービスを使用してAzure DevOps サービスに移行された組織でのみ使用できます。

継承プロセス モデルを使用する場合は、継承されたプロセスを作成することで、ユーザー インターフェイスを使用して作業の追跡をカスタマイズします。 オンプレミスの XML プロセス モデルを使用する場合は、プロセス テンプレートをカスタマイズできます。プロセス テンプレートを アップロードまたはダウンロードし 、 プロセス テンプレートをカスタマイズします。

詳細については、「作業追跡をカスタマイズする」を参照してください。

プロセスのインポート中にプロセスが検証され、カスタム プロセスでシステムが正常に動作することを確認します。 プロセスが検証に失敗した場合、エラー メッセージの一覧が表示されます。

プロセスが正常にインポートされました

インポート プロセスを試したときに検証エラーが発生した場合は、インポートを再試行する前にエラーを解決してください。 各エラーには、特定の検証エラーの詳細と、その修正方法に関するガイダンスを示すリンクがあります。 受信したメッセージに対して提供された解決策を適用し、更新されたファイルを zip 圧縮して、インポート操作を再試行します。

カスタマイズを開始したばかりの場合は、提供された検証規則を確認します。

前提 条件

特定のビジネス要件に合わせてAzure Boardsを調整する方法については、「構成とカスタマイズAzure Boardsを参照してください。

カテゴリ 必要条件
アクセス許可 - プロセスを作成、削除、または編集するには、プロジェクト コレクション管理者のメンバー グループまたは特定のコレクション レベルのアクセス許可 プロセスの作成、プロセスの削除、プロセスの編集、または [を許可] に設定されている 組織からフィールドを削除します。 詳細については、「 継承されたプロセスをカスタマイズする」を参照してください。
- ボードを更新するには、チーム管理者、または プロジェクト管理者 グループのメンバー。
アクセス - Basic または下位のアクセス権を持っている場合でも、他のユーザーがアクセス許可を付与した場合でもプロセスを変更できます。
- 既存の作業項目の種類を更新および変更するには:プロジェクトのメンバー。
プロジェクト プロセス モデル - プロジェクトを含むプロジェクト コレクションの 継承プロセス モデルをとして使用します。
- データを Azure DevOps Services に移行するには、Team Foundation Server Database Import Service を使用します。
知識 - カスタマイズ モデルとプロセス モデルに関する知識。

AI を使用してプロセス インポート エラーのトラブルシューティングを行う

次の例では、Copilot Chat のプロンプトを使用して、プロセス インポートの検証エラーと XML 構成の問題のトラブルシューティングを行います。 このプロンプトをコピーして Copilot チャットに貼り付け、プレースホルダーを特定の情報に置き換えます。

最適な AI 支援を得る場合は、エラー コード (TF ######)、影響を受けるファイル名、作業項目の種類名、検証エラーに記載されているフィールド参照名などの具体的な詳細を含めます。

'私はこのAzure DevOpsプロセスのインポートエラーを受け取っています: [ここにあなたのエラーメッセージを貼り付けます]

インポートの詳細を処理する:

  • エラー コード: [ERROR CODE like TF402###]
  • 影響を受けるファイル: [Bug.xml、ProcessConfiguration.xmlなどの XML ファイル名]
  • 作業項目の種類: [WIT NAME (該当する場合)]
  • フィールド参照名: [FIELD REFNAME (該当する場合)]
  • カスタム名前空間: [該当する場合はカスタム名前空間]

この問題のトラブルシューティングに役立ちますか? 段階的な指示を提供してください:

  1. 検証エラーの根本原因を特定する
  2. XML 構成またはプロセス定義を修正する
  3. 変更を確認して検証の問題を解決する

コンテキスト: これは、Hosted XML プロセス モデルを使用してカスタム プロセス テンプレートを Azure DevOps Services にインポートするためのものです。 このエラーは、作業項目の種類の定義、フィールドの構成、プロセス構成、カテゴリ、または XML スキーマ違反に関連している可能性があります。 `

Copilotは AI を活用しているため、驚きや間違いが起こりうる可能性があります。 詳細については、「Copilot一般的な使用に関する FAQを参照してください。

情報メッセージ - アクションは必要ありません

TF402555: フィールド [refName] が削除されます。

インポートするプロセスには、更新中のプロセスに名前付きフィールドが含まれていないため、更新操作の一部として削除されます。

シナリオの例

  1. Bug.xml 作業項目にカスタム フィールドを追加する
    <FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
    
  2. インポート プロセス
  3. Bug.xml からフィールドを削除する
  4. 更新されたプロセスをインポートする

削除するフィールドに関する情報メッセージが表示されます。
TF402555: Field MyCompany.CustomFields.Foo will be deleted

TF402591: 参照名 [refName] のフィールドは、既存のプロセス [processName] の '[name2]' から '[name1]' に名前を変更できません。

インポートするプロセスには、現在のプロセスで同じ を使用する名前が変更されたフィールドが含まれています。

フィールド名の名前を変更することはできません。

TF402598: 作業項目の種類 [refName] が削除されます。

更新するプロセスに、現在のプロセスに存在する名前付き WIT は含まれません。 既存のプロセスの更新の一環として、システムは現在のプロセスから名前付き WIT を削除します。

シナリオの例

  1. "LSI" という名前の新しい作業項目の種類を作成します
    <WORKITEMTYPE name="LSI" refname="My.LSI">  
    
  2. インポート プロセス
  3. プロセスから LSI 作業項目の種類を削除する
  4. 更新されたプロセスをインポートする

削除に関する情報メッセージが表示されます。
TF402598: Work item type My.LSI will be deleted

TF402601: 作業項目の種類 [witName] の名前が [name2] から [name1] に変更されます。

このプロセスには、名前が変更された WIT が含まれています。 WIT は、既存のプロセスで名前が変更されます。
更新するプロセスには、現在のプロセスの名前から名前が変更された WIT が含まれています。
既存のプロセスの更新の一環として、現在のプロセスで WIT の名前が変更されます。 プロセスを参照する既存のプロジェクトのすべての作業項目の名前も変更されます。

シナリオの例

  1. "LSI" という名前の新しい作業項目の種類を作成します
    <WORKITEMTYPE name="LSI" refname="My.LSI">  
    
  2. インポート プロセス
  3. LSI 作業項目の種類の名前をライブ サイト インシデントに変更する
    <WORKITEMTYPE name="Live Site Incident" refname="My.LSI">  
    
  4. 更新されたプロセスをインポートする

名前を変更する WIT に関する情報メッセージが表示されます。
TF402601: Work item type My.LSI will be renamed to 'Live Site Incident' from 'LSI'

その他のファイル エラー

TF402586: エラー解析ファイル: [エラー メッセージ]

XML 構文の形式が正しくない場合、ファイルの解析エラーが発生する可能性があります。 終了タグ、引用符、角かっこ ( または ) が見つからない場合、解析ファイル エラーが発生する可能性があります。

エラー メッセージから、形式が正しくない XML のソースを特定して修正します。

TF402594: ファイルがスキーマに違反し、次のエラーが発生しました: [エラー メッセージ]

プロセス zip ファイル内の各 XML ファイルは、指定されたスキーマに準拠している必要があります。 スキーマ違反エラーは、XML ファイル内のカスタム XML タグまたは属性が原因です。 エラー メッセージを読んでスキーマ違反の原因を特定し、それに応じて修正します。

作業項目追跡のスキーマ定義では、 要素内のすべての子要素はキャメル ケースとして、他のすべての要素は大文字として定義されます。 種類の定義ファイルの検証中にエラーが発生した場合は、要素の大文字と小文字の構造を確認してください。 また、開始タグと終了タグの大文字と小文字の構造は、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 ファイル (多くの場合、サブフォルダー内) を参照します。 一般には、プラグインごとに 1 つのタスク グループを指定します。

ProcessTemplate.xml 定義ファイルは、構文と規則に準拠している必要があります。

VS412457: 指定されたファイル '[fileName]' がプロセス パッケージに見つかりませんでした。

プロセス zip パッケージを、名前付きファイルを含むよう修正します。

VS402452: プロセス テンプレートでバージョンが指定されていないか、無効なバージョンが指定されました。

バージョンを指定するには、ProcessTemplate.xml ファイルを編集します。

エラーの例

ProcessTemplate.xmlファイルは、ロックされたプロセスであるアジャイル プロセスと同じ 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 プラグインは を指定しますが、WorkItem Tracking\TypeDefinitions フォルダーには追加されません。

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

解決策の例

Epic.xml ファイルを WorkItem Tracking\TypeDefinitions フォルダーに追加します。

VS412454: プラグイン [pluginName] には、いくつかの 、 が含まれています。 プラグインごとに 1 つの のみを使用できます。

名前付きプラグインのProcessTemplate.xml ファイルを修正して、定義されている 要素の数を減らします。

エラーの例

WorkItemTracking プラグインには、2 つの ステートメントが含まれています。

    <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: プロセスに含めることが可能なカテゴリ定義ファイルは 1 つだけです。

エラーの例

WorkItems.xml ファイルには、2 つの ステートメントが含まれています。

  <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 ファイルは、1 つの ステートメントのみを含むよう更新されます。

  <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 定義ファイルは 1 つだけです。

エラーの例

WorkItems.xml ファイルには、重複した ステートメントが含まれています。

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

解決策の例

WorkItems.xml ファイルは、1 つの ステートメントのみを含むよう更新されます。

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

TF402587: 必須の ProcessConfiguration ファイルがありません。

WorkItems.xml ファイルは、アップロードする ProcessConfiguration ファイルを指定します。 ファイルが指定されていないか、古い仕様が含まれているか、指定されたファイルがテンプレートに見つからないか、またはフォルダー/ファイル名が正しくありません。

エラーの例

指定された構成が古く、Process フォルダーに含まれていない 2 つのファイルを指定します。

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

解決策の例

正しい構成 ステートメントが含まれるよう、WorkItems.xml ファイルが更新されます。

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

TF402577: フィールド [refName] は、プロセス [processNames] フィールド [refName] で既に使用されているフレンドリ名 [friendlyName] を指定します。

フレンドリ名は、Azure DevOps サービスにインポートされるすべてのプロセスに対して指定されたすべての WIT 定義のすべてのフィールド定義で一意である必要があります。

名前付きプロセスには、フレンドリ名を使用するフィールドを定義する WIT が含まれています。

[refName] を含むプロセス zip ファイル内の WIT 定義を変更し、別のフレンドリ名を指定するか、使用中の既存のフィールドと一致させます。

エラーの例

UserStory WIT 定義には、フレンドリ名が「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 ファイルの セクションで、 プラグインを指定する必要があります。

エラーの例

ProcessTemplate.xml ファイルの セクションに プラグインがありません。

   <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 定義ファイルは、構文と規則に準拠している必要があります。

TF402546: カテゴリ [categoryName] がカテゴリ ファイルに表示されません。

ProcessConfiguration.xml ファイルで参照されるすべてのカテゴリは、Categories.xml ファイルで定義する必要があります。 さらに、システムでは、Categories.xml ファイルに次のカテゴリの定義が含まれている必要があります。

  • バグ カテゴリ
  • コード レビュー要求カテゴリ
  • コード レビュー応答カテゴリ
  • フィードバック要求カテゴリ
  • フィードバック応答カテゴリ
  • 非表示の型のカテゴリー
  • 要件カテゴリ
  • 共有ステップ カテゴリー
  • 共有パラメーター カテゴリ
  • タスク カテゴリ
  • テスト ケース カテゴリ
  • テスト計画カテゴリ
  • テスト スイート カテゴリ

Categories.xml ファイルを更新して、欠落している [name] カテゴリを定義します。

エラーの例

ProcessConfiguration はエピック カテゴリを参照しますが、Categories.xml 定義ファイルにはありません。

解決策の例

エピック カテゴリがカテゴリ ファイルに追加されます。

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

TF402553: カテゴリ ファイルで定義されていない要素 [name] 参照カテゴリ [categoryName]。

Categories.xml ファイルを更新して、欠落している [categoryName] カテゴリを定義します。

TF402560: [n] カテゴリを 定義しました。 [nn] のみが許可されます。

すべての 要素ステートメントの Categories.xml ファイルを確認し、許可された制限を超えないように削除できるステートメントを決定します。 次に、ProcessConfiguration.xml ファイルを確認して、削除されたカテゴリを参照する値を置き換えます。

TF402596: カテゴリ [categoryName] では、作業項目の種類 [witName] が定義されません。

カテゴリは、/WorkItem Tracking/TypeDefinitions フォルダーで定義され、WorkItems.xml プラグイン ファイルにアップロードするタスクとしてリストされている WIT を参照する必要があります。
/WorkItem Tracking/TypeDefinitions フォルダーに含まれていない WIT への参照については、Categories.xml ファイルを確認します。

エラーの例

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 定義ファイルで定義されています。

解決策の例

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

参照アーティクル:

  • プロセス構成 XML 要素のリファレンス

分類プラグイン エラー

Classification.xml 定義ファイルは、構文と規則に準拠している必要があります。

TF402511: 分類プラグインには、重複するプロパティ名: [propertyName] が含まれています。

エラーの例

Classification.xml ファイルには、 コンテナー要素の下に 2 つ目の ステートメントが含まれています。

      <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 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] はサポートされていません。

属性では、 と の値のみを使用できます。
指定した 要素を確認し、サポートされていない属性を削除します。

エラーの例

のスペルが間違って表示されます。

        <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: 分類プラグインのプロパティ属性が見つからないか、サポートされていません。

要素では、、、および の各属性のみを使用できます。
指定した 要素を確認し、サポートされていない属性を削除します。

エラーの例

属性のスペルが間違っています。

       <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: 分類プラグインには、サポートされていない 2 つ以上のルート レベルのノードが含まれています。

指定した 要素を確認し、追加のルート レベル ノードを削除します。

エラーの例

Classification.xml ファイルには、 コンテナー要素の下に 2 つ目の ステートメントが含まれています。

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

解決策の例

2 番目のステートメントを削除します。

      <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.xml は、イテレーションを指定します。

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

Note

現在のインポート プロセスでは、カスタム リンクの種類はサポートされていません。

すべての 要素ステートメントについて、WorkItems.xml プラグイン ファイルを確認します。 許可されている制限を超えないように、カスタム リンクの種類に関連付けられているステートメントを削除します。 次に、対応するリンクの種類の定義ファイルを LinkTypes フォルダーから削除します。

また、 セクションの下の セクション内の WIT 定義に追加したカスタム リンクの種類への参照を削除します。

すべての 要素ステートメントについて、WorkItems.xml プラグイン ファイルを確認します。 カスタム リンクの種類を指定するステートメントをすべて削除します。 次に、対応するリンクの種類の定義ファイルを LinkTypes フォルダーから削除します。

WorkItems.xml プラグイン ファイル内の次の 要素ステートメントは有効です。

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

グローバル リスト

Note

現在のインポート プロセス機能では、グローバル リストはサポートされていません。

TF402564: [n] グローバル リストを定義しました。 [nn] のみが許可されます。

カスタム プロセス テンプレートで定義されている 1 つ以上の WIT に、 要素が含まれています。 WIT 定義ファイルを検索し、 要素を または 要素に置き換えます。

TF402565: グローバル リスト [globalListName] で [n] 項目を定義しました。 最大 [nn] が許可されます。

名前付き 要素に含まれる項目が、許可されている数を超えています。 要素に含まれるリスト項目の数を減らすか、グローバル リストを 2 つ以上の要素に分割して、どちらのリストも許可される項目の最大数を超えないようにします。

プロセス構成

ProcessConfiguration.xml 定義ファイルは、「ProcessConfiguration XML 要素リファレンス」で説明されている構文と規則に準拠したものである必要があります。

TF402543: 要素 [elementName] では、1 つのワークフロー状態を metastate [metastateName] にマップする必要があります。

ProcessConfiguration.xml ファイル内の名前付き要素内の セクションを更新して、不足しているメタステート マッピングを提供するか、追加のマッピングを削除します。

エラーの例

ProcessConfiguration.xml 要素に、のメタステート マッピングがありません。

<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] に対して、少なくとも 1 つの状態をメタステート [metastateName] にマップする必要があります。

名前付き WIT に対して定義されている 状態を確認し、ProcessConfiguration.xml ファイル内の名前付き要素内の セクションを更新して、名前付き WIT に欠落しているメタステート マッピングを提供します。

TF402548: 要素 [elementName] では、最低 1 つのワークフロー状態をメタステート [metastateName] にマップする必要があります。

不足しているメタステート マッピングを提供するには、ProcessConfiguration.xml ファイル内の名前付き要素内の セクションを更新します。

エラーの例

ProcessConfiguration.xml 要素に、のメタステート マッピングがありません。

<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] の複数のメタステート マッピングが含まれています。

メタステート値を複数のワークフロー状態にマップすることはできません。

エラーの例

ProcessConfiguration.xml 要素には、のメタステート マッピングが 2 つ含まれています。

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

解決策の例

メタステート マッピングが修正されました。

<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]のメタステートにマップするため、必須です。

不足している と 要素を追加するには、ProcessConfiguration.xml ファイルまたは名前付き WIT の セクションを修正します。

エラーの例

ProcessConfiguration.xml 要素は を指定しますが、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 >

解決策の例

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]、[stateNames] の状態に対して 1 つの状態をメタステート [metastateName] にマップする必要があります。

名前付き要素の ProcessConfiguration.xml ファイルの セクションを確認し、エラー メッセージに一覧表示されている各 sate が存在し、メタステートにマップされていることを確認します。

エラーの例

ProcessConfiguration.xml 要素には、状態 がありません。これは、 作業項目の種類に存在します。 にマップされた リストに含まれている必要があります。

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

解決策の例

メタステート マッピングが修正されました。

<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] は、サポートされていないメタステート [metastateName] を指定します。

名前付き要素の ProcessConfiguration.xml ファイルの セクションを確認し、名前付きメタステートを削除または修正します。

エラーの例

ProcessConfiguration.xml 要素には、 のスペルが間違ったメタステート マッピングが含まれています。

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

解決策の例

メタステート マッピングが修正されました。

<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] が指定されていません。

ProcessConfiguration.xml ファイルを編集して、欠落している名前付き 要素を追加します。

必要な 要素に対して を確認します。

Scrum プロセスでは、次の 要素を指定します。 これらの要素のいずれかが見つからない場合は、エラー 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: [backlogNames][backlogName] を親として定義したポートフォリオ バックログがいくつかあります。 親バックログには、子バックログが 1 つだけ含まれる場合があります。

1 つの親バックログにマップできるのは、1 つの子ポートフォリオ バックログだけです。

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>

解決策の例

エピック バックログをポイントするには、フィーチャー バックログの親を変更します。

  <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: ポートフォリオ バックログ [backlogName] は、未定義の親ポートフォリオ バックログ [backlogName] を参照します。

ProcessConfiguration.xml 定義には、未定義のポートフォリオ バックログを参照する 値が含まれています。

エラーの例

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

解決策の例

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: 複数のポートフォリオ バックログ [Backlog 1, Backlog 2] は、その親を定義しません。

1 つのポートフォリオ バックログ、最上位のバックログのみが親に関連付けられていない場合があります。 他のすべてのバックログには、 属性と値を含める必要があります。

解決策の例

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

402595: 定義されているポートフォリオ バックログが多すぎます。 許可されている最大数は 5 個です。

ProcessConfiguration.xml ファイルを編集して、 セクションから追加の 要素を削除します。

詳細については、 「ProcessConfiguration XML 要素リファレンス」を参照してください。

TF400506: この要素は、バグまたは欠陥を表す作業項目の状態を定義します。

このエラーは、 セクションが正しく構成されていない場合に発生します。 に含まれる作業項目の種類に対して定義された各状態は、 セクションで定義されている一連の状態値に存在する必要があります。 たとえば、バグ作業項目の種類に定義されている作業項目の種類 (新規、承認済み、コミット済み、完了) に対して次の状態が定義されている場合、 セクションは次のように構成する必要があります。

  <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 で定義されている状態のいずれかに一致する初期状態の値をサポートする必要があります。

このエラーは、 に含まれる作業項目の種類が、ProcessConfiguration XML ファイルの セクションに含まれていない初期状態を指定した場合に発生します。 名前付き作業項目の種類の XML 定義ワークフローの状態を修正するか、不足している状態を含むように セクションを更新します。

詳細については、 「ProcessConfiguration XML 要素リファレンス」を参照してください。

TF400572: この機能を使用するには、プロジェクト プロセス設定を構成する必要があります。

このエラーは、プロジェクト プロセス設定が存在する前の古いテンプレートに起因します。 ProcessConfiguration XML ファイルをプロセス テンプレートに追加してみてください。

作業項目の種類

TF402570: [n] 作業項目の種類を定義しました。 最大 [witLimit] が許可されます。

プロセスで許可されるさらに多くの WIT を定義しました。 WorkItems.xml ファイルを確認し、それに含まれる ステートメントの数を減らし、関連付けられている WIT 定義ファイルをプロセスから削除します。

TF402573: 作業項目の種類 WIT では、必須の 属性が指定されていません。

作業項目の種類 (バグ、ユーザー ストーリー、タスクなど) には、 属性が必要です。 refname 値は一意である必要があり、予約済みの名前空間を含めることはできません。 namespaces-System.XXX および Microsoft.AzureDevOps.XXX はAzure DevOpsによって予約されます。

エラーの例

<WORKITEMTYPE name="Bug">

解決策の例

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

TF402599: 作業項目の種類 refname [refName] は、許可されていない名前空間 [namespace] を使用しているため無効です。

カスタム フィールドと WIT の参照名では、予約済みの名前空間 (System) を使用できません。XXX と Microsoft.AzureDevOps。XXX。

名前付き WIT の 属性を編集します。

エラーの例

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

解決策の例

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

TF402600: 作業項目の種類の参照名 [refName] が無効です。 作業項目の種類の参照名には、文字のみを含め、スペースは使用せ須、少なくとも 1 つのピリオド (.) を含む必要があります。

WIT 参照名は、確立された名前付け規則に従う必要があります (文字のみ、スペースなし、少なくとも 1 つのピリオド (.) を使用する)。

名前付け要件を満たすように、名前付き WIT の 属性を編集します。

エラーの例

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

解決策の例

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

作業項目フィールド

TF402538: フィールド ルール [ruleName] はサポートされていません。

WIT 定義を編集して、名前付き規則を削除します。 Azure DevOps へのインポートがサポートされていないルールは、MATCHCANNOTLOSEVALUEPROHIBITEDVALUES、およびNOTSAMEASです。

TF402539: フィールド [refName] では、次の規則のみが許可されます: [ruleNames]。

名前付きフィールドの WIT 定義を編集し、非制限ルールを削除します。 と の両方のセクションを確認します。 ほとんどのシステム フィールドでは、ルールの指定は許可されていません。

システム フィールドで使用する有効なルール

名前 許可されるルール
System.Title
System.Description
System.AssignedTo 、、、
System.ChangedBy 、、、

TF402540: 作業項目の種類 [witName] は、グローバル リスト [GLOBALLIST]を指定しているため無効です。 グローバル リストはサポートされていません。

グローバル リストは、Azure DevOpsではサポートされていません。 要素のすべてのインスタンスを、すべての WIT 定義ファイル内の および 要素に置き換えます。

エラーの例

<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 定義ファイル内の および 要素に置き換えます。

エラーの例

<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.AzureDevOps.XXX-はAzure DevOpsで予約されています。 カスタム フィールドと種類の参照名では、これらの名前空間を使用できません。

このエラーを解決するには、表示される WIT 定義ファイル内の名前付きフィールドの 属性の名前を変更します。

エラーの例

<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: 作業項目の種類 [refName] で定義されているフィールド [witName] には、ProcessConfiguration で指定された要素 をサポートする値を含む ルールが必要です。

名前付き WIT の名前付きフィールドを編集して、不足している ルールを指定し、名前付き要素を参照して詳細を確認します。

ProcessConfiguration.xml ファイル要素 、タスク カテゴリに属するすべての 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] を含める必要があります。

ProcessConfiguration.xml ファイルの セクション内で指定する各 の名前付き WIT 定義に、対応する 要素を含める必要があります。
また、名前付き WIT の セクション内に 要素を含める必要があります。

エラーの例

ProcessConfiguration では、2 つのユーザー設定フィールドを指定します。 ただし、これらのフィールドは、UserStory.xml ファイルでは定義されていません。

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

解決策の例

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] (フィールド refname [refName]) を定義する必要があります。

ProcessConfiguration で、 を含む を作成しました。 作業項目の種類で、同じ を参照します。

エラーの例

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 を実行している場合、プロセスが古く、システム フィールドが正しく定義されていない場合に、このエラーが生成されます。 ほとんどの場合、 コマンドを使用してフィールドの名前を適切に変更します。

予約フィールドの例

予約済みシステム。XXX と Microsoft.AzureDevOps。XXX フィールドには、 値と 値が必要です。

フィールド 名前 タイプ
System.Id ID 整数
System.Title Title String
Microsoft.AzureDevOps.Scheduling.StoryPoints ストーリー ポイント Double
Microsoft.AzureDevOps.Scheduling.RemainingWork 残存作業 Double
Microsoft.AzureDevOps.Scheduling.OriginalEstimate 最初の見積もり Double
Microsoft.AzureDevOps.Scheduling.CompletedWork 実績作業 Double

エラーの例

TF402556: フィールド Microsoft.AzureDevOps.TCM.ReproSteps を適切に定義するには、Repro Steps という名前を付け、その型を HTML に設定する必要があります。 Microsoft.AzureDevOps.TCM.ReproSteps が My Repro Steps であり、種類が HTML である場合。

Bug.xmlで、フレンドリ フィールド名が "My Repro Steps" に変更されました。

  <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: 次の作業項目の種類で、フィールド [witName] に一貫性のない定義が存在します: [refName]。 フィールドへのすべての参照が同じ RefName、 Name、および Type であることを確認します。

同じフレンドリ名を持つフィールドの要素定義は、WIT 間で一貫している必要があります。 名前付きフィールドの 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" />

属性と属性は、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] の 定義が既存のフィールドと矛盾しています。 は [typeName] ですが、[typeName] である必要があります。

名前付きフィールドを含む WIT ファイルを編集して、指定した 属性値がすべての WIT で一貫していることを確認します。

TF402562: 作業項目の種類 [witName] に [n] フィールドを定義しました。 [fieldLimit] のみが許可されます。

任意の 1 つの WIT で使用できるフィールドの数を超える名前付き WIT の [n] フィールドを定義しました。

名前付き WIT を編集し、追加のカスタム フィールドを削除して、許可される制限内のフィールドの合計数を減らします。

TF402563: すべての作業項目の種類に対して [n] フィールドの合計を定義しました。 [fieldLimit] のみが許可されます。

プロセスで定義されているすべての WIT に [n] フィールドを定義しました。 System を含む [fieldLimit] のみが許可されます。XXX と Microsoft.AzureDevOps。XXX 名前空間フィールドとユーザー設定フィールド。

と セクションを確認し、削除するカスタム フィールドを決定します。

TF402566: 作業項目の種類 [witName] に [n] フィールド ルールを定義しました。 許可される最大値は [ruleLimit] です。

任意の 1 つの WIT に対して許可されるフィールド ルールの数を超える名前付き WIT に対して [n] フィールド ルールを定義しました。

名前付き WIT を編集し、追加のフィールド ルールを削除して、許可される制限内のフィールドの合計数を減らします。

TF402568: 作業項目の種類 [witName] にを持つ [n] フィールドを定義しました。 最大 64 個が許可されます。

名前付き WIT に対して が定義されているフィールドの数が、System を含む許可される制限を超えています。XXX と Microsoft.AzureDevOps。XXX 名前空間フィールドとユーザー設定フィールド。

名前付き WIT の セクションを確認し、削除または変更するカスタム フィールドを決定します。

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

TF402569: 作業項目の種類 [witName] でフィールド [fieldName] に [n] 値を定義しました。 最大 [listLimit] が許可されます。

名前付き WIT 内の名前付きフィールドに定義されている 要素の数が、許可されている制限を超えています。

許可された最大値を超えないように、名前付き WIT を編集して 要素の数を減らします。

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

バグとユーザー ストーリー 値が異なっています。

TF402584: フィールド ルール属性 "for" または "not" はサポートされていません。

"for" 属性と "not" 属性は、Azure DevOps Services へのインポートに関するフィールド ルールではサポートされていません。
および のセクションで、 と 属性が存在することを確認し、それらを削除します。

エラーの例

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

解決策の例

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

TF402593: フィールド [fieldName] に対して、フィールド ルールはサポートされていません。

ほとんどの System フィールドと Microsoft.AzureDevOps フィールドはルールをサポートしていません。 詳細については、「規則と規則の評価」を参照してください。

名前付きフィールドを含む作業項目タイプの定義ファイルを編集して、指定されたフィールドルールを削除します。

TF402602: フィールド [refName] には、 これらの値が必要です。

  • 予約済みフィールドを変更しない: 予約済み名前空間 および で定義されているフィールドは変更しないでください。
  • ユーザー設定フィールドの定義: 選択リスト フィールドに値の異なるリストを設定するには、独自のユーザー設定フィールドを定義します。

エラーの例

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: ユーザーまたはグループが見つかりません [project]\Group Name。 作業項目の種類の定義で使用されているユーザーとグループが存在することを確認します。

カスタム プロジェクト スコープ グループはサポートされていません。 アカウント レベルのスコープ グループのみを参照できます。

エラーの例

Bug.xmlは、プロジェクト スコープ グループを参照しています。

... "[project]\Organization Leaders"

解決策の例

新しいアカウント (コレクション) レベル グループ "Organization Leaders" を作成し、それに応じて XML で参照します。

... "[global]\Organization Leaders"

Note

新しく作成されたグローバル グループは、インポート プロセスで検索されるまでに少し時間がかかる場合があります。

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] を 参照します。

この警告は、作業項目の種類に必須フィールドがあり、 ノードで参照されているが、 ではない場合に生成されます。 は、新しいフォームのレイアウトを変更するために使用されます。

VS403073: グループ & : グループに含めることができるのは、ラベル コントロールの前に 1 つの HTML コントロールまたは WebPage コントロールしか含めできないという規則に違反します。

新しいフォーム レイアウトでは、1 つの 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>

このエラーを解決するには、それぞれ 1 つのコントロールを含む 2 つの個別のグループを作成します。

解決策の例


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

エラーの例

  <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] が許可されます。

任意の 1 つの WIT に対して許可されているワークフロー状態の数を超える名前付き WIT に対して [n] ワークフロー状態を定義しました。

許可される制限内の状態の合計数を減らすには、名前付き WIT の セクションを編集し、追加の 要素を削除します。

TF402578: フィールド [refName] は、フィールド [refName] で既に使用されているフレンドリ名 [friendlyName] を指定します。 フレンドリ名は、すべてのフィールド定義で一意である必要があります。

フィールド名は、作業項目の種類内で一意である必要があります。

エラーの例

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

という名前のフィールドが 2 つあることに注意してください。

解決策の例

  <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]。 フィールドの名前は、プロジェクト コレクション全体で一意である必要があります。

同じ を参照するフィールドには、同じフレンドリ名 値が必要です。

エラーの例

プロセス 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] は、1 つの作業項目の種類にのみ使用できます。

WIT フレンドリ名 は、プロセス内で一意である必要があります。

エラーの例

作業項目の A.xml

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

作業項目の B.xml

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

両方の作業項目の種類で が同じであることに注目してください。

解決策の例

作業項目の 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] は、1 つの作業項目の種類にのみ使用できます。

WIT 参照名 は、プロセス内で一意である必要があります。

エラーの例

Bug.xml

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

UserStory.xml

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

両方の 値が "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 ではサポートされていません。 名前付き WIT の セクションを確認し、定義されているカスタム コントロールをすべて削除します。

エラーの例

はカスタム コントロールを指定します。 このカスタム コントロールを削除するか、サポートされているコントロールに置き換えます。

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