Versions Compared

Key

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

...

  • Schedules determine the point in time when orders for workflow execution will start. They assign a workflow and optionally variables that are used by jobs in the given workflow.
    • Start dates are specified by JS7 - Calendars and limit the days for execution of workflows.
    • Start times are specified by Schedules that can further limit the days for workflow execution.
  • Schedules create orders on a per day basis daily basis:
    • for one-time execution of workflows: this . This includes that a workflow starts at a number of specific points in time per day.
    • for cyclic execution of workflows: this . This specifies repeated execution of workflow based on configurable intervals.
  • Schedules are applied by the JS7 - Daily Plan to create orders for the resulting date and time.

...

Manage Schedules

Add Schedule

Schedules are available can be accessed from the Configuration->Inventory View in in the respective relevant sub-folders.

  • The tree in the left panel offers an action menu to create a Schedule.
  • The This action menu is available from for any Schedules object folder.

...

Add Run-time 

The Schedule object view offers provides the Add Run-Time button to specify the start time of orders created by the Schedule:

...

In a first step the Assign Working Day Calendar button is used to select access and make an assignment from the list of available Calendars:

Add Period

In a the next step with the Calendar being assigned after a Calendar has been assigned, the  icon in the Period column is used to specify the start time.

  • The Single Start repeat interval allows to specify specification of the time when an order should start.
  • Users can add any number of periods with a Single Start interval to an order's run-time to cover specific points in time during the day.

...

  • The Repeat interval requires the Repeat Time to be specified, for example to execute every 10 minutes.
  • The Begin and End of the repeat period have to be specified, for example from 8am to 8pm.
  • The Schedule will create individual order instances for each repeat start during the period:
    • The order instances are hidden from the JOC Cockpit GUI and appear as a single cyclic order with the  icon appended to the Order ID.
    • Any operation to cancel, to suspend, to resume or to modify a cyclic order is applied to all order instances included.

Add Restriction

Schedules allow to add the addition of Restrictions that further limit the days for which orders are created:

  • Restrictions correspond to the Frequencies available for Calendars.
    • They allow to further limit limitation of the days for which orders are created.
    • Restrictions are not applied for days that are not in scope of the underlying Calendar.
  • For details how to add Restrictions/Frequencies see JS7 - Management of Calendars.

...

A Schedule is assigned a workflow for which orders are created for:

Assign Variables

Workflows can declare variables, for details see JS7 - Order Variables.

  • The declaration includes to specify specifying if a variable is mandatory or if it is optional and makes use of a default value.
  • The Schedule object view requires that mandatory variables are assigned a value. In addition, values for optional variables can be specified.

...

Schedules are not deployed to a Controller and Agent. Instead, they are used by the JS7 - Daily Plan Service to create orders for workflow execution at the given days specified.

Schedules know a draft status and a released status:

  • A draft status is visible from indicated by the icon and from the  orange bullet.
    • The draft status is in place when after a Schedule is has been added or modified and is but has not yet been released.
      • A In addition a draft Schedule can further be invalid which is as indicated by the  icon. This happens can be due to missing input or invalid data added to the Schedule by the user.
      • Invalid Schedules are automatically stored in the same ways as valid Schedules. However, they cannot be released before they are validuntil they have been validated.
      • Validation is performed with a JSON Schema, see JS7 - Inventory Storage Format.
    • Draft Schedules are ignored by the Daily Plan when creating orders for workflow execution.
  • A released status is visible from indicated by the  icon and from by the  blue bullet.
    • Valid Only valid Schedules only can be released.
    • Released Schedules are applied by the Daily Plan to create orders for workflow execution.
    • In addition they , released Schedules are considered when manually creating the Daily Plan from the respective relevant view.

Use with the Daily Plan

...

  • Plan Order automatically: this setting activates the Schedule for use with the JS7 - Daily Plan Service. As a result orders are automatically added with a PLANNED state.
  • Submit Order to Controller when planned: this setting offers to automatically submit allows automatic submission of planned orders to Controllers:
    • when the daily plan is created from the JS7 - Daily Plan view and
    • when used by the Daily Plan Service.
    • As a result such orders are assigned the submitted state in the Daily Plan view and in the JS7 - Daily Plan History.

Use with the Daily Plan View

  • The view allows to manually create the manual creation of the daily plan for a given date. 
  • The functionality includes to select This function includes selection of specific Schedules, Schedules by folder or all Schedules to generate orders.
  • Released Only released Schedules only are applied to the Daily Plan.

...

  • The Daily Plan Service makes use of any released Schedules that hold the settings:
    • to plan orders that orders are to be planned automatically or
    • orders are to submit orders be submitted to a Controller when planned.
  • The Daily Plan Service plans and submits orders for the number of days ahead that is specified with the Daily Plan Service configuration.

...

As an alternative to cyclic orders created by Schedules using repeat intervals, the JS7 - Cycle Instruction is available for cyclic workflows.

  • Execution
    • A Cycle Instruction spawning a complete workflow is an equivalent to the use of cyclic orders from a Schedule.
    • In addition, a Cycle Instruction can be used to execute parts of a workflow in cycles.
  • Efficiency
    • Schedules create a number of order instances for each period in a cycle, Running a single workflow every 30s counts adds up to 2880 orders per day.
    • Cycle Instructions cause cyclic execution of a workflow from a single order.
    • Processing of cyclic workflows is by far more efficient than use the processing of cyclic orders.
  • Error Handling
    • Failure
      • If a job in a workflow fails then this will occur for each order instance of a cyclic order individually.
      • If a job within a Cycle Instruction fails then, depending on the error handling in place, any cycles that would occur while an order is in a failed state are skipped..
    • Notification
      • For each failing order instance of a cyclic order a JS7 - Notification is created.
      • For the single order of a cyclic workflow a single Notification is created.
    •  Intervention
      • Any operations on cyclic orders are applied to all order instances included, for example to resume , resuming execution after failure. This results in parallel execution of orders previously scheduled for execution in intervals.
      • For cyclic workflows there is a single order that waits for user intervention.
  • Logging
    • For each order instance of a cyclic order: a separate entry is created in the JS7 - Order History and in the JS7 - Task History.
    • For a cyclic workflow: there is a single entry in the Order History that is appended the log output of each cycle. Individual entries per job execution are added to the Task History.

...