Resolución de errores de validación para la importación de procesos

Azure DevOps Services

Durante la importación de procesos, el proceso se valida para asegurarse de que el sistema funciona según lo previsto para el proceso personalizado. Recibirá una lista de mensajes de error si se produce un error en la validación del proceso.

Si recibió un error de validación al intentar el proceso de importación, resuelva el error antes de volver a intentar la importación. Cada error tiene un vínculo para obtener más información sobre los errores de validación específicos e instrucciones sobre cómo corregirlo. Aplique la corrección de resolución proporcionada para el mensaje que recibió, comprima los archivos actualizados y vuelva a intentar la operación de importación.

Si acaba de iniciar la personalización, revise las reglas de validación proporcionadas.

Prerrequisitos

Para obtener instrucciones sobre cómo adaptar Azure Boards para que se alinee con sus requisitos empresariales específicos, consulte Configuración y personalización de Azure Boards.

Utiliza IA para solucionar errores de importación de procesos

El siguiente mensaje de ejemplo para El chat de Copilot le ayuda a solucionar problemas de validación de importación de procesos y problemas de configuración XML. Copie y pegue este mensaje en Copilot Chat, reemplazando los marcadores por la información específica suya.

Para obtener la mejor asistencia de IA, incluya detalles específicos como el código de error (TF######), los nombres de archivo afectados, los nombres de tipo de elemento de trabajo y los nombres de referencia de campo mencionados en el error de validación.

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 funciona con IA, por lo que es posible que se produzcan sorpresas y errores. Para obtener más información, consulte Preguntas más frecuentes sobre el uso general de Copilot.

Mensajes de información: no se requiere ninguna acción

TF402555: se elimina el campo [refName].

El proceso que está importando no incluye el campo nombrado en el proceso que se está actualizando, por lo tanto se elimina como parte de la operación de actualización.

Escenario de ejemplo

1. Agregar un campo personalizado al elemento de trabajo Bug.xml

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

2. Importar el proceso
3. Quitar campo de Bug.xml
4. Importar el proceso actualizado

El sistema muestra un mensaje de información sobre el campo que se va a eliminar.
TF402555: Field MyCompany.CustomFields.Foo will be deleted

TF402591: el campo con el nombre de referencia [refName] no se puede cambiar de nombre a '[name1]' de '[name2]' en los procesos existentes [processName].

El proceso que está importando contiene un campo que ha sido renombrado y utiliza el mismo refname que en el proceso actual.

No se puede cambiar el nombre de los nombres de campo.

TF402598: se elimina el tipo de elemento de trabajo [refName].

El proceso que está actualizando no incluye el WIT específico que existe en el proceso actual. Como parte de la actualización del proceso existente, el sistema elimina el WIT con nombre del proceso actual.

Escenario de ejemplo

1. Crear un nuevo tipo de elemento de trabajo denominado "LSI"

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

2. Importar el proceso
3. Quitar el tipo de elemento de trabajo LSI del proceso
4. Importar el proceso actualizado

El sistema muestra un mensaje de información sobre la eliminación.
TF402598: Work item type My.LSI will be deleted

TF402601: se cambia el nombre del tipo de elemento de trabajo [witName] a [name1] de [name2].

El proceso contiene un WIT cuyo nombre ha cambiado. Se cambia el nombre del WIT en el proceso existente.
El proceso que está actualizando contiene un WIT que cambia de nombre con respecto al nombre en el proceso actual.
Como parte de la actualización del proceso existente, el sistema cambia el nombre del WIT en el proceso actual. También se cambia el nombre de todos los elementos de trabajo de los proyectos existentes que hacen referencia al proceso.

Escenario de ejemplo

1. Crear un nuevo tipo de elemento de trabajo denominado "LSI"

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

2. Importar el proceso
3. Cambiar el nombre del tipo de elemento de trabajo LSI a Incidente en el sitio activo

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

4. Importar el proceso actualizado

El sistema muestra un mensaje de información sobre el WIT cuyo nombre se va a cambiar.
TF402601: Work item type My.LSI will be renamed to 'Live Site Incident' from 'LSI'

Errores de archivo varios

TF402586: Archivo de análisis de errores: [Mensaje de error]

La sintaxis XML con formato incorrecto puede provocar errores de análisis de archivos. La falta de etiquetas de cierre, de comillas de corchetes de apertura o cierre (< o >) pueden provocar un error de archivo de análisis.

En el mensaje de error, determine y corrija el origen del XML con formato incorrecto.

TF402594: El archivo infringe el esquema con el siguiente error: [Mensaje de error]

Cada archivo XML del archivo ZIP del proceso debe ajustarse al esquema especificado. Los errores de infracción de esquema se deben a etiquetas o atributos XML personalizados dentro del archivo XML. Lea el mensaje de error para determinar el origen de la infracción del esquema y corregirlo en consecuencia.

La definición de esquema para el seguimiento de elementos de trabajo define todos los elementos secundarios dentro del elemento FORM con una combinación de mayúsculas y minúsculas y todos los demás elementos en mayúsculas. Si se producen errores al validar los archivos de definición de tipos, compruebe la estructura del uso de mayúsculas y minúsculas en sus elementos. También, la estructura del uso de mayúsculas y minúsculas en las etiquetas de apertura y cierre deben ajustarse a las reglas sintácticas de XML.

Ejemplos de error

Etiqueta XML personalizada:

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

Atributo adicional agregado al elemento XML:

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

VS412450: error de validación del esquema Xml en [fileName]. [Mensaje de error]

Corrija el error de esquema en el archivo con nombre.

Errores del complemento de plantilla de proceso

El ProcessTemplate.xml es el archivo raíz que define todo el proceso y todos los archivos de definición XML que se importan para agregar o actualizar un proceso. Este archivo contiene todos los complementos y grupos de tareas a los que se hace referencia al crear un proyecto. Cada grupo de tareas hace referencia a un archivo XML subordinado (a menudo en una subcarpeta) donde se definen las tareas específicas. En general, se especifica un grupo de tareas para cada complemento.

El archivo de definición de ProcessTemplate.xml debe cumplir la sintaxis y las reglas.

VS412457: no se encontró el archivo especificado '[fileName]' en el paquete de proceso.

Corrija el paquete ZIP del proceso para incluir el archivo con nombre.

VS402452: la plantilla de proceso no especificó una versión o especificó una versión no válida.

Para especificar una versión, edite el archivo ProcessTemplate.xml.

Ejemplo de error

El archivo ProcessTemplate.xml especifica el mismo GUID de version que para el proceso ágil, que es un proceso 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" />

Ejemplo de resolución

Se especifica un GUID diferente.

<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: el archivo ZIP de plantilla de proceso no contiene el complemento necesario [pluginName].

Todos los archivos enumerados en el archivo ProcessTemplate.xml y sus archivos de complemento admitidos deben estar presentes en el archivo ZIP del proceso.

Use una herramienta de búsqueda para buscar todas las instancias de filename=value dentro del conjunto de archivos y carpetas de proceso. A continuación, actualice el complemento para quitar el archivo con nombre que falta o agregue el archivo con nombre a la carpeta de proceso a la que pertenece.

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

Ejemplo de error

El complemento WorkItemTracking especifica fileName="WorkItem Tracking\TypeDefinitions\Epic.xml, pero no se agrega a la carpeta WorkItem Tracking\TypeDefinitions.

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

Ejemplo de resolución

Agregue el archivo Epic.xml a la carpeta WorkItem Tracking\TypeDefinitions.

VS412454: el complemento [pluginName] contiene varios taskList{1}, {2}. Solo se permite un taskList por complemento.

Corrija el archivo ProcessTemplate.xml del complemento con nombre para reducir el número de elementos tasklist definidos.

Ejemplo de error

El complemento WorkItemTracking contiene dos instrucciones 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>

Ejemplo de resolución

    <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: solo puede incluir un archivo de definición de categoría en el proceso.

Ejemplo de error

El archivo WorkItems.xml contiene dos instrucciones 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>

Ejemplo de resolución

El archivo WorkItems.xml se actualiza para contener solo una CATEGORIES instrucción.

  <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: solo puede incluir un archivo de definición de ProcessConfiguration en el proceso.

Ejemplo de error

El archivo WorkItems.xml contiene instrucciones ProjectConfiguration duplicadas.

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

Ejemplo de resolución

El archivo WorkItems.xml se actualiza para contener solo una ProjectConfiguration instrucción.

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

TF402587: falta el archivo ProcessConfiguration necesario.

El archivo WorkItems.xml especifica el archivo ProcessConfiguration que se va a cargar. El archivo no se ha especificado, contiene una especificación obsoleta, falta el archivo especificado de la plantilla o el nombre de carpeta o archivo no es correcto.

Ejemplo de error

La configuración especificada está obsoleta y especifica dos archivos que no están incluidos en la carpeta Process.

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

Ejemplo de resolución

El archivo WorkItems.xml se actualiza para que contenga la instrucción de configuración ProjectConfiguration correcta.

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

TF402577: el campo [refName] especifica el nombre descriptivo [friendlyName] que ya se usa en los campos [refName] en los procesos [processNames].

Los nombres descriptivos deben ser únicos en todas las definiciones de campo para todas las definiciones de WIT especificadas para todos los procesos importados a Azure DevOps Services.

Los procesos con nombre contienen WIT que definen un campo que usa el nombre descriptivo.

Modifique la definición de WIT en el archivo ZIP de proceso que contiene [refName] y especifique un nombre descriptivo diferente o haga que coincida con un campo existente en uso.

Ejemplo de error

La definición del WIT UserStory contiene el elemento FIELD para Fabrikam.Product.Family con el nombre descriptivo 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>

Sin embargo, en un proceso existente, Fabrikam.Product.Versions usa el nombre descriptivo 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>

Ejemplo de resolución

Actualice la definición de WIT de UserStory para que coincida con el 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: falta la referencia necesaria del complemento WorkItemTracking de la plantilla de proceso.

Debe especificar el complemento Microsoft.ProjectCreationWizard.WorkItemTracking en la sección metadata del archivo ProcessTemplate.xml:

Ejemplo de error

Falta el complemento Microsoft.ProjectCreationWizard.WorkItemTracking en la sección plugins del archivo 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>

Ejemplo de resolución

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

Categorías

El archivo de definición de Categories.xml debe cumplir la sintaxis y las reglas.

TF402546: la categoría [categoryName] falta en el archivo de categorías.

Todas las categorías a las que se hace referencia en el archivo ProcessConfiguration.xml deben definirse en el archivo Categories.xml. Además, el sistema requiere que el archivo Categories.xml contenga definiciones para las siguientes categorías:

• Categoría de errores
• Categoría de solicitud de revisión de código
• Categoría de respuesta de revisión de código
• Categoría de solicitud de comentarios
• Categoría de respuesta de comentarios
• Categoría de tipos ocultos
• Categoría de requisito
• Categoría de paso compartido
• Categoría de parámetro compartido
• Categoría de la tarea
• Categoría de caso de prueba
• Categoría de plan de prueba
• Categoría de conjunto de pruebas

Actualice el archivo Categories.xml para definir la categoría [name] que falta.

Ejemplo de error

ProcessConfiguration hace referencia a la categoría Epic; sin embargo, falta en el archivo de definición Categories.xml.

Ejemplo de resolución

La categoría Epic se ha agregado al archivo Categorías.

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

TF402553: el elemento [name] hace referencia a la categoría [categoryName] que no está definida en el archivo de categorías.

Actualice el archivo Categories.xml para definir la categoría [categoryName] que falta.

TF402560: ha definido [n] categorías. Solo se permiten [nn].

Revise el archivo Categories.xml para todas las instrucciones de elemento CATEGORY y determine cuáles se pueden eliminar para que no superen el límite permitido. A continuación, revise el archivo ProcessConfiguration.xml para reemplazar los valores que hacen referencia a las categorías eliminadas.

TF402596: la categoría [categoryName] no define el tipo de elemento de trabajo [witName].

Las categorías deben hacer referencia a los WIT que se definen en la carpeta /WorkItem Tracking/TypeDefinitions y se muestran como una tarea para cargar en el archivo del complemento WorkItems.xml.
Revise el archivo Categories.xml para ver las referencias a un WIT que no se incluye en la carpeta /WorkItem Tracking/TypeDefinitions.

Ejemplo de error

El nombre del WIT al que se hace referencia para Microsoft.EpicCategory está mal escrito.

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

Ejemplo de resolución

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

TF402597: no se admite la categoría personalizada [categoryName] porque ProcessConfiguration no hace referencia a ella.

Solo puede especificar categorías personalizadas que use para configurar una característica de herramienta ágil en ProcessConfiguration.
Revise el archivo ProcessConfiguration.xml y determine si no ha agregado compatibilidad con una categoría. De lo contrario, quite [categoryName] del archivo Categories.xml.

Ejemplo de error

ProcessConfiguration no hace referencia a Microsoft.EpicCategory, aunque se define en el archivo de definición de Categories.xml.

Ejemplo de resolución

Agregue PortfolioBacklog a ProcessConfiguration para hacer referencia 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>

Artículos de referencia:

• Referencia de elementos XML de ProcessConfiguration

Errores de complemento de clasificación

El archivo de definición de Classification.xml debe cumplir la sintaxis y las reglas.

TF402511: el complemento Clasificación contiene el nombre de propiedad duplicado: [propertyName].

Ejemplo de error

El archivo Classification.xml contiene una segunda instrucción property name="MSPROJ" bajo el elemento contenedor 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>

Ejemplo de resolución

Quite la instrucción duplicada.

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

TF402512: el archivo [fileName] no existe.

El archivo especificado en el archivo Classification.xml no está presente en la ruta de acceso especificada o la ruta de acceso está mal escrita.

Ejemplo de error

La ruta de acceso de la carpeta Clasificación está mal escrita.

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

Ejemplo de resolución

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

TF402513: el nombre [pathName] del complemento Clasificación no se ajusta a las restricciones de nomenclatura de TreePath.

Revise los Node elementos especificados y cambie los nombres para que se ajusten a las convenciones de nomenclatura admitidas. Referencia: Adición y modificación de rutas de área e iteración.

Ejemplo de error

Los nombres de ruta de acceso incluyen el carácter #, que no se permite.

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

Ejemplo de resolución

Los nombres de ruta se corrigen.

        <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] en el complemento Clasificación no se admite.

