Asistente de listados

El asistente de listados le permite crear listados basados en los datos de la aplicación. Los listados que se pueden configurar tienen un formato basado en registros con los datos en columnas.

Funciones básicas

Después de pulsar el botón Imprimir de la barra de herramientas del formulario de detalle, se visualiza un formulario en el que se muestran todos los listados asociados al formulario de detalle, con su correspondiente descripción.

Mediante el botón Añadir del asistente de listados puede crear nuevos listados con el asistente a partir de los objetos de negocio a los que corresponden los formularios.

En la pestaña General puede definir las columnas del listado asociadas a los campos que desea utilizar. Sólo puede utilizar campos de dos paneles del objeto de negocio.

En la pestaña Orden puede crear agrupaciones y clasificaciones que permitirán ordenar los diferentes registros.

En la pestaña Opciones puede definir las propiedades situadas en la parte fija del listado (fecha y hora en la cabecera, número de página, repetición de etiquetas, etc.).

Mediante el botón Editar del asistente de listados puede modificar los listados que se ofrecen. Si, junto a la descripción de un listado, se visualiza un icono de un candado cerrado, no lo puede modificar.

Mediante el botón Por defecto del asistente de listados, puede seleccionar un listado para su uso mediante el botón de impresión directa de la barra de herramientas del formulario.

También mediante los botones correspondientes del asistente de listados, puede imprimir el listado actual o todos los listados disponibles.

El asistente de listados permite personalizar el formato de salida del campo. Dependiendo de su tipo de datos se puede utilizar un formato u otro.

Para poder personalizar el campo debe proceder del siguiente modo:

• Sitúe el cursor sobre el campo que desee de los Campos del listado.
• Pulse el botón Formato. Al activar esta opción se abre una ventana en la que puede personalizar el formato de salida.

Dependiendo del tipo de datos del campo es posible configurar distintas opciones. Las cuatro posibilidades se resumen a continuación.

Si el tipo de datos es booleano:

• Formato booleano. Indica el formato de la máscara a utilizar. Por ejemplo Apagado/Encendido. Considerando el separador "/" en caso de verdadero muestra el elemento de la derecha y en caso de falso muestra el elemento de la izquierda.

Si el tipo de datos es numérico:

• Decimales. Indica el número de decimales.
• Separador de miles. Mostrar los datos numéricos con el separador de miles.
• No mostrar si el valor es cero.

Si el tipo de datos es fecha:

• Formato de fecha. Permite seleccionar de entre varias la máscara de fecha de salida.

Si el tipo de datos es texto:

• Formato del texto. Permite seleccionar si se desea el texto en mayúsculas o minúsculas.

El asistente de listados permite insertar campos de tipo fórmula. Estos campos poseen un código asociado cuyo resultado es el valor que se muestra en el documento impreso para ese campo.

Para poder insertar un campo de tipo fórmula debe proceder del siguiente modo:

• Pulse el botón Añadir fórmula que aparece en el mismo grupo, situado debajo de la parrilla. Al activar esta opción se abre una ventana en la que puede definir la fórmula.
• Una vez insertada la fórmula en el listado puede editarla seleccionándola en la lista Campos del listado y utilizando el botón Editar fórmula que aparece en el marco Detalles del campo.

La ventana Editor de fórmulas permite definir de manera asistida fórmulas del listado. Para ello, se dispone de la lista de campos y funciones que es posible utilizar en la fórmula, así como la posibilidad de añadir constantes.

Al definir la fórmula es conveniente definir su tipo de datos devuelto; pudiendo ser Número entero, Número con decimales, Texto, Moneda o Fecha.

En caso de fórmula también es posible indicar una operación asociada; asociada a fórmula numérica: Total, Máximo, Mínimo, Promedio, Contador y Repetir fórmula. La operación Repetir fórmula sólo se soporta en columnas de tipo fórmula. Este tipo de operación permite repetir el cálculo de la fórmula en la línea de totales utilizando los valores de la línea de totales como parámetros de la fórmula.

