Task Management

Task Overview

Normally, a task can be a set of operations you perform on JReport Enterprise Server to achieve a goal, such as deploying a folder, deleting a resource, viewing resource properties, and so on. However, tasks that JReport Enterprise Server really cares and manages are those associated with report-running issues, say, the report-running tasks.

JReport Enterprise Server allows you to quick view a report result (Run), view a report result using selected options and parameters (AdvancedRun), and schedule a report to run unattended at a specific time or periodically (Schedule), which are the fundamental modes that JReport Enterprise Server performs report-running tasks.

You can track down the status of the report-running tasks, such as the scheduled tasks that are waiting to be performed by JReport Enterprise Server, the tasks that are currently being performed, and the tasks that have already been performed.

JReport Enterprise Server collects the task information and manages it in a set of tables, which includes:

Tasks that are scheduled:

Scheduled table
Shows the status information of the scheduled tasks that are waiting to be performed, such as the task ID, whether the task is enabled, previous running time, next running time, and so on.

Active table
Shows the status information of the tasks that are currently being performed, such as the task ID, time when the task is started, engine status, and so on.

Completed table
Shows the status information of the tasks that have already been performed, such as the task ID, time when the task is completed, whether the task is successfully performed, the result files, error message, and so on.

Tasks that are performed in the Run or AdvancedRun mode:

On-demands table
Shows the status information of the tasks submitted using the Run or AdvancedRun mode, such as the report path and name, time when the task is completed, time elapsed since the task has been performed, time when the task is started, and so on.

Scheduled table

The Scheduled table consists of the following columns:

Column Description

Task ID The internal ID for this task, which is a unique time stamp.

Task Name The name of this task, specified by the user who submits the task.

Catalog The catalog path and name that the report belongs to.

Report The report path and name.

Next Run At The time when this task is to be performed for the next time.

Last Run At The time when this task has been performed for the last time.

Task Type The type of this task, such as Versioning System, File System, E-mail, or Printer.

Is Enabled Shows whether this task is enabled. Can be Enabled or Disabled.

Submitter The user who submits this task.

Launch Type The way in which this task is executed, such as Repeatedly and One Time.

Is Successful Shows whether this task has been successfully performed. The value true (or false) means the task has been performed successfully (or unsuccessfully). If the column is left empty, that means the task has not yet been performed.

Column	Description
Task ID	The internal ID for this task, which is a unique time stamp.
Task Name	The name of this task, specified by the user who submits the task.
Catalog	The catalog path and name that the report belongs to.
Report	The report path and name.
Next Run At	The time when this task is to be performed for the next time.
Last Run At	The time when this task has been performed for the last time.
Task Type	The type of this task, such as Versioning System, File System, E-mail, or Printer.
Is Enabled	Shows whether this task is enabled. Can be Enabled or Disabled.
Submitter	The user who submits this task.
Launch Type	The way in which this task is executed, such as Repeatedly and One Time.
Is Successful	Shows whether this task has been successfully performed. The value true (or false) means the task has been performed successfully (or unsuccessfully). If the column is left empty, that means the task has not yet been performed.

Active table

The Active table consists of the following columns:

Column Description

Task ID The internal ID for this task, which is a unique time stamp.

Started Time The time when this task starts to be performed.

Catalog The catalog path and name that the report belongs to.

Report The report path and name.

Task Type The type of this task, such as Versioning System, File System, E-mail, or Printer.

Engine Status The current status of JReport engine, such as record fetching, grouping, memory paging, engine initializing, and so on.

Is Enabled Shows whether this task is enabled. Can be Enabled or Disabled.

Launch Type The way in which this task is executed, such as Repeatedly, One Time, and Instant.

Submitter The user who submit this task.

Parameters Files Shows the parameter file names and provides links to the parameters.

Parameters Shows the parameters according to the size that has been specified.