El atributo StructureType solo permite los siguientes valores: ProjectModelHierarchy y ProjectLifecycle.
Revise los Node elementos que especificó y quite los atributos no admitidos.

Ejemplo de error

ProjectLifecycle está mal escrito.

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

Ejemplo de resolución

Se ha corregido el nombre mal escrito.

        <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: falta o no se admite un atributo de propiedad en el complemento Clasificación.

El elemento property solo admite los siguientes atributos: name, value y isFile.
Revise los property elementos especificados y quite los atributos no admitidos.

Ejemplo de error

El atributo value está mal escrito.

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

Ejemplo de resolución

Se ha corregido el atributo mal escrito.

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

TF402516: el complemento Clasificación contiene más de dos nodos de nivel raíz, que no se admiten.

Revise los Node elementos que especificó y quite nodos de nivel raíz adicionales.

Ejemplo de error

El archivo Classification.xml contiene una segunda instrucción Node StructureType="ProjectLifecycle" bajo el elemento contenedor 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>

Ejemplo de resolución

Quite la segunda instrucción.

      <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: La ruta de acceso de área o iteración "[pathName]" en el complemento GroupsandPermissions falta en el complemento Classification.

Añada el [pathName] que falta al archivo Classification.xml o quítelo del archivo GroupsandPermissions.xml.

