Crear un informe
Objetivo
Convertir una plantilla diseñada en un informe que los usuarios puedan ejecutar: impreso para un registro («imprimir esta factura») o sobre toda una lista, desde la barra de comandos, en la aplicación que ya tienen abierta.
De qué se compone un informe
Dos mitades, que se encuentran en un nombre.
- La plantilla: la página: sus bandas, sus tablas, su logotipo, su marca de agua. Se diseña en el diseñador gráfico y se exporta como JSON, que usted pega aquí.
- Los conjuntos de datos: las filas que la rellenan. Cada uno nombra una consulta guardada o lleva una consulta propia, con un nombre al que hace referencia la plantilla.
Un informe no lleva datos propios. Todo lo que imprime es una consulta, que se ejecuta cuando alguien pulsa Imprimir, con los permisos de esa persona. Dos personas que imprimen el mismo informe ven los registros que cada una tiene permitido ver: un informe es un diseño sobre sus datos, nunca una forma de saltarse quién puede leerlos.
Requisitos previos
- Ha iniciado sesión como creador, con una solución y un entorno seleccionados.
- Las consultas guardadas que usará su informe ya existen (o escribirá la consulta en línea).
- Tiene una plantilla exportada desde el diseñador.
Pasos
- Abra su solución y elija Informes.
- Seleccione Nuevo y dele un nombre para mostrar; el nombre lógico se rellena solo.
- Rellene los conjuntos de datos. Para cada uno:
- Nombre: cómo llama la plantilla a estas filas. El repetidor de la plantilla lo nombra, así que los dos deben coincidir exactamente.
- Consulta guardada: la pregunta que lo rellena, elegida entre las consultas guardadas del entorno en lugar de escrita. Cada opción indica qué tabla lee la consulta, porque un nombre para mostrar rara vez distingue dos de ellas. Escriba primero la pregunta; consulte Guardar una consulta.
- Campo de registro: opcional; consulte más abajo.
- Pegue el JSON de la plantilla.
- Seleccione Guardar. La plataforma comprueba que el informe está bien formado, que cada consulta es una consulta válida y que cada una se ejecutaría realmente aquí: cada campo, combinación y medida contra las tablas reales de este entorno. Un campo mal escrito se rechaza ahora, en lugar de que lo descubra quien pulse Imprimir.
El primer conjunto de datos es el principal. Su tabla es aquello sobre lo que trata el informe: decide qué registros y qué listas ofrecen el informe en su barra de comandos, y es el conjunto al que se entrega el filtro actual de una lista.
Imprimir un registro
Establezca el campo de registro en un conjunto de datos y el informe podrá imprimirse para un solo registro.
- En el conjunto de datos principal suele ser
id: «esta factura». - En un conjunto de datos secundario es la búsqueda que vuelve al principal:
par_invoiceiden las líneas, de modo que imprimir la factura 42 imprime las líneas de la factura 42 y ninguna otra. - Déjelo vacío y el conjunto de datos no se ve afectado por el registro desde el que imprimió. Así es como un informe puede imprimir una sola factura junto a una tabla con los tipos de cambio de este mes.
Ejecutar uno
A un informe se llega deliberadamente: nada pone un botón en una tabla solo porque un informe la nombre. Hay tres vías de entrada:
- Desde la navegación de la aplicación, si un creador colocó ahí el informe. Se abre sobre toda la tabla.
- Desde un comando que un creador dibujó en un formulario o una vista, con Ejecutar un informe como comportamiento. Pulsado en un registro abierto imprime ese registro; pulsado en una lista abarca toda la tabla. Consulte Hacer que un botón haga algo.
- Desde un widget de panel que lo nombre.
En cualquier caso, el informe se abre como una pantalla propia, con la navegación de la aplicación todavía a su lado y su dirección en la barra de direcciones, así que un informe que está viendo se puede actualizar, guardar en marcadores o enviar a un compañero. Un informe abierto por un comando lleva un botón ← al principio de la barra de herramientas del visor, que vuelve a la pantalla en la que se pulsó el botón.
La búsqueda y el filtro de una lista no viajan con él. Un informe se direcciona por su propio nombre, y un filtro no es algo que una dirección pueda llevar; para informar sobre un conjunto más reducido de registros, dele el filtro al informe.
Leer un informe en pantalla
El visor se abre con una página cada vez, con un zoom que encaja una página entera, y con Imprimir al final. Cuatro controles cambian lo que está viendo:
- Páginas: Una página con un paginador (como se lee un informe) o Todas las páginas, con desplazamiento (como se revisa uno antes de imprimirlo). En Todas las páginas el paginador desaparece, porque sería una segunda respuesta a dónde está usted.
- Zoom: Ajustar a la página, Ajustar al ancho o Tamaño real. Ajustar significa ajustar, en ambas direcciones: una página más estrecha que su ventana se amplía para llenarla, porque para eso se llama así el comando. Tamaño real es la respuesta cuando quiere 1:1.
- Pantalla completa: llena la ventana con el informe. Esc sale de ella. El informe sigue dentro de la aplicación, así que los mensajes y el resto del producto siguen funcionando mientras está abierto.
- Imprimir.
Imprimir produce todas las páginas a tamaño completo, no la que está en pantalla ni con el zoom con el que la estaba leyendo, y ninguno de los botones propios del visor. El papel es del tamaño para el que se diseñó el informe: un informe A4 se imprime en A4, de borde a borde, sin encabezado, pie, URL ni número de página del navegador en el margen, porque la hoja no tiene margen en el que imprimirlos.
Si ha activado los encabezados y pies de página en el propio cuadro de diálogo de impresión de su navegador, los seguirá obteniendo: ese ajuste es suyo, y la plataforma no lo anula. Desactive ahí «Encabezados y pies de página».
Un informe es texto, no una imagen de texto
Puede seleccionar cualquier texto de un informe y copiarlo, y la función Buscar de su navegador (Ctrl+F / ⌘F) busca en la página en la que está. Un lector de pantalla lee el informe en voz alta en lugar de anunciar una imagen. Nada de esto es un ajuste: una página de informe es texto normal en la página, que es también lo que hace que las líneas en persa y árabe se representen correctamente cuando contienen un código de producto latino o un precio: el propio navegador ordena el tramo mixto.
Buscar busca en las páginas que están en pantalla. En Una página es la página que está leyendo; cambie a Todas las páginas para buscar en todo el informe a la vez.
Fechas, números y dígitos
Un informe imprime las fechas con el mismo calendario y patrón que la cuadrícula de al lado, y los números con los mismos dígitos: dígitos persas y fechas del calendario jalalí para un inquilino persa. No se configura por informe: viene de Configuración → Calendario y de la configuración regional del inquilino, así que un informe no puede desviarse del resto del producto.
Moverlo entre entornos
Un informe es un componente de solución, archivado bajo la tabla de la que trata. Agréguelo a su solución desde la lista Administrar componentes de esa tabla y se exportará e importará con todo lo demás, incluida su plantilla, que viaja dentro del informe y no a su lado.
Sus consultas guardadas también viajan, y se importan antes que él: un informe se rechaza si nombra una consulta que el entorno de destino no tiene, que es el fallo honesto en lugar de un informe que se importa y luego no imprime nada.
Solución de problemas
- «La plantilla no es un JSON válido.» — lo pegado está truncado o tiene un carácter de más. El cuadro no cambia el formato de lo que escribe, así que lo que ve es lo que se envió.
- «Un informe necesita al menos un conjunto de datos.» — una fila de conjunto de datos necesita un nombre y una consulta guardada para contar; una fila a medio rellenar se ignora.
- «El conjunto de datos 'rows' debe nombrar exactamente uno de 'savedQuery' o 'query'.» — ha indicado ambos, o ninguno.
- «…nombra la consulta guardada 'x', que no existe en este entorno.» — compruebe cómo está escrita, o agregue la consulta a la solución para que viaje.
- «Campo desconocido …» — la consulta nombra un campo que no está en su tabla. Corrija la consulta, no el informe.
- El informe se imprime pero la página está vacía. — el repetidor de la plantilla nombra un conjunto de datos que el informe no define. Los nombres tienen que coincidir exactamente.
- «No se pudo maquetar la plantilla de este informe.» — el motor no pudo convertirla en páginas. Vuelva a exportarla desde el diseñador; una plantilla editada a mano se rompe con facilidad.
- No aparece ningún comando de informe en el registro. — nada lo genera. Dibuje un botón y asígnele Ejecutar un informe, o coloque el informe en la navegación de la aplicación.
- El informe se abrió pero muestra todos los registros. — se ejecutó desde una lista, o desde un registro que nunca se ha guardado. Solo un registro guardado y abierto reduce un informe.