Column	Description
Task ID	The internal ID for this task, which is a unique time stamp.
Started Time	The time when this task starts to be performed.
Catalog	The catalog path and name that the report belongs to.
Report	The report path and name.
Task Type	The type of this task, such as Versioning System, File System, E-mail, or Printer.
Engine Status	The current status of JReport engine, such as record fetching, grouping, memory paging, engine initializing, and so on.
Is Enabled	Shows whether this task is enabled. Can be Enabled or Disabled.
Launch Type	The way in which this task is executed, such as Repeatedly, One Time, and Instant.
Submitter	The user who submit this task.
Parameters Files	Shows the parameter file names and provides links to the parameters.
Parameters	Shows the parameters according to the size that has been specified.

Completed table

The Completed table consists of the following columns:

Column Description

Task ID The internal ID for this task, which is a unique time stamp.

Task Name The name of this task, specified by the user who submits the task.

Completed Time The time when this task is completed.

Catalog The catalog path and name that the report belongs to.

Report The report path and name.

Task Type The type of this task, such as Versioning System, File System, E-mail, or Printer.

Is Successful Shows whether this task has been successfully performed. The value true (or false) means the task has been performed successfully (or unsuccessfully). If the column is left empty, that means the task has not yet been performed.

Parameters File Shows the parameter file names and provides links to the parameters.

Parameters Shows the parameters according to the size that has been specified.

Result File(s) Shows the report result files and provides links to the report result files.

Launch Type The way in which this task is executed, such as Repeatedly, One Time, and Instant.

Submitter The user who submit this task.

Error Message Shows the error message when the task fails to perform.

Engine Status The JReport engine status when the task is completed, such as record fetching, grouping, memory paging, engine initializing, and so on. If the task fails to perform, shows the engine status when the error occurs.

Column	Description
Task ID	The internal ID for this task, which is a unique time stamp.
Task Name	The name of this task, specified by the user who submits the task.
Completed Time	The time when this task is completed.
Catalog	The catalog path and name that the report belongs to.
Report	The report path and name.
Task Type	The type of this task, such as Versioning System, File System, E-mail, or Printer.
Is Successful	Shows whether this task has been successfully performed. The value true (or false) means the task has been performed successfully (or unsuccessfully). If the column is left empty, that means the task has not yet been performed.
Parameters File	Shows the parameter file names and provides links to the parameters.
Parameters	Shows the parameters according to the size that has been specified.
Result File(s)	Shows the report result files and provides links to the report result files.
Launch Type	The way in which this task is executed, such as Repeatedly, One Time, and Instant.
Submitter	The user who submit this task.
Error Message	Shows the error message when the task fails to perform.
Engine Status	The JReport engine status when the task is completed, such as record fetching, grouping, memory paging, engine initializing, and so on. If the task fails to perform, shows the engine status when the error occurs.

On-demands table

The On-demands table consists of the following columns:

Column Description

Report The report path and name.

Catalog The path and name of the catalog that the report belongs to.

Completed Time The time when this task is completed.

Time Elapse The elapsed time since the task starts to be performed.

Started Time The time when this task starts to be performed.

Catalog Version Number The version number of the catalog that the report belongs to.

Parameters The parameter of the report.

Report Version Number The version number of the report.

Notes:

Version Number: Each catalog or report type resource can hold a group of archive versions, and each version is given a unique number to distinguish itself from others.

Some columns will not be shown by default, to show other columns, use the Preferences page. For details, refer to User Guide | Administrating JReport Enterprise Server | Customizing JReport Enterprise Server.

Column	Description
Report	The report path and name.
Catalog	The path and name of the catalog that the report belongs to.
Completed Time	The time when this task is completed.
Time Elapse	The elapsed time since the task starts to be performed.
Started Time	The time when this task starts to be performed.
Catalog Version Number	The version number of the catalog that the report belongs to.
Parameters	The parameter of the report.
Report Version Number	The version number of the report.

Approaches to the Task Information Tables

All the task information are collected and managed in tables, on the service page of JReport Enterprise Server (Port 8888 by default).

If you want to Then do

Access the Scheduled table, Click Schedule on the top banner, and then click the Scheduled tab.

Access the Active table, Click Schedule on the top banner, and then click the Active tab.

Access the Completed table, Click Schedule on the top banner, and then click the Completed tab.

Access the On-demands table, Click On demand on the top banner, and then click the On demand tab.

