Cómo funciona el asistente de listados

Para iniciar el asistente de listados desde cualquier ventana de la aplicación, los pasos que se deben seguir son los siguientes:

1. Abra cualquier mantenimiento.
2. Seleccione el botón Imprimir de la barra de herramientas.
3. En la ventana que se visualiza a continuación, se muestran todos los listados asociados al mantenimiento actual, con su correspondiente descripción. Si junto a la descripción del listado se muestra un icono de un candado cerrado, significa que no es modificable por el asistente de listados.
4. Pulse el botón Añadir para abrir el asistente de listados y crear un listado nuevo asociado al mantenimiento actual.
5. Pulse el botón Editar si desea modificar el listado seleccionado por medio del asistente de listados.

Para imprimir el listado activo en pantalla debe pulsar el botón Imprimir situado en la barra de herramientas de la parte superior del asistente de listados.

Debe tener en cuenta que para poder imprimir un listado es necesario que se haya grabado con anterioridad. Por ello, es posible que al seleccionar su impresión se muestre un mensaje indicando que se debe guardar el listado antes de imprimirlo.

Una vez se ha guardado el listado, se abre la ventana correspondiente al diálogo de impresión de listados. Ver Cómo funciona el diálogo de impresión.

Si desea borrar la definición de un listado, debe seguir los siguientes pasos:

1. Pulse el botón Borrar el registro actual en la barra de herramientas de la parte superior del asistente de listados.

1. Pulse el botón Guardar las modificaciones en la barra de herramientas de la parte superior del asistente de listados.
2. Si el listado es nuevo, se solicita el nombre que se desea dar al listado.

El asistente de listados permite realizar un guardar como... de un listado para posteriormente poder hacer cambios sin modificar el listado original. Éste es un buen método para realizar pruebas de listados sin perder los cambios del listado origen.

Para guardar el listado con otro nombre y conseguir una copia del listado activo, los pasos que se deben seguir son los siguientes:

1. Pulse el botón Guardar como que aparece en la barra de herramientas de la parte superior del asistente.
2. Antes de guardar el listado indique el nombre que se desea dar a la copia del listado activo.

Los pasos que se deben seguir son los siguientes:

1. Pulse el botón Añadir campo que aparece en el mismo grupo, situado debajo de la parrilla.
2. Seleccione el campo y haga doble clic sobre el campo deseado y pulse el botón Aceptar.

Los pasos que se deben seguir son los siguientes:

1. Sitúe el cursor sobre el campo que desee modificar (la línea correspondiente al campo del grupo Campos del listado).
2. Indique los nuevos valores del campo. Estos valores se configuran en el grupo Detalles del campo, situado al lado del grupo Campos del listado.

Los pasos que se deben seguir son los siguientes:

1. Seleccione el campo que desea borrar en el grupo Campos del listado.
2. Pulse el botón Borrar que aparece en el mismo grupo, situado debajo de la parrilla.

En la ventana del asistente de listados, los campos que incluye el listado cuando se imprime se muestran dentro de una parrilla en el grupo Campos del listado en la pestaña General.

En la lista de campos se puede observar la siguiente información:

• Campo. Nombre del campo que forma parte de la columna indicada.
• Sección. Agrupación del objeto principal de la que forma parte el campo seleccionado.
• Etiqueta del campo. Texto que se mostrará en la cabecera del listado, identificando el dato que aparecerá impreso en la columna.
• Ver. Indica si se mostrará el valor del campo, su descripción o ambos.
• Tipo de datos. Tipo de datos del campo seleccionado (por ejemplo, Texto, Numérico, Fecha, Moneda, etc.).
• Tamaño. Ancho, en cantidad caracteres, que ocupa el campo al imprimirse. En caso de haber indicado en Ver el Valor y Descripción, se muestra la suma de los dos tamaños.
• Repetir. Indicador de si se desea que se repita el valor de un campo en cada línea del listado aunque tenga el mismo valor que en la línea anterior. Si no se repite, solamente aparece el valor al inicio de cada página, o bien cuando cambia.
• Operación. En los campos de tipo numérico, operación matemática que se desea realizar con los diferentes valores del campo (por ejemplo, totalizar, calcular un promedio, etc.).
• Debajo del anterior. Indica si se desea ver el dato debajo del dato anterior, en la misma columna. Marcando la casilla se generarán listados de varias líneas por cada detalle. Esta funcionalidad sólo está disponible si todos los campos del listado son de la misma sección o si el listado está aplanado.

El asistente de listados permite determinar ciertas propiedades situadas en la parte fija del formulario.

Utilizando el campo Descripción puede introducir una breve descripción del listado que está utilizando.

También es posible, mediante el campo Título, indicar un texto que se visualizará en la cabecera del listado y que servirá para identificarlo.

Aparte se pueden utilizar las siguientes casillas de la pestaña Opciones, en el grupo de Preferencias:

• Fecha en cabecera. Marque esta casilla para añadir la fecha de impresión en el listado. La fecha se mostrará en la parte superior derecha de cada página del listado.
• Hora en cabecera. Marque esta casilla para mostrar la hora en la cabecera del listado.
• Número de página. Marque esta casilla para indicar si se deben mostrar los números de página en el listado.
• Repetir etiquetas. Marque esta casilla para volver a imprimir la etiqueta de cada columna cuando se realice una página nueva para el listado.
• Aplanar operaciones. Marque esta casilla para mostrar todas las operaciones en una misma línea, en lugar de en líneas separadas.
• Sólo operaciones. Marque esta casilla para que el listado resultante muestre sólo las operaciones, obviando el resto de líneas.
• Expandir operaciones. En caso de disponer de agrupaciones en el listado, esta opción mostrará las operaciones parciales en cada nivel de agrupación.
• Expandir agrupaciones. En caso de disponer de varios campos de agrupación, esta opción permite agrupar por cada campo independientemente. Es especialmente útil cuando se selecciona la opción Expandir operaciones y se desea obtener valores parciales de cada operación por cada valor de los campos de agrupación.
• Línea en blanco. Mostrar una línea en blanco adicional entre cada registro.
• Operaciones nativas. Utilizar funciones nativas (de MS Excel y de Open Office Calc) para las operaciones del listado.

El asistente de listados ofrece una serie de opciones generales que se pueden configurar antes de la impresión. Para modificarlas los pasos que se deben seguir son los siguientes:

1. Acceda a la pestaña Opciones, y desde el grupo de Listados o de Diseño.
2. Modifique las opciones que desee.

Las opciones disponibles son las siguientes:

• Líneas pautadas. Seleccionando esta opción, el color de fondo de las líneas del listado se va alternando para simular el papel pautado. Así se facilita la visualización de los datos impresos.
• Aplanar listado. Utilizando esta opción, todos los campos se sitúan en la misma sección del listado, es decir, se sitúan en la misma línea. Esta funcionalidad es útil cuando se utilizan listados con columnas asociadas a controles de varios paneles. De este modo, al realizar restricciones en el listado por algún control de un panel que no es cabecera, ésta se aplica a todas las líneas del listado. Los listados que utilizan tablas enlazadas deben estar aplanados.
• Usar moneda en fórmulas. Al calcular las fórmulas utilizar tipos de datos monetarios para campos de tipo moneda. Tratar fórmulas con tipos de dato moneda (Divisa/Currency) como BigDecimal.
• Ajustar etiquetas. Activando esta opción, al añadir una columna, si la etiqueta no cabe completa en el tamaño definido por el campo de la columna, se acorta para ajustarla al tamaño del campo.
• Fuente. Para la selección de la fuente por defecto.

En la mayoría de los casos, interesa ordenar el listado por uno o más campos. Para añadir campos de clasificación se han de seguir los siguientes pasos:

1. Sitúe el cursor sobre el campo por el cual desea ordenar de los Campos del listado.
2. Pulse el botón Campo de clasificación para incluir el campo seleccionado como campo de clasificación.
   • El campo indicado pasa automáticamente a formar parte de los campos de clasificación, situados en el grupo Campos de clasificación en la pestaña Orden.
3. En caso de que desee eliminar un campo de clasificación, márquelo y pulse el botón Borrar, desde el grupo Campos de clasificación en la pestaña Orden.

Por defecto, cuando se crea una clasificación, el sentido de ordenación que se aplica es ascendente empezando por el primer campo añadido a la clasificación. Puede modificar esta ordenación marcando el campo de clasificación deseado y utilizando los botones para cambiar el orden de las clasificaciones.

El asistente permite agrupar las líneas del listado por los diferentes valores de un campo. Las agrupaciones permiten que las operaciones (totales, contadores, etc.) del listado se apliquen a los campos de agrupación seleccionados (roturas). La forma de incluir un campo como campo de agrupación es la siguiente:

1. Sitúe el cursor sobre el campo por el cual desea ordenar de los Campos del listado.
2. Pulse el botón Campo de agrupación para incluir el campo seleccionado como campo de agrupación.
   • El campo indicado pasará automáticamente a formar parte de los campos de agrupación, situado en el grupo Campos de agrupación en la pestaña Orden.
3. Si desea eliminar un campo de agrupación, márquelo y pulse el botón Borrar, desde el grupo Campos de agrupación en la pestaña Orden.

Por defecto, cuando se crea una agrupación, el sentido de ordenación que se aplica es ascendente por el campo seleccionado, pero es posible modificar esta ordenación marcando el campo de agrupación deseado y utilizando los botones para cambiar el orden de las agrupaciones.

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:

1. Sitúe el cursor sobre el campo que desee de los Campos del listado.
2. 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:

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

