Diferencias

Muestra las diferencias entre dos versiones de la página.

--- a:acad:follow:print_grades [2025/07/09 10:57]
kvaldez
+++ a:acad:follow:print_grades [2026/09/18 21:00] (actual)
wiki: a:acad:follow:print_grades gana el detalle de la boleta que produce el formato DEFAULT-GRADEBOOKS, algebraix
@@ Línea 1: / Línea 1: @@
 ====== Imprimir calificaciones ======
+<notes>También se conoce como descargar boletas.</notes>
 La impresión de calificaciones es el proceso de generar y obtener en formato físico (como papel) o digital (como PDF) un documento que contiene las calificaciones obtenidas por los estudiantes en sus evaluaciones o cursos.\\
 **IMPORTANTE:** Para poder hacer la impresión de calificaciones, es necesario contar con la plantilla que dicta el formato en el que se imprimirán. (Consulta el artículo [[a:system_configuration:templates|Plantillas de documentos]]).
+**Nota:** Si el colegio no tiene ninguna plantilla de calificaciones creada, la pestaña **Por estudiante** no muestra su formulario. La de **Imprimir calificaciones** sí se pinta completa —depende de que haya grupos, no de las plantillas—; lo único que queda vacío es el desplegable **Formato de impresión**.
+===== Formato DEFAULT-GRADEBOOKS (boleta sin plantilla personalizada) =====
+En el desplegable **Formato de impresión**, tanto de la pestaña por grupo como de la de por estudiante, siempre está disponible la opción **DEFAULT-GRADEBOOKS**: es el formato que trae Algebraix por defecto, incluso si tu colegio no ha creado ninguna plantilla propia de calificaciones. La boleta que genera con este formato:
+  - Encabezado con **Nombre** (apellido y nombre del estudiante), **Ciclo** y, si el estudiante sigue activo en un grupo, **Grupo**.
+  - Un bloque de tabla por cada categoría de calificación del reporte, con su nombre.
+    * Si alguno de los periodos de esa categoría todavía tiene la captura de calificaciones abierta, se resalta en amarillo y arriba aparece el aviso "El periodo **{periodo}** aún se encuentra abierto para captura, por lo que la calificación final puede variar" (o su versión en plural cuando son varios periodos).
+    * Un renglón por cada clase de la categoría, con su nombre y la calificación de cada periodo y sub-ciclo incluido en la impresión.
+      * Cuando la clase tiene un extraordinario o recuperación de periodo, sub-ciclo o ciclo ya capturado, la calificación se muestra junto a un ícono de rayo rojo. {{icon>fas fa-bolt text-red-algebraix}}
+      * Si la calificación de un periodo viene de criterios, se agrega el detalle **Criterio** con su nombre, su porcentaje y su valor (en verde si aprueba, en rojo si no).
+      * Si la clase es virtual, se detalla cada clase real que la compone, con su nombre y su calificación.
+      * Si la clase tiene **Puntos extra**, se incluyen junto con el valor obtenido.
+      * Si el estudiante excedió el máximo de ausencias permitidas en el periodo, el sub-ciclo o el ciclo, se agrega un ícono de advertencia con el aviso correspondiente.
+    * Cuando la categoría lo tiene habilitado, se agregan renglones de totales por categoría: **Ausencias**, **Justificadas**, **Retardos** y **Promedio**.
+  - Al final de la boleta, si el reporte lo tiene habilitado, un bloque de **Totales** con las mismas filas (Ausencias, Justificadas, Retardos, Promedio) para el conjunto completo de sub-ciclos impresos.
+  - Si el colegio configuró una tabla de equivalencias para la boleta, se agrega la sección **Tabla de conversiones de la boleta** con las columnas **Valor**, **Rango** (cuando aplica) y **Comentario**.
+  - Si el reporte tiene un mensaje configurado, se muestra al final de la boleta.
+**Nota:** A diferencia de la boleta que el estudiante o el padre consultan en pantalla, aquí no hay ventanas de detalle ni elementos en los que se pueda dar clic: es un documento estático, pensado para imprimirse o guardarse como PDF.
+<notes>FALTA_CAPTURA — pantalla: Panel de control → Imprimir calificaciones → boleta generada con el formato DEFAULT-GRADEBOOKS; mostrar: el encabezado con Nombre/Ciclo/Grupo, un bloque de categoría con al menos una clase con calificación por criterios y el bloque final de Totales; archivo sugerido: :a:acad:follow:boleta_default_gradebooks.png</notes>
 ===== Impresión de calificaciones por grupo =====