Ejemplo de error

El archivo Classification.xml especifica sprints, no iteraciones.

GroupsandPermissions.xmlteamSettings especifica iteraciones.

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

Sin embargo, el archivo 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>

Ejemplo de resolución

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

Tipos de vínculo

TF402561: ha definido [n] tipos de vínculo personalizados. Solo se permiten [nn].

Revise el archivo de complemento WorkItems.xml para todas las instrucciones de elementos LINKTYPE. Quite instrucciones asociadas a tipos de vínculo personalizados, de modo que no supere el límite permitido. A continuación, quite el archivo de definición de tipo de vínculo correspondiente de la carpeta LinkTypes.

Además, quite las referencias a los tipos de vínculo personalizados que agregó a una definición de WIT dentro de una sección LinksControlOptions en la sección FORM.

TF402583: el tipo de vínculo personalizado [name] no es válido porque no se admiten tipos de vínculo personalizados.

Revise el archivo de complemento WorkItems.xml para todas las instrucciones de elementos LINKTYPE. Quite las instrucciones que especifiquen un tipo de vínculo personalizado. A continuación, quite el archivo de definición de tipo de vínculo correspondiente de la carpeta LinkTypes.

Las siguientes instrucciones de elemento LINKTYPE dentro del archivo del complemento WorkItems.xml son 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 globales

