Parametrización > Utilización > Informes > 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.
    ../FCT/GESALT_01_01.jpg
  • Ampliar/reducir la tabla mediante el icono situado a la izquierda de la cruz.
    ../FCT/GESALT_01_01.jpg  ../FCT/GESALT_01_02.jpg
  • Desplazar la tabla mediante la barra de descripciones o la barra inferior.
  • Redimensionar la tabla mediante la esquina inferior derecha.
    ../FCT/GESALT_01_03.jpg
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.

../FCT/GESALT_01_04.jpg

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).
../FCT/GESALT_02_02.jpg  ../FCT/GESALT_02_03.jpg
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.
../FCT/GESALT_02_01.jpg

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.
../FCT/GESALT_02_01.jpg

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

SEEREFERTTO Consulta la documentación de Puesta en marcha

Gestión de pantalla

Cabecera

Presentación

Esta sección muestra los datos que permiten identificar la consulta y los parámetros generales.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

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.

Cerrar

 

Pestaña Campos

Presentación

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.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

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:

  • otros registros como los documentos y parámetros
  • los procesos en masa

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

 

Cerrar

 

Pestaña Avanzado

Campos

Los campos siguientes están presentes en esta pestaña :

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.

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:

*    [F:ABV1]CLE es la clave de la tabla vinculada. Haga clic en el icono Acciones para acceder a la función Tablas, que propone la lista de todas las tablas presentes en la primera sección. Al seleccionar una de las tablas, se visualiza el primer índice de la tabla. Para utilizar otro índice, acceda a Selección de un índice desde el icono Acciones, que propone realizar una selección en la lista todos los índices de la tabla seleccionada anteriormente.

*    expresión1, expresión2 son las expresiones que permiten proporcionar valores a los distintos campos de la clave definida anteriormente (si la clave solo tiene una parte, solo hay una expresión; de lo contrario, las expresiones aparecen separadas por punto y coma). También puede utilizar la función Campos, que permite completar los distintos valores de la clave con los campos de una de las tablas utilizadas. Una vez seleccionada la clave, que muestra el número de puntos y comas que definen la parte de la clave que hay que introducir, esta función permite completar sucesivamente las partes que faltan. Hay que tener en cuenta que se pueden definir partes de claves constantes.

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...

Cerrar

 

Pestaña Acceso

Presentación

Utilice esta sección para definir las condiciones de acceso a la consulta y a los datos extraídos.

Cerrar

 

Campos

Los campos siguientes están presentes en esta pestaña :

  • Tipo de petición (campo ALLUSR)

Utilice este campo para gestionar la visualización de una petición en modo consulta:

  • Normal - El resultado de la petición se muestra si el usuario ya la ha consultado. Cada uno de los usuarios que lanza la petición crea un conjunto de datos propio que los demás no pueden visualizar.
  • Compartida - El resultado de una petición ejecutada por un usuario lo pueden consultar otros usuarios. El interés de las peticiones compartidas es que una petición de gran tamaño, lanzada por un usuario en un momento determinado, permite a un conjunto de usuarios disponer posteriormente de una información común. Para este tipo de peticiones, se recomienda que un único usuario ejecute la petición y que los demás solo tengan acceso en consulta. Asimismo, si la petición es particularmente grande, es preferible calcularla en modo batch. El código de la tarea batch correspondiente es CALALH.
  • Recalculada - El resultado de la petición nunca se muestra automáticamente. Hay que hacer clic en el botón de actualización o introducir los criterios. El interés de este tipo de petición es evitar recargar datos que sabemos que se van a quedar obsoletos rápidamente.
  • Grupo (campo GRP)

Utilice este campo para crear una clasificación de los criterios disponibles para las consultas.

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).

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:

  • El código de objeto permite definir los campos de código de acceso y de código de planta a los que se va a aplicar un filtro.
  • Este filtro se realiza en función de las plantas autorizadas y de los derechos de acceso relativos a la gestión del objeto otorgados al usuario que ejecuta la consulta.
  • De la misma forma, también se aplica el filtro a los roles definidos por el código de objeto.

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.

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.

Cerrar

 

Pestaña Gráfico

Campos

Los campos siguientes están presentes en esta pestaña :

Bloque Número 1

  • Representación (campo REPGRA)

