Diferencias

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

--- a:system_configuration:custom_reports [2025/10/14 08:47]
[Reportes personalizados] , kvaldez
+++ a:system_configuration:custom_reports [2026/09/13 23:20] (actual)
wiki: a:system_configuration:custom_reports corrige la etiqueta del campo de notas y la ruta de permisos al crear un reporte personalizado (+8 mejoras más de la corrida), algebraix
@@ Línea 3: / Línea 3: @@
 **IMPORTANTE:** Puedes solicitar al equipo de soporte técnico que te ayude a generar este reporte. Dependiendo de la información que requieras y de la viabilidad de incluirla, el reporte será generado de forma que solo tengas que descargar la información resultante.
+<notes>En reportes personalizados puedes obtener el Listado de datos de facturación en .txt para verificarlos ante el SAT.</notes>
 Ejemplos de reportes personalizados
-  * **Archivo para validar datos de facturación ante el SAT:** Descarga un archivo .txt con los datos de facturación de los padres de familia: RFC, razón social y código postal. Permite hacer la validación masiva en el portal del SAT de forma rápida.
+  * **Archivo .txt para validar datos de facturación ante el SAT:** Descarga un archivo .txt con los datos de facturación de los padres de familia: RFC, razón social y código postal. Para después hacer la validación masiva en el portal del SAT de forma rápida.
+===== Consultar reportes personalizados =====
+  - Desde tu **Panel de control** selecciona **Reportes personalizados;** se abre la pestaña **General.**
+  - Si ya existen reportes, el panel **Reportes personalizados** muestra una tabla con el **Nombre** y la **Fecha de creación** de cada uno, ordenable por cualquiera de las dos columnas.
+  - Da clic en el **Nombre** de un reporte para entrar a su detalle, desde donde puedes modificarlo, agregarle consultas o descargarlo.
+  - Si todavía no has creado ningún reporte, el sistema muestra "No se han creado reportes personalizados" en lugar de la tabla.
+<notes>FALTA_CAPTURA — pantalla: Reportes personalizados → General; mostrar: el panel "Reportes personalizados" con la tabla Nombre / Fecha de creación; archivo sugerido: :a:system_configuration:reportes_personalizados_listado.png</notes>
+  - Al entrar al detalle de un reporte se abre la pestaña **General**, con el panel **Reporte personalizado**: muestra el **Nombre** del reporte y, si le agregaste **Notas** al crearlo o modificarlo, las muestra debajo bajo el título **Descripción**.
+<notes>FALTA_CAPTURA — pantalla: Reportes personalizados → [nombre del reporte] → General; mostrar: el panel "Reporte personalizado" con el Nombre y, si tiene, la Descripción; archivo sugerido: :a:system_configuration:reporte_personalizado_general.png</notes>
 ===== Crear reporte personalizado =====
   - Desde tu **Panel de control** selecciona **Reportes personalizados.**
   - Para crear un reporte da clic en **Crear reporte personalizado.**
   - Agrega el **Nombre** con el que identificarás tu reporte.
-  - Puedes agregar alguna **Nota** que resulte útil para este reporte.
+  - Puedes agregar **Notas** que resulten útiles para este reporte.
   - Haz clic en el botón **Aceptar** para guardar.
   - Luego haz clic en la pestaña **General.**
   - Haz clic en el nombre del reporte que acabas de crear.\\ {{:a:system_configuration:nombre_de_reporte_personalizado.png?direct&400|}}
+  - El reporte trae un menú desplegable **Consultas** con dos opciones: **Consultas**, que muestra las que ya agregaste, y **Agregar consulta.**
+    * Si el reporte todavía no tiene ninguna, al seleccionar **Consultas** el sistema muestra "No se han agregado consultas."
+    * Si ya agregaste alguna, **Consultas** muestra un panel con el nombre del reporte y la lista de tus consultas, cada una solo con su **Nombre**; da clic en una para entrar a su detalle.
+<notes>FALTA_CAPTURA — pantalla: Reportes personalizados → [nombre del reporte] → Consultas; mostrar: el panel con el nombre del reporte y la lista de nombres de consultas ya agregadas; archivo sugerido: :a:system_configuration:reporte_personalizado_lista_consultas.png</notes>
   - Despliega el menú **Consultas** y selecciona **Agregar consulta.**
   - Agrega el **Nombre** que darás a la consulta.