-  - Desde "Panel de control" selecciona **Imprimir calificaciones.**
+<notes>También se conoce como boletas de los estudiantes.</notes>
+  - Desde **Panel de control** selecciona **Imprimir calificaciones.**
   - Despliega el menú **Grupo** y selecciona el grupo del cual quieres imprimir la boleta de calificaciones.
+    * El listado está agrupado por sección y solo incluye grupos activos; si no hay ninguno, la pantalla avisa **No se han encontrado grupos** y no muestra el formulario.
+    * Además de los grupos, puedes elegir el nombre de un grado, para imprimir todos sus grupos de una vez, o **Todos los grupos** seguido del nombre de una sección entre paréntesis. **Ojo con esta última:** hoy no acota a esa sección —el sistema genera las boletas de todos los grupos con calificaciones en los sub-ciclos elegidos—, así que si tu colegio tiene más de una sección recibirás un archivo mayor del que pediste.
+  - **Orden:** este campo solo aparece cuando elegiste un grado o una sección completa, y define cómo se ordenan las boletas dentro del archivo generado: por **Grupo**, **Matrícula**, **CURP**, **Profesor** o por alguno de los **Datos adicionales** activos del estudiante. El valor que viene marcado de inicio es **Grupo**. Cuando imprimes un solo grupo el campo no se muestra y el orden es alfabético por apellido.
   - Despliega **Ciclos** y selecciona el ciclo escolar del cuál quieres imprimir las calificaciones.
   - En **Sub-ciclos** marca el sub ciclo que contiene las calificaciones que quieres imprimir.
+    * Puedes marcar varios sub-ciclos para imprimirlos en la misma boleta. El listado siempre corresponde al ciclo que elegiste en **Ciclos**, así que todos los que marques pertenecen al mismo ciclo; si cambias de ciclo, el listado se vuelve a armar y pierdes las marcas que habías hecho.
+    * Cada sub-ciclo se identifica con el nombre del ciclo y el del sub-ciclo separados por dos puntos. Si el ciclo elegido no tiene sub-ciclos, en su lugar se lee **Ninguno**.
   - **Boletas:** selecciona la boleta de la cual se tomará la información para la impresión de calificaciones.
+    * Solo se listan las boletas configuradas para los sub-ciclos que marcaste; si no hay ninguna, se lee **Ninguna**.
   - De manera opcional puedes seleccionar el **Periodo** del cuál quieres hacer la impresión de calificaciones.
+    * El listado solo trae los periodos del sub-ciclo que marcaste en último lugar y únicamente aquellos cuyas calificaciones ya están publicadas para el administrador; si marcas otro sub-ciclo, la lista se vuelve a armar con los periodos de ese.
+    * **Nota:** el periodo solo se toma en cuenta cuando marcaste un único sub-ciclo. Si marcaste dos o más, la boleta se genera con todos sus periodos aunque hayas elegido uno.
   - **Formato de impresión:** despliega la opción y selecciona el formato que deseas utilizar para imprimir tus calificaciones.
   - **Opciones:** De manera opcional puedes seleccionar cualquiera de las dos opciones que tienes disponibles.
     * **Mostrar todos los periodos:** Incluye periodos publicados donde los estudiantes no cuenten con registro de calificaciones.
