Diferencias

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

--- t:acad:students_annotations [2025/04/24 11:18]
[Agregar anotación] , vcontreras
+++ t:acad:students_annotations [2026/09/15 16:30] (actual)
wiki: t:acad:students_annotations corrige cuándo se puede agregar, editar y eliminar una anotación de estudiante (+2 mejoras más de la corrida), algebraix
@@ Línea 1: / Línea 1: @@
 ====== Anotaciones ======
-===== Listado de anotaciones =====
+Dentro del apartado Estudiantes, encontrarás la opción Anotaciones, la cual te permite agregar, consultar, modificar y dar seguimiento a observaciones relacionadas con el comportamiento, desempeño académico u otros aspectos relevantes de cada uno de tus estudiantes.
-  - Haz clic en el menú lateral en la opción de **Estudiantes**.
-  - Desde la pestaña **Estudiantes**, selecciona el enlace con el nombre del estudiante.
-  - Luego, selecciona la pestaña **Anotaciones**.
-  - Del lado derecho de la pantalla se mostrará la sección de **Anotaciones**, donde encontrarás el listado de las anotaciones que tiene el estudiante seleccionado. Para ver más detalles de una anotación, haz clic en el icono Ver {{icon>fas fa-info text-dark }}.
-     *** Nota:** En las anotaciones visibles para profesores, los botones de acciones de Editar {{icon>fas fa-pen text-blue }} y Eliminar {{icon>fas fa-trash-alt text-red }} estarán deshabilitados.
-  - Si deseas descargar las anotaciones en formato Excel, haz clic en el ícono de **Excel** {{icon>far fa-file-excel text-green}} ubicado en la esquina superior derecha de este apartado **Anotaciones**. También puedes imprimir el listado haciendo clic en el ícono de ** Imprimir** {{icon>fas fa-print }} que se encuentra junto al botón de excel.
-===== Búsqueda por fechas de anotaciones =====
-  - Haz clic en el menú lateral en la opción de **Estudiantes**.
-  - Desde la pestaña **Estudiantes**, selecciona el enlace con el nombre del estudiante.
-  - Luego, selecciona la pestaña **Anotaciones**.
-  - En el lado izquierdo de la pantalla se encuentra la sección **Búsqueda por fechas**. Haz clic en la flecha para desplegar los campos del formulario.
-  - Selecciona el rango de fechas que deseas consultar, indicando una fecha de ** Inicio** y **Final**.
-  - Haz clic en el botón **Aceptar** para realizar la búsqueda.
-  - En el lado derecho, en el apartado **Anotaciones**, se mostrarán únicamente las anotaciones que coincidan con el rango de fechas seleccionado.
 ===== Agregar anotación  =====
   - Haz clic en el menú lateral en la opción de **Estudiantes**.
@@ Línea 27: / Línea 11: @@
     * **Título (requerido)**: Ingresa un título descriptivo para la anotación.
     * ** Anotación (requerido)**: Escribe el contenido o detalle de la anotación.
-    * **Notificaciones adicionales: (opcional)** Activa esta opción si deseas notificar a otro usuario administrador, operador o profesor. Al escribir su nombre, se mostrarán coincidencias para seleccionar la persona correcta.
+    * **Notificaciones adicionales (opcional):** Activa esta opción si deseas notificar a otro usuario administrador, operador o profesor. Al escribir su nombre, se mostrarán coincidencias para seleccionar la persona correcta.
-    * **Adjuntar archivo: (opcional)** Puedes adjuntar un archivo relacionado (audio, documento, imagen u otro tipo).
+    * **Adjuntar archivo (opcional):** Puedes adjuntar un archivo relacionado (audio, documento, imagen u otro tipo),  haciendo clic en el botón de clip {{icon>fa fa-paperclip}}.
   - Una vez completado el formulario, haz clic en **Aceptar** para guardar la anotación.
+**IMPORTANTE:** La sección **Agregar anotación** solo aparece si el administrador de tu escuela activó la opción **Permiso para crear anotaciones** en tu perfil de profesor; sin ella no podrás agregar anotaciones a tus estudiantes.
 ===== Editar anotación =====
+  - Haz clic en el menú lateral en la opción de **Estudiantes**.
+  - Desde la pestaña **Estudiantes**, selecciona el enlace con el nombre del estudiante.
+  - Luego, selecciona la pestaña **Anotaciones**.
+  - Del lado derecho de la pantalla se mostrará la sección de **Anotaciones**, al lado de cada anotación aparecerá el ícono de **Editar** {{icon>fas fa-pen text-blue }}. Al hacer clic en este ícono, serás redirigido al formulario de**Modificar anotación**.
+  - En el formulario de modificación podrás actualizar los siguientes campos:
+    * **Título:** el título de la anotación.
+    * **Anotación:** el detalle o contenido de la anotación.
+    * **Adjuntos (opcional):** cada archivo ya adjunto se muestra en una tarjeta; haz clic en la **X** de la tarjeta para quitarlo. Puedes agregar archivos nuevos con el botón de clip {{icon>fa fa-paperclip}} mientras la anotación tenga menos de 3 adjuntos; al llegar a 3, el botón de clip se oculta.
+  - Si dejas el **Título** o la **Anotación** vacíos, al hacer clic en **Aceptar** verás los avisos "Título inválido." o "Anotación inválida" según el campo que falte.
+  - Una vez realizados los cambios, haz clic en **Aceptar** para guardar la información actualizada.
+  * **Nota:** El botón de **Editar** {{icon>fas fa-pen text-blue }} solo está habilitado si tienes activado el **Permiso para crear anotaciones** en tu perfil y, además, la anotación fue creada por ti; para cualquier otra anotación (incluidas las agregadas por el administrador, por otro profesor o por un operador) el botón aparece deshabilitado.
 ===== Eliminar anotación =====
