Inject job



Inject job is a a processor (acting as a producer) that injects a job into the flow when triggered by an incoming job or by various time-based events. The injected job can be selected dynamically from a repository of jobs, it can be a fixed job, or it can be the incoming job itself.

The properties for each outgoing connection specify what needs to happen for that connection (independently of other connections). For example, to inject a job from a repository based on the metadata of some incoming job while keeping the original job around, setup one connection to receive the incoming job, and a second connection to receive the job from the repository.

Keywords

Keywords can be used with the search function above the Elements pane.

The keywords for the Inject job element are:


Connections

Inject job supports an optional incoming connection and allows any number of outgoing connections. It offers additional properties on each of its outgoing connections.

Properties

Property

Description

Name

The name of the flow element displayed in the canvas

Outgoing connection properties

The following properties are provided for each of the outgoing connections in addition to the basic connection properties

Property

Description

Trigger

Specifies the type of event that triggers injection for this connection:


  • Incoming job: an injection is triggered for each incoming job

  • Time since previous job: an injection is triggered when the specified period of time passed since the last job arrived

  • Time of day: an injection is triggered at the specified time(s) during the day

Unit

Selects the unit for the subsequent property: Minutes, Hours, Days

Delay

The trigger delay in the units indicated by the previous property

Repeat

If set to yes, a new injection is triggered repeatedly at the specified interval as long as no jobs arrive; if set to no, an injection is triggered only once (until a new arrival resets the timer)

Time (hh:mm)

The time of day when an injection is triggered (every day)

Repeat unit

Selects the unit for the subsequent property: Minutes, Hours

Repeat delay

The repeat delay in the units indicated by the previous property; a value of zero means "do not repeat"

Inject

Specifies the scheme for determining the injected job for this connection:


  • Incoming job: inject the incoming job (or a copy, if more than one connection specify this scheme); if the injection is not triggered by an incoming job this behaves as if "Dummy job" was selected

  • Dummy job: inject an empty file called "dummy.txt" (generated by the tool)

  • Specific job: inject the job specified in a subordinate property through its absolute file or folder path

  • Job repository: inject the job specified in a subordinate property through an absolute folder path (the repository containing the jobs) and a job name (the name of the job residing in the repository)

Job path

The absolute file or folder path of the job to be injected (if a fixed file path is selected, the selected file is included in the exported flow)

Job repository

The absolute folder path of the repository containing the jobs

Job name

The file or folder name of the job residing in the repository (possibly including the filename extension, depending on the value of the subsequent property)

Extension

The filename extension for the job residing in the repository (without the period); an empty value means that the filename extension is included in the "Job name" property (or that there is no filename extension)

Delete after injection

Used in the Job Repository and Specific Job cases. If set to yes or if the condition is true, the original injection job is deleted after being injected in the outgoing connection. Otherwise, the original job is unaffected.

Name job after

Specifies how to determine the name of the jobs injected into this connection:


  • Incoming job: use the name of the incoming job; if the injection is not triggered by an incoming job this behaves as if "Injection job" was selected

  • Injection job: use the name of the job selected for injection (which may be the incoming job)