Importación, actualización y exportación de elementos de trabajo masivos con archivos CSV en Azure Boards

  • Artículo

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

Importe y exporte elementos de trabajo de forma masiva mediante archivos con formato CSV en Azure Boards. 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.

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 nativa de exportación de Queries 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.

Importación de nuevos elementos de trabajo

Realice estos pasos para importar nuevos 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.

  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 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 luego elija Importar elementos de trabajo.

    Captura de pantalla que muestra la página Paneles con Consultas y, a continuación, Importar elementos de trabajo seleccionados.

  4. Seleccione Elegir archivo, elija el archivo y luego seleccione Importar.

    Captura de pantalla que muestra el cuadro de diálogo Importar elementos de trabajo con el botón Importar resaltado.

    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.

    Captura de pantalla que muestra Guardar elementos para elementos de trabajo importados.

    Sugerencia

    No asigne identificadores a nuevos elementos de trabajo que agregue. La asignación de identificadores genera un mensaje de error.

  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, hay 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.

    Captura de pantalla que muestra los elementos de trabajo con problemas de datos que se van a corregir.

Las siguientes sugerencias pueden ser útiles.

  • Vínculos primarios y secundarios: Puede agregar vínculos primarios y secundarios entre los elementos de trabajo que importe aplicando sangría a las columnas de título, tal como se muestra en el ejemplo ¿Puedo importar un archivo CSV que tenga vínculos primarios y secundarios? Sin embargo, no puede especificar ningún otro tipo de vínculo al importar o actualizar elementos de trabajo.

  • Campo Estado predeterminado: al importar nuevos elementos de trabajo, el campo Estado se establece en Nuevo de forma predeterminada. No se puede indicar un estado diferente durante el proceso de importación. Si necesita cambiar el estado de los elementos de trabajo importados, use la siguiente solución alternativa:

    1. Importe los elementos de trabajo con el estado Nuevo predeterminado.
    2. Exporte los elementos de trabajo importados a un archivo CSV.
    3. Actualice los valores del campo Estado en el archivo CSV exportado.
    4. Vuelva a importar el nuevo archivo CSV modificado para activar los estados deseados.

  • Campos de área e iteración predeterminados: los campos Área e Iteración predeterminados para el nodo de nivel superior. Esto se produce porque el proceso de importación no tiene el contexto de estos campos a menos que se indique expresamente en el archivo CSV. Para establecer rutas de acceso de área e iteración específicas durante la importación, asegúrese de que estos campos se incluyen en el archivo CSV con los valores correctos. Por ejemplo:

    Title,Description,Area Path,Iteration Path
"Sample Work Item","This is a sample description.","Project\Team","Project\Sprint 1"

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 la máquina local.

    Captura de pantalla que muestra los elementos de trabajo en una consulta con la opción Exportar a CSV seleccionada.

    El archivo exportado debe tener un aspecto similar al del ejemplo siguiente:

    ID,Work Item Type,Title,Assigned To,State,Tags
"272","Issue","Fix issues with code","Active","",
"273","Issue","Merge testing modules","Active","",
"274","Issue","Open private preview for select customers","Active","",
"275","Issue","Enable feature for customer champs","Active","",
"276","Issue","Remove old test code","Active","",

  2. Realice las ediciones en los elementos de trabajo. El archivo CSV debe contener los campos ID, Tipo de elemento de trabajo y Título. 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 el ejemplo siguiente, se cambian los valores de los elementos de trabajo existentes.

    ID,Work Item Type,Title,Assigned To,State,Tags
"272","Issue","Fix issues with code","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
"273","Issue","Merge testing modules","Jamal Hartnett <fabrikamfiber4@hotmail.com>","Active",
"274","Issue","Open private preview for select customers","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
"275","Issue","Enable feature for customer champs","Raisa Pokrovskaya <fabrikamfiber5@hotmail.com>","Active",
"276","Issue","Remove old test code","Christie Church <fabrikamfiber1@hotmail.com>","Active",

  3. Guarde el archivo e importe, como se describe en la secció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.

    Captura de pantalla que muestra importar elementos de trabajo con la opción Guardar elementos.

  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.

    Captura de pantalla que muestra un valor no válido que aparece en el campo Asignado a.

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.

Nota:

Requiere Azure DevOps Server 2019 Update 1 o una versión posterior.

Captura de pantalla donde ve la opción Exportar una consulta como 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.

Importar campos HTML

Los campos HTML, como descripciones y criterios de aceptación, incluyen formato de texto enriquecido. Para asegurarse de que se conserva este formato, realice las siguientes acciones:

  1. Asegúrese de que el archivo CSV incluye etiquetas HTML dentro de los campos correspondientes.
  2. Importe el CSV en Excel.

Excel puede trabajar con campos de texto de varias líneas de forma diferente, por lo que es importante comprobar el formato después de la importación. Reemplace las líneas que terminan en CRLF por enunciados rodeados 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>"

Convertir campos de varias líneas en texto sin formato

Para deshabilitar HTML en campos de varias líneas para asegurarse de que son texto no cifrado, puede usar el witadmin changefield comando . Para obtener más información, vea Administrar campos de elemento de trabajo.

Comando de ejemplo:

witadmin changefield /collection:CollectionURL /n:FieldName /type:PlainText

Controlar incoherencias de formato

Al trabajar con campos HTML en distintos productos de Microsoft, es posible que detecte incoherencias en el formato. Estas son algunas sugerencias para arreglar estos problemas:

  • Revise el formato después de importar para asegurarse de que cumple sus requisitos.
  • Use las etiquetas y estructuras HTML adecuadas para minimizar las discrepancias. Puede agregar varias etiquetas separadas por punto y coma. Para obtener más información, vea Tareas que puede y no puede hacer con Excel.

Para obtener más información sobre cómo administrar el contenido HTML y garantizar la compatibilidad, vea Proporcionar texto de ayuda, hipervínculos o contenido web en un formulario de elemento de trabajo.

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

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

Captura de pantalla de vista de Excel.

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.

Captura de pantalla que muestra un error CSV en la página Importar elementos de trabajo.

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 desde CSV, por motivos de rendimiento, el selector de identidades no pasa por estos pasos adicionales. Solo comprueba si ya hay un nombre principal de usuario (UPN) coincidente en la organización. Si no encuentra un UPN coincidente, informa de que la identidad es desconocida.

P: ¿La importación de archivos .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.