AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / Editores / Editor de reportes / Crear un reporte mediante programación
  • Presentación
  • Creando un informe con parámetros
  • Presentación
  • Ejemplo
  • Imprimir un informe con parámetros
  • Ejemplo
  • Consejo
WINDEV
WindowsLinuxJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac Catalyst
Otros
Procedimientos almacenados
Presentación
Al imprimir un informe, tiene la posibilidad de pasar parámetros a este informe. El informe se llama "Informe con parámetros".
Por ejemplo, su informe corresponde a un mailing enviado a todos los clientes. El texto del mailshot se introduce en un control antes de ejecutar este informe. Este texto corresponde a un parámetro esperado por el informe.
Informe con parámetros
Creando un informe con parámetros

Presentación

La creación de un informe con parámetros se realiza en varios pasos:
  1. Crear un reporte.
  2. Modificación de este informe para apoyar los parámetros:
    • Recuperar parámetros en el evento "Apertura" del reporte con la siguiente sintaxis:
      PROCEDURE <ReportName>(<NameParam1>, <NameParam2>= "<DefaultValueParam2>", ...
      ...
      <NameParamN> = "<DefaultValueParamN>")

      Recordatorio: Algunos parámetros pasados a un procedimiento pueden ser opcionales. Al declarar el procedimiento, los parámetros opcionales deben describirse en última posición (a la derecha), con un valor por defecto precedido del signo "=". Para obtener más información, consulte Parámetros de un procedimiento.
    • Utilización de estos parámetros en los controles del informe.
  3. Modificar (si es necesario) la aplicación para especificar los distintos parámetros.
  4. Imprimir el informe pasando parámetros. Para obtener más información, consulte Imprimir un informe con parámetros.

Ejemplo

El programa necesario para crear un informe con parámetros se ilustra en el siguiente ejemplo:
  • "RPT_ParamReport" corresponde a un mailing enviado a los clientes.
  • Este informe espera el texto del mailing introducido en "EDT_MailingText" como parámetro.
Implementación:
  1. Crear el informe "RPT_ParamRpt":
    • Haga clic en nuevo en los botones de acceso rápido.
    • Aparece la ventana para crear un nuevo elemento: haga clic en "Informe" y luego en "Informe".
    • Se inicia el asistente de creación de informes.
    • En el asistente, seleccione "Mailshot" y valide.
      Este informe está vinculado al archivo de datos "Cliente" de su análisis. Para más detalles sobre cómo crear informes, véase Reportes.
  2. Personaliza este informe.
  3. Escriba el siguiente código en el evento "Open" de "RPT_ParamReport":
    // Retrieve the parameter passed to the report and
    // pass a default parameter for the report test
    PROCEDURE RPT_ParamReport(sText = "Default value")
  4. En el Cuerpo de este informe, añada el control estático "STC_MailingText" utilizado para mostrar el texto del mailing.
  5. Escriba el siguiente código en el evento "Antes de imprimir" de "STC_MailingText":
    // Retrieve the mailing text
    STC_MailingText = sText
  6. En una ventana de aplicación, añada:
    • el control Campo de entrada "EDT_MailingText" que permite al usuario escribir el texto del mailing.
    • el botón "BTN_Print" utilizado para imprimir el informe.
Imprimir un informe con parámetros
Para imprimir un informe con parámetros, debe:
  1. Establezca el destino de impresión de los reportes con iDestination (visor de reportes, impresión en un archivo HTML, etc.).
  2. Especifique los siguientes parámetros con iPrintReport:
    • el nombre del informe a imprimir.
    • los parámetros.
Observaciones:
  • Si el informe se basa en una vista HFSQL, el nombre de esta vista HFSQL debe especificarse en iPrintReport, antes de los parámetros. Para obtener más información, consulte Informe basado en una vista HFSQL.
  • Si el informe se basa en una zona de memoria, el nombre de esta zona de memoria debe especificarse en iPrintReport, antes de los parámetros. Para obtener más información, consulte Informe basado en un área de memoria.
  • Si el informe está acotado, los valores máximo y mínimo de los límites deben especificarse en iPrintReport, antes de los parámetros. Para obtener más información, consulte Informe limitado.

Ejemplo

"RPT_ParamReport" corresponde a un mailing enviado a los clientes. Este informe espera el texto del mailing introducido en "EDT_MailingText" como parámetro.
"RPT_ParamReport" se imprime cuando se pulsa "BTN_Print".
En este ejemplo, el código de clic de "BTN_Print" es el siguiente:
// Open report viewer
iDestination(iViewer)
// Print the report with parameters
iPrintReport(RPT_ParamReport, EDT_MailingText)
Consejo
Para ejecutar la prueba de un informe con parámetros desde el editor de informes, se debe dar un valor por defecto a los parámetros en la declaración de parámetros.
Por ejemplo, para probar el informe del ejemplo anterior, introduzca el siguiente código en el evento "Apertura" del informe "RPT_ParamReport":
// Retrieve the parameter passed to the report and
// pass a default parameter for the report test
PROCEDURE RPT_ParamReport(sText = "Default value")
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 22/01/2025

Señalar un error o enviar una sugerencia | Ayuda local