Versions Compared

Key

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

Table of Contents
outlinh1. true
outlinh1. true
1printablefalse
2stylh1. none
3indent20px

Introduction

The JITL FileOrderVariablesJob MonitoringJob template can be used to read variables from incoming files:

...

  • specify the JITL job class and com.sos.jitl.jobs.fileordervariablesjobmonitoring.FileOrderVariablesJob Java MonitoringJob Java class name and add arguments specifying the variables that are expected to be carried by incoming files.

...

Download (upload .json): pdfFileVariablespdmMonitoring.workflow.json

You can use the job wizard like this:

Image RemovedImage Added


Explanation:

  • Add an empty job from the instruction panel.
  • Specify a name and a label for the job.
  • Select an Agent.

In a next step invoke the job wizard that you find in the upper right corner of the job property editor. The wizard brings up the following popup window:

Image RemovedImage Added


Explanation:

  • From the list of available job templates select the FileOrderVariablesJob MonitoringJob.

Then hit the "Next" button to make the job wizard display available arguments:

Image RemovedImage Added


Explanation:

  • There are optional arguments for this job to identify the file carrying variables:
    • if the job is used in a workflow to which orders are added from JS7 - File Watching then the job will use the internal file variable that specifies the incoming file and does not require an argument.
    • if the job is used in a workflow not subject to File Watching then the js7_source_file argument is used to specify the path to the file carrying variables.
  • Any additional arguments specify variables that are expected from the incoming file. The example makes use of the var1 argument which translates to the fact that from the incoming file a line is expected to specify the variable like this: var1=some value.
  • Select the check box provided with each argument if you want this argument to be added to the arguments of the FileOrderVariablesJob MonitoringJob template.

When hitting the Submit button the wizard adds the required arguments to the job which should look like this:

Image RemovedImage Added

Documentation

The Job Documentation including the full list of arguments can be found under: https://www.sos-berlin.com/doc/JS7-JITL/FileOrderVariablesJobMonitoringJob.xml

The FileOrderVariablesJob MonitoringJob class accepts the following arguments:

...

NameRequiredDefault ValuePurposeExample
js7controller_source_fileidno

Specifies the path to the incoming file:

  • If the workflow in use is subject to File Watching then this argument is not required as the internal file variable will be used.
  • If the workflow is not subject to File Watching then the path to the incoming files has to be specified with the js7_source_file variable.
/tmp/file/some_file.csv

<variable>

yes

Specifies a variable that is expected from the incoming file:

  • If a value is specified then it is applied as a default value in case that the incoming file will not provide the variable.
  • If no value is specified then then incoming file is required to specify the variable and otherwise an error is raised.

Any number of variables can be specified like this.

var1

...