ITACA → iDoceo

Convierte localmente listados PDF de alumnado de ITACA (Generalitat Valenciana) en archivos .xlsx preparados para importar en iDoceo.

[!IMPORTANT] La herramienta no sube PDF ni datos del alumnado a ningún servicio. No contiene telemetría, analítica ni funciones de red para procesar los listados: la lectura del PDF y la generación del XLSX se realizan íntegramente en el equipo del usuario.

Compatibilidad actual

La versión 0.6.0a14 es una alpha y ha sido validada con listados reales «LLISTAT D'ALUMNES AMB ASSIGNATURES» generados desde ITACA 3 / Gestión Administrativa, incluidos casos de ESO, Bachillerato y FP.

Antes de procesar un listado, la aplicación comprueba la firma estructural del formato actualmente soportado mediante una de las filas de cabeceras conocidas:

Formato general: ORDE | NIA | REPETIX | COGNOMS I NOM | MATÈRIA
Formato FP:      ORDE | NIA | COGNOMS I NOM | MÒDUL

Si esa firma no aparece, el documento queda marcado para revisar. Esto ayuda a evitar que un PDF diferente de ITACA sea interpretado accidentalmente como el formato conocido.

Los PDF obtenidos desde el entorno docente Mòdul Docent 2 (MD2) pueden tener otro formato y todavía no están soportados ni validados. Se añadirá un extractor específico cuando dispongamos de ejemplos que puedan comprobarse localmente sin compartir datos personales.

Instalación

Requiere Python 3.12 o posterior. La instalación recomendada será mediante pipx, que mantiene la aplicación aislada del Python del sistema:

pipx install itaca-idoceo
itaca-idoceo integrate

Mientras la alpha aún no esté publicada en PyPI, puede instalarse directamente desde este repositorio:

pipx install 'git+https://github.com/lpla/itaca-idoceo.git'
itaca-idoceo integrate

La aplicación también puede abrirse directamente con:

itaca-idoceo

Dependencias de interfaz por plataforma

En Windows, las instalaciones de Python de python.org incluyen normalmente Tkinter. En macOS con Homebrew:

brew install python python-tk pipx

En LliureX/Ubuntu y derivados:

sudo apt install python3-tk pipx

itaca-idoceo integrate crea accesos gráficos locales: un acceso directo en Windows, un lanzador .desktop en Linux y, en macOS, ~/Applications/ITACA a iDoceo.app junto con la Acción rápida de Finder Abrir en ITACA a iDoceo.

Uso gráfico

El área superior de la ventana es el punto de entrada principal. Cuando TkDND está disponible, admite arrastrar uno o varios PDF o una carpeta. Al hacer clic sobre el área, tanto con drag-and-drop disponible como sin él, se puede elegir entre uno o varios PDF o una carpeta completa; no es necesario buscar estas acciones en la barra de menús.

La tabla no muestra nombres ni NIA. Antes de convertir enseña únicamente el PDF, el grupo, el curso, el número de alumnos y un estado Correcto, Revisar o Error.

La unidad de salida es GRUP. Un mismo PDF puede contener varios grupos, como ocurre en determinados listados de FP. A la vez, un mismo GRUP puede incluir varias secciones CURS, como ocurre en determinados listados de Bachillerato; cada reinicio legítimo de ORDE se valida por sección sin dividir necesariamente el XLSX final.

La herramienta detecta también TUTOR cuando existe. Se usa como metadato local y para comprobaciones de coherencia, pero no se exporta al XLSX.

Cuando una celda de nombre o de materias/módulos ocupa más de una línea visual, el extractor conserva la detección normal de la fila y añade únicamente los bloques de continuación sin ORDE/NIA que pertenecen inequívocamente a esa misma fila.

XLSX generado

Por defecto contiene únicamente:

Apellidos | Nombre

En la ventana principal aparecen tres opciones independientes para añadir datos del listado al XLSX:

• NIA, pensado para mapearlo al campo personal ID / Student ID de iDoceo.
• REPETIX, conservando el marcador que muestra ITACA (habitualmente R para alumnado repetidor y vacío en el resto).
• MATÈRIA / MÒDUL, conservando el contenido de la columna de materias o módulos de cada alumno.

Las tres opciones están desactivadas por defecto. ORDE se utiliza sólo para validar la estructura y no se exporta. Si se incluyen REPETIX o MATÈRIA / MÒDUL, conviene decidir explícitamente su destino en el asistente de iDoceo para evitar que terminen accidentalmente como columnas de notas.

Importación en iDoceo

En el asistente de importación de iDoceo, utiliza la primera fila como cabecera, asigna Nombre y Apellidos en la composición del nombre del estudiante y, si se exportó el NIA, asígnalo al campo personal ID / Student ID. Si también incluyes REPETIX o MATÈRIA / MÒDUL, decide expresamente cómo quieres importarlos. Comprueba antes de terminar que iDoceo no haya seleccionado ninguna columna no deseada como columna del cuaderno.

Diagnóstico anonimizado

Para informar de un problema sin compartir datos del alumnado, usa Ayuda → Copiar diagnóstico anonimizado. El texto copiado incluye versión, sistema operativo, versiones de Python/Tcl/Tk, disponibilidad del drag-and-drop, número de páginas, número de clases, recuentos de alumnado, resultado de la firma ITACA 3 y mensajes de validación filtrados.

El diagnóstico no incluye nombres ni rutas de PDF, centro, GRUP, CURS, valor de TUTOR, nombres del alumnado, NIA, REPETIX ni MATÈRIA. Los errores no reconocidos se omiten en lugar de copiar su texto potencialmente sensible.

No adjuntes PDF reales, XLSX resultantes ni capturas con datos personales a una incidencia pública.

Terminal

itaca-idoceo check listado.pdf
itaca-idoceo extract listado.pdf
itaca-idoceo batch carpeta/

Los datos opcionales se pueden combinar libremente:

itaca-idoceo extract listado.pdf --include-nia
itaca-idoceo extract listado.pdf --include-repetix --include-materia
itaca-idoceo batch carpeta/ --include-nia --include-repetix --include-materia

check es una herramienta de inspección local y sí puede mostrar metadatos del listado, por lo que su salida no debe copiarse a una incidencia pública. Para soporte utiliza el diagnóstico anonimizado de la GUI.

Actualización y desinstalación

Cuando la distribución esté en PyPI:

pipx upgrade itaca-idoceo

Para eliminar los accesos creados por la aplicación y después desinstalarla:

itaca-idoceo uninstall-integration
pipx uninstall itaca-idoceo

Privacidad y seguridad

Los PDF de ITACA pueden contener datos personales de menores. El proyecto está diseñado para no necesitar que esos documentos salgan del ordenador del centro. Consulta SECURITY.md antes de abrir una incidencia.

El drag-and-drop, cuando está disponible, se implementa mediante tkinterdnd2/TkDND y no cambia el modelo de procesamiento local. Si esa extensión nativa no puede cargarse, se desactiva automáticamente sin impedir el uso de la aplicación.

Licencia

Este proyecto se distribuye bajo GNU Affero General Public License v3.0 only (AGPL-3.0-only). El texto completo se incluye en LICENSE. PyMuPDF se distribuye bajo AGPL o licencia comercial, por lo que este proyecto adopta AGPL-3.0 para su distribución de código abierto.