Peticionario gráfico
Presentación general
Utilice esta función para crear pantallas de consulta con el resultado de las consultas realizadas en la base de datos. El peticionario funciona extrayendo temporalmente los datos de una tabla y, posteriormente, consultándola. La consulta puede incluir varios niveles de detalle, definidos por rupturas sucesivas.
La estructura de la tabla temporal permite a cada usuario conservar los resultados de la última consulta realizada (salvo si es una consulta compartida). El uso de esta funcionalidad se compone de tres fases:
- Definición de la consulta en la función.
- Lanzamiento de la consulta (haciendo clic en el botón o mediante la función de consulta y la actualización de los datos).
- Visualizando la consulta, si ya se ha ejecutado.
Una consulta se puede formar con campos de tabla o expresiones.
Las uniones entre las tablas se determinan automáticamente a partir del diccionario, pero se pueden definir de forma explícita arrastrando y soltando un campo de una tabla a otra. El campo de destino debe formar parte de una clave.
Es importante señalar que hay dos herramientas complementarias: un peticionario equivalente a este, pero en forma de tabla; un peticionario SQL que utiliza pantallas de consulta similares, pero con el objetivo de diseñar consultas basadas en el lenguaje SQL.
Gestión de la interfaz
El campo de creación de consultas está formado por una estación flotante, un espacio de diseño del modelo y una zona para almacenar los campos seleccionados.
Estación flotante
Contiene los botones:
- Tabla - Abre una lista de selección para añadir una tabla.
- Expresión - Abre el asistente de fórmula para añadir una expresión.
- Suprimir - Reinicializa la consulta.
- Activo - Casilla que permite mostrar o no los códigos de los campos, además de las descripciones.
Espacio de diseño del modelo
Tablas
Este espacio muestra las tablas añadidas con sus uniones.
Para añadir una tabla, haga clic en el botón "Añadir una tabla" de la estación flotante.
Las acciones que se pueden realizar en una tabla son:
- Suprimir la tabla haciendo clic en la cruz superior derecha de la tabla. Tenga en cuenta que las tablas solo se pueden suprimir una vez que se han suprimido todos sus vínculos y sus campos de la zona de almacenamiento.
- Ampliar/reducir la tabla mediante el icono situado a la izquierda de la cruz.
![]()
- Desplazar la tabla mediante la barra de descripciones o la barra inferior.
- Redimensionar la tabla mediante la esquina inferior derecha.
Uniones
Las uniones que no se han creado automáticamente se pueden crear arrastrando y soltando el campo de la tabla de origen al campo de la tabla de destino. Se crea una unión izquierda externa.
Si hace clic en la unión, se abre un menú que permite cambiar el tipo (externa izquierda o interna) o suprimirla.
Segundo plano
Si arrastra y suelta en una zona libre del espacio de diseño, puede reposicionar este espacio. Si hace doble clic, puede reemplazar el espacio de diseño con respecto a su origen.
![]()
Zona de almacenamiento
La zona de almacenamiento permite:
- Visualizar los campos en forma de viñetas.
- Modificar el orden y las propiedades (clasificación, acumulación, rangos, visibilidad) de dichas viñetas.
- Gestionar las expresiones.
- Gestionar las rupturas de la consulta.
Añadir un campo
Para añadir un campo de la tabla, haga doble clic en dicho campo o arrastre y suelte el campo en la zona de almacenamiento.
Añadir una expresión
Para añadir una expresión, haga clic en el botón "Expresión" de la estación flotante.
Editar una expresión
Haga clic en la descripción de la expresión para abrir la ventana de propiedades correspondiente.
Modificar las propiedades de una viñeta
Haga clic en los iconos para modificar el valor de las propiedades. Una visualización borrosa indica un valor negativo (por ejemplo, no ordenado).
![]()
Significación de los iconos de izquierda a derecha: visible, orden, acumulación, entrada de rangos.
Suprimir una viñeta
Haga clic en la cruz superior derecha de la viñeta.
Desplazar una viñeta
Haga clic en la parte superior de la viñeta, arrástrela y suéltela donde sea necesario. Los desplazamientos solo se pueden realizar en un mismo nivel.
Crear un nivel de ruptura (grupo)
Haga clic en la parte superior de la viñeta y arrástrela para mostrar las opciones disponibles. Arrástrela hasta "Crear un grupo" para llevarla a la cabecera de un nuevo grupo.
Desplazar una viñeta a un nivel de ruptura existente
Haga clic en la parte superior de la viñeta y arrástrela para mostrar las opciones disponibles. Seleccione "Grupo N", donde N es el nivel del grupo, para llevarla al final del nivel elegido.
Requisitos previos
Consulta la documentación de Puesta en marcha
Gestión de pantalla
Cabecera
Esta sección muestra los datos que permiten identificar la consulta y los parámetros generales.
Código (campo COD) |
Este código permite identificar una consulta. |
Descripción (campo INTIT) |
Permite definir una descripción asociada a cada ficha. |
Descrip. corta (campo INTITSHO) |
Este título, que proporciona una descripción para la ficha, se utiliza en algunas pantallas o informes cuando no hay espacio suficiente para la descripción larga. |
Pestaña Campos
Utilice esta sección para definir y agrupar los datos que se van a editar con un editor visual.
A partir del conjunto de datos definidos en el editor, el peticionario determina una consulta en las tablas vinculadas con condiciones de unión. Por lo tanto, en los casos simples, no es necesario completar las secciones siguientes.
Bloque Número 1
Activo (campo ENAFLG) |
Marca esta casilla para activar el registro en curso. Los registros no seleccionados conservan su contenido y parametrización, pero no se pueden utilizar mediante otra llamada a su código en:
Las habilitaciones en una función determinada pueden prohibir la creación de un registro activo. En ese caso, la casilla se desactiva por defecto. Solo se puede modificar por un usuario autorizado o mediante un Workflow de firma. |
Bloque Número 2
campo CLBFL |
Pestaña Avanzado
Bloque Número 1
N.º líneas (campo NBRLIG) |
Permite definir un número lógico de líneas por página en la pantalla de consulta generada en el peticionario. Si este número de líneas supera el número de líneas que se pueden mostrar físicamente, aparece una barra de desplazamiento a la derecha de la tabla. Los botones situados en la parte superior de la pantalla permitirán navegar entre las pantallas lógicas (visualizar la siguiente, anterior, última, primera). |
Máximo líneas (campo MAXLIG) |
El número máximo de líneas corresponde a un parámetro de la consulta (maxrows) que detiene la búsqueda una vez que se encuentra un número de líneas en la base correspondiente a las condiciones (estas líneas se ordenan, pero la base no garantiza que las N líneas encontradas sean las N primeras en el criterio de orden). Es una optimización que permite limitar la carga de la base de datos. |
N.º columnas fijas (campo NBRCOL) |
Permite fijar las x primeras columnas de una tabla en caso de paginación horizontal. |
Tiempo máximo (campo MAXTIM) |
Utilice este campo para detener la búsqueda después del periodo de tiempo indicado (en segundos). Permite evitar una larga espera en la parametrización de una nueva consulta, por ejemplo. Nota: Al contrario que el número máximo de líneas, esta información no se transmite a la base de datos. Por lo tanto, el tiempo máximo no se puede superar si la duración de la consulta es demasiado elevada. |
Informe (campo RPT) |
Define el código de un informe que se asociará a la función Ficha/Lista a partir de la visualización de las consultas. Si no se indica, se utiliza el informe ALISTE, que propone una composición por defecto. Este informe genérico se puede duplicar (en principio, modificando únicamente la composición) para crear informes perfectamente adaptados a la consulta definida. El código de informe introducido se puede asociar a un conjunto de códigos de impresión mediante la función dedicada. |
Tabla Selecciones
Criterios de selección (campo SEL) |
Permite introducir criterios de selección, que son expresiones lógicas con campos de tablas, que pueden incluir constantes, funciones y operadores. Solo se extraerán las líneas de las tablas que cumplan con estas condiciones. El editor de fórmulas permite simplificar la escritura de estas expresiones. |
Tabla Vínculos
Expresión de vínculo (campo LNK) |
Utilice este campo para definir los vínculos que no están definidos en el diccionario o que deben considerarse de forma prioritaria. La estructura del vínculo debe corresponder a la clave del fichero que se va a vincular. Debe haber tantos campos separados por punto y coma como partes de clave. La sintaxis exacta es la siguiente: [F:ABV1]CLE=expresión1 ; expresión2..., donde:
Desde el punto de vista de la base de datos, esta sintaxis define uniones externas izquierdas. Una segunda sintaxis permite definir uniones estrictas (lo que puede resultar interesante en el plan de rendimientos). Se añade una virgulilla (~) a la sintaxis, obteniendo: [F:ABV1]CLE=expresión1 ; expresión2... |
Pestaña Acceso
Utilice esta sección para definir las condiciones de acceso a la consulta y a los datos extraídos.
Tipo de petición (campo ALLUSR) |
Utilice este campo para gestionar la visualización de una petición en modo consulta:
|
Grupo (campo GRP) |
Utilice este campo para crear una clasificación de los criterios disponibles para las consultas. |
Cód. de acceso (campo ACS) |
Este código de acceso permite prohibir el acceso a la ficha en curso a ciertos usuarios. Si el campo se alimenta, solo los usuarios con derechos de lectura en este código de acceso pueden visualizar el registro y solo los usuarios con derechos de escritura pueden modificarlo. El derecho de ejecución controla quién puede ejecutar la consulta (actualizándola o modificando los parámetros y ejecutándola de nuevo). |
Objeto (campo OBJLNK) |
Permite determinar los filtros de habilitación aplicados a la creación de la consulta. Estos filtros son por planta, rol y código acceso. Los principios de filtrado son:
Esto, por supuesto, supone que la tabla en la que se realizan los filtros forma parte de la consulta generada. Es decir, la tabla en la que se encuentran los campos Código acceso, Código planta y, si es necesario, el campo definido por los roles asignados al usuario. No es necesariamente la tabla principal de la consulta. Una consulta sobre líneas de documentos se puede filtrar, por ejemplo, en función de las autorizaciones asociadas a los campos de las tablas vinculadas a la cabecera del documento. Aviso: Estos filtros solo se aplican en el cálculo, nunca en la consulta. Esto puede tener implicaciones cuando la consulta es compartida, por ejemplo, o cuando los filtros por planta de un usuario han cambiado entre el cálculo de la consulta y la visualización. |
Función (campo FCTLNK) |
Utilice este campo para vincular las autorizaciones de acceso a la consulta a las autorizaciones proporcionadas en la función. El principio es el siguiente: al entrar en la consulta, se comprueba que la función vinculada está autorizada para el usuario (para al menos una planta, si la habilitación de esta función se realiza por planta). Esta comprobación solo se realiza si la consulta no es compartida. Si lo es, las habilitaciones de la persona que ha calculado la consulta se aplican y propagan a todos los que tienen derechos de consulta. Por lo tanto, hay que definir cuidadosamente las habilitaciones a las consultas compartidas que contienen datos sensibles. Para ello, utilice el código de acceso situado en esta sección. |
Pestaña Gráfico
Bloque Número 1
Representación (campo REPGRA) |
Este indicador define cómo se representan los datos en la pantalla. Las opciones son:
|
campo OPTGRA |
Utilice este campo para organizar la relación entre el carácter y el gráfico, cuando el modo de representación de datos permite ambos. Según el contexto:
|
Bloque Número 3
campo IMAG |
Imagen que detalla los datos introducidos anteriormente. |
Gráfico
Tipo (campo TYPGRA) |
Este campo se utiliza cuando hay más de un valor numérico en la tabla que se puede representar en forma de gráfico. Este campo puede mostrar dos valores:
|
Representación (campo FSHGRA) |
Cuando hay varias series representadas en el gráfico (y la presentación de todas ellas es idéntica y no por "sector"), puede indicar cómo se van a combinar los valores de las series:
|
Gráfico por defecto (campo DEFGRA) |
Este campo define la representación gráfica aplicada a los datos mostrados (Barras, Líneas, Áreas, Sectores). En función de la elección, aparece una imagen que muestra el tipo de presentación obtenida. Si solo hay una serie de valores disponibles, este parámetro fija la representación gráfica por defecto. Si hay varias series de valores disponibles, se pueden combinar los modos de presentación (una serie en barras y otra en líneas, por ejemplo). En este caso, la representación de cada serie de valores depende del campo Representación de la tabla de campos:
Si la representación de las series es homogénea (solo hay una serie en el gráfico), hay un selector disponible para el tipo de gráfico que permite seleccionar otro modo de presentación. |
Bloque Número 4