Diferencias

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

--- a:acad:configuration:rubrics [2026/07/14 10:04]
iavechuco
+++ a:acad:configuration:rubrics [2026/09/14 01:30] (actual)
wiki: a:acad:configuration:rubrics gana la sección "Descargar el reporte de resultados de tareas de una rúbrica" (+3 mejoras más de la corrida), algebraix
@@ Línea 1: / Línea 1: @@
 ====== Rúbricas ======
 Te permite generar y gestionar plantillas de evaluación estructuradas (criterios por niveles de desempeño) en un catálogo global de la escuela.
+**Nota**: Esta función solo está disponible si el administrador principal de la plataforma tiene activada la bandera correspondiente en Configuración general; si no la ves en tu Panel de control, solicita su activación.
+===== Agregar rúbrica =====
   -Ingresa a Panel de control y selecciona la opción **Rúbricas**.
-  -Haz clic en **Agregar rúbrica**.
+  -Haz clic en la pestaña **Agregar rúbrica**.
-  -Se mostrará el formulario que deberás llenar con Nombre, Descripción y si quieres ponderar criterios por porcentaje.
+  -Se mostrará el formulario "Define el nombre, descripción y estructura de la nueva rúbrica.", que deberás llenar con **Nombre**, **Descripción** y, si quieres ponderar criterios por porcentaje, la casilla **Ponderar criterios por porcentaje**. La casilla **Activo** viene marcada de forma predeterminada.
-  -En la parte inferior deberás dar de alta los niveles con las características de cada uno. **Nota**: Es posible agregar varios niveles, haz clic en el signo + a la derecha.
+  -Si ya existe al menos una rúbrica en el catálogo (activa o inactiva), verás la casilla **Copiar configuración de otra rúbrica**: actívala y haz clic en el campo que aparece para abrir el buscador (**Buscar rúbrica**, o escribe al menos 2 caracteres en **Buscar rúbricas...** para filtrar); al elegir una, el formulario se rellena con su descripción, si estaba activa y si pondera por porcentaje, además de sus niveles, criterios y celdas —el **Nombre** se deja en blanco a propósito, para que no repitas el de la rúbrica copiada—. Si desmarcas la casilla después de copiar, el formulario se recarga en blanco. **Nota**: Si la rúbrica que intentas copiar ya no existe, verás el aviso "No se encontró la rúbrica seleccionada para copiar".
+  -En la parte inferior deberás dar de alta los niveles de desempeño con las características de cada uno, haciendo clic en **Agregar nivel**:
        *Nombre del nivel
        *Puntuación del nivel
        *Descripción
-  -Ahora, crea los criterios de la rúbrica con los campos: **Nota**: Es posible agregar varios criterios, haz clic en el signo + en la parte inferior.
+  -Ahora, crea los criterios de la rúbrica haciendo clic en **Agregar criterio**, con los campos:
        ***Nombre**: Título que identifica el criterio de evaluación.
        ***Porcentaje**: Valor porcentual asignado al criterio dentro de la calificación total.
        ***Descripción**: Breve explicación de lo que se evaluará en el criterio.
-       ***Descripción de celda**: Descripción del desempeño esperado para cada nivel de logro de la rúbrica.
+       ***Descripción de celda**: Descripción del desempeño esperado para cada nivel de logro de la rúbrica, una por cada cruce de criterio y nivel.
        ***Comentario previo**: Comentario general que el profesor podrá utilizar como retroalimentación al momento de calificar este criterio.
