Local Folder Watcher Action Plugin



This action plugin waits for the arrival of folders matching a certain pattern and optionally waits for the stability of all files in that folder.

Saved Parameters Description

  • Name: The name used to identify a saved LocalFolderWatcher configured instance.
  • Watch directory: The search root. GLOB wildcard are supported (*, ** and ?). Dynamic attributes are supported.
  • Multi folder search?: Check this box if multiple folders are provided in the watch directory field.
  • Folder pattern: (optional) The pattern for the name of the folders to be detected. Pattern can be either expressed in GLOB or in REGEX (depending on the switch chosen below). Dynamic attributes are supported. If no patterns are provided any new folder will trigger.
  • Use regex pattern matching?: By default, GLOB matching is used, but if checked, REGEX will be used.
  • Ignore folder name pattern: (optional) The pattern (expressed as REGEX) of directory names to be excluded.
  • Ignore folder name pattern applied to full path?: By defualt the exclusion pattern above is applied just to the basename of the foldername folder. If checked, the pattern will be applied to the full path.
  • Polling frequency: (optional) The wait time between each status check. The polling frequency is also used as the minimum time a folder as to be stable if 'trigger on partial' is not checked.
  • Return folder content?: If checked, an additional inputs providing a list of the content for the trigger folders will be provided.
  • Keep ongoing?: If checked, the containing workflow will be cloned after each trigger event.
  • Return all matching entries?: By default only the oldest matching entry is returned, but if checked, all matching entries will be returned.
  • Trigger on partial?: By default, only stable folders are returned, but if checked, the stability check is by-passed.
  • Trigger persistence scope: Sets the scope/availability of the trigger output. The default value is 'By workorder group'. The definitions are: 'By workorder group', 'By action template', 'absolute', 'By step', 'By workflow', 'None'

Details:

  • 'By workorder group' - Trigger folders are tracked while workorder is executing and will only be trapped once. If the workorder is restarted, all past triggers will be detected again if they are still present.
  • 'By workflow' - Same as 'By workorder group' except no triggering will occur upon a 'restart' action as the workflow is still the same.
  • 'By action template' - Allows the tracking and thus non-triggering in the second workflow for previously processed trigger files shared across workflows that contain the same template,
  • 'absolute' - One trigger list is tracked regardless of the where it occurs,
  • 'By step' - Similar to 'By workflow', but allows for multiple independent trigger steps within the workflow.
  • 'None' – No persistence at all. If a past trigger file is still present, it will re-trigger if ‘keep on-going’ is selected. This option is recommended when ‘keep on-going’ is not selected.

Inputs Description

The list of inputs depends on the configuration of the LocalFolderWatcher action template.

  • Watch_directory: If a 'Watch directory' is not provided in the configuration, it can be provided as an input.
  • Folder_pattern: If a 'Folder pattern' is not provided in the configuration, it can also be provided as an input.

If dynamic attributes are used in the 'Watch directory' or 'Folder pattern', they will be required inputs typed as strings.

Outputs Description

  • Folder_path: Only if 'Return all matching entries?' is not checked - returns the full path to the detected folder matching the set search criteria.
  • Folder_list: Only if 'Return all matching entries?' is checked - returns an array of the full path to the detected folders matching the set search criteria.
  • Content: Only if 'Return folder content?' is checked - returns the list of the full paths to the files present in the trigger folder (or folders). If 'Return all matching entries?' is checked, this output is presented as a Hash of arrays, with the trigger folder path as the key, else it is just an array of the files with the single trigger folder.

Supported Actions

None

Operating Instructions

This plugin does not support value overwrites: if a value is specified in the template it will not be available as input of the step at run time.