Importación y actualización masiva de elementos de trabajo con archivos CSV

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Puede importar y exportar elementos de trabajo de forma masiva mediante un archivo con formato .csv en Azure DevOps. Aunque puede seguir usando Excel para la importación y las actualizaciones masivas, puede usar la característica nativa de importación y exportación que no requiere Excel. Para obtener más información, consulte Adición o modificación de elementos de trabajo de Azure Boards de forma masiva con Microsoft Excel.

Nota:

La característica de exportación está disponible con Azure DevOps Server 2019 Actualización 1 y versiones posteriores. La característica de importación está disponible con Azure DevOps Server 2020 y Azure DevOps Services.

Importación de nuevos elementos de trabajo

Todos los elementos de trabajo que importe se crean en un estado Nuevo. Esta regla significa que no se pueden especificar valores de campo que no cumplan las reglas de campo para el estado nuevo. Por ejemplo, al crear un nuevo caso de usuario con el proceso Agile, State = New y Reason = New. No se pueden especificar otros valores.

1. Cree un archivo import.csv local y ábralo en Visual Studio Code o Excel.

2. El archivo debe contener el los campos Tipo de elemento de trabajo y Título. Puede incluir otros campos según sea necesario. A fin de obtener una lista de campos predeterminados, vea Descripciones de campos para campos predeterminados y de elementos de trabajo usados en plantillas de proceso.

   En este ejemplo, se incluye el campo Prioridad.

   Work Item Type,Title,Priority
   Issue,Fix issues with code,1
   Issue,Merge testing modules,3
   Issue,Open private preview for select customers,2
   Issue,Enable feature for customer champs,2
   Issue,Remove old test code,2
   

3. En el portal web del proyecto, abra Paneles - Consultas y elija la opción Importar elementos de trabajo.

   

4. Seleccione el archivo .csv y, después, Importar.

   

   El proceso de importación carga los elementos de trabajo importados en la vista de consultas en un estado no guardado. No se asigna ningún identificador.

5. Compruebe los resultados y seleccione Guardar elementos para guardar los elementos de trabajo.

   

   Sugerencia

   No asigne identificadores a nuevos elementos de trabajo que agregue; de lo contrario, recibirá un mensaje de error.

   TFS401232: El elemento de trabajo 1794 no existe o no tiene permisos para leerlo.

6. El sistema resalta esos elementos de trabajo con incidencias de datos. Resuelva las incidencias de datos antes de guardar los elementos de trabajo. En este ejemplo, se ha especificado un valor no válido en el campo Priority. Corrija los datos abriendo el elemento de trabajo directamente. En su lugar, use la edición masiva para corregir varios elementos de trabajo con el mismo problema.

   

Sugerencia

Puede agregar vínculos primarios y secundarios entre los elementos de trabajo que importe mediante la sangría de las columnas de título, como se muestra en el ejemplo que aparece más adelante en este artículo, ¿Puedo importar un archivo .csv que tenga vínculos primarios y secundarios?. Pero no puede especificar ningún otro tipo de vínculo al importar o actualizar elementos de trabajo.

Nota:

Puede importar hasta 1000 elementos de trabajo a la vez. Si tiene más de 1000 elementos de trabajo para importarlos, divídalos en varios archivos e impórtelos por separado.

Actualización de elementos de trabajo existentes

1. Para actualizar los elementos de trabajo, cree una consulta que contenga todas las columnas que quiere exportar y, posiblemente, editar. Guarde la consulta y seleccione Exportar a CSV para guardar el archivo data.csv en el equipo local.

   

   El archivo exportado debería ser similar a esta sintaxis:

    ID,Work Item Type,State,Assigned To,Title,Tags
    "1043","Issue","To Do",,"Fix issues with code",
    "1044","Issue","To Do",,"Merge testing modules",
    "1045","Issue","To Do",,"Open private preview for select customers",
    "1046","Issue","To Do",,"Enable feature for customer champs",
    "1047","Issue","To Do",,"Remove old test code",
   

