Importar o actualizar elementos de trabajo de forma masiva mediante archivos CSV en Azure Boards

Puede importar y exportar elementos de trabajo de forma masiva mediante un archivo con formato CSV. Aunque puede seguir usando Excel para la importación y actualizaciones masivas, puede usar la característica nativa de importación y exportación que no requiere Excel. Para más información sobre el uso de Excel, consulte Agregar o modificar elementos detrabajo de forma masiva con Excel .

Puede exportar elementos de trabajo de forma masiva mediante un archivo con formato CSV. Aunque siga usando Excel para la importación y las actualizaciones masivas, puede usar la característica de exportación nativa de consultas que no requiere Excel. Para más información sobre el uso de Excel, consulte Agregar o modificar elementos detrabajo de forma masiva con Excel .

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 nuevo estado. Por ejemplo, al crear un nuevo caso de usuario con el proceso agile, State=New y Reason=New. No se puede especificar ningún otro valor.

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

2. El archivo debe contener los campos Tipo de elemento de trabajoy Título. Puede incluir otros campos según sea necesario. Para obtener una lista de campos predeterminados, vea Índice de campo de elemento de trabajo.

   En el ejemplo siguiente, 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 Boards consultas y elija la opción Importar elementos de trabajo.

   

4. Seleccione el archivo CSV y, a continuación, elija Importar.

   

5. 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 ID. Compruebe que los resultados son los que desea. A continuación, elija Guardar elementos para guardar los elementos de trabajo.

   

   Nota:

   Asegúrese de que no asigna los iDs a los nuevos elementos de trabajo que va a agregar. Si lo hace, recibirá un mensaje de error similar al siguiente.

   

6. El sistema resalta esos elementos de trabajo con problemas de datos. Resuelva los problemas de datos antes de guardar los elementos de trabajo. En este ejemplo, se ha especificado un valor no válido en el campo Prioridad. 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.

   

Actualización de elementos de trabajo existentes

1. Para actualizar los elementos de trabajo, cree una consulta que contenga todas las columnas que desea 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 debe ser similar a la sintaxis siguiente:

    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 modificaciones en los elementos de trabajo. El archivo CSV debe contener los campos Id.,Tipo de elemento de trabajo,Títuloy Estado. Los demás campos que quiera incluir son opcionales.

   Nota:

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

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

    ID,Work Item Type,State,Assigned To,Title,Tags
    "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 impórtese (consulte los pasos 4 a 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. Elija Guardar elementos para aplicar los cambios.

   

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

   

Exportación de la 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, elija el icono de acciones y elija 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 proyecto. Sin embargo, antes de importarlos a otro proyecto, debe quitar el identificador del elemento de trabajo. Se produce un error si intenta importar nuevos elementos de trabajo a un proyecto con un identificador 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 rodeando las oraciones por <p>... </p> .

Por ejemplo, puede importar el siguiente 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 & y respuestas

¿Puedo importar nuevos elementos y actualizar los elementos existentes en el mismo archivo CSV?

Por supuesto. Deje el campo ID vacío para los nuevos elementos de trabajo. En el ejemplo siguiente, la última entrada de una epopeya no especifica un identificador.

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 Telementry for data imports",,"To Do","2",

¿Puedo importar un archivo CSV que tenga vínculos de elementos primarios y secundarios?

Sí, puede agregar elementos de trabajo secundarios mediante la sangría de columnas de título. En el ejemplo siguiente se agregan tres problemas secundarios en la epopeya ya definida.

ID,Work Item Type,Title 1,Title 2,Assigned To,State,Priority,Tags
"165","Epic","Track Telementry 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",

Este es un objeto visual mejor en Excel.

Cómo saber si mi archivo importado tiene errores?

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 son correctos.

Los resultados de los elementos de trabajo siempre muestran los errores de datos encontrados para los elementos de trabajo individuales. Corrija cada error desde el portal web o en el archivo CSV e impórtese de nuevo.