TF402564: ha definido [n] listas globales. Solo se permiten [nn].

Uno o varios WIT definidos en la plantilla de proceso personalizado contienen un elemento GLOBALLIST. Busque en los archivos de definición de WIT y reemplace los elementos GLOBALLIST por elementos ALLOWEDVALUES o SUGGESTEDVALUES.

TF402565: ha definido [n] elementos de la lista global [globalListName]. Se permite un máximo de [nn].

El elemento GLOBALLIST con nombre contiene más elementos de los permitidos. Reduzca el número de elementos de lista contenidos en el elemento GLOBALLIST o segmente la lista global en dos o más elementos para que ninguna lista supere el número máximo de elementos permitidos.

Configuración de proceso

El archivo de definición ProcessConfiguration.xml debe cumplir la sintaxis y las reglas descritas en la referencia de elementos ProcessConfiguration XML.

TF402543: el elemento [elementName] requiere que asigne exactamente un estado de flujo de trabajo al metaestado [metastateName].

Actualice la sección States del elemento con nombre en el archivo ProcessConfiguration.xml para proporcionar la asignación de metaestado que falta o quite las asignaciones adicionales.

Ejemplo de error

Al elemento RequirementBacklog de ProcessConfiguration.xml le falta una asignación de metaestado para 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 >

Ejemplo de resolución

Se han añadido las asignaciones de metaestado que faltan.

<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: el elemento [elementName] requiere que para el tipo de elemento de trabajo [witName] asigne al menos un estado al metaestado [metastateName].

Revise los estados WORKFLOW definidos para el WIT especificado y, a continuación, actualice la sección States dentro de dicho elemento con nombre en el archivo ProcessConfiguration.xml para proporcionar la asignación de metaestado que falta para el WIT especificado.

TF402548: el elemento [elementName] requiere que asigne al menos un estado de flujo de trabajo al metaestado [metastateName].

Para proporcionar la asignación del metaestado que falta, actualice la sección States dentro del elemento con nombre en el archivo ProcessConfiguration.xml.

Ejemplo de error

Al elemento RequirementBacklog de ProcessConfiguration.xml le falta una asignación de metaestado para 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 >

Ejemplo de resolución

Se han añadido las asignaciones de metaestado que faltan.

<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: el elemento [elementName] incluye más de una asignación de metaestado para el estado de flujo de trabajo [stateName].

El valor de metastate no se puede asignar a más de un estado de flujo de trabajo.

Ejemplo de error

El elemento RequirementBacklog de ProcessConfiguration.xml contiene dos asignaciones de metaestado para 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 >

Ejemplo de resolución

Las asignaciones de metaestado se han corregido.

<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: el tipo de elemento de trabajo [witName] no define el estado de flujo de trabajo [stateName], que es necesario porque ProcessConfiguration lo asigna a un metaestado para el elemento [elementName].

Para añadir los elementos STATE y TRANSITION que faltan, corrija el archivo ProcessConfiguration.xml o la sección WORKFLOW del WIT con nombre.

Ejemplo de error

El elemento ProcessConfiguration.xml RequirementBacklog especifica value="Committed", pero UserStory.xml no define Committed como 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 >

Ejemplo de resolución

Se ha quitado el elemento State de Confirmados.

<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: el elemento [elementName] requiere que para el tipo de elemento de trabajo [witName] asigne exactamente un estado al metaestado [metastateName] para los estados siguientes: [stateNames].

Revise la sección STATES del archivo ProcessConfiguration.xml para el elemento con nombre y asegúrese de que cada estado enumerado en el mensaje de error está presente y asignado a un metaestado.

