Report Designer

Crear informes personalizados de la OT

157 views 25 January, 2017 25 February, 2019 Valuekeep 0

Valuekeep permite la creación y personalización de informes de las entidades, a través de la herramienta de Report Designer. En esta sección se muestra cómo personalizar un informe operativo de la OT. Estos artículos describen el proceso para crear y personalizar un informe:

  1. ¿Cómo crear un nuevo informe basado en el informe operativo de la OT?
  2. ¿Cómo añadir un campo a la fuente de datos del informe operativo de la OT?
  3. ¿Cómo añadir detalles a la fuente de datos del informe operativo de la OT?
  4. ¿Cómo añadir un campo al informe operativo de la OT?
  5. ¿Cómo añadir campos de las rutas al informe operativo de la OT?
  6. ¿Cómo traducir el informe operativo de la OT?
  7. ¿Cómo acceder a la vista previa de las modificaciones al informe operativo de la OT?
  8. Ejemplo 1 – Añadir campos de la OT y del Activo al informe operativo de la OT.
  9. Ejemplo 2 – Añadir el detalle de los registros de mano de obra al informe operativo de la OT.
  10. Ejemplo 3 – Añadir adjuntos de tipo imagen al informe

La documentación de DevExpress permite saber más sobre Report Designer y cómo usar las opciones de la herramienta. Nota: debido a la evolución a nuevas versiones del productor de esta herramienta y a las personalizaciones, algunos de los elementos descritos en la documentación pueden no corresponder a los que están disponibles en Valuekeep. Report Designer: https://documentation.devexpress.com/#XtraReports/CustomDocument17545

Vista previa: https://documentation.devexpress.com/#XtraReports/CustomDocument17554

¿Cómo crear un nuevo informe basado en el informe operativo de la OT?

El informe operativo de la OT puede personalizarse. Para ello, debe utilizarse la herramienta Report Designer. Para personalizar el informe operativo de la OT:

  1. Acceder a la opción “Carga de Registro de Entidades”;
  2. Filtrar la lista por la entidad “Work Order” en el filtro rápido (columna Descripción);
  3. Editar el registro correspondiente a la entidad “Work Order”;
  4. En la tabla “Definiciones del Informe”, hacer clic en el enlace “Editar” del informe operativo;
  5. En la ventana para duplicar el informe, introducir el nuevo nombre y la descripción y hacer clic en “Guardar”;
  6. Editar el informe y, en el menú de opciones de Report Designer, seleccionar “Guardar”.
El nuevo informe puede definirse por defecto en la tabla “Definiciones del Informe”.

¿Cómo añadir un campo a la fuente de datos del informe operativo de la OT?

Además de los campos ya incluidos en el informe, pueden añadirse otros campos de la OT o de entidades relacionadas. Los campos para seleccionar están disponibles en la fuente de datos del informe. Para añadir campos a la fuente de datos del informe operativo de la OT deben seguirse los siguientes pasos:

  1. En el menú de Report Designer, seleccionar “Editar Fuente de Datos”, para abrir el asistente de edición de la fuente de datos;
  2. Hacer clic en el botón a la derecha de la entidad “WorkOrders” y seleccionar “Configurar”;
  3. Hacer clic en el nombre de la entidad en la que se desea añadir el campo y seleccionar los campos que se desean añadir a la fuente de datos;
  4. Al terminar de añadir los campos, hacer clic en “OK” y después en “Guardar”.
Guardar el informe antes de editar la fuente de datos, para evitar perder las modificaciones efectuadas. Si el campo corresponde a una entidad asociada que aún no forme parte de la fuente de datos del informe, esta surgirá al final de la lista y debe seleccionarse al menos uno de sus campos.
Para eliminar campos de la fuente de datos, seguir los mismos pasos y eliminar la selección de los campos que se desean eliminar.

¿Cómo añadir detalles a la fuente de datos del informe operativo de la OT?

