En esta sección: |
Cuando entra a la herramienta Programación básica, las opciones de la pestaña Tarea aparecen predefinidas con la información del procedimiento de informe (FEX) seleccionado. Puede completar las opciones de tarea disponibles, como especificar los valores de parámetros o seleccionar si desea estallar el informe.
La imagen siguiente muestra un ejemplo de una pestaña Tarea predefinida, en la herramienta Programación básica.
Nota: Puede usar parámetros (variables ampersand) a la hora de especificar un valor en el campo Guardar informe como de una programación. Estos parámetros pueden ser variables del sistema, como &YYMD o cualquier otra variable ampersand para la que el Servidor de informes devuelve un valor al ejecutar el procedimiento programado. Para usar el separador de punto de extensión de archivo después de una variable, finalice la variable con el carácter '|'; por ejemplo, &YYMD|.htm. De un modo similar, para usar el carácter de ampersand, coloque el carácter '|' después del ampersand (por ejemplo, Smith&|Jones). Si el valor de un parámetro especificado en una programación no es devuelto por el Servidor de informes al ejecutarse el procedimiento, la programación falla y se produce un error de "No hay ningún informe que distribuir". Si divide (estalla) la tarea programada, también puede usar el símbolo '%BURST' para incluir el valor dividido en el campo Guardar informe como.
Opciones disponibles al seleccionar la pestaña Tarea son:
Seleccione una de las opciones siguientes del cuadro de diálogo Opciones de alerta.
Aviso: Asegúrese de establecer el intervalo de la programación en un periodo de tiempo superior a la duración de la ejecución del procedimiento programado. Cuando el intervalo de la programación es inferior a la duración del procedimiento y se ha seleccionado la opción Retrasar, la programación de la alerta se distribuye (basada en la distribución seleccionada) con más frecuencia de lo esperado. En distribuciones por e-mail, esto puede resultar en distribuciones innecesarias de e-mails, afectando negativamente a los objetivos empresariales u operativos de la distribución de informes de alerta.
Nota: Al programar un procedimiento de gráfico (.fex), con una declaración de PCHOLD que utilice JPEG, GIF, PNG o SVG, si no selecciona un formato en la programación, la salida se distribuirá en formato PNG, a menos que añada la extensión JPEG, GIF o SVG al valor de Guardar como o a un nombre de archivo en una lista de distribución. Opcionalmente, si necesita que la salida se distribuya como un archivo JPEG, GIF o SVG, especifique el formato correspondiente en la programación. Para ello, seleccione la casilla Anular el formato especificado en el procedimiento, como se explica más arriba.
En esta sección: Cómo: Referencia: |
Puede personalizar un informe y controlar su ejecución con parámetros. Al programar un procedimiento de informe (FEX), la sección Parámetros de tarea de programación permite introducir un valor para los parámetros citados en el procedimiento de informe, o añadir un parámetro a la programación creando uno nuevo y especificando su nombre y valor.
Para más información sobre los parámetros, también llamados variables, y cómo usarlos en procedimientos de informe, consulte el tema Cómo personalizar un procedimiento con variables del manual Cómo desarrollar aplicaciones de informe.
Si su procedimiento de servidor contiene procedimientos pre-/pos-, consulte Cómo Utilizar la pestaña Pre-/pos-procedimientos o un informe .
Si el procedimiento programado contiene parámetros cuyos valores deben ser introducidos en tiempo de ejecución, estos aparecerán en la sección parámetros de la herramienta de programación.
Desde la herramienta Programación básica, pulse la pestaña Parámetros de la cinta para abrir el cuadro de diálogo Parámetros de tarea.
Los parámetros pueden tener valores predeterminados, o valores que pueden seleccionarse en una lista estática o dinámica. Para más información sobre cómo seleccionar parámetros en el cuadro de diálogo Parámetros de tareas de programación, consulte los ejemplos incluidos en este capítulo. Para más información sobre cómo definir parámetros, consulte el manual Cómo desarrollar aplicaciones de informe.
A continuación, consideraciones al especificar valores de parámetro para un procedimiento:
Nota:
Como alternativa, puede crear un formulario HTML con una opción de programación, a través de la herramienta Compositor HTML de Developer Studio, para generar la lista dinámica, seleccionable, de valores de parámetros. Para más detalles acerca de cómo añadir el botón Programación a un formulario, consulte Cómo diseñar una interfaz de usuario para una aplicación Web con el Compositor HTML.
ReportCaster muestra las variables globales empleadas en los FILTERS definidos en archivos máster y citados por un procedimiento. Por ejemplo, si un archivo máster contiene
FILENAME=CAR,SUFFIX=FOC VARIABLE NAME=&&COUNTRY1, USAGE=A10, DEFAULT=ENGLAND,$ FILTER FILTER1=COUNTRY EQ '&&COUNTRY1'; $
y el procedimiento que está siendo programado contiene
WHERE FILTER1
ReportCaster muestra COUNTRY1 en la ventana Parámetros.
Puede especificar los valores de parámetro predeterminados mediante los comandos -DEFAULT y -DEFAULTH, o dentro de la declaración WHERE. No se solicitarán los valores predeterminados especificados con el comando -DEFAULTH. Para más información sobre el aviso de parámetros, consulte el tema Aviso automático de ampersands, en el manual Cómo desarrollar aplicaciones de informes WebFOCUS.
El procedimiento siguiente establece el valor predeterminado NY para el parámetro STATE (2-3 letras para los estados de EE UU). Para más información sobre cómo crear y especificar valores para los parámetros, consulte el manual Cómo desarrollar aplicaciones de informe WebFOCUS.
-DEFAULT &STATE=NYTABLE FILE GGSALES SUM DOLLARS UNITS BY ST BY CATEGORY BY PRODUCT ON TABLE SUBHEAD "Product Sales Report" WHERE ST EQ '&STATE.2-3 letters for US State.' END
Los parámetros que tienen valores predeterminados definidos en el procedimiento de informe (FEX) aparecen listados en la pestaña Parámetros, con el valor predeterminado en la columna Valor. Cuando los parámetros se encuentran almacenados en una programación, ReportCaster añade un -SET para el parámetro al procedimiento de programación enviado al Servidor de informes, para que lo ejecute. Los comandos -SET anulan los valores predeterminados especificados en un comando -
La imagen siguiente muestra el cuadro de diálogo Parámetros de tarea con el parámetro STATE, que presenta un valor predeterminado. El parámetro STATE tiene un valor de Sí en la columna Usar valores predeterminados de la tabla Parámetros de tarea. El parámetro STATE aparece indicado en la sección Propiedades de parámetro, mostrando el valor predeterminado, NY en el campo Valor.
Para utilizar un valor distinto al predeterminado a la hora de ejecutar la programación, para que sea utilizado incluso cuando el procedimiento haya cambiado, pulse el parámetro y cambie su valor en la sección Propiedades de parámetro. Los valores de parámetros simples se especifican introduciendo un valor para el parámetro en el campo Valor. También existen tipos de parámetros estáticos y dinámicos que permiten seleccionar valores individuales o múltiples, explicados en los ejemplos siguientes.
Cuando los parámetros se encuentran almacenados en una programación, ReportCaster añade un -SET para el parámetro al procedimiento de programación enviado al Servidor de informes, para que lo ejecute. Los comandos -SET anulan los valores predeterminados especificados en un comando -DEFAULT.
El procedimiento siguiente proporciona una lista de valores estáticos, válidos para el parámetro CATEGORY (Categoría).
-DEFAULT &STATE=NY
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE CATEGORY EQ '&CATEGORY.(Coffee,Food,Gifts).Category.'
END La imagen siguiente muestra el parámetro CATEGORY (Categoría) seleccionado en la tabla Parámetros de tarea. El parámetro CATEGORY tiene un valor predeterminado de Coffee. La columna Usar predeterminado de Parámetro de tarea está en blanco con respecto a CATEGORY, mientras que el campo Valor de la sección Propiedades de parámetro está en blanco con respecto a STATE.
Para proporcionar un valor para un parámetro de selección simple, seleccione el parámetro de la tabla Parámetros de tarea y seleccione el control de lista situado al final del campo Valor, en la sección Propiedades de parámetro. Desde la lista de valores, seleccione un valor para asignar al parámetro. Solo puede seleccionar un valor para un parámetro estático de selección simple.
El valor seleccionado aparece en el campo Valor y en la columna Valor. La imagen siguiente muestra que el valor Food está seleccionado.
El procedimiento siguiente proporciona una lista de selección simple con valores válidos para el campo PRODUCT (nombre de producto). La lista se alimenta dinámicamente con valores del origen de datos GGSALES.
-DEFAULT &STATE=NY;
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE PRODUCT EQ '&PRODUCT.(FIND PRODUCT IN GGSALES).Product Name.'END La imagen siguiente muestra el parámetro PRODUCT (Nombre de producto) seleccionado en la tabla Parámetros de tarea. El parámetro PRODUCT no tiene un valor predeterminado especificado, así que la columna Usar valores predeterminados de Parámetro de tarea y el campo Valor predeterminado de la sección Propiedades de parámetro están en blanco.
Para introducir un valor, pulse el parámetro PRODUCT (Nombre de producto) de la tabla, y cambie el valor del parámetro en la sección Propiedades de parámetro. Seleccione el control de lista situado al final del campo Valor para listar los valores especificados del parámetro. Solo puede seleccionar un valor de la lista dinámica de selección simple.
Seleccione el valor que se va a utilizar. El valor seleccionado aparece en el campo Valor y en la columna Valor. La imagen siguiente muestra que el valor Latte está seleccionado.
El procedimiento siguiente proporciona una lista estática de selección múltiple de valores válidos para el campo CATEGORY (Categoría).
-DEFAULT &STATE=NY
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE CATEGORY EQ '&CATEGORY.(OR(Coffee,Food,Gifts)).Category.'END La imagen siguiente muestra el parámetro CATEGORY seleccionado en la tabla Parámetros de tarea.
Para introducir valores, pulse el parámetro CATEGORY (Categoría) de la tabla y a continuación, el botón Valor de la sección Propiedades de parámetro, para abrir el cuadro de diálogo de selección Valor de parámetro. Puede seleccionar más de un valor de la lista, como se muestra en la imagen siguiente.
Una vez seleccionados los valores de la lista, pulse Aceptar. Los valores seleccionados aparecen en el campo Valor de la sección Propiedades de parámetro, y en la columna Valor de la tabla de parámetros. La siguiente imagen indica que los valores Alimentos y Café están seleccionados.
El procedimiento siguiente proporciona una lista dinámica de selección múltiple con valores válidos para el campo PRODUCT (nombre de producto). La lista se alimenta dinámicamente con valores del origen de datos GGSALES.
-DEFAULT &STATE=NY;
TABLE FILE GGSALES
SUM DOLLARS UNITS
BY ST
BY CATEGORY
BY PRODUCT
ON TABLE SUBHEAD
"Product Sales Report"
WHERE ST EQ '&STATE.2-3 letters for US State.'
WHERE PRODUCT EQ '&PRODUCT.(OR(FIND PRODUCT IN GGSALES)).Product Name.'END La imagen siguiente muestra el parámetro PRODUCT seleccionado en la tabla Parámetros de tarea.
Para introducir valores, pulse el parámetro PRODUCT de la tabla y a continuación, el botón Valor de la sección Propiedades de parámetro, para abrir el cuadro de diálogo de selección Valor de parámetro. Puede seleccionar uno o varios valores de la lista, como se indica en la imagen, o seleccionar la casilla Ninguna selección, si no desea realizar ninguna prueba de selección de datos.
Una vez seleccionados los valores de la lista, pulse Aceptar. Los valores seleccionados aparecen en el campo Valor de la sección Propiedades de parámetro, y en la columna Valor de la tabla de parámetros.
Es importante comprobar que los parámetros borrados al programar un procedimiento de informe (FEX) se manipulen del modo siguiente, para que el trabajo programado se ejecute correctamente:
Para borrar un parámetro y que no quede almacenado con la información de la programación, resáltelo en la tabla de parámetros, y pulse el botón Borrar.
Si necesita que el trabajo de programación envíe un parámetro y un valor no definidos en el procedimiento de informe que se está programando, puede crear un parámetro nuevo en el cuadro de diálogo Parámetros de tarea. Debe asignarse un valor a los parámetros citados por el servidor de informes durante el procesamiento, para que el trabajo se ejecute correctamente. El informe de registro del trabajo de programación contiene información cuando no están incluidos los valores de parámetro obligatorios.
Para crear parámetros para una tarea, siga estos pasos:
Se abre el cuadro de diálogo Parámetro de tarea, como se muestra a continuación.
Los cuadros Nombre y Valor se rellenan en la tabla Parámetros del cuadro de diálogo Parámetros de tarea.
Siga las pautas mostradas a continuación para seleccionar un formato:
Cómo: |
Si está programando un procedimiento de servidor de o un procedimiento de informe (FEX), puede programar un máximo de dos procedimientos de pre- y posprocesamiento. Los procedimientos programados de pre- y posprocesamiento deben residir en el servidor de informes.
Nota: Se pasan todas las variables internas de ReportCaster, que empiezan por &DST, a los procedimientos de pre- y posprocesamiento para que estén disponibles en la lógica específica de las aplicaciones. Para más información, consulte Variables de ReportCaster.
Puede introducir el nombre del procedimiento (FEX) con o sin la ruta de la aplicación. Cuando la ruta de aplicación no aparece especificada, se emplea la ruta de búsqueda predeterminada del servidor de informes para localizar el procedimiento determinado.
Puede asignar uno o varios valores de parámetro mediante la pareja nombre y valor; las parejas múltiples deben estar separadas por comas:
procedurename name=value, name=value
No tiene por qué introducir las parejas en el orden en que aparecen en el procedimiento. Para más información acerca de cómo proporcionar valores de parámetros para un procedimiento, consulte el tema Cómo proporcionar valores de variables de otro procedimiento del manual Cómo desarrollar aplicaciones de informe.
| WebFOCUS |