Ejemplo de error

Al elemento RequirementBacklog de ProcessConfiguration.xml le falta el estado New que existe en el tipo de elemento de trabajo User Story. Debe estar en la lista STATES asignada 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 >

Ejemplo de resolución

Se ha corregido el mapeo metastate.

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

TF402554: el elemento [elementName] especifica un metaestado no admitido [metastateName].

Revise la sección STATES del archivo ProcessConfiguration.xml para el elemento con nombre y elimine o corrija el metaestado con nombre.

Ejemplo de error

El elemento RequirementBacklog de ProcessConfiguration.xml contiene una asignación de metaestado escrita incorrectamente 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 >

Ejemplo de resolución

Se ha corregido el mapeo metastate.

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

TF402571: falta el elemento necesario [elementName] en Configuración del proceso.

Edite el archivo ProcessConfiguration.xml para agregar el elemento con nombre que falta.

Revise la referencia de elementos XML de ProcessConfiguration para los elementos necesarios.

TF402572: no se encuentra el archivo especificado en el paquete de plantilla de proceso.

En el archivo zip falta un archivo especificado en un archivo de complemento para la carga. Revise todos los archivos especificados para la carga y asegúrese de que se incluyen en el archivo ZIP del proceso.

Revise la referencia de elementos XML de ProcessConfiguration para los elementos necesarios.

TF402574: ProcessConfiguration no especifica el TypeFieldtypeField requerido.

Edite el archivo ProcessConfiguration.xml para agregar el elemento TypeField con nombre que falta.

Revise Referencia de elementos XML de ProcessConfiguration para los elementos TypeField necesarios.

Ejemplo

El proceso de Scrum especifica los siguientes elementos TypeField. Si falta alguno de estos elementos, recibirá un error 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: Varios trabajos pendientes de cartera [backlogNames] han definido [backlogName] como su elemento principal. Un trabajo pendiente principal solo puede tener un trabajo pendiente secundario.

Solo se puede asignar un trabajo pendiente de cartera secundario a un único trabajo pendiente principal.

Edite ProcessConfiguration para corregir las especificaciones de trabajos pendientes principal-secundario.

Ejemplo de error

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

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

Ejemplo de resolución

Para apuntar al trabajo pendiente Epic, cambie el elemento principal en el trabajo pendiente Feature.

  <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: El trabajo pendiente de cartera [backlogName] hace referencia a un trabajo pendiente de cartera principal [backlogName] no definido.

La definición de ProcessConfiguration.xml contiene un valor parent que hace referencia a un trabajo pendiente de cartera no definido.

Ejemplo de error

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

Ejemplo de resolución

Agregue el elemento Epic PortfolioBacklog al archivo 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: Varios trabajos pendientes de cartera [Trabajo pendiente 1, Trabajo pendiente 2] no definen su elemento principal.

Solo un trabajo pendiente de cartera, el trabajo pendiente superior, puede no ser principal. Todos los demás trabajos pendientes deben incluir un atributo y un valor parent="Microsoft.FooCategory".

Ejemplo de resolución

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

402595: Se han definido demasiados trabajos pendiente de cartera. Se permite un máximo de 5.

Edite el archivo ProcessConfiguration.xml para quitar los elementos PortfolioBacklog adicionales de la sección PortfolioBacklogs.

Para obtener más información, consulte la Referencia de elementos XML de ProcessConfiguration.

TF400506: este elemento define los estados de los elementos de trabajo que representan errores o defectos.

Este error se produce cuando la sección BugWorkItems está mal configurada. Cada estado definido para un tipo de elemento de trabajo incluido en Microsoft.BugCategory debe existir en el conjunto de valores de estado definidos en la sección BugWorkItems. Por ejemplo, si se definen los siguientes estados para los tipos de elementos de trabajo definidos para el tipo de elemento de trabajo Bug (New, Approved, Committed, Done), la sección BugWorkItems debe configurarse de la siguiente manera:

  <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 obtener más información, consulte Referencia de elementos XML de ProcessConfiguration.

TF400507: cada tipo de elemento de trabajo debe admitir un valor de estado inicial que coincida con uno de los estados definidos en: BugWorkItems.

Este error se produce cuando un tipo de elemento de trabajo incluido en Microsoft.BugCategory especifica un estado inicial que no se incluye en la sección BugWorkItems del archivo XML ProcessConfiguration. Corrija los estados de flujo de trabajo en la definición XML para los tipos de elementos de trabajo nombrados o actualice la sección BugWorkItems para incluir el estado que falta.

Para obtener más información, consulte Referencia de elementos XML de ProcessConfiguration.

TF400572: la configuración del proceso del proyecto debe configurarse para que se use esta característica.

Este error se debe a las plantillas antiguas, antes de que existiera la configuración del proceso del proyecto. Intente agregar el archivo XML ProcessConfiguration a la plantilla de proceso.

tipos de elemento de trabajo

TF402570: ha definido [n] tipos de elementos de trabajo. Se permite un máximo de [witLimit].

Ha definido más WIT de los permitidos en el proceso. Revise el archivo WorkItems.xml y reduzca el número de instrucciones WORKITEMTYPE que contiene y quite los archivos de definición de WIT asociados del proceso.