-   -Una vez que configures el 100%, haz clic en **Aceptar** para guardar lo capturado.
+  -Puedes dar de alta hasta 10 niveles y hasta 10 criterios; si intentas agregar uno más verás el aviso "Se permiten máximo 10 niveles por rúbrica" o "Se permiten máximo 10 criterios por rúbrica", según el caso.
-   -Al hacer clic en **Rúbricas**, podrás ver el total de rúbricas, las activas, en uso. Además por cada rúbrica visualizarás los criterios configurados, cantidad de niveles, si esta relacionada o no, si esta activo o no, con la posibilidad de modificar, eliminar, ver o desactivarla.
+  -Para quitar un nivel o un criterio usa **Eliminar nivel** o **Eliminar criterio**. Si ese nivel o criterio ya estaba guardado (es decir, editas después de un intento fallido) se te pide confirmar primero: "Este nivel ya está guardado. Al eliminarlo se borrarán sus celdas al guardar la rúbrica. ¿Deseas continuar?" o el equivalente para el criterio.
+  -El panel **Rúbrica** muestra arriba a la derecha el porcentaje acumulado de los criterios (el chip **Total**). **Nota**: Si el total no llega a 100%, la rúbrica se guarda de todas formas, pero como inactiva ("Se guardó como inactiva: los porcentajes de los criterios no suman 100%. No podrá activarse hasta que sumen 100%."); si el total pasa de 100% no se puede guardar en absoluto.
+  -Si el **Nombre** que capturaste ya lo usa otra rúbrica, al guardar verás "Ya existe una rúbrica con ese nombre" y la rúbrica no se crea.
+  -Si dejas algún campo de niveles o criterios incompleto verás "Completa correctamente todos los campos de criterios y niveles antes de guardar." u "Uno ó más campos son inválidos, por favor verifique y vuelva a intentar.", según el caso, y la rúbrica tampoco se crea.
+  -Una vez que configures el 100%, haz clic en **Aceptar** para guardar lo capturado; verás el aviso "Rúbrica creada" y pasarás a la vista de la rúbrica recién creada.
+  -Al hacer clic en **Rúbricas**, podrás ver el total de rúbricas, las activas, en uso. Además por cada rúbrica visualizarás los criterios configurados, cantidad de niveles, si esta relacionada o no, si esta activo o no, con la posibilidad de modificar, eliminar, ver o desactivarla.
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Agregar rúbrica; mostrar: el formulario completo con Nombre, Descripción, la casilla Ponderar criterios por porcentaje, el panel de niveles y el panel de criterios con al menos dos de cada uno capturados; archivo sugerido: :a:acad:rubricas_agregar.png</notes>
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Agregar rúbrica, con la casilla Copiar configuración de otra rúbrica activada; mostrar: el campo Buscar rúbrica abierto con el buscador desplegado y al menos un resultado; archivo sugerido: :a:acad:rubricas_copiar_configuracion.png</notes>
+===== Consultar el listado de rúbricas =====
+  -Ingresa a Panel de control y selecciona la opción **Rúbricas**; verás el listado en la pestaña **Rúbricas**.
+  -Arriba del listado se muestran tres tarjetas con el conteo: **Total de rúbricas**, **Rúbricas activas** y **En uso actualmente** (rúbricas relacionadas a al menos una clase o actividad).
+  -El listado muestra, por cada rúbrica, las columnas **Nombre** (con la fecha de su última actualización debajo, cuando existe), **Criterios de rúbrica**, **Niveles de desempeño**, **Relacionada** (si tiene al menos una clase o actividad relacionada) y **Estado** (**Activo** o **Inactivo**). Una rúbrica **Agregado desde corporativo** se distingue con un ícono junto a su nombre.
+  -Para acotar el listado usa el campo **Filtrar** (busca por cualquier columna visible) o el desplegable **Estado**, que admite **Todos**, **Activo** e **Inactivo**.
+  -Si aún no existe ninguna rúbrica, o el filtro no encuentra ninguna, verás el aviso "No se encontraron rúbricas".
+  -Por cada rúbrica, según su situación, verás disponibles algunas de estas acciones:
+      ***Editar:** abre la pantalla para modificarla. No está disponible si la rúbrica ya tiene resultados de calificación registrados, ni si es **Agregado desde corporativo**.
+      ***Remover** (ícono de bote de basura): la elimina, previa confirmación "Esta acción no se puede deshacer. ¿Eliminar esta rúbrica?". Solo aparece si la rúbrica no está relacionada a ningún criterio, no tiene historial y no tiene resultados de calificación registrados.
+      ***Vista** (ícono de ojo): abre el detalle de la rúbrica; siempre está disponible.
+      ***Descargar reporte de rúbrica** (ícono de Excel): solo aparece si la rúbrica ya tiene resultados de calificación de tareas, y abre la ventana descrita en "Descargar el reporte de resultados de tareas de una rúbrica".
+      ***Duplicar** (ícono de copiar): abre **Agregar rúbrica** con la casilla **Copiar configuración de otra rúbrica** ya aplicada a partir de esta rúbrica.
+      *Activar o desactivar, con un interruptor: al desactivar una rúbrica que sí está **Relacionada** se te pide confirmar primero, con el título **Desactivar rúbrica** y el mensaje "Al desactivarla, la rúbrica dejará de estar disponible para nuevas relaciones. Las clases o actividades que ya la tienen relacionada podrán seguir calificándose con ella sin cambios."; si no está relacionada, se desactiva de inmediato. Esta acción no está disponible para una rúbrica **Agregado desde corporativo**.
+===== Consultar el detalle de una rúbrica =====
+  -En el listado de **Rúbricas** da clic en el ícono **Vista** de la rúbrica que quieras consultar.
+  -Verás una tarjeta con el **Nombre** de la rúbrica (junto con un ícono si es **Agregado desde corporativo**) y su **Descripción**, además de los chips **Relacionada** (si tiene al menos una clase o actividad relacionada) y **Activo** o **Inactivo**. **Nota**: Si la rúbrica está inactiva verás además el aviso "Esta rúbrica está inactiva".
+  -Debajo, el panel **Rúbrica** muestra cuántos **Criterios de rúbrica** y **Niveles de desempeño** tiene, y si la rúbrica pondera por porcentaje, el chip **Total** con la suma de los porcentajes de sus criterios.
+  -El panel despliega la rejilla completa: cada columna es un nivel de desempeño con su nombre, su puntuación y su descripción; cada fila es un criterio con su nombre, su porcentaje (si aplica) y su descripción; y cada celda cruza un criterio con un nivel, mostrando la descripción de ese desempeño y, cuando existe, un comentario previo para el profesor. Si la rúbrica aún no tiene criterios o niveles capturados, verás en su lugar el aviso "No se encontraron rúbricas".
+  -Si la rúbrica está relacionada a alguna clase o actividad, verás además el panel **Criterios y actividades relacionadas**, con una fila por cada relación y las columnas **Tipo**, **Nombre** y **Clase** (con el grado y el plan de estudios debajo, cuando aplica).
+  -Desde esta misma vista puedes usar los íconos **Descargar reporte de rúbrica**, **Duplicar** y **Remover** descritos en "Consultar el listado de rúbricas", bajo las mismas condiciones.
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Vista de una rúbrica; mostrar: la tarjeta con Nombre, Descripción, chips Relacionada y Activo, y la rejilla completa de niveles y criterios con al menos una celda con comentario previo; archivo sugerido: :a:acad:rubricas_vista_detalle.png</notes>
+===== Modificar rúbrica =====
+  -En el listado de **Rúbricas** da clic en el ícono **Editar** de la rúbrica que quieras modificar. **Nota**: Esta acción no está disponible si la rúbrica ya tiene resultados de calificación registrados o si es **Agregado desde corporativo**; si de cualquier forma se intenta entrar a una rúbrica con resultados registrados, verás el aviso "No se puede editar: la rúbrica ya tiene resultados de calificación registrados." y volverás a la vista de la rúbrica.
+  -Se mostrará el formulario "Editar rúbrica" con los mismos campos que **Agregar rúbrica** (**Nombre**, **Descripción**, **Activo**, **Ponderar criterios por porcentaje**, los niveles de desempeño y los criterios de la rúbrica), ya llenos con la configuración actual de la rúbrica. A diferencia de **Agregar rúbrica**, aquí no está disponible la casilla **Copiar configuración de otra rúbrica**.
+  -Los topes de niveles y criterios, sus validaciones y las reglas del porcentaje acumulado son las mismas que en **Agregar rúbrica**.
+  -Si el **Nombre** que capturaste ya lo usa otra rúbrica (distinta a la que estás editando), al guardar verás "Ya existe una rúbrica con ese nombre" y los cambios no se guardan.
+  -Da clic en **Guardar** para confirmar los cambios; verás el aviso "Rúbrica actualizada" y pasarás a la vista de la rúbrica.
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Editar rúbrica; mostrar: el formulario "Editar rúbrica" con Nombre, Descripción y el panel de niveles y criterios ya llenos con datos de una rúbrica existente; archivo sugerido: :a:acad:rubricas_editar.png</notes>
+===== Descargar el reporte de resultados de tareas de una rúbrica =====
+Genera un archivo de Excel con los resultados de las tareas calificadas con una rúbrica, para un periodo específico.
+  -En el listado de **Rúbricas** da clic en el ícono **Descargar reporte de rúbrica** de la rúbrica que buscas.
+  -Se abrirá la ventana "Selecciona un periodo para el reporte de rúbrica", donde eliges en cascada el **Ciclo**, el **Sub-ciclo** y el **Periodos**; este último permanece deshabilitado hasta que elijas un sub-ciclo. **Nota**: Las opciones que se muestran se limitan a los ciclos, sub-ciclos y periodos donde esa rúbrica realmente tiene resultados de calificación, para que no tengas que adivinar en cuál se usó.
+  -El botón **Descargar** permanece deshabilitado hasta que eliges un periodo.
+  -Al dar clic en **Descargar** sales de la ventana y comienza la generación del reporte; verás la pantalla "Generando reporte de rúbrica, esta operación puede tardar varios minutos".
+  -Al terminar, verás el aviso "Se ha descargado el archivo de Excel" en la vista de la rúbrica y el archivo se descargará automáticamente.
+  -Si algo falla durante la generación verás el aviso "Ha ocurrido un error" y regresarás al listado de **Rúbricas**.
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Descargar reporte de rúbrica; mostrar: la ventana "Selecciona un periodo para el reporte de rúbrica" con el Ciclo, Sub-ciclo y Periodos ya elegidos y el botón Descargar habilitado; archivo sugerido: :a:acad:rubricas_descargar_reporte_periodo.png</notes>
 ===== Relacionar rúbricas a la clase =====