Este indicador define cómo se representan los datos en la pantalla. Las opciones son:

  • Carácter -  Los datos solo se presentan en forma de tabla.
  • Car. o Gráf. - Los datos se presentan en uno de los dos modos. El campo Consulta por defecto, definido en los parámetros gráficos de la ficha, determina el modo por defecto.
  • Car. y Gráf. - Los datos se presentan en ambos modos de forma simultánea. La posición del gráfico con respecto a la tabla se determina mediante el campo Posición de la sección Gráfico.
  • Carácter -  Los datos solo se presentan en forma de gráfico.
  • 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:

  • Si la representación es Car. o Gráf., se aplica el valor por defecto a la representación.
  • Si la representación es Car. y Gráf., la posición del gráfico depende de la tabla de datos.

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:

  • Gráfico simple - Solo se puede mostrar una columna de valores de forma simultánea (hay un selector disponible).
  • Multigráfico - Se muestran todas las columnas, combinadas según el valor del parámetro Representación.
  • 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:

  • La opción Multi permite presentar los valores de cada serie uno al lado del otro (un color por serie)
  • La opción Acumulativos permite presentar los valores en forma vertical.
  • La opción Comparativos permite presentar los valores en forma de comparación relativa (la altura del gráfico es constante).
  • 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:

  • Con Barras o Líneas, el modo de representación se aplica a las series de valores compatibles con la representación gráfica por defecto (los sectores no se pueden combinar con las barras o las líneas).
  • Con el modo Por defecto, se aplica la representación gráfica por defecto a las series.

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

Cerrar

 

Botones específicos

Los campos siguientes están en la ventana abierta por el botón :

Bloque Número 1

  • campo OBJET

 

  • campo CLES

 

Bloque Número 2

  • Desde el dossier (campo DOSORG)

Indica el dossier desde el que se va a copiar la ficha. Las posibles sintaxis se describen en el anexo dedicado.

  • Todos los dossieres (campo TOUDOS)

Esta opción permite copiar la ficha en todos los dossieres definidos en el diccionario (tabla ADOSSIER de la solución en curso).

  • Hacia el dossier (campo DOSDES)

Indica el dossier en el que se va a copiar la ficha. Las posibles sintaxis se describen en el anexo dedicado.

Cerrar

Mensajes de error

Además de los mensajes genéricos, los mensajes siguientes de error pueden aparecer durante la captura :

Demasiados criterios de clasificación

Demasiados rangos

Demasiados acumulados

Se han superado los límites de la consulta. El número de criterios de clasificación está limitado a 8 y el número de rangos y acumulados a 10.

Tabla no definida

Se ha proporcionado una fórmula de cálculo en una expresión que incluye campos de una tabla que no está en línea.

xxx: Tabla inexistente

yyy: Campo inexistente

La tabla o el campo no existen en el diccionario.

Índice erróneo

Un campo está indexado con un valor que supera la dimensión del campo.

Vínculos imposibles

No se han podido establecer los vínculos entre las tablas a partir del diccionario. Hay un error en la consulta o hay que indicar detalladamente los vínculos en la sección Avanzado.

Este campo ya ha sido seleccionado

Se ha intentado añadir un campo a los campos seleccionados, pero este ya existe.

Acción desconocida

El componente flash ha devuelto una acción no gestionada por el supervisor.

Vínculos imposibles. Los campos deben ser del mismo tipo

No se pueden vincular campos de tabla de tipos diferentes. Por ejemplo, un campo numérico no se puede vincular a un campo de clave alfanumérico.

Vínculo imposible. Componente de clave ya introducido

Si se ha comenzado a establecer un vínculo con una clave de una tabla, hay que vincular todas las partes de la clave. Este mensaje aparece cuando se intenta vincular un campo que no forma parte de la clave.

Vínculo imposible. Clave existente incompleta

El vínculo no se ha definido en todos los campos de la clave.

Vínculo imposible. Clave inexistente

Se ha intentado vincular un campo que no forma parte de la clave.

Es necesario al menos un campo de tipo texto y de tipo valor para utilizar el gráfico

Cuando el campo "Representación gráfica" está activado, hay que definir uno de los campos seleccionados para los título del gráfico, y al menos otro para el cálculo de los gráficos.

Tipo de dato no gestionado

No se puede utilizar un campo de tipo clob o blob en las expresiones de los campos seleccionados.

Tablas utilizadas

SEEREFERTTO Consulta la documentación de Puesta en marcha