Versions Compared

Key

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

...

  • The Cycle Instruction allows to repeat all jobs or a number of jobs and additional instructions in a workflow.
  • The instruction Cycle Instruction can be used
    • to spawn the complete workflow,
    • to spawn a a number of jobs in a workflow,
    • in a sequential way by using a number of Cycle Instructions within the same workflow,
    • in a nested way by embedding Cycle InstructionsInstructions within the same workflow.
  • The Cycle Instruction offers some versatile options when to repeat execution and how often this should happen.
  • Consider that a Cycle Instruction spawning a complete workflow is an alternative to using JS7 - Schedules for cyclic orders.
    • The difference being that that JS7 - Schedules create cyclic orders whereas the Cycle Instruction creates cyclic workflows causes cyclic execution of a workflow for a single order.
    • For each cyclic order a separate log entry is created while cyclic workflows report to the same log.
    • Processing of cyclic workflows is by far more efficient than use of cyclic workflows.

...

The Cycle Instruction allows to specify any number of cycles that define different rule sets when to repeat job nodes and other instructions.

Each cycle allows to use one the following cycle types:

  • periodical execution: allows to specify periodic points in time, as e.g. for the 10th, 15th, 40th minute of each hour.
  • continuous execution: allows to specify a fixed interval for a -length pause between cyclic executions.
  • ticking execution: allows to specify a fixed-length interval between each start of a cycle.

In addition for any cycles included with a Cycle Instruction a rule set specifies

  • the begin of first cycle considering the workflow's time zone
  • the maximum duration for which cycles are repeated, for example for 8 hours.

...

  • the period by which the cycle repeats: this could can be for example 1 hour, 4 hours, 1 day etc.
  • the point in time within the repeat period when cycles start.

...

  • The property editor displays the summary information of the period.
  • The period is configured
    • by use of a frequency, for example every day:
      • if an order's scheduled date (Daily Plan date) is not matched by a frequency then the order will skip skips the Cycle Instruction,
      • otherwise the order considers the Cycle Instruction and e.g. waits for the begin of the first cycle,
    • by period details specifying the begin and duration of the period, e.g. begin of day for 23 hours,
    • by repeat details specifying for example
      • the repeat period of 1 hour,
      • the minutes for which the cycle is started for in each repeat period..

When creating/modifying a periodical cycle then this can look like this:

...

  • The cycle is of periodical type, i.e. the cycle repeats within the given period at fixed points in time.
  • The period duration is 1h. 
  • The offsets when to start the cycle within the given period are specified by minutes: at each full hour, at each 15th, 30th and 45th minute of each hour.
  • The first cycle is specified to start at midnight, i.e. begin of day, in the workflow's time zone, with the last cycle being started 23 hours later.

...

Continuous Execution

This cycle type allow allows to specify

  • a fixed-length pause between cycle executions - consider that the execution time of jobs spawned by a Cycle Instruction might vary between cycles,
  • a limit specifying the max. number of cycles to be executed.

...

  • The property editor displays the summary information of the period.
  • The period is configured
    • by use of a frequency, for example every day,
      • if an order's scheduled date (Daily Plan date) is not matched by a frequency then the order will skip skips the Cycle Instruction,
      • otherwise the order considers the Cycle Instruction and e.g. waits for the begin of the first cycle,
    • by period details specifying the begin and duration of the period, e.g. begin of day for 23 hours,
    • by repeat details specifying for example
      • a 15 minutes break between cycles,
      • a limit of 10 repeated executions of the cycle.

...

Ticking Execution

This cycle type allow allows to specify

  • a fixed-length interval between cycle executions - consider that the execution time of jobs spawned by a Cycle Instruction might vary between cycles,

...

  • The property editor displays the summary information of the period.
  • The period is configured
    • by use of a frequency, for example every day,
      • if an order's scheduled date (Daily Plan date) is not matched by a frequency then the order will skip skips the Cycle Instruction,
      • otherwise the order considers the Cycle Instruction and e.g. waits for the begin of the first cycle,
    • by period details specifying the begin and duration of the period, e.g. begin of day for 23 hours,
    • by repeat details specifying for example a 2 minutes fixed-length interval between cycles.

...