Diferencias

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

--- a:system_configuration:templates [2026/09/14 18:40]
wiki: a:system_configuration:templates profundiza "Crear plantilla" con el tipo Mensaje a deudores, las plantillas de Excel como lenguaje, la restricción de JavaScript y el panel de variables del Encabezado (+5 mejoras más de la corrida), algebraix
+++ a:system_configuration:templates [2026/09/14 19:00] (actual)
wiki: a:system_configuration:templates profundiza "Modificar una plantilla" con sus campos (Lenguaje de plantilla, Tamaño de papel, Generar en formato horizontal, Generar PDF, Depuración/Desarrollo), el comportamiento por Tipo (Reporte personalizado, Mensaje a deudores, Encabezado) y los avisos de guardado (JavaScript no permitido, encabezado duplicado, tamaño de papel faltante, plantilla ya bloqueada por JavaScript existente). (+1 mejoras más de la corrida), algebraix
@@ Línea 85: / Línea 85: @@
     * Si no dejas seleccionada una **Estructura** o un **Estilo**, la plataforma te lo pide con un aviso y no guarda los cambios.
 <notes>FALTA_CAPTURA — pantalla: Plantillas de documentos → [nombre de una plantilla de Formato predefinido] → Modificar; mostrar: el formulario de modificación completo, con la Vista previa de la Estructura y el Estilo vigentes; archivo sugerido: :a:system_configuration:modificar_formato_predefinido.png</notes>
+===== Consultar el detalle de una plantilla =====
+  - Desde tu "Panel de control" selecciona **Plantillas de documentos.**
+  - En la pestaña **General** da clic en el nombre de la plantilla que deseas consultar.
+  - Se muestra la pestaña **General** con:
+    * **Nombre**
+    * Si el **Tipo** de la plantilla es **Reporte personalizado**, el nombre del reporte personalizado del que toma los datos.
+    * Si el **Lenguaje de plantilla** es **Plantilla de Microsoft Excel ® XLS 2003** o **XLS 2007**, el enlace **Descargar plantilla** para obtener el archivo adjuntado.
+    * El panel **Especificaciones técnicas:**
+      * Si la plantilla es un **Formato predefinido**, se indica con esa etiqueta; en cualquier otro caso se muestra el **Lenguaje de plantilla** (**Template toolkit**, **Plantilla de Microsoft Excel ® XLS 2003**, **Plantilla de Microsoft Excel ® XLS 2007**, **XSLT** o **Mustache**).
+      * **Tamaño de papel:** solo se muestra si la plantilla tiene uno asignado (**Carta** u **Oficio**).
+      * **Generar formato horizontal, Generar PDF** y **Depuración / Desarrollo:** cada uno con un ícono verde o rojo según esté activado o no.
+      * Si la plantilla es un **Formato predefinido**, se agregan también **Incluir comentarios** e **Incluir ausencias**, con el mismo ícono verde o rojo.
+    * Si el **Lenguaje de plantilla** no es Excel ni **Formato predefinido**, se muestra debajo el código completo de la **Plantilla**.
+  - En la parte inferior derecha de la pantalla, el ícono **Eliminar** {{icon>far fa-trash-can}} solo aparece si tienes permiso para eliminar la plantilla; al darle clic la plataforma te pide confirmar con "¿ Está seguro que desea eliminar esta plantilla [nombre de la plantilla] ?".
+<notes>FALTA_CAPTURA — pantalla: Plantillas de documentos → [nombre de una plantilla] → General; mostrar: la pestaña General completa, con el panel de datos generales y el panel "Especificaciones técnicas"; archivo sugerido: :a:system_configuration:detalle_plantilla_general.png</notes>
 ===== Modificar una plantilla =====
 <notes>También se conoce como modificar constancia de estudios, boletas, reportes.</notes>
-Esta opción es para poder modificar tus plantillas de boletas, kardex, constancias, etc.
+Esta opción es para poder modificar tus plantillas de boletas, kardex, constancias, etc. No aplica a las plantillas de **Formatos predefinidos** (consulta "Modificar un formato predefinido").
   - Desde tu "Panel de control" selecciona **Plantillas de documentos.**
@@ Línea 94: / Línea 110: @@
   - Da clic en el nombre de la plantilla que deseas modificar.
   - Haz clic en **Modificar.**