Pueden añadirse detalles de la OT al informe, con una relación “master/detail”. Algunos ejemplos ya disponibles en el informe base son el detalle de los planes y de las tareas. Para añadir detalles al informe operativo de la OT deben seguirse los siguientes pasos:

  1. En el menú de Report Designer, seleccionar “Editar Fuente de Datos”, para abrir el asistente de edición de la fuente de datos;
  2. Hacer clic en el botón a la derecha de la entidad “WorkOrders” y seleccionar “Añadir tabla de detalle”;
  3. Buscar la entidad deseada y hacer clic en “Añadir”;
  4. La entidad detalle se añade al final de la lista de entidades. Hacer clic en el menú a la derecha y seleccionar “Configurar”;
  5. Definir la conexión entre la entidad principal y el detalle”;
  6. Seleccionar los campos que se desean ver disponibles en el informe, en la lista de columnas. Hacer clic en “OK” y después en “Guardar”;

Se crea una banda en el informe para el detalle, con dos bandas: encabezado y detalle. Los campos o información sobre todos los registros del detalle deben introducirse en la banda de encabezado. Los campos o información sobre cada registro del detalle deben introducirse en la banda de detalle.

Guardar el informe antes de editar la fuente de datos, para evitar perder las modificaciones efectuadas.
Para eliminar detalles de la fuente de datos, seguir los mismos pasos y seleccionar “Eliminar esto”.

¿Cómo añadir un campo al informe operativo de la OT?

Pueden añadirse otros campos de la OT, de entidades relacionadas o detalles al informe operativo. Los campos para seleccionar son los que están disponibles en la fuente de datos del informe. Para añadir campos al informe operativo de la OT deben seguirse los siguientes pasos:

  1. En Report Designer, seleccionar la pestaña “Campos” a la derecha de la pantalla;
  2. Expandir la fuente de datos “WorkOrders” y después la tabla “WorkOrder”;
  3. Navegar hasta la entidad relacionada deseada y arrastrar el campo hasta la superficie del informe;
  4. Definir el tamaño y la posición del campo;
  5. Si se desea añadir una etiqueta al campo, arrastrar un control de tipo “XRLabel” de la barra de herramientas a la izquierda de la pantalla. Colocar la etiqueta al lado del campo;
  6. Para definir el texto de la etiqueta, hacer clic dos veces en la misma, o definir el texto en las propiedades (pestaña a la derecha de la pantalla).
Los campos de la OT y de entidades relacionadas deben añadirse dentro de la banda “Detail”. Los de entidades detalle deben añadirse dentro de la banda de detalle correspondiente.
La fuente de datos del informe es la tabla “WorkOrders”, por lo que se deben siempre añadir campos que se encuentren dentro de esta tabla en el explorador de campos.
En la pestaña de propiedades pueden definirse diversas opciones de formato del campo, como el tipo de letra, color, límites o tamaño de la letra.

¿Cómo añadir campos de las rutas al informe operativo de la OT?

Para añadir campos de las rutas al informe operativo de la OT deben seguirse los siguientes pasos:

  1. Seleccionar “Editar Fuente de Datos” en el menú de Report Designer;
  2. Seleccionar configurar en el menú de las tablas de detalle “AssetRouteCompositions” o “LocationRouteCompositions”;
  3. Seleccionar los campos que se desean añadir;
  4. Hacer clic en OK y después en Guardar;
  5. Arrastrar los nuevos campos del explorador de campos al informe;
  6. Acceder a la vista previa y guardar los cambios.

¿Cómo traducir el informe operativo de la OT?

Pueden definirse las etiquetas del texto en diversos idiomas. Para ello, deberán usarse los textos definidos en el producto, por ejemplo los valores usados en la vista de la entidad. La lógica de generación de la clave de recursos del texto de un campo de la entidad es la siguiente: RES_LBL_<Entidad>_<Campo>_Description

