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
  • Creación de una reporte con parámetros
  • Presentación
  • Ejemplo
  • Impresión de un reporte con parámetros
  • Ejemplo
  • Consejo
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
Al imprimir una reporte, tiene la posibilidad de pasar parámetros a esta reporte. La reporte se llama "Reporte con parámetros".
Por ejemplo, su reporte corresponde a un mailshot enviado a todos los clientes. El texto del mailing se introduce en un control antes de ejecutar este reporte. Este texto corresponde a un parámetro esperado por la reporte.
Reporte con parámetros
Creación de una reporte con parámetros

Presentación

La creación de un reporte con parámetros se realiza en varios pasos:
  1. Creación de una reporte.
  2. Modificar esta reporte para soportar 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 de los parámetros pasados a un Procedure pueden ser parámetros opcionales. Al declarar la Procedure, los parámetros opcionales deben describirse en última posición (a la derecha), con un valor Default precedido del signo "=".. Para obtener más información, consulte Parámetros de un procedimiento.
    • Utilizando estos parámetros en los controles reporte.
  3. Modificar (si es necesario) la aplicación para especificar los diferentes parámetros.
  4. Imprimir la reporte al pasar los parámetros. Para obtener más información, consulte Impresión de un reporte con parámetros.

Ejemplo

El programa necesario para crear una reporte con parámetros se ilustra en el siguiente ejemplo:
  • "RPT_ParamReport" corresponde a un mailing enviado a los clientes.
  • Esta reporte espera como parámetro el texto del mailing introducido en "EDT_MailingText".
Implementación:
  1. Crear el "RPT_ParamReport" reporte:
    • Haga clic en nuevo en los botones de acceso rápido.
    • La ventana de creación de nuevos elementos se abre: haga clic en "Reporte", y luego en "Reporte".
    • El asistente de creación de reportes se abre.
    • En la asistente, seleccione "Mailshot" y valide.
      Esta reporte es relacionado al fichero "Cliente" de su análisis. Para más detalles sobre la creación de informes, véase Reportes.
  2. Personaliza esta reporte.
  3. Escriba el siguiente código en la Event "Abrir" 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 bloque Cuerpo de este reporte , agregue el control estático "STC_MailingText" que se usa para mostrar el texto del correo.
  5. Escriba el siguiente código en el "Antes de imprimir" de "STC_MailingText" Event:
    // Retrieve the mailing text
    STC_MailingText = sText
  6. En una ventana de la aplicación, agregue:
    • la control Campo de entrada "EDT_MailingText" que permite al usuario escribir el texto del mailing.
    • el botón "BTN_Print" que permite imprimir la reporte.
Impresión de un reporte con parámetros
Para imprimir una reporte con parámetros, debe:
  1. set el destino de impresión de reporte con iDestination (visor de reporte, impresión en un archivo HTML, etc.).
  2. Especifique los siguientes parámetros con iPrintReport:
    • el nombre de la reporte a imprimir.
    • los parámetros.
Observaciones:
  • Si el reporte 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 Reporte basada en una vista HFSQL.
  • Si la reporte 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 Reporte basada en una zona de memoria.
  • Si la reporte está acotada, 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 reporte encuadernada.

Ejemplo

"RPT_ParamReport" corresponde a un mailing enviado a los clientes. Esta reporte espera como parámetro el texto del mailing introducido en "EDT_MailingText".
"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 vieweriDestination(iViewer)
// Print the report with parameters
iPrintReport(RPT_ParamReport, EDT_MailingText)
Consejo
Para ejecutar la prueba de un reporte con parámetros del editor de reportes, se debe dar un valor Default a los parámetros en la declaración de parámetros.
Por ejemplo, para probar la reporte del ejemplo anterior, introduzca el siguiente código en la "Apertura" de la reporte "RPT_ParamReport" Event:
// 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: 27/05/2023

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