TF402573: el tipo de elemento de trabajo de WIT no especifica el atributo necesario refname.

Los tipos de elementos de trabajo (Bug, User Story, Task, etc.) requieren el atributo refname. El valor refname debe ser único y no puede contener ningún espacio de nombres reservado. Los espacios de nombres System.XXX y Microsoft.AzureDevOps.XXX están reservados por Azure DevOps.

Ejemplo de error

<WORKITEMTYPE name="Bug">

Ejemplo de resolución

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

TF402599: el refname del tipo de elemento de trabajo [refName] no es válido, ya que usa un espacio de nombres no permitido [namespace].

Los nombres de referencia de campos personalizados y WIT no pueden usar espacios de nombres reservados: sistema. XXX y Microsoft.AzureDevOps. XXX.

Edite el atributo refname del WIT con nombre.

Ejemplo de error

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

Ejemplo de resolución

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

TF402600: el nombre de referencia de tipo de elemento de trabajo [refName] no es válido. Los nombres de referencia de tipo de elemento de trabajo deben contener solo letras, sin espacios y al menos un punto (.)

Los nombres de referencia de WIT deben cumplir las convenciones de nomenclatura establecidas: solo letras, sin espacios y al menos un punto (.)

Edite el atributo refname del WIT con nombre para cumplir los requisitos de nomenclatura.

Ejemplo de error

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

Ejemplo de resolución

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

Campos de elementos de trabajo

TF402538: no se admite la regla de campo [ruleName].

Edite las definiciones de WIT para quitar la regla con nombre. No se admiten las reglas siguientes para la importación en Azure DevOps: MATCH, CANNOTLOSEVALUE, PROHIBITEDVALUES y NOTSAMEAS.

TF402539: el campo [refName] solo admite las siguientes reglas: [ruleNames].

Edite las definiciones de WIT para el campo con nombre y quite las reglas no permitidas. Revise las secciones FIELDS y WORKFLOW. La mayoría de los campos del sistema no permiten especificar reglas.

Reglas válidas que se usarán con campos del sistema

TF402540: el tipo de elemento de trabajo [witName] no es válido porque especifica la lista global [GLOBALLIST]. No se admiten listas globales.

Las listas globales no se admiten en Azure DevOps. Reemplace todas las instancias de elementos GLOBALLIST por elementos ALLOWEDVALUES y LISTITEM en todos los archivos de definición de WIT.

Ejemplo de error

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

Ejemplo de resolución

<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: el tipo de elemento de trabajo [witName] no es válido porque hace referencia a la lista global [globalListName]. No se admiten listas globales.

Las listas globales no se admiten en Azure DevOps. Reemplace todas las instancias de elementos GLOBALLIST por elementos ALLOWEDVALUES y LISTITEM en todos los archivos de definición de WIT.

Ejemplo de error

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

Ejemplo de resolución

<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: el refname de campo personalizado [refName] no es válido, ya que usa un espacio de nombres no permitido [namespace].

Los espacios de nombres - System.XXX y Microsoft.AzureDevOps.XXX - están reservados dentro de Azure DevOps. Los nombres de referencia de los campos y tipos personalizados no pueden usar estos espacios de nombres.

Para corregir este error, cambie el nombre del atributo refname del campo con nombre en los archivos de definición de WIT donde aparece.

Ejemplo de error

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

  - OR - 

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

Ejemplo de resolución

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

TF402544: el campo [refName], definido en el tipo de elemento de trabajo [witName], requiere una regla ALLOWEDVALUES que contenga valores para admitir el elemento [elementName] especificado en ProcessConfiguration.

Edite el campo con nombre en el WIT con nombre para proporcionar la regla ALLOWEDVALUES que falta, haciendo referencia al elemento con nombre para obtener más detalles.

El elemento de archivo ProcessConfiguration.xml, TypeField refname="Microsoft.AzureDevOps.Common.Activity" type="Activity" requiere que se defina una lista de selección para el campo Microsoft.AzureDevOps.Common.Activity en todos los WIT que pertenecen a la Categoría de Tarea.

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

Si ha agregado errores a la categoría de tareas, asegúrese de que el archivo Bug.xml contiene el campo con nombre y especifica la misma lista de selección que se define para ella en el archivo Task.xml.

Ejemplo de error

Bug.xml tiene definido el campo, pero no la lista de selección.

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

Ejemplo de resolución

Bug.xml corregido

      <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: el elemento [elementName] requiere que incluya el campo [fieldName] en la definición del tipo de elemento de trabajo [witName].

Debe incluir un elemento FIELD correspondiente en la definición de WIT con nombre para cada field que especifique dentro de la sección AddPanel del archivo ProcessConfiguration.xml.
También debe incluir un elemento Control dentro de la sección FORM del WIT con nombre.

Ejemplo de error

ProcessConfiguration especifica dos campos personalizados. Sin embargo, estos campos no están definidos en el archivo UserStory.xml.

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

Ejemplo de resolución

Se han agregado los elementos FIELD que faltan al archivo UserStory.xml.

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

Para admitir el elemento de ProcessConfiguration [elementName], el tipo de elemento de trabajo [witName] debe definir TypeField [typeField] ([refName] de refname de campo).