+  - Haz clic en el menú lateral en la opción de **Estudiantes**.
+  - Desde la pestaña **Estudiantes**, selecciona el enlace con el nombre del estudiante.
+  - Luego, selecciona la pestaña **Anotaciones**.
+  - Del lado derecho de la pantalla se mostrará la sección de **Anotaciones**, al lado de cada anotación aparecerá el ícono de **Eliminar** {{icon>far fa-trash-alt text-red }}. Al hacer clic en este ícono, se mostrará un mensaje de confirmación. Para continuar, haz clic en **Eliminar**.
+  - También puedes eliminar una anotación desde el formulario **Modificar anotación**. Para acceder a este formulario, haz clic primero en el ícono de Editar {{icon>fas fa-pen text-blue }} y una vez dentro, encontrarás el ícono de papelera {{icon>far fa-trash-alt text-red }} en la esquina superior derecha del formulario. Haz clic en la papelera y confirma la acción para eliminar la anotación.
+  * **Nota:** El mensaje de confirmación dice "¿ Está seguro que desea eliminar esta anotación: [título de la anotación] ?".
+  * **Nota:** El botón de **Eliminar** {{icon>far fa-trash-alt text-red }} solo está habilitado si tienes activado el **Permiso para crear anotaciones** en tu perfil y, además, la anotación fue creada por ti; para cualquier otra anotación (incluidas las agregadas por el administrador, por otro profesor o por un operador) el botón aparece deshabilitado.
+===== Listado de anotaciones =====
+  - Haz clic en el menú lateral en la opción de **Estudiantes**.
+  - Desde la pestaña **Estudiantes**, selecciona el enlace con el nombre del estudiante.
+  - Luego, selecciona la pestaña **Anotaciones**.
+  - Del lado derecho de la pantalla se mostrará la sección de **Anotaciones**, donde encontrarás el listado de todas las anotaciones que tiene el estudiante seleccionado.
+  - Puedes ordenar el listado de anotaciones utilizando el menú desplegable del campo **Ordenar por**. Selecciona la opción que prefieras según el criterio deseado:
+    * Razón de anotación ascendente.
+    *  Razón de anotación descendente.
+    *  Fecha ascendente.
+    *  Fecha descendente.
+  - Para ver más detalles de una anotación, haz clic en el icono Ver {{icon>fas fa-info text-dark }}.
+     *** Nota:** Si la anotación contiene archivos adjuntos, tendrás las opciones de ver el archivo {{icon>fas fa-eye}} y  descargarlo {{icon>fas fa-download text-blue }} si es necesario.
+  - Si deseas descargar las anotaciones en formato Excel, haz clic en el ícono de **Excel** {{icon>far fa-file-excel text-green}} ubicado en la esquina superior derecha de este apartado **Anotaciones**. También puedes imprimir el listado haciendo clic en el ícono de ** Imprimir** {{icon>fas fa-print }} que se encuentra junto al botón de excel.
+===== Vista de impresión de anotaciones =====
+Al hacer clic en **Imprimir** se abre una vista independiente, lista para imprimirse:
+  - En la parte superior se muestra un panel **Opciones** que te permite, antes de imprimir, activar o desactivar qué columnas se incluyen en la hoja: **Todos**, **Nota**, **Razón**, **Creador**, **Fecha** y **Adjuntos**; este panel es solo para la vista en pantalla y no aparece en la hoja impresa.
+  - Debajo se muestra el título "Anotaciones: **apellido**, **nombre**" del estudiante consultado.
+  - Enseguida se lista una tabla con todas las anotaciones del estudiante, con las columnas: **Título**, **Nota**, **Razón** (o "Sin razón" cuando la anotación no tiene una asignada), **Creador** (quien capturó la anotación), **Fecha** y **Adjuntos** (el nombre, tipo y tamaño de cada archivo adjunto a la anotación).
+**IMPORTANTE:** Para consultar e imprimir las anotaciones de tus estudiantes es necesario que el administrador de tu escuela haya activado la opción **Permiso para ver anotaciones** en tu perfil de profesor; sin ella, no verás la pestaña **Anotaciones**. Además, solo puedes consultar las anotaciones de los estudiantes que están inscritos en tus clases.
+===== Búsqueda por fechas de anotaciones =====
+  - Haz clic en el menú lateral en la opción de **Estudiantes**.
+  - Desde la pestaña **Estudiantes**, selecciona el enlace con el nombre del estudiante.
+  - Luego, selecciona la pestaña **Anotaciones**.
+  - En el lado izquierdo de la pantalla se encuentra la sección **Búsqueda por fechas**. Haz clic en la flecha para desplegar los campos del formulario.
+  - Selecciona el rango de fechas que deseas consultar, indicando una fecha de ** Inicio** y **Final**.
+  - Haz clic en el botón **Aceptar** para realizar la búsqueda.
+  - En el lado derecho, en el apartado **Anotaciones**, se mostrarán únicamente las anotaciones que coincidan con el rango de fechas seleccionado.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="t:acad:students_annotations" make -C pipeline revisar</notes>