In this section: How to: |
The Task option allows you to specify a task type, which will determine what the schedule will run or do to obtain the report that is to be distributed. For WebFOCUS procedures (FEXs), you can indicate whether or not to burst the report. In the Advanced Scheduling tool, you can set multiple tasks for the Email and Printer distribution methods. For more information, see About Tasks in the Basic Scheduling Tool.
The following task types are available:
The following image shows the Task tab in the Advanced Scheduling tool when you click the New drop-down list.
To create a Task, select one of the options. For more information, see Task Types.
In this section: |
This section describes the different Task types.
The options available when you select the WebFOCUS Server Procedure Task type are shown in the following image.
The Task dialog box for a WebFOCUS Server Procedure displays three tabs.
Note: When creating a task for a WebFOCUS Server Procedure using a procedure that contains .SVG, .GIF, .PNG, or .JPG formats, all formats are distributed in .PNG format, by default. You must override the format to distribute a file in .SVG, .GIF, or .JPG format.
The functionality within the Advanced Scheduling tool Task Parameters tab is the same as the Basic Scheduling tool Parameters option that displays in the Task Parameters dialog box. For more information about creating new parameters or specifying parameter values for a simple, static list, or a dynamic list parameter that allows single or multiple values, see Specifying Parameter Values.
For more information about creating a new parameter, see Creating a New Parameter. For more information about deleting a parameter, see Deleting a Parameter.
The following terms and definitions apply to the WebFOCUS Server Procedure Task type:
If the Execution ID field is not grayed out and you will be using an ID that you previously used for a Task on the selected server, you can select the ID (for example, rcadmin) from the drop-down list.
If the Execution ID is not grayed out and you will be using a new ID, you can type the new ID and click Set Password. The Password Editor opens. Type a password for the ID in the Password field and retype it in the Confirm password field, then click OK.
To change the password for an existing Execution ID, click Change password. The Password Editor opens, where you can type a new password and click OK.
Note: The Execution ID is added to the ReportCaster Repository and is viewable in the ReportCaster Console.
For Report Properties, indicate if you want to burst the report (FEX) output. Optionally, select the Override the Format Specified in the Procedure check box to override the format specified in the procedure with a selection from the drop-down list. The following image shows the Task dialog box for a WebFOCUS Server Procedure task.
You can also use parameters when populating certain fields in this dialog box, as shown in the following image.
Note: You can use parameters (amper variables) when specifying a value in the Save Report As field of a schedule. These parameters can be system variables, such as &YYMD or any amper variable for which a value is returned by the Reporting Server when the scheduled procedure is executed. To use the dot file extension separator after a variable, terminate the variable with the '|' character, for example, &YYMD|.htm. Similarly, to use the ampersand character itself, follow the ampersand with the '|' character (for example, Smith&|Jones). If a value for a parameter specified in a schedule is not returned by the Reporting Server when the procedure executes, the schedule will fail with a "No report to distribute" error. If the scheduled task is burst, you can also use the '%BURST' symbol to include the burst value in the Save Report As field.
The options available when you select the WebFOCUS Report Task type are shown in the following image.
The Task dialog box for a WebFOCUS Repository Report displays three tabs.
Note: When creating a task for a WebFOCUS Repository Report using a procedure that contains .SVG, .GIF, .PNG, or .JPG formats, all formats are distributed in .PNG format, by default. You must override the format to distribute a file in .SVG, .GIF, or .JPG format.
The functionality within the Advanced Scheduling tool Task Parameters tab is the same as the Basic Scheduling tool Parameters option that displays in the Task Parameters dialog box. For more information about creating new parameters or specifying parameter values for a simple, static list, or a dynamic list parameter that allows single or multiple values, see Specifying Parameter Values.
For more information about creating a new parameter, see Creating a New Parameter. For more information about deleting a parameter, see Deleting a Parameter.
The following terms and definitions apply to the WebFOCUS Report Task type:
If the Execution ID field is not grayed out and you will be using an ID that you previously used for a Task on the selected server, you can select the ID (for example, rcadmin) from the drop-down list.
If the Execution ID is not grayed out and you will be using a new ID, you can type the new ID and click Set Password. The Password Editor opens. Type a password for the ID in the Password field and retype it in the Confirm password field, then click OK.
To change the password for an existing Execution ID, click Change password. The Password Editor opens, where you can type a new password and click OK.
Note: The Execution ID is added to the ReportCaster Repository and is viewable in the ReportCaster Console.
For Report Properties, indicate if you want to burst the report (FEX) output. Optionally, select the Override the Format Specified in the Procedure check box to override the format specified in the procedure with a selection from the drop-down list. The following image shows the Task dialog box for a WebFOCUS Repository Report task.
You can also use parameters when populating certain fields in this dialog box, as shown in the following image.
Note: You can use parameters (amper variables) when specifying a value in the Save Report As field of a schedule. These parameters can be system variables, such as &YYMD or any amper variable for which a value is returned by the Reporting Server when the scheduled procedure is executed. To use the dot file extension separator after a variable, terminate the variable with the '|' character, for example, &YYMD|.htm. Similarly, to use the ampersand character itself, follow the ampersand with the '|' character (for example, Smith&|Jones). If a value for a parameter specified in a schedule is not returned by the Reporting Server when the procedure executes, the schedule will fail with a "No report to distribute" error. If the scheduled task is burst, you can also use the '%BURST' symbol to include the burst value in the Save Report As field.
The options available when you select the File Task type are shown in the following image.
The following terms and definitions apply to the File Task type:
Note: If a schedule has multiple tasks and one of the tasks fails, then the file will not be deleted. This is applicable even when the file is successfully distributed.
The options available when you select the FTP Task type are shown in the following image.
The following terms and definitions apply to the FTP Task type:
Note: If this check box is not selected, you can optionally select the check box in the scheduling tool at schedule creation time.
The options available when you select the URL Task type are shown in the following image.
The following terms and definitions apply to the URL Task type:
Note: You can also specify parameter names and associated values using the following format:
www.address.com?¶meter1_name=parameter1_value¶meter2_name= parameter2_value
The maximum length of the field is 1200 characters.
How to: |
When working with an established schedule, you can disable one or more tasks within that schedule. You can also create a new schedule with multiple tasks and then disable one or more of those tasks, as needed. For more information, see How to Create a Schedule in the Advanced Scheduling Tool.
Note: This procedure applies to schedules that have multiple tasks. If you disable all tasks in a schedule, the schedule is disabled.
WebFOCUS |