-    * **Excluir bajar y graduados:** No se imprimirán las calificaciones de estudiantes que hayan sido dados de baja o que ya estén graduados del colegio.
+    * **Excluir bajas y graduados:** No se imprimirán las calificaciones de estudiantes que hayan sido dados de baja o que ya estén graduados del colegio.
   - Da clic en **Continuar.**
+    * Si no marcaste sub-ciclo o boleta, la pantalla te lo pide con los avisos **Es necesario seleccionar al menos un sub-ciclo** y **Es necesario seleccionar al menos una boleta.**
+    * Si dejaste vacíos **Grupo** o **Formato de impresión**, los avisos son **Grupo inválido** y **Formato de impresión inválido**.
+    * **Nota:** si la boleta que elegiste ya no corresponde al grupo y al ciclo seleccionados, la generación no arranca y regresas al formulario sin ningún mensaje que lo explique; vuelve a elegir la boleta del listado.
     * Se mostrará una barra que indica el progreso de impresión de las boletas.
-    * Al finalizar, se mostrarán las boletas generadas de los estudiantes del grupo seleccionado.
+    * Al finalizar, se mostrarán las boletas generadas de los estudiantes del grupo seleccionado. <notes>También se conoce como ver boletas de todos los alumnos de un grupo o sección.</notes>
+<notes>FALTA_CAPTURA — pantalla: Panel de control → Imprimir calificaciones (pestaña Imprimir calificaciones); mostrar: el formulario completo con Grupo, Orden, Ciclos, Sub-ciclos, Boletas, Periodo, Formato de impresión y el bloque Opciones; archivo sugerido: :a:acad:follow:imprimir_calificaciones_por_grupo.png</notes>
+==== Seguir el avance y obtener el archivo ====
+La generación de las boletas de un grupo se realiza en segundo plano, porque puede tardar varios minutos.
+  - Mientras se generan, la pantalla muestra la barra de avance con el porcentaje completado, que se actualiza solo, y el botón **Cancelar operación**. No aparece ningún mensaje de texto acompañando a la barra.
+  - **IMPORTANTE:** **Cancelar operación** te regresa al formulario con el aviso **Operación cancelada**, pero no detiene la generación: el proceso continúa en segundo plano hasta terminar y, como ya saliste de la pantalla de avance, el archivo no se te entrega. Si lo que quieres es el archivo, deja la pantalla abierta hasta que la barra llegue al 100%.
+  - Al llegar al 100% aparece el mensaje **Calificaciones generadas exitosamente** junto con el enlace **Generar calificaciones nuevas**, que te devuelve al formulario, y la descarga del archivo comienza automáticamente.
+  - Lo que pasa al terminar depende del formato de impresión que elegiste: los formatos de hoja de cálculo se **descargan** como archivo llamado **CALIFICACIONES**, y los demás —incluidos los que producen PDF, que es el caso normal de una boleta— se **abren en el navegador** en vez de descargarse, así que no los busques en tu carpeta de descargas.
+  - **Nota:** el archivo generado se conserva solo un tiempo. Si intentas descargarlo de nuevo desde una pestaña vieja o desde el historial del navegador, aparece el aviso **El archivo generado ya no está disponible, por favor vuelve a generarlo** y tendrás que repetir la generación.
+<notes>FALTA_CAPTURA — pantalla: Panel de control → Imprimir calificaciones, después de dar clic en Continuar; mostrar: la barra de avance con el porcentaje y el botón Cancelar operación; archivo sugerido: :a:acad:follow:imprimir_calificaciones_avance.png</notes>
 ===== Impresión de calificaciones por estudiante =====
