Importante
Esta función de importación está disponible en nuestra rama «Dev».

Importar paquetes de trabajo desde un archivo CSV

Puede crear varios paquetes de trabajo a la vez cargando un archivo CSV. Los paquetes de trabajo existentes nunca se modifican al realizar una importación, y no se envían notificaciones respecto a los paquetes de trabajo que esta genera.

Resumen

Tema	Contenido
Antes de empezar	El permiso que necesita y la plantilla con la que puede empezar.
Importar un archivo	Cómo comprobar primero un archivo y, a continuación, importarlo.
Referencia de la columna	Todas las columnas que se pueden importar y cómo se asignan sus valores.
Límites	¿Cuál es el tamaño máximo que puede tener un archivo?
Lo que no se importa	Lo que la importación de archivos CSV no cubre actualmente.

Antes de empezar

Nota
Necesita el permiso Importar paquetes de trabajo para poder importar paquetes de trabajo a un proyecto. Se puede asignar a un rol en la administración de roles y permisos, junto con el permiso Añadir paquetes de trabajo que requiere.

Para abrir la página de importación, vaya a Configuración del proyecto en su proyecto y seleccione Importador de paquetes de trabajo en la barra lateral.

Empiece por la plantilla. El enlace Descargar la plantilla de la página de importación le proporciona un archivo CSV con los encabezados de columna exactos que admite este proyecto y dos líneas de ejemplo. Sustituya los ejemplos por los suyos propios, mantenga la línea de encabezado y guarde el archivo como CSV UTF-8.

El archivo debe ser un archivo .csv codificado en UTF-8 o UTF-16. Se aceptan como separadores la coma, el punto y coma y la tabulación, y el separador se detecta a partir de la línea de encabezado, por lo que un archivo exportado desde una aplicación de hoja de cálculo en cualquier configuración regional puede cargarse tal cual. Un valor que contenga el separador, un salto de línea o una comilla debe ir entre comillas, algo que las aplicaciones de hojas de cálculo hacen automáticamente por usted.

Importar un archivo

Seleccione el archivo en la sección Archivo CSV.
Deje seleccionada la opción Comprobar primero el archivo, sin importarlo. A continuación, cada línea se valida y se registra, pero no se crea nada.
Seleccione Comprobar archivo.
Lea el informe. Si el archivo presenta errores, cada uno de ellos se indica junto con la línea en la que se encuentra, la columna, el valor y cuál es el problema. Un archivo con numerosos problemas muestra los primeros 500 en la página; la descarga en formato CSV que aparece junto a la lista siempre contiene todos ellos, por lo que podrá revisarlos en su programa de hojas de cálculo.
Corrija el archivo y compruébelo de nuevo, hasta que el informe no muestre ningún problema.
Seleccione el botón Importar, en el que se indica el número de paquetes de trabajo que se crearán, para crearlos.

El resumen que aparece tras una comprobación satisfactoria le indica cuántas líneas se han leído, cuántas cuentas contiene el archivo según las columnas «Asignado», «Responsable» y «Autor», y qué tipos, estados, prioridades y categorías presentan dichas líneas, de modo que pueda comprobar que el archivo se ha interpretado tal y como usted lo pretendía antes de que se cree nada.

Una vez ejecutada la importación, el informe incluye enlaces a los paquetes de trabajo que se han creado. El enlace abre una vista denominada Importación de CSV del día y la hora de la ejecución, guardada de forma privada para usted, que también aparece entre sus propias vistas en la barra lateral del módulo de paquetes de trabajo. Elimínela como lo haría con cualquier otra vista cuando ya no la necesite.

Borrar descarta el informe y le devuelve el formulario en blanco. Esta opción aparece junto al botón en todos los casos, por lo que nunca tendrá que dejar en la página un informe que ya haya completado o un archivo que haya sido rechazado.

Consejo
El archivo marcado se conserva durante unas horas, por lo que no es necesario que lo vuelva a subir al realizar la importación. Si vuelve a consultar el informe más adelante y el archivo ha caducado, vuelva a subirlo. Se comprueba una vez más antes de crear nada.

Puede desmarcar la casilla Comprobar primero el archivo, sin importarlo para proceder a la importación de inmediato. El botón muestra entonces el texto Importar archivo, por lo que siempre indica lo que va a suceder.

Una importación es todo o nada. Si no se puede crear alguna línea, no se crea nada, y el informe enumera todos los problemas del archivo en lugar de detenerse en el primero. Se le registrará como autor de cada paquete de trabajo que genere la importación, a menos que el archivo indique a otra persona en la columna «Autor».

Referencia de columna

La línea de encabezado determina qué se importa. El orden de las columnas es libre, y solo necesita las columnas que desee rellenar. Si aparece un encabezado que no figure en la tabla que figura a continuación, la importación se detendrá antes de que se lea ninguna línea; lo mismo ocurrirá si un mismo atributo aparece dos veces.

