Diferencias

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

--- a:acad:configuration:social_service_hours_by_group [2025/05/29 12:29]
creado, vcortes
+++ a:acad:configuration:social_service_hours_by_group [2026/09/14 03:40] (actual)
wiki: a:acad:configuration:social_service_hours_by_group precisa "Importar plantilla" del registro masivo de horas por grupo (validación de archivo vacío, el mensaje de confirmación exacto, la tabla de errores detectados con Ubicación/Tipo de error/Descripción, el aviso de importe duplicado y la cancelación desde la barra de progreso). (+1 mejoras más de la corrida), algebraix
@@ Línea 2: / Línea 2: @@
 Las horas de servicio social por grupo se refieren al número total de horas de servicio social que deben cumplir los estudiantes de un grupo específico dentro de un programa educativo.
   - Desde tu "Panel de control" selecciona **Horas de servicio social por grupo.**
-  - Se mostrará una tabla que contiene las horas de servicio configuradas en cada grupo.
+  - Se mostrará una tabla con las columnas **Sección**, **Grupo** y **Horas**, con las horas de servicio social configuradas en cada grupo activo que ya tenga horas asignadas.
-    * Para descargar la información a Excel da clic en el ícono {{icon>far fa-file-excel text-green action-item__icon}}.
+    * **Nota:** si ningún grupo tiene horas de servicio social configuradas, el sistema muestra el aviso "No se han encontrado grupos configurados con número de horas de servicio social." y la tabla no aparece.
-    * Para imprimir la información da clic en el ícono de impresión {{icon>fa fa-print action-item__icon text-dark}}
+    * Para descargar la información a Excel da clic en el ícono {{icon>far fa-file-excel text-green action-item__icon}}.
+    * Para imprimir la información da clic en el ícono de impresión {{icon>fa fa-print action-item__icon text-dark}}
 ===== Modificar horas de servicio social por grupo  =====
   - Desde tu "Panel de control" selecciona **Horas de servicio social por grupo.**
   - Selecciona **Modificar horas de servicio social.**
-  - En el apartado **Horas de servicio social** agregar la cantidad de horas de servicio social que deberán cumplir el o los grupos que seleccionarás.
+  - En el apartado **Horas de servicio social** agrega la cantidad de horas de servicio social que deberán cumplir el o los grupos que seleccionarás (hasta 3 dígitos).
+    * **Nota:** si el campo no es numérico el sistema muestra el aviso "Cantidad de horas inválida" y no guarda.
   - En el apartado **Grupos** despliega el campus.
     * Despliega la sección en la que se encuentran los grupos a modificar.
     * Despliega el grado.
     * Selecciona el o los grupos a los que se aplicará la modificación de horas de servicio social.
+    * Para encontrarlos más rápido usa el campo **Búsqueda por grupo** con sus íconos **Filtrar** y **Limpiar**, o el menú **Perfiles** para marcar de una vez los grupos de un perfil de grupos que tengas configurado; lo que vas marcando se enlista a la derecha bajo **Grupos seleccionados.**
   - Da clic en **Aceptar** para guardar.
+    * **Nota:** si no seleccionas ningún grupo, el sistema muestra el aviso "Es necesario seleccionar al menos un grupo" y no guarda.
+    * Al guardar, el sistema muestra el aviso "Horas actualizadas."
 ===== Registro masivo de horas por grupo =====
   - Desde tu "Panel de control" selecciona **Horas de servicio social por grupo.**
   - Selecciona **Registro masivo de horas por grupo.**
-  - Despliega el menú **Secciones** y selecciona la sección en donde están los grupos a los que se les hará la actualización masiva.
+  - En el panel **Descargar plantilla para importe** despliega **Sección** y selecciona la sección en donde están los grupos a los que se les hará la actualización masiva.
-  - Despliega el menú sub-ciclo y selecciona el sub-ciclo donde quedarán registradas las horas de servicio social.
+  - Al elegir la **Sección** se habilita el campo **Sub-ciclo**; selecciona el sub-ciclo donde quedarán registradas las horas de servicio social.
-  -Los **Grupos** se visualizarán en la parte derecha de la pantalla; marca la casilla de aquellos a los que se les asignarán las horas de servicio social.
+    * **Nota:** el campo se llena marcado con **Mostrar sub-ciclos inactivos**, que incluye en la lista también los sub-ciclos ya cerrados; desmárcalo si solo quieres ver los sub-ciclos activos.
+  - Al elegir el **Sub-ciclo** se muestra el panel **Grupos**, agrupados por grado; marca la casilla de un grado para seleccionar todos sus grupos, o marca la casilla de cada grupo por separado.
   - Da clic en **Descargar.**
+    * **Nota:** si no seleccionas ningún grupo, el sistema muestra el aviso "Es necesario seleccionar al menos un grupo" y no descarga el archivo.
   - Se descargará un archivo de Excel en donde deberás llenar la siguiente información:
     * **Empresa afiliada:** Selecciona la empresa en donde el estudiante está realizando su servicio social.
-      * **NOTA:** En el archivo de Excel encontrarás la sección "Nombre de empresa", donde se indica qué información debes agregar según la empresa afiliada, por ejemplo: Empresa_1, Empresa_2, etc.
+      * **Nota:** En el archivo de Excel encontrarás la sección "Nombre de empresa", donde se indica qué información debes agregar según la empresa afiliada, por ejemplo: Empresa_1, Empresa_2, etc.
     * **Horas:** La cantidad de horas de servicio social que se van a registrar al estudiante.
     * **Fecha de inicio:** La fecha en la que comenzó a generar sus horas de servicio social.
