Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Introduction

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

Reports can be generated manually created using the JOC Cockpit Report view or automatically using a JITL Job in a workflow that is scheduled periodically.

JITL RunReportJob

Creating a workflow to automate the report generation

Create a new workflow and assign one job to the workflow. 

Specify the value for the agent to any available standalone agent or agent cluster.

Image Removed

Open the wizard to assign the RunReport JITL-Job

Image Removed

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.

Image Added



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

Image Added


It is not required to configure job argumentsClick the Submit Button. It is not necessary  to configure parameters for the job. The default behavior is to create all reports. 

Reports that have already been created Existing reports will not be created againoverwritten.

Create a schedule and assign the schedule to the workflow. The workflow should run one time every month.

Adding a Schedule to automate Creation of Reports

A schedule can be created like this:

Image Added


The schedule is assigned a the workflow:

Image Added


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

Image AddedJS7 - JITL RunReportJob