Diferencias

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

--- a:comms:student_report_surveys [2025/05/14 08:35]
[Crear aplicación de encuesta de informe de estudiantes recurrente] , vcontreras
+++ a:comms:student_report_surveys [2026/09/14 14:10] (actual)
wiki: a:comms:general_surveys, a:comms:teacher_evaluation_survey y a:comms:student_report_surveys ganan las reglas duras de "Modificar Encuesta" que faltaban: no se puede editar una encuesta agregada desde corporativo, no se guardan cambios si hay una aplicación abierta, y el aviso de confirmación al guardar. (+1 mejoras más de la corrida), algebraix
@@ Línea 1: / Línea 1: @@
 ====== Encuestas informe de estudiantes ======
 Las encuestas de informe de estudiantes son aquellas en las que los padres de familia deben proporcionar respuestas en nombre de sus hijos, especialmente cuando los estudiantes son demasiado pequeños o cuando la escuela necesita obtener información que solo puede ser proporcionada por los padres. Estas encuestas permiten recopilar datos sobre aspectos clave que los padres pueden observar y conocer mejor que los propios estudiantes.
+<notes> No utilices Encuesta como sinónimo de Quiz o Examen de admisión. </notes>
 ===== Crear una encuesta de informe de estudiantes =====
@@ Línea 11: / Línea 12: @@
     ***Nombre de la encuesta**: Identifica de manera única y clara la encuesta que estás creando.
     ***Tipo**: Seleccionar **Informe de estudiantes**.
-    ***Agrupar estudiantes por pregunta**: Dentro de cada pregunta permitir responder individualmente por cada uno de los estudiantes (hijos).
+    ***Agrupar estudiantes por pregunta**: Dentro de cada pregunta permitir responder individualmente por cada uno de los estudiantes (hijos).  \\ {{:a:comms:encuesta_agrupar_por_estudiante.png?direct&600|}}
     ***Recurrente**: Habilita esta opción si deseas que la encuesta se realice de manera periódica o repetitiva, según una frecuencia preestablecida, se programa para que se envíe o se administre repetidamente, permitiendo recoger datos de forma continua.
-    ***Puntuable**: Al seleccionar la opción de encuesta **Recurrente**, aparecerá la opción **Puntuable**, que permite evaluar las respuestas de los participantes y asignarles puntuaciones o calificaciones.
+    ***Puntuable**: Al seleccionar la opción de encuesta **Recurrente**, aparecerá la opción **Puntuable**, que permite evaluar las respuestas de los participantes y asignarles puntuaciones o calificaciones. Esta opción solo la ve el operador que tenga asignado el permiso **Configuración de puntajes**; el administrador de la escuela la ve siempre.
     ***Descripción**: Ayuda para proporcionar contexto y explicar el propósito de la encuesta.
   -Haz clic en **Aceptar** para confirmar.
 ===== Modificar encuesta de informe de estudiantes=====
+**Nota**: Si la encuesta se agregó desde corporativo no es posible modificarla; al intentar entrar a su edición se muestra el aviso "No es posible modificar una encuesta agregada desde corporativo" y se regresa al detalle de la encuesta.
   -Accede a **Panel de control** en la parte superior.
@@ Línea 27: / Línea 30: @@
     ***Agrupar estudiantes por pregunta**. Dentro de cada pregunta permitir responder individualmente por cada uno de los estudiantes (hijos).
     ***Descripción**: Ayuda para proporcionar contexto y explicar el propósito de la encuesta.
-  -Finalmente, haz clic en **Aceptar** para guardar los cambios.
+  -Finalmente, haz clic en **Aceptar** para guardar los cambios; se muestra el aviso "Encuesta actualizada".
+**IMPORTANTE:** Si ya existe una aplicación abierta de esa encuesta, no se guardan los cambios y se muestra el aviso "Ya existe una aplicación abierta"; deberás esperar a que se cierre para poder modificarla.
 ===== Modificar encuesta de informe de estudiantes y recurrente =====
+**Nota**: Si la encuesta se agregó desde corporativo no es posible modificarla; al intentar entrar a su edición se muestra el aviso "No es posible modificar una encuesta agregada desde corporativo" y se regresa al detalle de la encuesta.
   -Accede al **Panel de Control** y, en el apartado **Comunicaciones**, selecciona la opción **Encuestas**.