Columna	Contenido	Obligatorio	Formato y correspondencias
`Asunto`	El nombre del paquete de trabajo	Sí	Texto
`Descripción`	La descripción	No	Texto. Un valor que contenga saltos de línea debe ir entre comillas.
`Tipo`	Tarea, hito, fase, etc.	No	Coincidencia por nombre, sin tener en cuenta las mayúsculas y minúsculas. El tipo debe estar habilitado en este proyecto.
`Estado`	El estado	No	Coincidencia por nombre, sin tener en cuenta las mayúsculas y minúsculas. El estado debe existir.
`Prioridad`	La prioridad	No	Coincidencia por nombre, sin tener en cuenta las mayúsculas y minúsculas. La prioridad debe existir y estar activa.
`Categoría`	La categoría	No	Coincidencia por nombre, sin tener en cuenta las mayúsculas y minúsculas. La categoría debe existir en este proyecto.
`Versión`	La versión	No	Coincidencia por nombre; no se distingue entre mayúsculas y minúsculas. La versión debe estar abierta y disponible en este proyecto. En la celda solo se admite una versión.
`Asignado`	El asignado	No	Se compara con la dirección de correo electrónico con la que el usuario inicia sesión, sin tener en cuenta las mayúsculas y minúsculas. Se debe permitir que se asignen paquetes de trabajo a este usuario en este proyecto.
`Responsable`	El responsable	No	Se compara de la misma forma que «`Asignado`».
`Autor`	Quién creó el paquete de trabajo	No	Coinciden por dirección de correo electrónico. Si lo deja en blanco o omite la columna, se le registrará como autor.
`Fecha de inicio`	La fecha de inicio	No	`AAAA-MM-DD`, por ejemplo, `2026-03-17`.
`Fecha de finalización`	La fecha de finalización	No	`AAAA-MM-DD`.
`Trabajo`	El trabajo estimado	No	Horas expresadas como un número, por ejemplo, «8» o «7,5», o como una duración, como «1 h 30 m».
`Trabajo restante`	El trabajo que aún queda por hacer	No	Se escribe como `Work`. No está disponible mientras se calcula el progreso a partir del estado.
`% completado`	El progreso	No	Un número entero comprendido entre 0 y 100, con o sin el signo de porcentaje. No está disponible mientras se calcula el progreso a partir del estado.
`Creado el`	Cuándo se creó el paquete de trabajo	No	`AAAA-MM-DDTHH:MM:SSZ`, por ejemplo, `2025-11-04T09:30:00Z`. No en el futuro.
`Actualizado el`	Cuándo se actualizó por última vez	No	`AAAA-MM-DDTHH:MM:SSZ`. Ni en el futuro, ni antes de «Creado el».

Los valores que no se ajustan a los requisitos se indican junto a la línea en la que aparecen, y el informe enumera los valores que se habrían aceptado, por lo que es fácil corregir rápidamente un error ortográfico en el tipo o el estado.

Los campos «Creado el» y «Actualizado el» están previstos para los paquetes de trabajo procedentes de otro sistema y que deben conservar sus fechas. La opción «Creado el» también desplaza la entrada de creación en la actividad del paquete de trabajo, por lo que una comparación de base de referencia correspondiente a un periodo anterior a la importación se comporta tal y como lo habría hecho en ese momento.

Nota
Los encabezados de las columnas también se aceptan en el idioma en el que utilice OpenProject. Un archivo creado con encabezados en alemán, como «Thema» y «Zugewiesen an», se importa siempre que su idioma esté configurado en alemán. No obstante, no se garantiza que las traducciones sean compatibles entre versiones, por lo que es posible que un archivo importado en una versión de OpenProject no se acepte en otra. Los encabezados en inglés de la tabla anterior funcionan siempre, independientemente del idioma que se haya configurado, por lo que la plantilla descargable los utiliza.

Todo lo que el formulario del paquete de trabajo rechazaría se rechaza también aquí, línea por línea: un asunto que falta, una fecha de finalización anterior a la fecha de inicio, un tipo que no tiene ese estado en su flujo de trabajo.

Una celda vacía significa «no especificado», y el paquete de trabajo se crea con los valores que le asignen el proyecto y el tipo. No existe forma de indicar «explícitamente vacío» en un archivo CSV, por lo que un valor establecido por defecto no puede borrarse dejando la celda en blanco.

Límites

Un archivo puede contener hasta 5000 líneas y tener un tamaño máximo de 5 MB de forma predeterminada. Divida una importación de gran tamaño en varios archivos. En la página de importación se indican los límites que se aplican a su instancia.

Ambos límites son configurables. El límite de tamaño de archivo es el que se aplica a cada archivo adjunto, por lo que un administrador puede modificarlo en Administración, Archivos, Archivos adjuntos. El límite de filas no se configura en la administración: se establece para la instancia mediante la variable de entorno OPENPROJECT_WORK__PACKAGE__IMPORT__MAX__ROWS, para lo cual es necesario tener acceso al servidor en el que se ejecuta la instancia.

Lo que no se importa

La importación de un archivo CSV crea paquetes de trabajo. Actualmente no realiza ninguna de las siguientes acciones.

Modificar los paquetes de trabajo existentes: cada línea crea un nuevo paquete de trabajo. No hay forma de dirigirse a uno que ya existe.
Crear jerarquías: es necesario establecer las relaciones entre elementos principales y secundarios tras la importación.
Crear relaciones: no se leen los predecesores, los sucesores ni los demás tipos de relación.
Rellene los campos personalizados: solo se aceptan las columnas indicadas anteriormente.
Configurar observadores o archivos adjuntos:
Leer archivos de hoja de cálculo: guarde primero un archivo .xlsx o .ods como CSV.