@@ Línea 23: / Línea 85: @@
   -Ingresa al plan de estudios, desglosa el grado y haz clic sobre la clase a la que deseas relacionarle las rúbricas.
-  -Selecciona la opción Temas y criterios y haz clic en Agregar criterio.
+  -Selecciona la opción **Temas y criterios** y haz clic en **Agregar criterio**.
-  -Llena el formulario con los datos del nombre del criterio, porcentaje y especifica que será  Calificable por medio de rúbricas.
+  -Llena el formulario con los datos del nombre del criterio, porcentaje y especifica que será  **Calificable por medio de rúbricas**.
-  -Finalmente haz clic en Aceptar
+  -Elige la rúbrica deseada.
+  -Finalmente haz clic en **Aceptar**.
 **Nota**: Si el criterio se evalúa mediante actividades y, además, se selecciona la opción de calificar mediante rúbricas, se indicará que la rúbrica deberá seleccionarse para cada actividad.
+===== Importar rúbricas desde Excel =====
+Te permite dar de alta varias rúbricas a la vez —con sus criterios, niveles de desempeño y celdas— subiendo un archivo de Excel, en lugar de capturarlas una por una desde **Agregar rúbrica**.
+  -En **Rúbricas** selecciona la pestaña **Importar desde Excel**.
+  -Da clic en **Descargar plantilla** para obtener el archivo de Excel con la estructura que debes llenar.
+  -De vuelta en la pantalla, llena el campo **Nombre del importe** (debe ser único; si repites uno ya usado, verás el aviso "Ya existe un importe con ese nombre") y selecciona tu archivo de **Microsoft Excel ®**.
+  -Da clic en **Importar**.
+  -Mientras se revisa el archivo se muestra "Validando archivo...".
+       *Si el archivo tiene errores, el importe no se realiza y la pantalla muestra el panel **Errores detectados** con el nombre de tu archivo y una tabla de tres columnas:
+         **Ubicación:** La **Hoja** del Excel y, dentro de ella, la **Celda** exacta o la **Fila** completa cuando el renglón entero está vacío.
+         **Tipo de error:** La categoría del problema encontrado.
+       *Si el archivo es válido, comienza la creación de las rúbricas: cada una avanza con su propia barra de progreso y un estado —**Pendiente**, **Procesando**, **Completado**, **Error** u **Operación cancelada**—, mientras arriba se muestra "Importe en progreso".
+  -Durante la creación puedes dar clic en **Cancelar importe**; el botón cambia a "Cancelando..." y luego a "Cancelación confirmada". La rúbrica que se estaba creando en ese momento se termina, pero ninguna otra rúbrica de ese archivo se conserva.
+  -Al terminar con éxito verás "Importe completado" y el importe pasa a formar parte del **Historial de importes**, con las columnas **Usuario**, **Nombre del importe**, **Nombre de archivo** (con el propio archivo para descargar), **Fecha** y **Rúbricas**.
+       *En la columna **Rúbricas** da clic en **Ver rúbricas** (o **Ocultar rúbricas** para plegarlo) para desplegar la lista de rúbricas que ese importe creó; cada una te lleva a su pantalla de la rúbrica, salvo que ya la hayan eliminado, en cuyo caso se muestra marcada como "eliminada".
+       *Si aún no tienes ningún importe verás el aviso "No se encontraron importes de rúbricas".
+  -Cuando el historial tiene más de una página, navega con **Anterior** y **Siguiente**.
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Importar desde Excel; mostrar: el formulario con el campo Nombre del importe, el selector de archivo de Microsoft Excel y el botón Importar; archivo sugerido: :a:acad:rubricas_importar_excel.png</notes>
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Importar desde Excel, con una importación en curso; mostrar: la barra de progreso general y al menos dos rúbricas en la lista con distintos estados (Procesando, Completado); archivo sugerido: :a:acad:rubricas_importar_excel_progreso.png</notes>
+<notes>FALTA_CAPTURA — pantalla: Rúbricas → Importar desde Excel; mostrar: el Historial de importes con al menos un renglón y su lista de rúbricas desplegada; archivo sugerido: :a:acad:rubricas_importar_excel_historial.png</notes>
+===== Permisos para el operador =====
+Para que el operador pueda consultar, agregar, modificar, activar/desactivar, eliminar rúbricas o importarlas desde Excel, es necesario asignarle los siguientes permisos al momento de agregarlo o modificar su perfil:
+    * Desde "Permisos globales" > **Rúbricas.**
+      * **Consultar:** Permite ver el listado de **Rúbricas**, consultar el detalle de una rúbrica y descargar su reporte de resultados de tareas en Excel.
+      * **Agregar:** Permite ver la pestaña **Agregar rúbrica** y crear rúbricas nuevas, incluyendo copiar la configuración de otra rúbrica existente.
+      * **Modificar:** Permite editar una rúbrica existente desde el listado.
+      * **Activar:** Permite activar o desactivar una rúbrica desde el listado.
+      * **Eliminar:** Permite eliminar una rúbrica desde el listado.
+      * **Importar desde Excel:** Permite ver la pestaña **Importar desde Excel**, descargar la plantilla, subir un archivo y consultar o cancelar una importación en curso.
+El administrador de la escuela realiza estas acciones sin necesidad de que se le asigne ningún permiso.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:acad:configuration:rubrics" make -C pipeline revisar</notes>