Ejemplo: Campo fecha de la OT RES_LBL_WorkOrder_Date_Description Para definir etiquetas en diversos idiomas en el informe operativo de la OT deben seguirse los siguientes pasos:

  1. Seleccionar el informe (en el Explorador de Informe a la derecha o haciendo clic en la superficie de dibujo, fuera de los márgenes del informe);
  2. Seleccionar la pestaña “Propiedades” a la derecha de la pantalla;
  3. Expandir la opción “Datos” y en el campo “Tag” introducir este valor:
    1. Primavera.MaintenanceManagementCore.Resources.Resources, Primavera.MaintenanceManagementCore.Resources, Version=1.0.0.0, Culture=neutral, PublicKeyToken=33086db60a481256
  4. Seleccionar una etiqueta;
  5. Seleccionar la pestaña “Propiedades” a la derecha de la pantalla;
  6. Expandir la opción “Datos” y en el campo “Tag” introducir la clave de recursos del texto;
  7. Repetir el proceso para las demás etiquetas del informe.
Para validar las traducciones, imprimir el informe con un usuario en el idioma deseado.

¿Cómo acceder a la vista previa de las modificaciones al informe operativo de la OT?

Para validar las modificaciones al informe, puede accederse a la vista previa durante el proceso de edición. Para ello, deben seguirse los siguientes pasos:

  1. En el menú superior de Report Designer, seleccionar la opción “Vista previa”;
  2. Navegar por el informe a través de las opciones del menú superior;
  3. Para volver a la edición, hacer clic en “Design”.
Para aumentar el rendimiento y la rapidez al crear los informes, la vista previa muestra un máximo de 50 registros.

Ejemplo 1 – Añadir campos de la OT y del Activo al informe operativo de la OT.

Este ejemplo completo muestra cómo crear un nuevo informe y cómo añadir campos de la entidad OT y de entidades relacionadas: Crear nuevo informe

  1. En la opción de Carga de Registros de Entidades, editar el informe operativo de la OT;
  2. Definir el nombre y la descripción del nuevo informe. Hacer clic en “Guardar”.

Definir la fuente de datos

  1. En el menú, hacer clic en “Editar Fuente de Datos”;
  2. En el menú de la entidad “WorkOrders”, seleccionar “Configurar”;
  3. Hacer clic en “WorkOrders” para expandir la lista de columnas;
  4. Seleccionar la columna “Created By”;
  5. Volver a hacer clic en “WorkOrders” para cerrar la lista de columnas;
  6. Hacer clic en “Assets” para expandir la lista de columnas;
  7. Seleccionar la columna “IsUptime”;
  8. Volver a hacer clic en “Assets” para cerrar la lista de columnas;
  9. Hacer clic en “OK” y después en “Guardar”;
  10. En el menú de Report Designer, hacer clic en “Guardar”.

Añadir campos

  1. En las pestañas a la derecha de la pantalla, seleccionar “Campos”;
  2. Expandir la fuente de datos “WorkOrders” y después la tabla “WorkOrders”;
  3. Arrastrar el campo “Created By” a la banda “Detail”. Introducir, por ejemplo, al lado del estado de la OT;
  4. Expandir la tabla “Assets_AssetId” por debajo de la tabla “WorkOrders”;
  5. Arrastrar el campo “IsUptime” a la banda “AssetData”. Introducir, por ejemplo, al lado de la importancia;
  6. Con el campo “IsUptime” seleccionado en el informe, hacer clic en la pestaña “Propiedades” a la derecha de la pantalla e introducir el valor “¿Disponible?” en la propiedad Texto;
  7. En el menú superior, hacer clic en “Vista previa” para validar los cambios;
  8. En el menú de Report Designer, hacer clic en “Guardar”.

Ejemplo 2 – Añadir el detalle de los registros de mano de obra al informe operativo de la OT.