@@ Línea 41: / Línea 48: @@
      ***Puntuable**: Marca/Desmarca si deseas permitir evaluar las respuestas de los participantes y asignarles puntuaciones o calificaciones.
     ***Descripción**: Proporciona contexto y explicar el propósito de la encuesta.
-  -Finalmente, haz clic en **Aceptar** para guardar los cambios.
+  -Finalmente, haz clic en **Aceptar** para guardar los cambios; se muestra el aviso "Encuesta actualizada".
+**IMPORTANTE:** Si ya existe una aplicación abierta de esa encuesta, no se guardan los cambios y se muestra el aviso "Ya existe una aplicación abierta"; deberás esperar a que se cierre para poder modificarla.
 ===== Crear categorías =====
@@ Línea 56: / Línea 65: @@
     ***Peso**: Determina el orden en el que se mostrará la categoría en relación con las demás.
     ***Activa**: Desmarca esta opción si solo deseas crear la categoría, pero no utilizarla por el momento.
-  -Finalmente, haz clic en **Aceptar**.
+  -Finalmente, haz clic en **Aceptar**.{{:a:comms:categoria_encuesta.png?direct&600|}}
 ===== Modificar categoría =====
@@ Línea 63: / Línea 72: @@
   -Luego en el apartado **Comunicaciones**, haz clic en **Encuestas**.
   -Una vez dentro, haz clic en **Categorías**.
-  - Luego, selecciona la opción **Agregar categoría**.
   - Selecciona la categoría que deseas modificar.
   - Haz clic en **Modificar** para acceder al formulario de edición.
@@ Línea 212: / Línea 220: @@
     ***Fecha final**. Establece la fecha límite para responder la encuesta. **Nota**: No debe ser mayor a 30 días.
     ***Días visibles**. Indica cuántos días  que estará visible para los usuarios dentro del rango de fechas definido. Marca la casilla correspondiente a cada día que deseas que la encuesta sea visible.
-  -Selecciona una o varias [[a:comms:distribution_lists|listas de distribución]] que incluyan a las personas que deberán responder la encuesta.
+    ***Respuesta obligatoria**: Al activar esta opción, los usuarios no podrán continuar navegando en su sesión de Algebraix hasta que respondan la encuesta.
+    ***Acceso controlado**: Define quiénes tendrán permiso para visualizar los resultados de la encuesta.
+    ***Actualizar destinatarios**: Permite asignar la encuesta o retirarla (según sea el caso) a cada estudiante, padre de familia, profesor que se agregue a la sección (o se dé de baja/cambio/etc.) a la cual se esté aplicando.
+  -Selecciona una o varias [[a:comms:distribution_lists|listas de distribución]] que incluyan a las personas que deberán responder la encuesta.
   -Finalmente haz clic en **Aplicar encuesta**.
 ==== Modificar aplicación de encuesta de informe de estudiantes recurrente ====
-  -Accede al **Panel de Control** y selecciona la opción **Encuestas**.
+  -Accede al **Panel de Control** y, en el apartado **Comunicaciones**, selecciona la opción **Encuestas**.
   -Luego, haz clic en **General** y selecciona la opción **Recurrentes**.
   -Una vez dentro, elige la Encuesta cuya aplicación deseas modificar.
@@ Línea 235: / Línea 246: @@
 ===== Crear aplicación de encuesta de informe de estudiantes =====
-  -Accede al **Panel de Control** y selecciona la opción **Encuestas**.
+  -Accede al **Panel de Control** y, en el apartado **Comunicaciones**, selecciona la opción **Encuestas**.
   -Una vez dentro, elige la **Encuesta** para la que deseas crear la aplicación.
   -Haz clic en la opción **Aplicación de encuesta** y luego selecciona **Crear aplicación**.
@@ Línea 243: / Línea 254: @@
     ***Aplicar de forma anónima**:Si habilitas esta opción, las respuestas serán registradas sin asociarse a los usuarios, garantizando el anonimato.
     ***Acceso controlado**:  Define quiénes tendrán permiso para visualizar los resultados de la encuesta.