-  - En el apartado **Consulta** agrega la consulta que se deberá hacer en la base de datos.
+  - En el apartado **Consulta** agrega la consulta que se deberá hacer en la base de datos, con el formato TIPO:TITULO:(ID OPCIONAL) que se explica del lado derecho de la pantalla.
-    * **IMPORTANTE:** Del lado derecho de la pantalla encontrarás el ejemplo del formato que debe manejarse para hacer la consulta.\\ {{:a:system_configuration:formato_para_reporte_personalizado.png?direct&400|}}
+    * **IMPORTANTE:** Del lado derecho de la pantalla, el panel **Formato** trae la tabla de **Tipo** y **Resultado** con los tipos de dato que puedes usar en la consulta: **Valor exacto**, **Valor numérico**, **Fecha**, **Estudiante**, **Grupo**, **Múltiples grupos**, **Sección académica**, **Ciclo**, **Sub-ciclo** y **Periodo**.\\ {{:a:system_configuration:formato_para_reporte_personalizado.png?direct&400|}}
+    * El **ID OPCIONAL** identifica un dato de la consulta para poder referenciarlo desde otro; para eso existe el tipo **Mismo valor que identificador opcional** (same_as), que toma el mismo valor que el dato cuyo identificador le indiques.
+    * **Nota:** si el **Nombre** o la **Consulta** no cumplen el formato esperado, el sistema muestra "Nombre inválido" o "Consulta inválida" y no te deja continuar.
   - Agregada tu consulta da clic en **Aceptar.**
     * **Nota:** Puedes agregar más de una consulta a tu reporte.
@@ Línea 25: / Línea 39: @@
   - Da clic en el nombre del reporte a modificar.
   - Haz clic en **Modificar.**
-  - Podrás hacer la modificación del nombre del reporte y las notas agregadas, para guardar da clic en **Aceptar.**
+  - Podrás hacer la modificación del **Nombre** y las **Notas** del reporte; para guardar da clic en **Aceptar.**
-  - Si deseas eliminar un reporte, da clic en el ícono **Eliminar** {{icon>far fa-trash-alt}} que aparece en la parte inferior derecha de la pantalla.
+    * El sistema muestra "Reporte personalizado actualizado" y te deja en la misma pantalla con los datos ya guardados.
+  - Si deseas eliminar un reporte, da clic en el ícono **Eliminar** {{icon>far fa-trash-alt}} que aparece en la parte inferior derecha de la pantalla.
+    * El sistema te pide confirmar con "¿ Está seguro que desea eliminar el reporte personalizado : [nombre del reporte] ?"; si aceptas, el reporte y todas sus consultas se eliminan.
+===== Modificar una consulta =====
+  - Desde tu **Panel de control** selecciona **Reportes personalizados.**
+  - Da clic en el nombre del reporte cuya consulta quieres modificar.
+  - Despliega el menú **Consultas** y selecciona **Consultas.**
+  - Da clic en el nombre de la consulta que quieres revisar o modificar; se abre en la pestaña **Consulta.**
+  - La pestaña **Consulta** muestra el **Nombre** de la consulta y, debajo, la consulta tal como quedó guardada, en el formato TIPO:TITULO:(ID OPCIONAL).
+  - Para modificarla, da clic en la pestaña **Modificar.**
+  - En la pestaña **Modificar** puedes cambiar el **Nombre** y la **Consulta**, con el mismo formato TIPO:TITULO:(ID OPCIONAL) que ya usaste al agregarla.
+    * El panel **Formato** muestra, igual que al agregar una consulta, la tabla de **Tipo** y **Resultado** con los tipos de dato disponibles.
+  - Da clic en **Aceptar** para guardar; el sistema muestra "Consulta modificada."
 ===== Descargar reporte personalizado =====
   - Desde tu **Panel de control** selecciona **Reportes personalizados.**
   - Haz clic en el nombre del reporte del cuál quieres descargar la información.
   - Haz clic en **Descargar.**