La fuente por defecto del asistente de listados es Arial y su tamaño ocho puntos. Para poder cambiar la fuente del listado activo debe proceder del siguiente modo:

• Pulse el botón Fuente de la pestaña Opciones en el grupo de Diseño. Al activar esta opción se abre una ventana en la que puede seleccionar la fuente que desea utilizar.
• Seleccione la fuente y el tamaño deseado.
• Pulse el botón Aceptar.

Esta funcionalidad permite relacionar una tabla de la base de datos a la que el usuario tenga acceso con el objeto de negocio del listado. Esta relación consiste en indicar la clave primaria de la tabla enlazada con constates y/o controles de panel del objeto de negocio del listado. De esta manera, a cada registro del objeto de negocio le corresponde un registro de la tabla enlazada. Una vez enlazada una tabla, sus campos se pueden incluir en el listado como si de campos del objeto de negocio se trataran.

Por ejemplo el teléfono del cliente no está en el objeto de negocio de pedidos, podemos enlazar una tabla de la base datos para obtener el teléfono del cliente.

Esta funcionalidad es de uso exclusivo en listados y está disponible únicamente desde el Asistente de listados.

Como ejemplo sencillo de enlace de tabla, vamos a confeccionar un nuevo listado de pedidos igual que el listado ksk_lstorders_wz pero añadiendo el teléfono del cliente.

Desde el formulario de detalle del mantenimiento de pedidos seleccione Imprimir.

• Desde Selección de listados, seleccione el listado ksk_lstorders_wz y pulse el botón Editar para acceder al Asistente de listados.

En el Asistente de listados:

• Actualice la descripción y el título, y con Guardar como guarde un nuevo listado; p.ej. un nuevo listado de nombre ksk_lstorders_wz2.
• Pulse Añadir campo y en el diálogo de Añadir campo seleccione el nodo Pedidos y Cabecera de pedidos.
• Sobre el nodo de Tablas enlazadas, y con el botón derecho de ratón, seleccione Añadir tabla enlazada para acceder al diálogo de Añadir tabla enlazada.
• En selección de tablas busque por el literal clientes y seleccione la tabla pd_customer.
• A continuación debe indicar la relación entre la clave primaria de la tabla seleccionada y los controles del objeto de negocio del listado. Relacione Empresa con Empresa y Cliente con Código del cliente que realiza en pedido.
• Pulse el botón Aceptar y la tabla Clientes se habrá añadido al listado como una tabla enlazada.
• Expanda el nodo Cabecera de pedidos.
• Expanda el nodo Tablas enlazadas y se mostrará la tabla que se acaba de enlazar. Expanda el nodo Clientes que identifica la tabla enlazada y se mostrará la lista de campos de la tabla que es posible enlazar.
• Haga doble clic en el campo Teléfono (Clientes) para añadir este campo.
• Pulse el botón Aceptar y acto seguido guarde la nueva versión del listado.

De nuevo, desde el formulario de detalle de los pedidos:

• Pulse el botón Imprimir y aparecerá el Diálogo de impresión.
• Seleccione el nuevo listado e imprímalo. Pruebe el listado y verifique que se muestra el teléfono de los clientes que tienen este dato indicado.

Limitaciones

El uso de tablas enlazadas presenta algunas limitaciones:

• No se permiten agrupaciones sobre campos enlazados.
• De una tabla enlazada no puede añadir un campo enlazado de tipo imagen.
• De una tabla enlazada no puede añadir un campo enlazado con un nivel alto de seguridad de datos de carácter personal.
• En caso de que hayan clasificaciones o selecciones sobre campos enlazados en ejecución se necesitan crear tablas temporales, por lo tanto el usuario de la base de datos del usuario de conexión o proxy para el acceso a los datos de usuario debe tener permisos para ello.