Introduction

JS7 - Reports offer aggregated information about past execution of workflows and jobs.

Reports can be created using the JOC Cockpit Reports view. In addition, they can be created automatically using the JS7 - JITL RunReportJob Job Template. Users can create workflow and job using the Job Template that can be scheduled for begin of month.

JITL RunReportJob

The purpose of the RunReportJob Job Template is to create reports that are defined with the Reports system folders in the Configuration view.

JITL Authentication

The JITL RunReportJob makes use of the JS7 - REST Web Service API. To access the API it is required to configure an account for authentication, see JS7 - JITL Common Authentication

The account needs the following permissions to create reports:

  • sos:products:joc:reports:manage  
  • sos:products:joc:reports:view 


Arguments

NameDescription
report_paths

List of paths pointing to the location of report configurations for which reports should be created

Items in the list are separated by semicolon. Reports will be created for all list items. List items for non-existing report configurations will be ignored. If the same report configuration is specified more than once, then it will be used just once.

If both report_paths argument and report_folders argument are not used, then reports for all report configurations will be created.

report_folders

List of folders holding report configurations for which reports should be created

Items in the list are separated by semicolon. Reports will be created for all list items. List items for non-existing report configurations will be ignored. If the same report configuration is specified more than once, then it will be used just once. This can occur if a report configuration is found in the report_paths argument and in a folder specified by the report_folders argument.

Folders will be processed recursively if the name ends with: /*

If both report_paths argument and report_folders argument are not used, then reports for all report configurations will be created.

Adding a Workflow to automate Creation of Reports

Users can add a workflow that holds a single job to create reports.



The wizard is available to assign the job the JITL RunReportJob Job Template:


It is not required to configure job arguments. The default behavior is to create all reports. 

Existing reports will not be overwritten.

Adding a Schedule to automate Creation of Reports

A schedule can be created like this:


The schedule is assigned a the workflow:


The schedule specifies start times. In the following example reports will be created on the first day of month at 12:00:00:



  • No labels