> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/es/sonar/administration/audit/reports.md). # Informes Reports & Audits › Reports: plantillas que convierten datos de SONAR en un archivo PDF, HTML o texto para un cliente, un sitio o un dispositivo, generado bajo demanda y descargado en el navegador. ## Qué es y cuándo usarlo Un informe convierte datos de SONAR en un documento que alguien ajeno a la consola puede leer: el inventario de dispositivos de un cliente, el estado de las actualizaciones de un sitio, las alertas del mes, el software instalado en un equipo. Cada informe es una **plantilla de informe**: un diseño, los datos que lee y los valores que pide cuando se ejecuta, como el cliente o el sitio. La plantilla se ejecuta desde **Reports & Audits › Reports**. SONAR genera el informe con los datos tal como están en ese momento, y su navegador descarga el archivo. SONAR no conserva los archivos generados y no tiene programación de informes: para enviar el mismo informe cada mes, descárguelo de nuevo cada mes. Use un informe cuando el lector no esté en la consola. Para investigar un evento, busque en el [registro de auditoría](/es/sonar/administration/audit/audit-trail.md). ## Antes de empezar * Su rol necesita **View Reports** para abrir **Reports & Audits › Reports**, y **Manage Reports** para crear, editar, descargar, exportar y eliminar plantillas de informe (grupo **Reports** en **Admin Center › Roles**). * Las plantillas de informe que use deben existir en su instalación. Se crean en el editor descrito más abajo, o se importan desde un archivo exportado de otra instalación de SONAR. ## Pasos ### Descargar un informe 1. Abra **Reports & Audits › Reports**. La tarjeta **Reports Management** lista las plantillas de informe, ocho por página. Use **Search** para encontrar una por nombre, tipo o descripción. 2. En la tarjeta de la plantilla, haga clic en uno de los dos botones de descarga, o abra el menú de la tarjeta y elija **Download PDF** o **Download HTML** (**Download Text** en las plantillas de texto sin formato). 3. En **Download Report Template**, conserve o cambie el **File Name**. 4. En **Dependencies**, elija los valores que pide la plantilla: un **Client**, un **Site**, un **Agent** o un valor escrito a mano. 5. Haga clic en **Download**. SONAR genera el informe y el navegador guarda el archivo. ### Crear una plantilla de informe 1. Haga clic en el menú **+** y elija **Markdown Template**, **HTML Template** o **Plain Text Template**. 2. Escriba el informe en el editor. Use las herramientas **Formatting** y **Section** para los elementos comunes, **VARS** para ver los datos que puede usar la plantilla y **BASE** para crear una plantilla base. 3. Declare en el panel de variables los datos que lee el informe. Las **Data Queries** guardadas se pueden insertar desde la barra de herramientas. 4. Escriba el **Report Name**. 5. Elija una entrada de **Base Templates** si el informe debe compartir un diseño común. 6. En **Template Dependencies**, elija lo que el informe pide cuando se ejecuta: `client`, `site`, `agent` o un nombre propio. 7. Abra la pestaña **Preview** para ver el informe con datos reales. 8. Haga clic en **Save**. ### Gestionar plantillas * **Edit**, o un doble clic en una tarjeta, abre el editor. Mientras edita una plantilla ya guardada, **Auto-save** guarda los cambios a medida que escribe, y **Apply** guarda sin cerrar. * **Clone** abre una copia de la plantilla en el editor. * El lápiz junto a la descripción edita el texto que se muestra en la tarjeta. * **Export** descarga la plantilla, su plantilla base y sus imágenes como un archivo JSON, con el nombre de la plantilla. * **Import Report Template**, en el menú **+**, carga un archivo de ese tipo. Marque **Overwrite if name exists** para sustituir una plantilla con el mismo nombre. * **Delete** elimina la plantilla después de que usted confirme con **Delete**. El menú **⋮** junto al botón **+** abre tres bibliotecas compartidas: | Entrada | Qué contiene | | ---------------------- | ------------------------------------------------------------------------------------------------------------------- | | **Base Templates** | Diseños comunes, como un encabezado y un pie con su logotipo, sobre los que se construyen las plantillas de informe | | **Base Report Assets** | Imágenes, como logotipos, que insertan las plantillas | | **Data Queries** | Selecciones de datos guardadas que se insertan en las plantillas | ## Qué debe ver Cada tarjeta muestra el nombre de la plantilla, su tipo (`markdown`, `html` o `plaintext`), su descripción y sus **Dependencies**, o `—` cuando no pide nada. Debajo de la cuadrícula, **Showing 1 to 8 of N templates** y **Page 1 of N**. Mientras se genera un informe, la página lo espera; un informe sobre muchos dispositivos tarda más que uno de un solo sitio. Después, el archivo llega a las descargas del navegador, con el nombre que usted le dio. | Tipo de plantilla | Botones de descarga | Nombre de archivo predeterminado | | ----------------- | ------------------- | -------------------------------- | | Markdown, HTML | PDF, HTML | `NAME.pdf`, `NAME.html` | | Texto sin formato | PDF, Text | `NAME.pdf`, `NAME.csv` | Las fechas y horas del informe siguen la zona horaria del navegador que lo genera. ## Cómo verificar que funcionó 1. Abra el archivo y compruebe que cubre lo que eligió en **Dependencies**: el cliente, el sitio o el dispositivo que nombra debe ser el que usted eligió. 2. Compare una cifra con la consola. Para una lista de dispositivos de un cliente, el número de dispositivos debe coincidir con la tarjeta del cliente en **Dashboard › Sysadmin**; para un solo dispositivo, los valores deben coincidir con su panel; vea [Detalles del dispositivo](/es/sonar/administration/devices/device-details.md). 3. Para una plantilla nueva, la pestaña **Preview** debe mostrar el mismo contenido que el archivo descargado. ## Errores comunes | Síntoma | Causa | Solución | | ------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | -------------------------------------------------------------------- | | Los botones de descarga aparecen atenuados, con **You don't have permission for this action** | El rol tiene **View Reports** pero no **Manage Reports** | Conceda **Manage Reports** en **Admin Center › Roles** | | **Reports** no aparece en el menú | Al rol le falta **View Reports** | Concédalo | | **Download** sigue deshabilitado en **Download Report Template** | **File Name** está vacío, o una dependencia no tiene valor | Rellene el nombre del archivo y todas las dependencias | | **Download** en el editor está deshabilitado, o aparece **Save your changes before downloading.** | La plantilla tiene cambios sin guardar, o nunca se ha guardado | Haga clic primero en **Save** | | **Template Name is required** o **Template Text is required** al hacer clic en **Save** | **Report Name** o el cuerpo de la plantilla está vacío | Rellene ambos | | **Error in variables:** seguido de un mensaje | El panel de variables tiene un error de sintaxis | Corrija la línea que indica el mensaje | | Un mensaje de que el nombre ya existe | Los nombres de las plantillas de informe son únicos | Elija otro nombre, o importe con **Overwrite if name exists** | | El informe sale vacío | Nada coincide con el cliente, el sitio o el dispositivo elegido | Revise los valores de las dependencias, o elija un ámbito más amplio | | **No templates found.** | Aún no existe ninguna plantilla, o **Search** las filtra todas | Borre **Search**, o cree o importe una plantilla | ## Referencia de campos ### Download Report Template | Campo | Qué hace | Valores aceptados | Predeterminado | | ------------------------------- | -------------------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------ | | **File Name** | Nombre del archivo descargado | Cualquier nombre de archivo. Obligatorio | El nombre de la plantilla con la extensión del formato | | **Client**, **Site**, **Agent** | El cliente, el sitio o el dispositivo sobre el que trata el informe, visible cuando la plantilla depende de él | Una entrada de la lista. Obligatorio | Vacío | | Otras dependencias | Valores que pide la plantilla, como una fecha | Texto. Obligatorio | Vacío | ### Editor de plantillas de informe | Campo | Qué hace | Valores aceptados | Predeterminado | | ------------------------- | ---------------------------------------------------------------------------- | ----------------------------------------------------- | -------------- | | **Report Name** | Nombre que se muestra en la tarjeta y en el nombre de archivo predeterminado | Hasta 200 caracteres, único. Obligatorio | Vacío | | **Base Templates** | Diseño común sobre el que se construye el informe | Una plantilla base, o vacío | Vacío | | **Template Dependencies** | Valores que se piden cada vez que se ejecuta el informe | `client`, `site`, `agent` o nombres que usted escriba | Ninguno | | **Auto-save** | Guarda los cambios de una plantilla ya guardada a medida que escribe | Activado o desactivado | Activado | | Cuerpo de la plantilla | El informe en sí, en el tipo de la plantilla | Markdown, HTML o texto sin formato. Obligatorio | Vacío | | Pestaña **CSS** | Estilos del informe, para plantillas Markdown y HTML | CSS | Vacío | ### Tarjeta | Elemento | Qué contiene | | ---------------- | ------------------------------------------------------------- | | Nombre y tipo | El nombre de la plantilla, y `markdown`, `html` o `plaintext` | | Descripción | Texto libre, hasta 500 caracteres, editado con el lápiz | | **Dependencies** | Los valores que se piden cuando se ejecuta el informe | ## Páginas relacionadas * [Registro de auditoría](/es/sonar/administration/audit/audit-trail.md): el registro de las acciones, consultable en la consola * [Detalles del dispositivo](/es/sonar/administration/devices/device-details.md): los datos del dispositivo de los que se nutren los informes * [Clientes y sitios](/es/sonar/administration/devices/clients-and-sites.md): los ámbitos para los que se puede ejecutar un informe * [Campos personalizados](/es/sonar/administration/settings/custom-fields.md): valores adicionales que pueden incluir los informes * [Roles y permisos](/es/sonar/administration/identities/roles.md): **View Reports** y **Manage Reports**