+    ***Actualizar destinatarios**: Permite asignar la encuesta o retirarla (según sea el caso) a cada estudiante, padre de familia, profesor que se agregue a la sección (o se dé de baja/cambio/etc.) a la cual se esté aplicando.
   -Selecciona una o varias [[a:comms:distribution_lists|listas de distribución]] que incluyan a las personas que deberán responder la encuesta.
   -Finalmente haz clic en **Aplicar encuesta**.
@@ Línea 285: / Línea 297: @@
     ***Nota**: Si deseas eliminar un usuario del listado, simplemente haz clic en la X roja junto a su nombre.
   - Una vez que tengas el listado completo de usuarios autorizados, haz clic en **Aceptar** para guardar los cambios.
-===== Resultados =====
 ==== Resultados ====
@@ Línea 300: / Línea 309: @@
 ==== Resultados por estudiante ====
- -Accede al **Panel de Control** y selecciona la opción **Encuestas**.
+  -Accede al **Panel de Control** y selecciona la opción **Encuestas**.
   -Una vez dentro, elige la **Encuesta** cuya aplicación deseas consultar.
   -Haz clic en la opción **Aplicación de encuesta**, y nuevamente **Aplicación de encuesta**.
   -Selecciona la aplicación que deseas revisar.
   -Haz clic en **Resultados**, y luego nuevamente **Resultados por estudiante** para acceder a los datos recopilados.