If you want to	Then do
Access the Scheduled table,	Click Schedule on the top banner, and then click the Scheduled tab.
Access the Active table,	Click Schedule on the top banner, and then click the Active tab.
Access the Completed table,	Click Schedule on the top banner, and then click the Completed tab.
Access the On-demands table,	Click On demand on the top banner, and then click the On demand tab.

Managing Tasks in Task Tables

JReport Enterprise Server provides you with a set of tables to collect and show task information. You can also manage the tasks in these tables.

For information on how to run reports in a specific way, see User Guide | Accessing JReport Enterprise Server - Browser.

Common Task Management Operations

Some task management operations are common in most tables, as listed in the following table:

If you want to Then do

Select a task, Click the leftmost check box in the row of the task you want to select.

Select all the tasks, Click the Select All button.

Deselect all the tasks, Click the Clear All button.

Remove a task, Select the task you want to remove, and then click the Delete button.

If you want to	Then do
Select a task,	Click the leftmost check box in the row of the task you want to select.
Select all the tasks,	Click the Select All button.
Deselect all the tasks,	Click the Clear All button.
Remove a task,	Select the task you want to remove, and then click the Delete button.

Scheduled table

If you want to Then do

Create a new scheduled task, Click the New button, and then follow the screen prompts.

Run a task at once, Select the task you want to run, and then click the Run Now button.

Duplicate a task, Select the task you want to duplicate, and then click the Copy button.

Enable a task, Select the task you want to enable, and then click the Enable button.

Disable a task, Select the task you want to disable, and then click the Disable button, the disable tasks will not be performed until you enable it again.

Export a scheduled task to a script on disk,

Select the task you want to export to script, click the Export To Script button.

Modify the script text in the box.

Provide a name for the script.

Click Save.

Import a scheduled task from a script saved on disk,

Select a script from the Deal Script drop-down list.
Click Deal Script.
Modify the script text in the box.
Click Import from the Script.

Delete a script from disk,

Select a script from the Deal Script drop-down list.

Click Deal Script.

Click Delete the Script.

Notes:

The script file you export will be saved to the folder %JREntServerInstallRoot%\realm\%ActiveRealm%\schedule, using the name you specify. Meanwhile, the name of the exported script will be added to the Import from Script drop-down list.

The Import from Script button appears only when there are scripts existing in the %JREntServerInstallRoot%\realm\%ActiveRealm%\schedule folder.

The script file name extension is *.script.

If you want to	Then do
Create a new scheduled task,	Click the New button, and then follow the screen prompts.
Run a task at once,	Select the task you want to run, and then click the Run Now button.
Duplicate a task,	Select the task you want to duplicate, and then click the Copy button.
Enable a task,	Select the task you want to enable, and then click the Enable button.
Disable a task,	Select the task you want to disable, and then click the Disable button, the disable tasks will not be performed until you enable it again.
Export a scheduled task to a script on disk,	Select the task you want to export to script, click the Export To Script button. Modify the script text in the box. Provide a name for the script. Click Save.
Import a scheduled task from a script saved on disk,	Select a script from the Deal Script drop-down list. Click Deal Script. Modify the script text in the box. Click Import from the Script.
Delete a script from disk,	Select a script from the Deal Script drop-down list. Click Deal Script. Click Delete the Script.

Active table

If you want to Then do

Stop a task from running, Click the corresponding Stop link.

View parameter information, Click the corresponding parameter link on the Parameters File column.

If you want to	Then do
Stop a task from running,	Click the corresponding Stop link.
View parameter information,	Click the corresponding parameter link on the Parameters File column.

Completed table

If you want to Then do

Delete all completed tasks, Click the Delete All Completed Tasks button.

View detailed task running information, Click the corresponding Details link on the Is Successful column.

View parameter information, Click the corresponding parameter link on the Parameters File column.

If you want to	Then do
Delete all completed tasks,	Click the Delete All Completed Tasks button.
View detailed task running information,	Click the corresponding Details link on the Is Successful column.
View parameter information,	Click the corresponding parameter link on the Parameters File column.

Index