@@ Línea 30: / Línea 37: @@
   - Selecciona **Registro masivo de horas por grupo.**
   - Selecciona **Importar plantilla.**
-  - Da clic en "Microsoft Excel" para que selecciones el archivo de Excel que has llenado.
+  - En el panel **Subir plantilla** da clic en "Microsoft Excel" para que selecciones el archivo de Excel que has llenado.
+    * **Nota:** si intentas continuar sin seleccionar ningún archivo, el sistema muestra el aviso "Archivo inválido." y no continúa.
   - Haz clic en **Importar.**
-  - Aparecerá un mensaje de confirmación, da clic en **Aceptar.**
+  - Se muestra el mensaje "¿ Está seguro de que desea continuar ?" con el detalle "Se verificará el archivo en busca de errores, si todo es correcto se procederá a realizar el importe, el cual puede llevar varios minutos."; da clic en **Aceptar.**
-    * Se mostrará una barra que indica el progreso del importe.
+    * Si el archivo no tiene el formato de Excel esperado, el sistema muestra el aviso "Formato de archivo inválido" y no continúa.
-  - Concluido el importe, se te redirigirá a **General** en donde podrás consultar el histórico de los importes que has realizado.
+    * Si el archivo tiene un formato válido pero el sistema encuentra errores en su contenido, se muestra el aviso "Es necesario corregir los errores encontrados y volver a subir el archivo para continuar con el importe" y, arriba del panel **Subir plantilla**, el panel **Errores detectados: <nombre del archivo>** con una tabla de columnas **Ubicación**, **Tipo de error** y **Descripción.**
-    * Puedes hacer la descarga del archivo que importaste dando clic en el ícono de descarga {{icon>fas fa-download}}
+      * En **Ubicación** se indica la **Hoja** del Excel y, según el error, la **Fila** o la **Celda** exacta.
+      * Corrige el archivo según lo que indique la tabla y repite los pasos para subirlo de nuevo.
+    * Si ya existe un importe de este tipo en proceso para la misma sección y el mismo sub-ciclo, el sistema muestra el aviso "No es posible realizar dos importes similares al mismo tiempo" y no continúa.
+    * Si el archivo es válido, se muestra una barra que indica el progreso del importe, con el mensaje "Abandonar o cerrar esta página no cancelará el proceso de importe, el cual puede consultarse en la página General de importes."
+      * Mientras el importe está en proceso puedes cancelarlo con el botón **Cancelar operación**: se muestra el mensaje "¿ Está seguro que desea cancelar ?" con el detalle "Al cancelar el importe en proceso se perderá también el avance realizado y será necesario realizar el importe nuevamente."; al confirmar con **Aceptar** regresas a **General.**
+  - Concluido el importe, se te redirigirá a **General**, donde el sistema muestra el aviso "El importe se ha realizado exitosamente" y podrás consultar el progreso y el histórico de los importes que has realizado.
+    * Puedes hacer la descarga del archivo que importaste dando clic en el ícono de descarga {{icon>fas fa-download}}
+===== Consultar y cancelar un importe desde General =====
+  - Desde tu "Panel de control" selecciona **Horas de servicio social por grupo.**
+  - Selecciona **Registro masivo de horas por grupo.**
+  - En la pestaña **General** se muestran dos paneles:
+    * **Importes en progreso:** lista los importes que aún se están procesando, con las columnas **Usuario** (quien realizó el importe), **Nombre de archivo**, **Estatus** (una barra de progreso con el porcentaje completado), **Fecha** y **Tipo.**
+    * **Históricos de importes:** lista los importes ya finalizados, con las columnas **Usuario**, **Nombre de archivo** y **Fecha.**
+  - En cualquiera de los dos paneles puedes descargar el archivo importado dando clic en el ícono de descarga {{icon>fas fa-download}} junto a su fila.
+  - Mientras un importe está en progreso, junto a su barra se muestra el ícono {{icon>far fa-trash-can text-red}} para cancelarlo.
+    * Al dar clic se muestra el mensaje "¿ Está seguro que desea cancelar ?" con el detalle "Al cancelar el importe en proceso se perderá también el avance realizado y será necesario realizar el importe nuevamente."
+    * Al confirmar, el sistema muestra el aviso "El importar se ha cancelado exitosamente" y el importe desaparece del panel **Importes en progreso.**
+    * **Nota:** una vez que un importe llega al 100%, el ícono de cancelar se deshabilita: ya no es posible cancelarlo desde ahí.
+  - Si no hay ningún importe realizado ni en proceso, el sistema muestra el aviso "No se encontraron importes realizados o en proceso" y te lleva directamente al panel **Descargar plantilla para importe.**
 ===== Permisos para el operador =====
-Para que el operador pueda hacer estas configuraciones, necesita los siguientes permisos:
+Para que el operador pueda realizar estas configuraciones, es necesario asignarle los siguientes permisos al momento de agregarlo o modificar su perfil:
     * Desde "Permisos globales" > **Servicio social.**
       * **Modificación masiva de horas de servicio social:**Permite modificar las horas de servicio social para más de un grupo.
@@ Línea 43: / Línea 69: @@
       * **Registro masivo de horas por grupo:** Permite el registro masivo de las horas de servicio social completadas por estudiantes de uno o más grupos.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:acad:configuration:social_service_hours_by_group" make -C pipeline revisar</notes>