En ProcessConfiguration creó un TypeField con TypeFieldValues. En el tipo de elemento de trabajo, haga referencia a ese mismo TypeField.

Ejemplo de error

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 usa el campo Microsoft.AzureDevOps.Feedback.ApplicationType cuando debe usar el campo Custom.ApplicationType.

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

Ejemplo de resolución

FeedbackRequest.xml

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

TF402556: para que el campo [refName] esté bien definido, debe asignarle el nombre [fieldName] y establecer su tipo en [fieldType]. El [refName] proporcionado es [fieldName] y el tipo es [fieldType].

Si está en un servidor local y ejecuta tfsMigrator, este error se genera cuando el proceso no está actualizado y un campo del sistema no está definido correctamente. En la mayoría de los casos, use el witadmin /changefield comando para cambiar correctamente el nombre del campo.

Ejemplos de campos reservados

Sistema reservado. XXX y Microsoft.AzureDevOps.XXX requieren valores name y type.

Ejemplo de error

TF402556: para que el campo Microsoft.AzureDevOps.TCM.ReproSteps esté bien definido, debe asignarle el nombre Repro Steps y establecer su tipo en HTML. Dado que Microsoft.AzureDevOps.TCM.ReproSteps es "My Repro Steps" y el tipo es HTML.

En Bug.xml, el nombre descriptivo del campo cambió a "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> 

Ejemplo de resolución

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: existen definiciones incoherentes para el campo [refName] en los siguientes tipos de elemento de trabajo: [witName]. Asegúrese de que todas las referencias a un campo tengan el mismo RefName, Name y Type.

Las definiciones de elementos FIELD para los campos con el mismo nombre descriptivo deben ser coherentes entre los WIT. Compruebe que los atributos refname, name y type son los mismos en cada una de las definiciones de WIT para el campo con nombre.

Ejemplo de error

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 los name atributos y type difieren del tipo de elemento de trabajo Bug.xml.

Ejemplo de resolución

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: la definición del campo [refName] es incoherente con un campo existente. El type es [typeName], pero debe ser [typeName].

Edite el archivo WIT que contiene el campo con nombre para asegurarse de que el valor de atributo especificado type sea coherente en todas las WIT.

TF402562: ha definido [n] campos para el tipo de elemento de trabajo [witName]. Solo se permite [fieldLimit].

Ha definido [n] campos para el WIT especificado, lo que supera el número permitido de campos para cualquier WIT.

Edite el WIT con nombre y quite los campos personalizados adicionales para reducir el número total de campos que deben estar dentro del límite permitido.

TF402563: Definiste un total de [n] campos para todos los tipos de elementos de trabajo. Solo se permite [fieldLimit].

Ha definido [n] campos para todos los WIT definidos en el proceso. Solo se permiten [fieldLimit], lo que incluye campos del espacio de nombres System.XXX y Microsoft.AzureDevOps.XXX, así como campos personalizados.

Revise las secciones FIELDS y WORKFLOW y determine qué campos personalizados se van a quitar.

TF402566: ha definido [n] reglas de campo para el tipo de elemento de trabajo [witName]. Se permite un máximo de [ruleLimit].

Ha definido [n] reglas de campo para el WIT especificado, lo cual supera el número permitido de reglas de campo para cualquier WIT.

Edite el WIT con nombre y quite las reglas de campo adicionales para reducir el número total de campos que deben estar dentro del límite permitido.

TF402568: ha definido [n] campos con syncnamechanges="true" para el tipo de elemento de trabajo [witName]. Se permite un máximo de 64.

El número de campos con syncnamechanges="true" definidos para el WIT con nombre supera el límite permitido, que incluye los campos de espacio de nombres System.XXX y Microsoft.AzureDevOps.XXX y campos personalizados.

Revise la sección FIELDS del WIT con nombre y determine qué campos personalizados se van a quitar o modificar.

Ejemplo

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

TF402569: ha definido [n] valores para el campo [fieldName] en el tipo de elemento de trabajo [witName]. Se permite un máximo de [listLimit].

El número de elementos LISTITEM definidos para el campo con nombre en el WIT con nombre supera el límite permitido.

Edite el WIT con nombre para reducir el número de elementos LISTITEM para que no supere el máximo permitido.

Ejemplo

  <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 los valores refname de bug y user story son diferentes.

TF402584: no se admiten los atributos de regla de campo "for" o "not".

Los atributos "for" y "not" no se admiten para ninguna regla de campo para la importación a Azure DevOps Services en absoluto.
Revise las secciones FIELDS y WORKFLOW para ver la presencia de los atributos "for" y "not" y quítelos.

Ejemplo de error

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

Ejemplo de resolución

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

TF402593: no se admiten reglas de campo para el campo [fieldName].

La mayoría de los campos System y Microsoft.AzureDevOps no admiten reglas. Para obtener más información, consulte Reglas y evaluación de reglas.

Edite los archivos de definición de los tipos de elemento de trabajo que contienen el campo con nombre para quitar las reglas de campo especificadas para él.

TF402602: el campo [refName] debe tener exactamente estos valores [values].

• No modifique los campos reservados: no modifique ningún campo definido en los espacios de nombres reservados System.*XXX* y Microsoft.AzureDevOps.*XXX*.
• Definir campos personalizados: para tener una lista diferente de valores en los campos de la lista de selección, defina su propio campo personalizado.