Este ejemplo completo muestra cómo crear un nuevo informe y cómo añadir el detalle de los registros de mano de obra (fecha y clave del documento): Crear nuevo informe

  1. En la opción de Carga de Registros de Entidades, editar el informe operativo de la OT;
  2. Definir el nombre y la descripción del informe; Hacer clic en “Guardar”.

Definir la fuente de datos

  1. En el menú, hacer clic en “Editar Fuente de Datos”;
  2. En el menú de la entidad “WorkOrders”, seleccionar “Configurar”;
  3. Hacer clic en “WorkOrders” para expandir la lista de columnas;
  4. Eliminar la selección de la columna “Failure”;
  5. Hacer clic en “OK”;
  6. Hacer clic en el botón a la derecha de las entidades “WorkOrderPlans” y “FailureTypifications” y seleccionar “Eliminar esto”;
  7. Hacer clic en “Guardar”.
  8. En el menú de Report Designer, hacer clic en “Guardar”.

Eliminar detalles

  1. Seleccionar la pestaña del explorador del informe a la derecha de la pantalla;
  2. Expandir el informe y seleccionar la banda “MaintenanceManagementCore.FailureTypifications”;
  3. Eliminar esta banda;
  4. Seleccionar la banda “MaintenanceManagementCore.WorkOrderPlans”;
  5. Eliminar esta banda;
  6. En el menú de Report Designer, hacer clic en “Guardar”.

Añadir detalle

  1. En el menú, hacer clic en “Editar Fuente de Datos”;
  2. En el menú de la entidad “WorkOrders”, seleccionar “Añadir tabla de detalle”;
  3. Seleccionar la tabla “WorkOrderReportLabors” y hacer clic en “Añadir”;
  4. En el menú de la entidad “WorkOrderReportLabors”, seleccionar “Configurar”;
  5. En el enlace seleccionar la columna “Id” en la entidad WorkOrders y “WorkOrder” en la entidad WorkOrderReportLabors;
  6. Hacer clic en la entidad WorkOrderReportLabors para expandir la lista de columnas;
  7. Seleccionar las columnas “ReportDate” y “SequenceKey”;
  8. Hacer clic en “OK” y después en “Guardar”;
  9. En el menú de Report Designer, hacer clic en “Guardar”.

Añadir campos

  1. En las pestañas a la derecha de la pantalla, seleccionar “Campos”;
  2. Expandir la fuente de datos “WorkOrders” y después la tabla “WorkOrders”;
  3. Expandir la tabla “WorkOrderReportLabors”;
  4. Arrastrar los campos “ReportDate” y “SequenceKey” a la nueva banda “Detail1”;
  5. Arrastrar los controles “XRLabel” del menú a la izquierda, colocar al lado de los campos y modificar el texto para identificar correctamente los campos;
  6. En el menú superior, hacer clic en “Vista previa” para validar los cambios;
  7. En el menú de Report Designer, hacer clic en “Guardar”.

Ejemplo 3 – Añadir adjuntos de tipo imagen al informe

En los archivos adjuntos de la OT puede definir si un archivo de tipo JPEG o PNG está disponible para la impresión. Estas imágenes pueden añadirse al informe personalizado siguiendo estos pasos:

  1. Editar el origen de datos del mapa;
  2. Añadir una tabla de detalle a la tabla Workorders;
  3. Seleccionar la tabla EntityImageAttachments;
  4. Configurar la conexión de la tabla, seleccionando el campo de Id de la tabla Workorders y el campo de EntityId de la tabla EntityImageAttachments;
  5. Seleccionar algunos campos de la tabla EntityImageAttachments, incluido el campo de Buffer;
  6. Confirmar;
  7. Añadir un control de imagen en banda de detalle creada y configurar la conexión de datos para utilizar el campo de Buffer;
  8. Guardar el mapa
Para asegurarse que el mapa se imprime sin problemas de rendimiento o errores, le recomendamos que utilice un máximo de 20 imágenes para cada mapa.

¿Fue útil?