Compartilhar via


Resolver erros de validação para importação de processo

Serviços do Azure DevOps

Importante

O processo de importação dá suporte ao modelo de processo XML hospedado, que permite gerenciar personalizações por meio da atualização da definição de WIT de um modelo de processo. Esse recurso só está disponível para organizações migradas para o Azure DevOps Services usando o serviço de importação de dados do Azure DevOps.

Se você usar o modelo de processo de herança, poderá personalizar o acompanhamento de trabalho por meio da interface do usuário, criando um processo herdado. Se você usar o modelo de processo XML local, poderá personalizar um modelo de processo: carregar ou baixar um modelo de processo e personalizar um modelo de processo.

Para obter mais informações, consulte Personalizar acompanhamento de trabalho.

Durante a importação do processo, ele é validado para garantir que o sistema funcione conforme o esperado para o processo personalizado. Você receberá uma lista de mensagens de erro se o processo falhar na validação.

Processo importado com êxito

Se você recebeu um erro de validação ao tentar importar o processo, resolva o erro antes de tentar novamente a importação. Cada erro tem um link para saber mais sobre a falha de validação específica e diretrizes sobre como corrigi-la. Aplique a correção de resolução fornecida para a mensagem que você recebeu, feche os arquivos atualizados e repita a operação de importação.

Se você está apenas começando sua personalização, examine as regras de validação fornecidas.

Pré-requisitos

Para obter diretrizes sobre como personalizar os Conselhos do Azure para se alinharem aos seus requisitos de negócios específicos, consulte Configurar e personalizar os Quadros do Azure.

Categoria Requisitos
Permissões – Para criar, excluir ou editar um processo: membro do grupo Administradores de Coleção de Projetos ou permissões específicas no nível da coleção Criar processo, Excluir processo, Editar processoou Excluir um campo da organização definido como Permitir. Para obter mais informações, consulte Personalizar um processo herdado.
– Para atualizar os painéis: Administrador da equipe ou um membro do grupo de Administradores do projeto.
Access - Mesmo que você tenha acesso Básico ou inferior, ainda poderá alterar um processo se alguém lhe der permissão.
- Para atualizar e alterar os tipos de itens de seus trabalhos existentes: Membro do projeto.
Modelo de processo do projeto - É preciso ter o Modelo de processo de herança para a coleção de projetos que contém o projeto.
– Para migrar dados para o Azure DevOps Services, use o Serviço de Importação de Banco de Dados do Team Foundation Server.
Conhecimento - Familiaridade com os modelos de personalização e processo.

Usar a IA para solucionar problemas de erros de importação de processo

O prompt de exemplo a seguir para o Copilot Chat ajuda a solucionar problemas de erros de validação de importação de processo e problemas de configuração XML. Copie e cole este prompt no Copilot Chat, substituindo os marcadores de posição por suas informações específicas.