2. Realice las ediciones en los elementos de trabajo. El archivo .csv debe contener los campos Id., Tipo de elemento de trabajo, Título y Estado. Los demás campos que quiera incluir son opcionales.

   Nota:

   Al importar campos de identidad, escriba el nombre y el correo electrónico en el formato siguiente "Display Name <email>". Por ejemplo, para asignar trabajo a Jamal Hartnett, especifique "Jamal Hartnett <fabrikamfiber4@hotmail.com>". Si especifica un valor que no se reconoce como un usuario válido para el sistema, es posible que tenga problemas con la importación.

   En este ejemplo, se cambian varios valores en los elementos de trabajo existentes.

   "1043","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Fix issues with code",architecture
   "1044","Issue","To Do","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Merge testing modules",testing
   "1045","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Open private preview for select customers","customer focus"
   "1046","Issue","To Do","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Enable feature for customer champs","customer focus"
   "1047","Issue","To Do","Christie Church <fabrikamfiber1@hotmail.com>","Remove old test code",architecture```
   
   

3. Guarde el archivo e importe (consulte los pasos 4-6 de la sección de importación anterior).

4. La lista de resultados con elementos de trabajo que contienen cambios de valor aparece resaltada en negrita. Seleccione Guardar elementos para aplicar los cambios.

   

5. Los elementos de trabajo con incidencias de datos se resaltan en rojo y deben resolverse para poder guardarlos. En este ejemplo, aparece un valor no válido en el campo Asignado a. Corrija los datos abriendo el elemento de trabajo directamente. Puede usar la edición masiva si tiene muchos elementos de trabajo con el mismo problema.

   

Exportación de una lista como un archivo .csv

Desde cualquier consulta, puede exportar una lista de elementos de trabajo como una lista delimitada por comas. Abra la consulta, seleccione el icono de acciones y, a continuación, seleccione Exportar a CSV.

Exportación e importación de elementos de trabajo a un proyecto diferente

Puede usar esta característica para exportar elementos de trabajo de un proyecto e importarlos a otro. Sin embargo, antes de importarlos a otro proyecto, debe quitar el id. de elemento de trabajo. Le aparece un error si intenta importar elementos de trabajo nuevos a un proyecto con un id. especificado.

Importación o actualización de campos de texto enriquecido

Puede actualizar o importar campos de texto enriquecido, como los campos Descripción o Criterios de aceptación. Los campos de texto enriquecido son campos con formato HTML. Reemplace las líneas que terminan en CRLF por oraciones rodeadas por <p>... </p>.

Por ejemplo, puede importar este elemento de trabajo, que incluye tres líneas de texto en el campo Descripción.

Work Item Type,Title,Description
"Product Backlog Item","Hello World Web Site - 8","<p><strong>&nbsp;You can include bold text</strong></p><p><em>&nbsp;And italic text</em></p><p><u>&nbsp;Underline text</u></p>"

Preguntas más frecuentes

P: ¿Puedo importar elementos nuevos y actualizar los elementos existentes en el mismo archivo .csv?

R: Por supuesto. Deje el campo id. vacío para los elementos de trabajo nuevos. En este ejemplo, la última entrada de una Epopeya no especifica un id.

ID,Work Item Type,Title,Assigned To,State,Priority,Tags
"16504","Issue","Fix issues with code",,"To Do","1",
"16505","Issue","Merge testing modules",,"To Do","3",
"16506","Issue","Open private preview for select customers",,"To Do","2",
"16507","Issue","Enable feature for customer champs",,"To Do","2",
"16508","Issue","Remove old test code",,"To Do","2",
,"Epic","Track Telemetry for data imports",,"To Do","2",

P: ¿Cómo puedo agregar varias etiquetas?

R: Puede agregar varias etiquetas separadas por un punto y coma. Para obtener más información, vea Tareas que puede y no puede hacer con Excel.

P: ¿Puedo importar un archivo .csv que tenga vínculos primarios y secundarios?

R: Sí, puede agregar elementos de trabajo secundarios mediante la sangría de columnas de título. En este ejemplo se agregan tres incidencias secundarias en el epic ya definido.

ID,Work Item Type,Title 1,Title 2,Assigned To,State,Priority,Tags
"165","Epic","Track Telemetry for data imports",,,"To Do","2",
,"Issue",,"Fix issues with code",,"To Do","1",
,"Issue",,"Open private preview for select customers",,"To Do","2",
,"Issue",,"Enable feature for customer champs",,"To Do","2",

P: ¿Cómo sé si mi archivo importado tiene errores?

R: Puede probar a agregar etiquetas con espacios y guiones, por ejemplo, e incluirlo en la exportación. La importación debe coincidir con el mismo formato. Los problemas con el formato del archivo .csv aparecen en la página Resultados de la vista de importación. No se pueden importar los elementos de trabajo hasta que el formato y la sintaxis sean correctos.

Los resultados de los elementos de trabajo siempre enumeran los errores de datos encontrados para los elementos de trabajo individuales. Corrija cada error desde el portal web o en el archivo .csv e importe de nuevo.

P: ¿Por qué recibo errores para algunos valores de identidad?

R: Al usar la interfaz de usuario web, el selector de identidades tiene pasos adicionales para validar al usuario. En primer lugar, comprueba si la persona es un usuario válido en la organización. Si no es así, busca en la identidad de Microsoft Entra ID. Si el usuario está en el identificador de Microsoft Entra, pero no en la organización, ese usuario se agrega a las identidades válidas. Al importar mediante un archivo .csv, por motivos de rendimiento, el selector de identidades no realiza estos pasos adicionales. Solo comprueba si ya hay un UPN coincidente en la organización. Si no encuentra un UPN coincidente, informa de que la identidad es desconocida.

P: ¿La importación de archivo .csv admite todos los tipos de elementos de trabajo?

R: No, la importación del archivo .csv no admite estos tipos de elementos de trabajo:

• Solicitud de revisión de código
• Respuesta de revisión de código
• Solicitud de comentarios
• Respuesta a comentarios
• Caso de prueba
• Plan de prueba
• Conjunto de pruebas
• Parámetro compartido

Para obtener más información, consulte Importación masiva o exportación de casos de prueba.

Artículos relacionados

• Índice de campo de elemento de trabajo
• Agregar o modificar en bloque elementos de trabajo con Excel
• Preguntas frecuentes sobre el uso de Excel en conexión con Azure Boards