-  -Una vez ahí, podrás ver el listado completo de todos los estudiantes, el grupo al que pertenecen y si ya se obtuvo respuesta o no.
-**Nota:** Puedes Descargar en Excel el listado de los estudiantes con resultados y también el listado de los faltantes,  utilizando los botones ubicados en la parte superior derecha.
+**Nota:** Si la encuesta es **Recurrente**, primero verás un panel de búsqueda:
+  -El panel muestra un enlace con el nombre y el rango de fechas de la aplicación; da clic ahí para usar ese rango por omisión, o captura tu propia **Fecha**.
+  -Da clic en **Usar rango de fechas** para que aparezca también el campo **Fecha final** y así acotar la búsqueda a un periodo.
+  -Si además la encuesta es **Puntuable**, el mismo panel incluye un filtro por **Campus**, con cada plantel desplegable en sus secciones y, dentro de cada una, sus grados; todas las casillas empiezan marcadas y puedes desmarcar las que no quieras incluir.
+  -Da clic en **Buscar** para aplicar los filtros.
+Una vez dentro (o de inmediato, si la encuesta no es recurrente) verás el listado completo de estudiantes en una tabla con las columnas:
+    ***Estudiante**: nombre del estudiante; da clic para consultar su detalle.
+    ***Grupo**: la Sección, el Grado y el Grupo del estudiante, separados por »
+    ***Respuestas**: cuántas de las personas asignadas a ese estudiante (por ejemplo, sus padres) ya respondieron, en formato "respondidas/total".
+Si buscaste por un rango de fechas, arriba de la tabla se muestra el título "Resultados de:" seguido de las fechas usadas.
+**Nota:** Puedes Descargar en Excel el listado de los estudiantes con resultados y también el listado de los faltantes, utilizando los dos íconos ubicados en la parte superior derecha de esta sección.
+==== Consultar los resultados de un estudiante ====
+  -Desde el listado de **Resultados por estudiante**, selecciona al estudiante cuyos resultados deseas consultar. Se abrirá su detalle con dos pestañas: **Resultados** y **Respuestas**.
+  -En la pestaña **Resultados** verás el nombre del estudiante (apellidos, nombre) y, si consultaste un rango de fechas, se agrega junto al nombre.
+  -En la parte superior derecha están los iconos para **Descargar a Microsoft Excel** y para **Imprimir**.
+  -**Nota:** Esta pestaña solo muestra información si el estudiante ya tiene al menos una respuesta registrada; de lo contrario aparece en blanco.
+  -**Nota:** Si la encuesta es **Puntuable**, arriba se muestra el panel **Distribución de resultados totales**, que puedes colapsar dando clic en su encabezado: una gráfica de pastel con el porcentaje y el total de respuestas por cada resultado posible.
+  -Debajo se muestra un panel colapsable por cada **Categoría** de la encuesta, con su nombre en el encabezado.
+  -Dentro de cada categoría, solo se muestran las preguntas que no son de tipo **Texto**: cada una aparece numerada como **Pregunta** seguida de su enunciado, acompañada de una gráfica de pastel con el porcentaje y el total de respuestas por cada opción. Las preguntas de tipo **Texto** no se muestran en esta pestaña.
+  -Si la aplicación tiene comentarios capturados para ese estudiante, al final se muestra un panel **Comentarios** con una tabla de columnas **Usuario** y **Comentario**.
+<notes>FALTA_CAPTURA — pantalla: Encuestas → aplicación recurrente de informe de estudiantes → Resultados → Resultados por estudiante → un estudiante → pestaña Resultados; mostrar: el nombre del estudiante arriba con los iconos de Excel e Imprimir, el panel Distribución de resultados totales si es puntuable, al menos una categoría con una pregunta de opción y su gráfica, y la tabla de Comentarios al final; archivo sugerido: :a:comms:encuesta_resultados_por_estudiante.png</notes>
+==== Imprimir los resultados de un estudiante ====
+  -Desde el listado de **Resultados por estudiante**, selecciona al estudiante cuyos resultados deseas imprimir para abrir su detalle.
+  -En la pestaña **Resultados**, da clic en el icono de imprimir {{icon>fas fa-print text-dark}}, ubicado junto al icono de descarga a Excel en la parte superior derecha.
+  -Se abre una pestaña nueva con la vista de impresión: el título muestra el nombre del estudiante (apellidos, nombre) y, si consultaste un rango de fechas, lo agrega junto al nombre.
+  -**Nota:** Si la encuesta es **Puntuable**, arriba se muestra la gráfica **Distribución de resultados totales**.
+  -Debajo se repite cada **Categoría** de la encuesta con su nombre y, dentro, cada pregunta numerada como **Pregunta**: las preguntas de opción se muestran con una gráfica de pastel con el porcentaje y el total de respuestas por opción; las preguntas de texto libre se muestran en una tabla con las columnas **Usuario** y **Respuesta**.
+  -Si la aplicación tiene comentarios capturados para ese estudiante, al final se muestra una tabla **Comentarios** con las columnas **Usuario** y **Comentario**. **Nota:** esta tabla muestra como máximo 50 comentarios.
+  -**Nota:** la pestaña de impresión abre automáticamente el cuadro de impresión del navegador a los pocos segundos de cargar.
+<notes>FALTA_CAPTURA — pantalla: Encuestas → aplicación recurrente de informe de estudiantes → Resultados → Resultados por estudiante → un estudiante → pestaña Resultados → icono de imprimir; mostrar: la vista de impresión completa, con el nombre del estudiante arriba, la gráfica Distribución de resultados totales si es puntuable, al menos una categoría con una pregunta de opción y su gráfica, y la tabla de Comentarios al final; archivo sugerido: :a:comms:encuesta_resultados_estudiante_imprimir.png</notes>
+==== Consultar las respuestas de un estudiante ====
+**Nota:** Esta consulta solo está disponible para encuestas **Recurrentes**.
+  -Accede al **Panel de Control** y selecciona la opción **Encuestas**.
+  -Una vez dentro, elige la **Encuesta** cuya aplicación deseas consultar.
+  -Haz clic en la opción **General** y selecciona la opción **Recurrentes**.
+  -Selecciona la **Encuesta** a la que deseas consultar.
+  -Haz clic en la opción **Aplicación de encuesta**, y nuevamente **Aplicación de encuesta**.
+  -Selecciona la aplicación que deseas revisar.
+  -Haz clic en **Resultados**, y luego nuevamente **Resultados por estudiante**.
+  -Selecciona al estudiante cuyas respuestas deseas consultar. Se abrirá su detalle con dos pestañas: **Resultados** y **Respuestas**.
+  -Haz clic en la pestaña **Respuestas** para ver el detalle de quién respondió por ese estudiante.
+  -Encontrarás una tabla con las siguientes columnas:
+    ***Nombre de usuario**: la persona (por ejemplo, el padre de familia) que respondió en nombre del estudiante.
+    ***Fecha**: el momento en que se envió esa respuesta. Al hacer clic en la fecha se muestran las respuestas completas de esa persona a cada pregunta.
+    ***Resultado**: solo aparece si la encuesta es **Puntuable**; muestra el resultado obtenido en esa respuesta.
+    ***Comentario**: el comentario que dejó esa persona al responder. Si el comentario es muy largo se muestra recortado, seguido de puntos suspensivos.
+  -Puedes usar el campo **Filtrar** para buscar dentro de la tabla y navegar entre páginas de 10 resultados. Si no hay respuestas registradas se muestra el aviso "No hay resultados".
+<notes>FALTA_CAPTURA — pantalla: Encuestas → aplicación recurrente de informe de estudiantes → Resultados → Resultados por estudiante → un estudiante → pestaña Respuestas; mostrar: la tabla con las columnas Nombre de usuario, Fecha, Resultado y Comentario; archivo sugerido: :a:comms:encuesta_respuestas_por_estudiante.png</notes>
+==== Consultar el detalle de respuestas de una persona ====
+  -Desde la pestaña **Respuestas** (ver **Consultar las respuestas de un estudiante**), da clic en la **Fecha** de la respuesta que quieres revisar.
+  -Se abre el detalle bajo la pestaña **Detalle**, con el panel **Respuestas de usuario** (si consultaste una fecha, se muestra junto al título).
+  -En un panel a la izquierda encontrarás:
+    ***Resultado**: solo aparece si la encuesta es **Puntuable**; muestra el resultado obtenido en esa respuesta.
+    ***Nombre de usuario**: la persona que respondió en nombre del estudiante; puede ser un padre de familia o un profesor.
+    ***Estudiante**: apellidos y nombre del estudiante por el que se respondió.
+    ***Grupo**: la Sección, el Grado y el Grupo del estudiante, separados por »
+  -Si esa persona dejó un comentario al responder, debajo del panel se muestra el apartado **Comentarios** con el texto completo.
+  -A la derecha, en el panel **Detalle de respuestas**, aparece cada pregunta numerada como **Pregunta** seguida de su enunciado, y debajo la etiqueta **Respuesta** con lo que esa persona contestó.
+<notes>FALTA_CAPTURA — pantalla: Encuestas → aplicación recurrente de informe de estudiantes → Resultados → Resultados por estudiante → un estudiante → pestaña Respuestas → clic en una fecha → pestaña Detalle; mostrar: el panel izquierdo Respuestas de usuario con Resultado (si es puntuable), Nombre de usuario, Estudiante y Grupo, y a la derecha el panel Detalle de respuestas con al menos dos preguntas y sus respuestas; archivo sugerido: :a:comms:encuesta_detalle_respuestas_usuario.png</notes>
 ===== Finalizar encuesta =====