-  - Desde "Panel de control" selecciona **Imprimir calificaciones.**
+Puedes realizar la impresión de boletas de estudiantes activos como inactivos/desativados.
-  - Selecciona **Por estudiante.**
+  - Desde **Panel de control** selecciona **Imprimir calificaciones.**
+  - Selecciona **Por estudiante.** El formulario se titula **Imprimir calificaciones del estudiante** y sus campos van apareciendo a medida que eliges: primero el estudiante, luego sus sub-ciclos y, con el primer sub-ciclo marcado, las boletas, el periodo y las opciones.
   - En el apartado **Búsqueda de estudiante** comienza a escribir el apellido del estudiante del cuál quieres hacer la impresión de calificaciones.
   - El sistema te arrojará las coincidencias para que selecciones al estudiante correspondiente.{{:a:acad:follow:busqueda_de_estudiante_impriir_calificaciones.png?direct&400|}}
-  - Selecciona el **Sub-ciclo** en donde están registradas las calificaciones que quieres imprimir.
+  - En **Sub-ciclos** marca el sub-ciclo en donde están registradas las calificaciones que quieres imprimir.
+    * Solo se listan los sub-ciclos en los que el estudiante tiene calificaciones registradas —no depende de que tenga boleta configurada—, cada uno identificado con el grupo, el ciclo y el nombre del sub-ciclo. Si el estudiante no tiene ninguno, aparece el aviso **No se encontraron calificaciones para el estudiante seleccionado**.
+    * Puedes marcar varios sub-ciclos, siempre que pertenezcan al mismo grupo y al mismo ciclo. Si no es así, al aceptar aparece **Todos los sub-ciclos de impresión deben pertenecer al mismo grupo** o **Todos los sub-ciclos de impresión deben pertenecer al mismo ciclo** y regresas al formulario.
   - **Boletas:** Selecciona la boleta de la cual se tomará la información para hacer la impresión.
   - **Periodo:** De manera opcional puedes seleccionar un periodo específico para la impresión de calificaciones.
   - Despliega **Formato de impresión** y selecciona el formato bajo el cuál quieres que se impriman las calificaciones.
+    * **Nota:** este campo es obligatorio: si lo dejas vacío, al aceptar verás **Formato de impresión inválido** y no se genera nada.
   - **Mostrar todos los periodos:** Al marcar esta opción se mostrarán todos los periodos publicados donde el estudiante no cuenta con registro de calificaciones.
   - Da clic en **Aceptar** para imprimir la boleta de calificaciones.
+    * Si no elegiste estudiante, no marcaste ningún sub-ciclo o no marcaste boleta, los avisos son **Estudiante inválido**, **Sub-ciclo inválido** y **Es necesario seleccionar al menos una boleta.**
+    * A diferencia de la impresión por grupo, aquí no hay barra de avance: la boleta se genera al momento y se abre o se descarga según el formato de impresión elegido.
+    * Si el estudiante no tiene calificaciones para la combinación que elegiste, no se genera ningún documento y regresas al formulario sin ningún mensaje: revisa el sub-ciclo, la boleta y el periodo que marcaste.
 ===== Permisos para el operador =====
 Para que el operador pueda realizar estas configuraciones, es necesario asignarle los siguientes permisos al momento de agregarlo o modificar su perfil:
-    * Desde "Permisos por grupo" > **Calificaciones.**
+    * Desde "Permisos por grupo" > **Calificaciones** > IMPRIMIR CALIFICACIONES.
-      * **Imprimir calificaciones:**
+      * **Grupal:** Permite que realice la impresión de las calificaciones de todo un grupo, incluida la descarga del archivo generado.
-        * **Grupal:** Permite que realice la impresión de las calificaciones de todo un grupo.
+      * **Individual:** Permite que realice la impresión de calificaciones de estudiantes específicos.
-        * **Individual:** Permite que realice la impresión de calificaciones de estudiantes específicos.
+El administrador de la escuela puede usar ambas pestañas sin necesidad de ningún permiso. **Nota:** cancelar una generación en curso solo lo puede hacer el administrador de la escuela; no existe permiso que habilite esa acción para un operador.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:acad:follow:print_grades" make -C pipeline revisar</notes>