Y para conocer más sobre fórmulas consulte Cómo funciona el motor de fórmulas.

En el caso de una fórmula es posible indicar el tipo de datos del valor de salida facilitando la personalización del dato de salida usando el diálogo de Formato de campo. ver Para personalizar el formato del campo.

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:

1. 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.
2. Seleccione la fuente y el tamaño deseado.
3. 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 pd_orders, 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.

Pasos que se deben seguir

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:

1. 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.
2. Pulse Añadir campo y en el diálogo de Añadir campo seleccione el nodo Pedidos y Cabecera de pedidos.
3. 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.
4. En selección de tablas busque por el literal clientes y seleccione la tabla pd_customer.
5. 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.
6. Pulse el botón Aceptar y la tabla Clientes se habrá añadido al listado como una tabla enlazada.
7. Expanda el nodo Cabecera de pedidos.
8. Expanda el nodo Tablas enlazadas y se mostrará la tabla que se acaba de enlazar.
9. Expanda el nodo Clientes que identifica la tabla enlazada y se mostrará la lista de campos de la tabla que es posible enlazar.
10. Haga doble clic en el campo Teléfono (Clientes) para añadir este campo.
11. 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:

1. Pulse el botón Imprimir y aparecerá el Diálogo de impresión.
2. 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.

1. En primer lugar accedemos al mantenimiento de clientes, formulario de detalle del cliente deseado.
2. Al pulsar el icono de Imprimir de la barra de tareas accedemos al Diálogo de selección de listados. Con el botón de Añadir se accede al Asistente de listados.
3. Informamos las propiedades básicas del listado:
   • El nombre del listado, kw_lstcustomer, y la descripción y su título, Listado de clientes y Clientes.
   • Añadimos campos al listado, por ejemplo, Empresa, Cliente, Nombre y el campo de usuario VIP.
     • En el campo Cliente ajustamos su tamaño a 40 caracteres para que no ocupe demasiado espacio.
     • En el campo VIP, se revisa el formato. Desde el Formato de campo indicamos como dato booleano la máscara No/Si.
   • Como campos de clasificación  indicamos Empresa y Cliente.
4. Y por fin salvamos el listado y con Aceptar regresamos al formulario de detalle.

De nuevo pulsamos Imprimir y desde el Diálogo de selección de listados marcamos el nuevo listado Listado de clientes y con Imprimir todos accedemos al Diálogo de impresión de listados.

Podemos elegir como dispositivo Pantalla y formato Portable Document Format (.pdf), y pulsando el botón Imprimir pasamos a la impresión del listado.

1. En primer lugar accedemos al mantenimiento de clientes, formulario de detalle del cliente deseado.
2. Al pulsar el icono de Imprimir de la barra de tareas accedemos al Diálogo de selección de listados. Seleccionando el listado Listado de clientes con el botón de Editar se accede de nuevo al Asistente de listados en modo edición del listado seleccionado.
3. Informamos las propiedades básicas del listado:
   • • Añadimos más campos, por ejemplo Dirección, Población y País. Los añadimos a continuación de nuestro campo de usuario VIP. En los dos últimos indicar la opción Debajo del anterior.
       • Ajustar el tamaño máximo a un valor razonable, por ejemplo 24.
     • En opciones añadimos Fecha en cabecera, Hora en cabecera y Número de página. Desmarcamos la opción Líneas pautadas.
     • Y por qué no, vamos a añadir un campo de una tabla externa:
       • Se plantea el objetivo de que en lugar del código de la empresa aparezca su nombre, información contenida en la tabla pd_company.
       • En el diálogo Añadir campo, en el nodo Tablas enlazadas, seleccionamos la acción Añadir tabla enlazada con el botón derecho del ratón.
       • En Añadir tabla enlazada, seleccione la tabla pd_company; es decir Empresas.
       • En tipo de enlace Control, indique el Campo de enlace Empresa. Se enlaza automáticamente con el campo xcompany_id, identificador de la empresa de Empresas.
       • Al regresar con Aceptar al diálogo de añadir campo, en el nodo de Tablas enlazadas y Empresas ya puede seleccionar el campo Nombre (Empresas). Entre paréntesis le indica que el campo procede de una tabla enlazada. Con Aceptar regresamos al diálogo principal del asistente.
       • Para finalizar sitúe el nuevo campo en la primera posición del listado y ajuste su tamaño a 32; además puede cambiar su etiqueta a Empresa.
4. Y por fin salvamos el listado y con Aceptar regresamos al formulario de detalle.

De nuevo pulsamos Imprimir y desde el Diálogo de selección de listados marcamos el nuevo listado Listado de clientes y con Imprimir todos accedemos al Diálogo de impresión de listados.

Podemos elegir como dispositivo Pantalla y formato Portable Document Format (.pdf), y pulsando el botón Imprimir pasamos a la impresión del listado.