Para obter a melhor assistência de IA, inclua detalhes específicos como o código de erro (TF######), nomes de arquivo afetados, nomes de tipo de item de trabalho e nomes de referência de campo mencionados no erro de validação.

I'm getting this Azure DevOps process import error: [PASTE YOUR ERROR MESSAGE HERE]

Process import details:
- Error code: [ERROR CODE like TF402###]
- Affected file: [XML FILE NAME like Bug.xml, ProcessConfiguration.xml]
- Work item type: [WIT NAME if applicable]
- Field reference name: [FIELD REFNAME if applicable]
- Custom namespace: [YOUR CUSTOM NAMESPACE if applicable]

Can you help me troubleshoot this issue? Please provide step-by-step instructions to:
1. Identify the root cause of the validation error
2. Fix the XML configuration or process definition
3. Verify the changes resolve the validation issue

Context: This is for importing a custom process template to Azure DevOps Services using the Hosted XML process model. The error might be related to work item type definitions, field configurations, process configuration, categories, or XML schema violations.

Copilot é alimentado pela IA, portanto, surpresas e erros são possíveis. Para obter mais informações, consulte perguntas frequentessobre uso geral do Copilot.

Mensagens informativas: nenhuma ação necessária

TF402555: O campo [refName] é excluído.

O processo que você está importando não inclui o campo nomeado no processo que está sendo atualizado, portanto, ele é removido como parte da operação de atualização.

Cenário de exemplo

  1. Adicionar campo personalizado ao item de trabalho Bug.xml
    <FIELD name="Foo" refname="MyCompany.CustomFields.Foo" type="String" reportable="dimension" />
    
  2. Processo de importação
  3. Remover campo do Bug.xml
  4. Importar processo atualizado

O sistema exibe uma mensagem informativa sobre o campo a ser excluído.
TF402555: Field MyCompany.CustomFields.Foo will be deleted

TF402591: o campo com o nome de referência [refName] não pode ser renomeado como '[name1]' de '[name2]' em processos existentes [processName].

O processo que você está importando contém um campo renomeado que usa o mesmo refname no processo atual.

Você não pode renomear nomes de campo.

TF402598: O tipo de item de trabalho [refName] é excluído.

O processo que você está atualizando não inclui o WIT especificado que existe no processo atual. Como parte da atualização do processo existente, o sistema exclui o WIT nomeado do processo atual.

Cenário de exemplo

  1. Crie um tipo de item de trabalho chamado "LSI"
    <WORKITEMTYPE name="LSI" refname="My.LSI">  
    
  2. Processo de importação
  3. Remover o tipo de item de trabalho LSI do processo
  4. Importar processo atualizado

O sistema exibe uma mensagem informativa sobre a exclusão.
TF402598: Work item type My.LSI will be deleted

TF402601: O tipo de item de trabalho [witName] é renomeado de [name2] para [name1].

O processo contém um WIT renomeado. O WIT é renomeado no processo já existente.
O processo que você está atualizando contém um WIT que tem o nome do processo atual.
Como parte da atualização do processo existente, o sistema renomeia o WIT no processo atual. Todos os itens de trabalho em projetos existentes que fazem referência ao processo também são renomeados.

Cenário de exemplo

  1. Crie um tipo de item de trabalho chamado "LSI"
    <WORKITEMTYPE name="LSI" refname="My.LSI">  
    
  2. Processo de importação
  3. Renomear o tipo de item de trabalho LSI para Incidente em Site Ativo
    <WORKITEMTYPE name="Live Site Incident" refname="My.LSI">  
    
  4. Importar processo atualizado

O sistema exibe uma mensagem informativa sobre o WIT a ser renomeado.
TF402601: Work item type My.LSI will be renamed to 'Live Site Incident' from 'LSI'

Erros de arquivo diversos

TF402586: Erro ao analisar o arquivo: [mensagem de erro]

A sintaxe XML malformada pode causar erros de análise de arquivo. A ausência de tags de fechamento, aspas, colchetes abertos ou fechados (< ou >) podem causar erros de análise de arquivo.

Na mensagem de erro, determine e corrija a origem do XML malformado.

TF402594: O arquivo viola o esquema com o seguinte erro: [mensagem de erro]

Cada arquivo XML no arquivo zip do processo deve estar em conformidade com o esquema fornecido. Os erros de violação de esquema ocorrem devido a marcas XML personalizadas ou atributos dentro do arquivo XML. Leia a mensagem de erro para determinar a origem da violação do esquema e corrija adequadamente.

A definição de esquema para acompanhamento de item de trabalho define todos os elementos filhos do elemento FORM como maiúsculas e minúsculas concatenadas e todos os outros elementos como tudo em maiúscula. Se você encontrar erros ao validar seus arquivos de definição de tipo, verifique a estrutura de maiúsculas e minúsculas de seus elementos. Além disso, a estrutura de maiúsculas e minúsculas das marcas de abertura e fechamento devem corresponder às regras da sintaxe XML.

Exemplos de erro

Tag XML personalizada:

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

Atributo extra adicionado ao elemento XML:

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

VS412450: Erro de validação de esquema Xml em [fileName]. [Mensagem de erro]

Corrija o erro de esquema no arquivo nomeado.

Erros de plug-in de modelo de processo

O ProcessTemplate.xml é o arquivo raiz que define todo o processo e todos os arquivos de definição XML importados para adicionar ou atualizar um processo. Esse arquivo contém todos os plug-ins e grupos de tarefas que são referidos ao criar um projeto. Cada grupo de tarefas faz referência a um arquivo XML subordinado (geralmente em uma subpasta) em que as tarefas específicas são definidas. Em geral, você especifica um grupo de tarefas para cada plug-in.

O arquivo de definição ProcessTemplate.xml deve estar em conformidade com a sintaxe e as regras.

VS412457: Não foi possível encontrar o arquivo especificado "[fileName]" no pacote de processo.

Corrija o pacote zip do processo para incluir o arquivo nomeado.

VS402452: O modelo de processo não especificou uma versão ou especificou uma versão inválida.

Para especificar uma versão, edite o arquivo ProcessTemplate.xml.

Exemplo de erro

O arquivo ProcessTemplate.xml especifica o mesmo GUID version do processo Agile, que é um processo bloqueado.

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

Exemplo de resolução

Um GUID diferente é especificado.

<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: O arquivo zip do modelo de processo não contém o plug-in necessário [pluginName].

Todos os arquivos listados no arquivo ProcessTemplate.xml e seus arquivos de plug-in suportados devem estar presentes no arquivo zip do processo.

Use uma ferramenta de pesquisa para localizar todas as instâncias de filename=value no conjunto de arquivos e pastas de processo. Em seguida, atualize o plug-in para remover o arquivo nomeado ausente ou inclua o arquivo nomeado na pasta de processo à qual ele pertence.

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

Exemplo de erro

O plug-in WorkItemTracking especifica fileName="WorkItem Tracking\TypeDefinitions\Epic.xml, no entanto, ele não é adicionado à pasta WorkItem Tracking\TypeDefinitions.

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

Exemplo de resolução

Adicione o arquivo Epic.xml à pasta WorkItem Tracking\TypeDefinitions.

VS412454: O plug-in [pluginName] contém vários taskList{1}, {2}. Apenas um taskList é permitido por plug-in.

Corrija o arquivo ProcessTemplate.xml do plug-in nomeado para reduzir o número de elementos tasklist definidos.

Exemplo de erro

O plug-in WorkItemTracking contém duas instruções 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>

Exemplo de resolução

    <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: Você só pode incluir um arquivo de definição de categoria em seu processo.

Exemplo de erro

O arquivo WorkItems.xml contém duas instruções 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>

Exemplo de resolução

O arquivo WorkItems.xml é atualizado para conter apenas uma CATEGORIES instrução.

  <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: Você só pode incluir um arquivo de definição de ProcessConfiguration em seu processo.

Exemplo de erro

O arquivo WorkItems.xml contém instruções ProjectConfiguration duplicadas.

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

Exemplo de resolução

O arquivo WorkItems.xml é atualizado para conter apenas uma ProjectConfiguration instrução.

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

TF402587: arquivo ProcessConfiguration necessário ausente.

O arquivo WorkItems.xml especifica o arquivo ProcessConfiguration do qual fazer upload. O arquivo não está especificado, contém uma especificação desatualizada, o arquivo especificado está ausente do modelo ou o nome da pasta/arquivo não está correto.

Exemplo de erro

A configuração especificada está desatualizada e especifica dois arquivos que não estão contidos na pasta Processo.

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

Exemplo de resolução

O arquivo WorkItems.xml é atualizado para conter a instrução de configuração ProjectConfiguration correta.

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

TF402577: O campo [refName] especifica o nome amigável [friendlyName] que já está sendo usado pelos campos [refName] nos processos [processNames].

Os nomes amigáveis devem ser exclusivos em todas as definições de campo para todas as definições de WIT especificadas para todos os processos importados para o Azure DevOps Services.

Os processos nomeados contêm WITs que definem um campo que usa o nome amigável.

Modifique a definição de WIT no arquivo zip do processo que contém [refName] e especifique um nome amigável diferente ou faça com que ele corresponda a um campo existente em uso.

Exemplo de erro

A definição de WIT UserStory contém o elemento FIELD para Fabrikam.Product.Family com o nome amigável Product.

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

No entanto, em um processo existente, Fabrikam.Product.Versions usa o nome amigável 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>

Exemplo de resolução

Atualize a definição de WIT UserStory para corresponder ao campo existente.

      <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: referência necessária do plug-in WorkItemTracking ausente no modelo de processo.

Você deve especificar o plug-in Microsoft.ProjectCreationWizard.WorkItemTracking na seção metadata do arquivo ProcessTemplate.xml:

Exemplo de erro

O plug-in Microsoft.ProjectCreationWizard.WorkItemTracking está ausente na seção plugins do arquivo 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>

Exemplo de resolução

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

Categorias

O arquivo de definição Categories.xml deve estar em conformidade com a sintaxe e as regras.

TF402546: A categoria [categoryName] está ausente no arquivo de categorias.

Todas as categorias referidas no arquivo ProcessConfiguration.xml devem ser definidas no arquivo Categories.xml. Além disso, o sistema requer que o arquivo Categories.xml contenha definições para as seguintes categorias:

  • Categoria Bug
  • Categoria Solicitação de revisão de código
  • Categoria Resposta de revisão de código
  • Categoria Solicitação de feedback
  • Categoria de resposta de feedback
  • Categoria Tipos ocultos
  • Categoria Requisito
  • Categoria de etapa compartilhada
  • Categoria Parâmetro compartilhado
  • Categoria da Tarefa
  • Categoria Caso de teste
  • Categoria Plano de teste
  • Categoria Conjunto de testes

Atualize o arquivo Categories.xml para definir a categoria [name] ausente.

Exemplo de erro

ProcessConfiguration faz referência à Categoria Épica, no entanto, ela está ausente do arquivo de definição Categories.xml.

Exemplo de resolução

A categoria Épico é adicionada ao arquivo de categorias.

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

TF402553: O elemento [name] faz referência à categoria [categoryName] que não está definida no arquivo de categorias.

Atualize o arquivo Categories.xml para definir a categoria [categoryName] ausente.

TF402560: você definiu [n] categorias. Apenas [nn] são permitidos.

Revise o arquivo Categories.xml para todas as instruções de elemento CATEGORY e determine quais você pode excluir para não exceder o limite permitido. Em seguida, revise o arquivo ProcessConfiguration.xml para substituir os valores que fazem referência a categorias excluídas.

TF402596: A categoria [categoryName] não define o tipo de item de trabalho [witName].

As categorias devem fazer referência a WITs definidos na pasta /WorkItem Tracking/TypeDefinitions e listados como uma tarefa para upload no arquivo de plug-in WorkItems.xml.
Examine o arquivo Categories.xml para obter referências a um WIT não incluído na pasta /WorkItem Tracking/TypeDefinitions.

Exemplo de erro

O nome do WIT referido para Microsoft.EpicCategory está incorreto.

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

Exemplo de resolução

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

TF402597: Não há suporte para a categoria personalizada [categoryName] porque ProcessConfiguration não faz referência a ela.

Você só pode especificar categorias personalizadas utilizadas para configurar um recurso de ferramenta Agile no ProcessConfiguration.
Revise seu arquivo ProcessConfiguration.xml e determine se você esqueceu de adicionar suporte para uma categoria. Caso contrário, remova [categoryName] do arquivo Categories.xml.

Exemplo de erro

ProcessConfiguration não faz referência a Microsoft.EpicCategory, embora definido no arquivo de definição Categories.xml.

Exemplo de resolução

Adicione PortfolioBacklog a ProcessConfiguration para fazer referência a 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>

Artigos de referência:

Erros de plug-in de classificação

O arquivo de definição Classification.xml deve estar em conformidade com a sintaxe e as regras.

TF402511: o plug-in de classificação contém o nome da propriedade duplicada: [propertyName].

Exemplo de erro

O arquivo Classification.xml contém uma segunda instrução property name="MSPROJ" no elemento de contêiner properties.

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

Exemplo de resolução

Remova a instrução duplicada.

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

TF402512: o arquivo [fileName] não existe.

O arquivo especificado no arquivo Classification.xml não está presente no caminho especificado ou o caminho está incorreto.

Exemplo de erro

O caminho da pasta Classification está incorreto.

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

Exemplo de resolução

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

TF402513: O nome [pathName] no plug-in Classification não está em conformidade com as restrições de nomenclatura do TreePath.

Examine os Node elementos especificados e altere os nomes para estar em conformidade com as convenções de nomenclatura de suporte. Referência: adicione e modifique caminhos de área e iteração.

Exemplo de erro

Os nomes de caminho incluem o caractere # que não é permitido.

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

Exemplo de resolução

Os nomes dos caminhos são corrigidos.

        <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: Não há suporte para o Node StructureType [structureTypeName] no plug-in de classificação.

O atributo StructureType permite apenas os seguintes valores: ProjectModelHierarchy e ProjectLifecycle.
Examine os Node elementos especificados e remova todos os atributos sem suporte.

Exemplo de erro

ProjectLifecycle está com ortografia incorreta.

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

Exemplo de resolução

O nome incorreto está corrigido.

        <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: Um atributo de propriedade no plug-in Classification está ausente ou não é suportado.

O elemento property permite apenas os seguintes atributos: name , value , e isFile.
Examine os elementos especificados e remova todos os property atributos sem suporte.

Exemplo de erro

O atributo value está incorreto.

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

Exemplo de resolução

O atributo com ortografia incorreta é corrigido.

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

TF402516: o plug-in de classificação contém mais de dois nós de nível raiz, o que não é permitido.

Examine os Node elementos especificados e remova nós de nível raiz extras.

Exemplo de erro

O arquivo Classification.xml contém uma segunda instrução Node StructureType="ProjectLifecycle" no elemento de contêiner 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="ProjectLifecycle" Name="Iteration" xmlns="">
        <Node StructureType="ProjectModelHierarchy" Name="Area" xmlns="" />
      </Nodes>

Exemplo de resolução

Remova a segunda instrução.

      <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: o caminho de área ou iteração "[pathName]" no plug-in GroupsandPermissions está ausente no plug-in de classificação.

Adicione o [pathName] ausente ao arquivo Classification.xml ou remova-o do arquivo GroupsandPermissions.xml.

Exemplo de erro

O arquivo Classification.xml especifica sprints, não iterações.

GroupsandPermissions.xmlteamSettings especifica Iterações.

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

No entanto, o Classification.xml especifica sprints.

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

Exemplo de resolução

Atualize GroupsandPermissions.xml para usar sprints.

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

Observação

Não há suporte para tipos de link personalizados no processo de importação atual.

Revise o arquivo de plug-in WorkItems.xml para todas as declarações de elemento LINKTYPE. Remova instruções associadas a tipos de link personalizados para não exceder o limite permitido. Em seguida, remova o arquivo de definição de tipo de link correspondente da pasta LinkTypes.

Além disso, remova todas as referências aos tipos de link personalizados que você adicionou a uma definição de WIT, em uma seção LinksControlOptions dentro da seção FORM.

Revise o arquivo de plug-in WorkItems.xml para todas as declarações de elemento LINKTYPE. Remova todas as instruções que especificam um tipo de link personalizado. Em seguida, remova o arquivo de definição de tipo de link correspondente da pasta LinkTypes.

As seguintes instruções de elemento LINKTYPE no arquivo de plug-in WorkItems.xml são válidas:

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

Listas globais

Observação

Não há suporte para listas globais no recurso de processo de importação atual.

TF402564: você definiu [n] listas globais. Apenas [nn] são permitidos.

Um ou mais WITs definidos no modelo de processo personalizado contêm um elemento GLOBALLIST. Pesquise seus arquivos de definição de WIT e substitua todos os elementos GLOBALLIST por ALLOWEDVALUES ou SUGGESTEDVALUES.

TF402565: você definiu [n] itens na lista global [globalListName]. É permitido um máximo de [nn].

O elemento nomeado GLOBALLIST contém mais itens do que o permitido. Reduza o número de itens de lista contidos no elemento GLOBALLIST ou segmente a lista global em dois ou mais elementos para que nenhuma lista exceda o número máximo de itens permitidos.

Configuração do processo

O arquivo de definição ProcessConfiguration.xml deve estar em conformidade com a sintaxe e as regras descritas na Referência do elemento XML ProcessConfiguration.

TF402543: O elemento [elementName] requer que você associe exatamente um estado de fluxo de trabalho ao metaestado [metastateName].

Atualize a seção States dentro do elemento nomeado no arquivo ProcessConfiguration.xml para fornecer o mapeamento de metaestado ausente ou remover mapeamentos extras.

Exemplo de erro

O elemento RequirementBacklog do ProcessConfiguration.xml não tem um mapeamento de metaestado a 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 >

Exemplo de resolução

Mapeamentos de metaestado ausentes são adicionados.

<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: O elemento [elementName] requer que, para o tipo de item de trabalho [witName], você associe pelo menos um estado ao metaestado [metastateName].

Examine os estados WORKFLOW definidos para o WIT nomeado e atualize a seção States dentro do elemento nomeado no arquivo ProcessConfiguration.xml para fornecer o mapeamento de metaestado ausente para o WIT nomeado.

TF402548: O elemento [elementName] requer que você associe pelo menos um estado ao metaestado [metastateName].

Para fornecer o mapeamento de metaestado ausente, atualize a States seção dentro do elemento nomeado no arquivo ProcessConfiguration.xml.

Exemplo de erro

O elemento RequirementBacklog do ProcessConfiguration.xml não tem um mapeamento de metaestado a 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 >

Exemplo de resolução

Mapeamentos de metaestado ausentes são adicionados.

<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: O elemento [elementName] inclui mais de um mapeamento de metaestado para o estado de fluxo de trabalho [stateName].

O valor de metaestado não pode ser mapeado para mais de um estado de fluxo de trabalho.

Exemplo de erro

O elemento RequirementBacklog do ProcessConfiguration.xml contém dois mapeamentos de metaestado a 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 >

Exemplo de resolução

Os mapeamentos de metaestado são corrigidos.

<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: O tipo de item de trabalho [witName] não define o estado do fluxo de trabalho [stateName], que é necessário porque ProcessConfiguration o associa a um metaestado para o elemento [elementName].

Para adicionar os elementos STATE e TRANSITION ausentes, corrija o arquivo ProcessConfiguration.xml ou a seção WORKFLOW do WIT nomeado.

Exemplo de erro

O elemento ProcessConfiguration.xml RequirementBacklog especifica value="Committed", no entanto, UserStory.xml não define Committed como um Estado.

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

Exemplo de resolução

Remoção do elemento State para 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: O elemento [elementName] requer que, para o tipo de item de trabalho [witName], você associe exatamente um estado ao metaestado [metastateName] para os seguintes estados: [stateNames].

Analise a seção STATES no arquivo ProcessConfiguration.xml para o elemento nomeado e garanta que cada estado listado na mensagem de erro esteja presente e associado a um metaestado.

Exemplo de erro

O elemento RequirementBacklog do ProcessConfiguration.xml está sem o estado New, que existe no tipo de item de trabalho User Story. Deve estar na lista STATES associada a type=Proposed".

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

Exemplo de resolução

O mapeamento de metaestado está corrigido.

<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: O elemento [elementName] especifica um metaestado [metastateName] sem suporte.

Analise a seção STATES no arquivo ProcessConfiguration.xml para o elemento nomeado e remova ou corrija o metaestado nomeado.

Exemplo de erro

O elemento RequirementBacklog de ProcessConfiguration.xml contém um mapeamento de metaestado com erro de ortografia para type=Proposed".

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

Exemplo de resolução

O mapeamento de metaestado está corrigido.

<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: O elemento necessário [elementName] está ausente na configuração do processo.

Edite o arquivo ProcessConfiguration.xml para adicionar o elemento nomeado ausente.

Revise a referência do elemento XML ProcessConfiguration para obter os elementos necessários.

TF402572: Não é possível localizar o arquivo especificado no pacote de modelos de processo.

Um arquivo especificado em um arquivo de plug-in para upload está ausente do arquivo zip. Examine todos os arquivos especificados para upload e verifique se eles estão incluídos no arquivo zip do processo.

Revise a referência do elemento XML ProcessConfiguration para obter os elementos necessários.

TF402574: ProcessConfiguration não especifica TypeField[typeField] obrigatório.

Edite o arquivo ProcessConfiguration.xml para adicionar o elemento TypeField nomeado ausente.

Revise a referência do elemento XML ProcessConfiguration para obter os elementos TypeField necessários.

Exemplo

O processo Scrum especifica os elementos TypeField a seguir. Se algum desses elementos estiver ausente, você receberá TF402574 de erro.

<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: várias listas de pendências de portfólio [backlogNames] definiram [backlogName] como pai. Uma lista de pendências pai pode ter apenas uma lista de pendências filha.

Somente uma lista de pendências de portfólio filha pode ser mapeada para uma única lista de pendências pai.

Edite ProcessConfiguration para corrigir as especificações da lista de pendências pai-filho.

Exemplo de erro

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

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

Exemplo de resolução

Para apontar para a lista de pendências do Epic, altere o elemento pai na lista de pendências de recurso.

  <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: a lista de pendências de portfólio [backlogName] faz referência a uma lista de pendências de portfólio pai não definido [backlogName].

A definição ProcessConfiguration.xml contém um valor parent que faz referência a uma lista de pendências de portfólio indefinida.

Exemplo de erro

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

Exemplo de resolução

Adicione o PortfolioBacklog Épico ao arquivo 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: várias listas de pendências de portfólio [Lista de pendências 1, Lista de pendências 2] não definem o elemento pai.

Apenas uma lista de pendências de portfólio, a superior, pode não ter vínculo. Todas as outras listas de pendências devem incluir um atributo parent="Microsoft.FooCategory" e o valor.

Exemplo de resolução

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

402595: há muitas listas de pendências de portfólio definidas. São permitidos, no máximo, cinco.

Edite o arquivo ProcessConfiguration.xml para remover os elementos extras PortfolioBacklog da seção PortfolioBacklogs.

Analise a referência de elementos XML ProcessConfiguration para obter mais informações.

TF400506: Esse elemento define os estados para itens de trabalho que representam Bugs ou Defeitos.

Esse erro ocorre quando a seção BugWorkItems está configurada incorretamente. Cada estado definido para um tipo de item de trabalho incluído no Microsoft.BugCategory deve existir no conjunto de valores de Estado definidos na seção BugWorkItems. Por exemplo, se os seguintes estados forem definidos para tipos de item de trabalho definidos para o tipo de item de trabalho Bug — Novo, Aprovado, Confirmado, Concluído — a seção BugWorkItems deverá ser configurada da seguinte maneira:

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

Para obter mais informações, consulte Referência do elemento XML de ProcessConfiguration.

TF400507: Cada tipo de item de trabalho deve dar suporte a um valor de estado inicial que corresponda a um dos estados definidos em: BugWorkItems.

Esse erro ocorre quando um tipo de item de trabalho incluído no Microsoft.BugCategory especifica um estado inicial que não está incluído na seção BugWorkItems do arquivo XML ProcessConfiguration. Corrija os estados de fluxo de trabalho de definição XML para os tipos de item de trabalho nomeados ou atualize a BugWorkItems seção para incluir o estado ausente.

Para obter mais informações, consulte Referência do elemento XML de ProcessConfiguration.

TF400572: As Configurações do Processo do Projeto devem ser definidas para que esse recurso seja usado.

Esse erro decorre de modelos antigos antes da existência das Configurações do Processo de Projeto. Tente adicionar o arquivo XML ProcessConfiguration ao modelo de processo.

Tipos de item de trabalho

TF402570: você definiu [n] tipos de item de trabalho. São permitidos, no máximo, [witLimit].

Você definiu outros WITs que são permitidos no processo. Examine o arquivo WorkItems.xml e reduza o número de instruções WORKITEMTYPE que ele contém e remova os arquivos de definição de WIT associados do processo.

TF402573: O tipo de item de trabalho WIT não especifica o atributo refname necessário.

Os tipos de item de trabalho (Bug, História do Usuário, Tarefa etc.) exigem o atributo refname. O valor do refname deve ser exclusivo e não pode conter namespaces reservados. O namespaces-System. XXX e Microsoft.AzureDevOps. XXX são reservados pelo Azure DevOps.

Exemplo de erro

<WORKITEMTYPE name="Bug">

Exemplo de resolução

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

TF402599: O tipo de item de trabalho refname [refName] não é válido, pois usa um namespace não permitido [namespace].

Nomes de referência de campos personalizados e WITs não podem usar namespaces reservados: Sistema. XXX e Microsoft.AzureDevOps. XXX.

Edite o atributo refname do WIT nomeado.

Exemplo de erro

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

Exemplo de resolução

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

TF402600: O nome de referência do tipo de item de trabalho [refName] não é válido. Os nomes de referência de tipo de item de trabalho devem conter apenas letras, sem espaços e pelo menos um ponto (.)

Os nomes de referência de WIT devem seguir as convenções de nomenclatura estabelecidas: apenas letras, sem espaços e pelo menos um ponto (.)

Edite o atributo refname do WIT nomeado para satisfazer os requisitos de nomenclatura.

Exemplo de erro

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

Exemplo de resolução

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

Campos de item de trabalho

TF402538: Não há suporte para a regra de campo [ruleName].

Edite suas definições de WIT para remover a regra nomeada. Não há suporte para as regras a seguir para importação para o Azure DevOps: MATCH, CANNOTLOSEVALUE, PROHIBITEDVALUES e NOTSAMEAS.

TF402539: O campo [refName] permite apenas as seguintes regras: [ruleNames].

Edite suas definições de WIT para o campo nomeado e remova as regras não permitidas. Analise as seções FIELDS e WORKFLOW. A maioria dos campos do sistema não permite a especificação de regras.

Regras válidas para usar com campos do sistema

Nome Regras permitidas
System.Title REQUIRED, DEFAULT
System.Description REQUIRED, DEFAULT
System.AssignedTo REQUIRED, DEFAULT, , ALLOWEXISTINGVALUEVALIDUSER
System.ChangedBy REQUIRED, DEFAULT, , ALLOWEXISTINGVALUEVALIDUSER

TF402540: O tipo de item de trabalho [witName] não é válido porque especifica a lista global [GLOBALLIST]. Não há suporte para listas globais.

Não há suporte para listas globais no Azure DevOps. Substitua todas as instâncias de elementos GLOBALLIST por ALLOWEDVALUES e elementos LISTITEM em todos os arquivos de definição de WIT.

Exemplo de erro

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

Exemplo de resolução

<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: O tipo de item de trabalho [witName] não é válido porque faz referência à lista global [globalListName]. Não há suporte para listas globais.

Não há suporte para listas globais no Azure DevOps. Substitua todas as instâncias de elementos GLOBALLIST por ALLOWEDVALUES e elementos LISTITEM em todos os arquivos de definição de WIT.

Exemplo de erro

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

Exemplo de resolução

<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: O campo personalizado refname [refName] não é válido, pois usa o namespace não permitido [namespace].

Os namespaces System.XXX e Microsoft.AzureDevOps.XXX são reservados no Azure DevOps. Nomes de referência de campos e tipos personalizados não podem usar esses namespaces.

Para corrigir esse erro, renomeie o atributo refname do campo nomeado nos arquivos de definição de WIT em que ele aparece.

Exemplo de erro

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

  - OR - 

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

Exemplo de resolução

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

TF402544: O campo [refName], definido no tipo de item de arquivo [witName], requer uma regra ALLOWEDVALUES que contém valores para dar suporte ao elemento [elementName] especificado em ProcessConfiguration.

Edite o campo especificado no WIT especificado para fornecer a regra ausente ALLOWEDVALUES, referenciando o elemento especificado para mais detalhes.

O elemento de arquivo ProcessConfiguration.xml, TypeField refname="Microsoft.AzureDevOps.Common.Activity" type="Activity", requer que uma lista de seleção seja definida para o campo Microsoft.AzureDevOps.Common.Activity em todos os WITs que pertencem à Categoria de Tarefa.

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

Se você adicionou bugs à categoria de tarefa, verifique se o arquivo Bug.xml contém o campo nomeado e especifica a mesma lista de seleção definida para ele no arquivo Task.xml.

Exemplo de erro

Bug.xml tem o campo definido, mas não a lista de seleção.

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

Exemplo de resolução

Correção de 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: O elemento [elementName] requer que você inclua o campo [fieldName] na definição do tipo de item de trabalho [witName].

Você deve incluir um elemento correspondente FIELD na definição de WIT nomeado para cada field que você especificar na seção AddPanel do arquivo ProcessConfiguration.xml.
Você também deve incluir o elemento Control na seção FORM do WIT indicado.

Exemplo de erro

ProcessConfiguration especifica dois campos personalizados. No entanto, esses campos não são definidos no arquivo UserStory.xml.

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

Exemplo de resolução

Elementos FIELD ausentes adicionados ao arquivo UserStory.xml.

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

Para dar suporte ao elemento [elementName] deProcessConfiguration, o tipo de item de trabalho [witName] deve definir TypeField [typeField] (campo refname [refName]).

No ProcessConfiguration, você criou um TypeField com TypeFieldValues. No tipo de item de trabalho, faça referência a esse mesmo TypeField.

Exemplo de erro

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 está usando o campo Microsoft.AzureDevOps.Feedback.ApplicationType quando deve estar usando o campo Custom.ApplicationType.

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

Exemplo de resolução

FeedbackRequest.xml

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

TF402556: Para que o campo [refName] seja bem definido, você deve nomeá-lo [fieldName] e definir seu tipo como [fieldType]. Desde que [refName] seja [fieldName] e o tipo seja [fieldType].

Se você estiver em um servidor local e executando o tfsMigrator, esse erro será gerado quando o processo estiver desatualizado e um campo do sistema não estiver definido corretamente. Na maioria dos casos, use o witadmin /changefield comando para renomear corretamente o campo.

Exemplos de campo reservado

Sistema Reservado. XXX e Microsoft.AzureDevOps. Os campos XXX exigem name e type os valores.

Campo Nome Tipo
System.Id ID Inteiro
System.Title Título Cadeia de caracteres
Microsoft.AzureDevOps.Scheduling.StoryPoints Pontos da história Double
Microsoft.AzureDevOps.Scheduling.RemainingWork Trabalho restante Double
Microsoft.AzureDevOps.Scheduling.OriginalEstimate Estimativa Original Double
Microsoft.AzureDevOps.Scheduling.CompletedWork Trabalho concluído Double

Exemplo de erro

TF402556: Para que o campo Microsoft.AzureDevOps.TCM.ReproSteps seja bem definido, você deve nomeá-lo Etapas de Reprodução e definir seu tipo como HTML. O Microsoft.AzureDevOps.TCM.ReproSteps fornecido é Minhas Etapas de Reprodução e o tipo é HTML.

Em Bug.xml, o nome do campo amigável foi alterado para "Minhas Etapas de Reprodução".

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

Exemplo de resolução

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: Existem definições inconsistentes para o campo [refName] nos seguintes tipos de item de trabalho: [witName]. Todas as referências a um campo devem ter o mesmo RefName, Name e Type.

As definições de elemento FIELD para campos com o mesmo nome amigável devem ser consistentes entre WITs. Verifique se os atributos refname, name e type são os mesmos em cada uma das definições de WIT para o campo nomeado.

Exemplo de erro

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

Observe que os atributos name e type diferem do tipo de item de trabalho Bug.xml.

Exemplo de resolução

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: a definição do campo [refName] é inconsistente com um campo existente. O type é [typeName], mas deve ser [typeName].

Edite o arquivo WIT que contém o campo nomeado para garantir que o valor do atributo especificado type seja consistente em todos os WITs.

TF402562: você definiu [n] campos para o tipo de item de trabalho [witName]. Somente [fieldLimit] são permitidos.

Você definiu [n] campos para o WIT nomeado, o que excede o número permitido de campos para qualquer WIT.

Edite o WIT nomeado e remova os campos personalizados extras para reduzir o número total de campos para estar dentro do limite permitido.

TF402563: você definiu um total de [n] campos para todos os tipos de item de trabalho. Somente [fieldLimit] são permitidos.

Você definiu campos [n] para todos os WITs definidos no processo. Somente [fieldLimit] são permitidos, o que inclui os campos de namespace System.XXX e Microsoft.AzureDevOps.XXX e campos personalizados.

Analise as seções FIELDS e WORKFLOW e determine quais campos personalizados remover.

TF402566: você definiu [n] regras de campo para o tipo de item de trabalho [witName]. São permitidos, no máximo, [ruleLimit].

Você definiu [n] regras de campo para o WIT especificado, que excede o número permitido de regras de campo para qualquer WIT.

Edite o WIT nomeado e remova as regras de campo extras para reduzir o número total de campos para estar dentro do limite permitido.

TF402568: Você definiu [n] campos com syncnamechanges="true" para o tipo de item de trabalho [witName]. São permitidos, no máximo, 64.

O número de campos com syncnamechanges="true" definido para o WIT nomeado excede o limite permitido, incluindo campos dos namespaces System.XXX e Microsoft.AzureDevOps.XXX, além de campos personalizados.

Examine a seção FIELDS do WIT nomeado e determine quais campos personalizados remover ou modificar.

Exemplo

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

TF402569: você definiu [n] valores para o campo [fieldName] no tipo de item de trabalho [witName]. São permitidos, no máximo, [listLimit].

O número de elementos LISTITEM definidos para o campo nomeado do WIT especificado excede o limite permitido.

Edite o WIT nomeado para reduzir o número de elementos LISTITEM para não exceder o máximo permitido.

Exemplo

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

Observe que os valores de bug e história de usuário refname são diferentes.

TF402584: Não há suporte para atributos de regra de campo "para" ou "não".

Os atributos "for" e "not" não são suportados de forma alguma para qualquer regra de campo na importação no Azure DevOps Services.
Analise nas seções FIELDS e WORKFLOW a presença de atributos "for" e "not" e remova-os.

Exemplo de erro

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

Exemplo de resolução

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

TF402593: As regras de campo não são compatíveis com o campo [fieldName].

A maioria dos campos System e Microsoft.AzureDevOps não dá suporte a regras. Para obter mais informações, consulte Regras e avaliação de regras.

Edite os arquivos de definição para tipos de item de trabalho que contêm o campo nomeado para remover as regras de campo especificadas para ele.

TF402602: O campo [refName] deve ter exatamente estes valores [values].

  • Não altere campos reservados: não altere nenhum campo definido nos namespaces reservados System.*XXX* e Microsoft.AzureDevOps.*XXX*.
  • Definir campos personalizados: para ter uma lista diferente de valores nos campos de lista de seleção, defina seu próprio campo personalizado.

Exemplo de erro

Bug.xml tem o campo de prioridade definido, mas tem uma lista de valores diferente do esperado.

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

Exemplo de resolução

Correção do Bug.xml incluindo um novo campo

      <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: Usuário ou grupo não pode ser encontrado [projeto]\Nome do Grupo. Verifique se os usuários e os grupos usados em sua definição de tipo de item de trabalho existem.

Não há suporte para grupos com escopo de projeto personalizado. Você só pode fazer referência a grupos com escopo em nível de conta.

Exemplo de erro

Bug.xml está fazendo referência a um grupo com escopo de projeto.

... "[project]\Organization Leaders"

Exemplo de resolução

Crie um grupo de nível de conta (coleção) "Líderes da organização" e faça referência a ele corretamente no XML.

... "[global]\Organization Leaders"

Observação

Um grupo global recém-criado pode demorar um pouco antes que o processo de importação o localize.

TF237094: o nome do campo '[fieldName]' é usado pelo campo '[refName]', portanto, ele não pode ser usado pelo campo '[refName]'.

O nome do campo já existe com o mesmo nome em um campo diferente. Altere o nome do campo.

Exemplo de erro

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

Exemplo de resolução

Alterar o nome do campo de Custom.NewField.ExternalID

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

Layout do item de trabalho

VS403104: o tipo de item de trabalho [witName] faz referência ao campo necessário [refName] que não está incluído em todos os layouts.

Esse aviso será gerado se você tiver um campo obrigatório em um tipo de item de trabalho referido no nó <Layout>, mas não no <WebLayout>. O <WebLayout> é usado para modificar o layout do novo formulário.

VS403073: Agrupar & <Group Name>: viola a regra de que um grupo só pode conter um único controle HTML ou WebPage precedido por controles de rótulo.

No novo layout de formulário, um grupo só pode conter um HTMLFieldControl ou WebPageControl.

Exemplo de erro

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

Para resolver esse erro, crie dois grupos separados que contêm um controle cada.

Exemplo de resolução


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

Exemplo de erro

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

Exemplo de resolução

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

Definições de fluxo de trabalho

TF402567: você definiu [n] estados de fluxo de trabalho para o tipo de item de trabalho [witName]. São permitidos, no máximo, [stateLimit].

Você definiu [n] estados de fluxo de trabalho para o WIT nomeado que excede o número permitido de estados de fluxo de trabalho para qualquer WIT.

Para reduzir o número total de estados para que fiquem dentro do limite permitido, edite a seção WORKFLOW do WIT especificado e remova os elementos extras STATE.

TF402578: O campo [refName] especifica o nome amigável [friendlyName] que já está sendo usado pelo campo [refName]. Os nomes amigáveis devem ser exclusivos em todas as definições de campo.

Os nomes de campo devem ser exclusivos dentro do tipo de item de trabalho.

Exemplo de erro

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

Observe que há dois campos com o nome <FIELD name="Foo".

Exemplo de resolução

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

TF402579: O nome [friendlyName] é usado várias vezes em campos diferentes nos seguintes tipos de item de trabalho: [witNames]. O nome dos campos deve ser exclusivo em toda a coleção de projetos.

Os campos que fazem referência ao mesmo refname="MyCompany.FieldName" devem ter o mesmo valor de nome amigável FIELD name="fieldname".

Exemplo de erro

Processo A, Bug.xml

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

Processo B, Bug.xml

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

Como ambos os campos compartilham o mesmo nome de referência, refname="MyCompany.CustomFields.Foo"eles também devem especificar o mesmo nome <FIELD name="Foo" amigável em todos os processos importados ou para serem importados para o Azure DevOps.

TF402580: Você só pode usar o nome [witName] para um único tipo de item de trabalho.

Os nomes amigáveis de WIT WORKITEMTYPE name="Name" devem ser exclusivos no processo.

Exemplo de erro

Meu item de trabalho A.xml

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

Meu item de trabalho B.xml

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

Observe como o WORKITEMTYPE name= é o mesmo nos dois tipos de item de trabalho.

Exemplo de resolução

Meu item de trabalho A.xml

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

Meu item de trabalho B.xml

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

TF402581: Você só pode usar o refname [refName] para um único tipo de item de trabalho.

Os nomes de referência de WIT refname="value" devem ser exclusivos dentro do processo.

Exemplo de erro

Bug.xml

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

UserStory.xml

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

Ambos os refname valores são iguais a "MyCompany.Name"

Exemplo de resolução

Bug.xml

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

UserStory.xml

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

TF402582: o tipo de item de trabalho [witName] contém controle personalizado [controlName] que não tem suporte.

Não há suporte para controles personalizados no Azure DevOps Services. Revise a seção FORM do WIT nomeado e remova todos os controles personalizados definidos.

Exemplo de erro

Type="OneViewMultiValueControl" especifica um controle personalizado. Remova ou substitua esse controle personalizado por um controle com suporte.

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