-    * Si deseas hacer la copia del código de la plantilla, da clic en las hojas que aparecen en la parte inferior derecha de la pantalla {{icon>far fa-copy text-dark action-item__icon action-item__icon}}
+    * **IMPORTANTE:** si el código de tu plantilla ya incluye JavaScript, la plataforma no te deja abrirla para modificarla y te avisa con "La plantilla incluye código JavaScript y no puede ser editada"; solo el administrador principal de la plataforma puede hacerlo en ese caso.
-  - Realizadas las modificaciones al código da clic en **Aceptar** para guardar.
+  - Se muestra el formulario con la configuración actual de la plantilla:
+    * **Nombre**
+    * **Lenguaje de plantilla:** puedes cambiarlo entre **Template toolkit**, **XSLT**, **Mustache**, **Plantilla de Microsoft Excel ® XLS 2003** y **Plantilla de Microsoft Excel ® XLS 2007** (esta última no se ofrece si el **Tipo** de la plantilla es **Encabezado**). Si el **Tipo** es **Encabezado** y ya existe otra plantilla de encabezado en Template toolkit o en Excel 2007, esa opción de lenguaje se deshabilita para evitar duplicarla.
+      * Si eliges **Plantilla de Microsoft Excel ® XLS 2003** o **XLS 2007**, el formulario reemplaza el editor de código por un campo para adjuntar el **Archivo**, con la extensión que corresponda (.xls o .xlsx); si adjuntas uno de otro tipo, la plataforma te avisa con "El archivo adjuntado debe ser de tipo Microsoft Excel ® 1997-2003 (XLS)" o "... 2007-365 (XLSX)" según el caso.
+    * **Tamaño de papel:** **Carta** u **Oficio**.
+    * **Generar en formato horizontal**
+    * **Generar PDF**
+    * **Depuración / Desarrollo**
+    * Si el **Tipo** de la plantilla es **Reporte personalizado**, se muestra además el campo **Reporte personalizado**, donde eliges de cuál de tus reportes ya creados tomará los datos.
+    * Si el **Tipo** de la plantilla es **Mensaje a deudores**, los campos **Tamaño de papel**, **Generar en formato horizontal**, **Generar PDF** y **Depuración / Desarrollo** aparecen deshabilitados, y debajo del formulario se muestra el panel **Datos disponibles** con la estructura de datos (estudiante, periodos y cargos) que puedes usar en tu código.
+    * Si el **Tipo** de la plantilla es **Encabezado** y el **Lenguaje de plantilla** es Template toolkit o Excel 2007, se muestra debajo del formulario la lista de **Variable** que puedes usar en tu código (fecha, hora, apellido del autor, nombre del autor y nombre del reporte).
+  - **Código de plantilla:** se muestra el código actual para que lo modifiques.
+    * Si deseas hacer la copia del código de la plantilla, da clic en las hojas que aparecen en la parte inferior derecha de la pantalla. {{icon>far fa-copy text-dark action-item__icon action-item__icon}}
+    * **IMPORTANTE:** si tu **Lenguaje de plantilla** es Template toolkit, tu código no puede incluir JavaScript; si lo incluyes, la plataforma no guarda los cambios y te avisa con "La plantilla no puede incluir código JavaScript".
+  - Realizadas las modificaciones da clic en **Aceptar** para guardar.
+    * Si tu plantilla es de **Tipo** **Encabezado** y cambias el **Lenguaje de plantilla** a uno que ya tiene otra plantilla de encabezado, la plataforma no guarda los cambios y te avisa con "Ya existe un encabezado de este tipo".
+    * Si no seleccionaste un **Tamaño de papel** (y tu plantilla no es de **Tipo** **Mensaje a deudores**), la plataforma te lo pide con un aviso y no guarda los cambios.
+<notes>FALTA_CAPTURA — pantalla: Plantillas de documentos → [nombre de una plantilla que no sea de Formato predefinido] → Modificar; mostrar: el formulario de modificación con el editor de código y el botón de copiar al portapapeles en la esquina inferior derecha; archivo sugerido: :a:system_configuration:modificar_plantilla.png</notes>
 ===== Generar un reporte personalizado con tu plantilla =====
 Si creaste una plantilla de tipo **Reporte personalizado**, puedes usarla para obtener la información de ese reporte con el formato que programaste, en vez de descargarla en Excel o texto.