@@ Línea 324: / Línea 406: @@
   -Haz clic en la opción **Aplicación de encuesta**, y nuevamente **Aplicación de encuesta**.
   -Selecciona la aplicación que deseas revisar.
-  -Haz clic en el botón **Finalizar**, ubicado en la esquina inferior derecha.
+  -Haz clic en el botón **Finalizar**, ubicado en la esquina inferior derecha.{{:a:comms:cerrar_aplicacion_encuesta.png?direct&600|}}
   -Aparecerá una ventana de confirmación. Haz clic en **Cerrar** para finalizar, o en **Cancelar** si decides no continuar.
+===== 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:
+   * Dentro de "Permisos globales" > **Encuestas.**
+     * **Agregar:** Permite agregar la encuesta de tipo informe de estudiantes.
+     * **Configuración de puntajes:** Si la encuesta es puntuable, permite hacer la configuración de los puntajes.
+     * **Aplicar:** Permite aplicar la encuesta.
+     * **Modificar:** Permite modificar encuestas creadas.
+   * **Preguntas:**
+     * **Activar preguntas:** Permite activar preguntas existentes.
+     * **Agregar preguntas:** Permite agregar preguntas a la encuestas tipo informe de estudiantes.
+     * **Eliminar preguntas:** Permite eliminar preguntas existentes.
+     * **Modificar preguntas:** Permite modificar preguntas existentes.
+     * **Ver pregunta:** Puede consultar las preguntas creadas.
+     * **Resultado:** Puede hacer la lectura de los resultados de las encuestas.
+   * **Categorías:**
+     * **Agregar categorías:** Permite crear categorías para las preguntas.
+     * **Modificar categorías:** Permite modificar las categorías de preguntas existentes.
+     * **Ver categoría:** Permite consultar las categorías de preguntas existentes.
 **Temas relacionados:**[[a:comms:distribution_lists|Listas de distribución]]
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:comms:student_report_surveys" make -C pipeline revisar</notes>