-  - Elige el formato de descarga, puedes ser en Excel o en texto.
+  - Si ninguna de las consultas del reporte necesita datos adicionales, el sistema te muestra el panel **Reporte personalizado** con el campo **Formato**, donde eliges **Microsoft Excel ®** o **Texto**.
-    * **Nota:** Dependiendo de la información contenida en el reporte el sistema te permitirá hacer la descarga en formato tipo texto.
+    * **Nota:** la opción **Texto** solo está disponible para el reporte que descarga el archivo .txt de validación ante el SAT; en el resto, la descarga siempre es en **Microsoft Excel ®**.
-  - Da clic en **Descargar.**
+  - Si alguna consulta del reporte sí necesita datos adicionales, en su lugar aparece un formulario con los campos que esa consulta requiera, por ejemplo:
+    * Un texto o un valor numérico.
+    * Una fecha, con calendario para elegirla.
+    * Un estudiante, que buscas escribiendo su nombre.
+    * Un grupo, una sección, un ciclo, un sub-ciclo o un periodo, cada uno con su propio menú desplegable.
+    * El árbol completo de **Grupos** (con **Búsqueda por grupo**, **Perfiles**, **Seleccionar todo** y **Mostrar grupos inactivos**) o de **Ciclos, sub-ciclos y periodos**, cuando la consulta necesita varios a la vez.
+    * Una casilla para responder sí o no, o un menú para elegir cómo redondear un número (**Redondear al entero**, **Recortar al primer decimal**, entre otras opciones).
+    * **IMPORTANTE:** debes llenar todos los campos que se muestren; si dejas alguno vacío el sistema te avisa "Es necesario especificar un valor para todos los datos requeridos de cada consulta" y no te deja continuar.
+    * Completados los campos, da clic en **Aceptar** para obtener el reporte en **Microsoft Excel ®**.
+  - Para el reporte de validación de facturación ante el SAT, al terminar la descarga del .txt aparece además el panel **Validar respuesta del SAT**:
+    * Da clic en **Respuesta SAT** y elige el archivo .txt que te devolvió el portal del SAT.
+    * Haz clic en **Validar** para revisarlo.
+    * Si el archivo no corresponde al formato esperado, el sistema muestra "Archivo inválido."
+    * El sistema muestra la lista **Usuarios con información inválida** con el **RFC**, el **Nombre o razón social**, el **Código postal**, la **Razón** por la que el SAT lo marcó y el **Usuario** al que pertenece cada registro; cada nombre es un enlace a su perfil.
+    * Junto al título de esa lista puedes dar clic en el icono de Excel para descargarla.
+  - Ejemplo de reporte personalizado:
+    * Archivo .txt para validar datos de facturación ante el SAT: Descarga un archivo .txt con los datos de facturación de los padres de familia: RFC, razón social y código postal. Para después hacer la validación masiva en el portal del SAT de forma rápida.
+<notes>FALTA_CAPTURA — pantalla: Reportes personalizados → [nombre del reporte] → Descargar; mostrar: el panel "Reporte personalizado" con el campo Formato (Microsoft Excel / Texto) y el botón Descargar; archivo sugerido: :a:system_configuration:descargar_reporte_personalizado.png</notes>
+<notes>FALTA_CAPTURA — pantalla: Reportes personalizados → [nombre del reporte] → Descargar, con una consulta que pide datos; mostrar: el formulario con los campos solicitados (por ejemplo fecha, grupo o el árbol de grupos) y el botón Aceptar; archivo sugerido: :a:system_configuration:descargar_reporte_personalizado_con_datos.png</notes>
 ===== Permisos para el operador =====
 Para que el operador pueda realizar este tipo de reportes, necesita los siguientes permisos:
-    * Desde "Permiso globales" > **Configuración general.**
+    * Desde "Permisos globales" > **Configuración general** > REPORTES PERSONALIZADOS.
-      * **Reportes personalizados.**
         * **Agregar reportes personalizados:** Le permite crear un reporte personalizado.
         * **Agregar consulta:** Podrá agregar consultas a los reportes personalizados.
@@ Línea 47: / Línea 90: @@
         * **Ver consulta:** Podrá ver las consultas creadas en los reportes personalizados.
+<notes>REVISION_PENDIENTE — redactado por el canal automático y publicado sin revisión de un segundo lector. Para revisarlo: ARTICULOS="a:system_configuration:custom_reports" make -C pipeline revisar</notes>