Ejemplo de error

Bug.xml tiene definido el campo de prioridad, pero tiene una lista de valores diferente de la esperada.

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

Ejemplo de resolución

Bug.xml corregido, incluido un nuevo 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: no se encuentra el usuario o grupo [project]\Nombre del grupo. Compruebe que existen los usuarios y grupos usados en la definición de tipo de elemento de trabajo.

No se admiten grupos de ámbito de proyecto personalizados. Solo puede hacer referencia a grupos con ámbito de nivel de cuenta.

Ejemplo de error

Bug.xml hace referencia a un grupo con ámbito de proyecto.

... "[project]\Organization Leaders"

Ejemplo de resolución

Cree un nuevo grupo de nivel de cuenta (colección) "Líderes de la organización" y haga referencia a él en consecuencia en el XML.

... "[global]\Organization Leaders"

TF237094: el nombre de campo '[fieldName]' se usa en el campo '[refName]', por lo que no se pude usar en el campo '[refName]'.

El nombre del campo ya existe con ese mismo nombre en un campo diferente. Cambie el nombre del campo.

Ejemplo de error

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

Ejemplo de resolución

Cambiar el nombre del campo de Custom.NewField.ExternalID

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

Diseño del elemento de trabajo

VS403104: tipo de elemento de trabajo [witName] hace referencia al campo requerido [refName] que no se incluye en todos los diseños.

Esta advertencia se genera si tiene un campo necesario en un tipo de elemento de trabajo al que se hace referencia en el nodo <Layout>, pero no en <WebLayout>. El <WebLayout> se usa para modificar el diseño del nuevo formulario.

VS403073: Group & <Group Name>: infringe la regla que un grupo solo puede contener un único control HTML o WebPage precedido por los controles de etiqueta.

En el nuevo diseño de formulario, un grupo solo puede contener un HTMLFieldControl o WebPageControl.

Ejemplo de error

<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 este error, cree dos grupos independientes que contengan un control cada uno.

Ejemplo de resolución

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

TF402594: El archivo infringe el esquema con el siguiente error: el elemento 'Control' no puede contener el elemento secundario 'Link' porque el modelo de contenido del elemento primario está vacío.

Ejemplo de error

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

Ejemplo de resolución

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

Definiciones de flujo de trabajo

TF402567: ha definido [n] estados de flujo de trabajo para el tipo de elemento de trabajo [witName]. Se permite un máximo de [stateLimit].

Ha definido [n] estados de flujo de trabajo para el WIT nombrado que supera el número permitido para cualquier WIT.

Para reducir el número total de estados para que estén dentro del límite permitido, edite la sección WORKFLOW del WIT nombrado y quite los elementos STATE adicionales.

TF402578: el campo [refName] especifica el nombre descriptivo [friendlyName], que ya se usa en el campo [refName]. Los nombres descriptivos deben ser únicos en todas las definiciones de campo.

Los nombres de campo deben ser únicos dentro del tipo de elemento de trabajo.

Ejemplo de error

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

Observe que hay dos campos con el nombre <FIELD name="Foo".

Ejemplo de resolución

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

TF402579: el nombre [friendlyName] se usa varias veces en campos diferentes en los siguientes tipos de elementos de trabajo: [witNames]. El nombre de los campos debe ser único en toda la colección de proyectos.

Los campos que hacen referencia al mismo refname="MyCompany.FieldName" deben tener el mismo valor FIELD name="fieldname" de nombre descriptivo.

Ejemplo de error

Proceso A, Bug.xml

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

Proceso B, Bug.xml

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

Dado que ambos campos comparten el mismo nombre de referencia, refname="MyCompany.CustomFields.Foo", también deben especificar el mismo nombre <FIELD name="Foo" descriptivo en todos los procesos importados o que se importarán en Azure DevOps.

TF402580: solo puede usar el nombre [witName] para un solo tipo de elemento de trabajo.

Los nombres descriptivos de WIT WORKITEMTYPE name="Name" deben ser únicos dentro del proceso.

Ejemplo de error

Mi elemento de trabajo A.xml

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

Mi elemento de trabajo B.xml

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

Observe cómo WORKITEMTYPE name= es el mismo en ambos tipos de elementos de trabajo.

Ejemplo de resolución

Mi elemento de trabajo A.xml

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

Mi elemento de trabajo B.xml

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

TF402581: solo puede usar el refname [refname] para un solo tipo de elemento de trabajo.

Los nombres de referencia de WIT refname="value" deben ser únicos dentro del proceso.

Ejemplo de error

Bug.xml

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

UserStory.xml

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

Ambos refname valores son iguales a "MyCompany.Name"

Ejemplo de resolución

Bug.xml

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

UserStory.xml

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

TF402582: el tipo de elemento de trabajo [witName] contiene el control personalizado [controlName] que no se admite.

Los controles personalizados no se admiten en Azure DevOps Services. Revise la sección FORM para el WIT con nombre y quite los controles personalizados que estén definidos.

Ejemplo de error

Type="OneViewMultiValueControl" especifica un control personalizado. Quite o reemplace este control personalizado por un control compatible.

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