17.6.2.4.1.1.16 File Watcher

The File Watcher widget (or component) in the Process Modelling Framework is designed to monitor Oracle Object Storage for files that match a predefined pattern (previously known). Once a matching file is detected, it can automatically trigger subsequent tasks, enabling smoother integrations and supporting event-driven process automation.

There are two types of File Watcher widgets:
  • Polling Based: A polling-based File Watcher periodically checks Oracle Object Storage at defined intervals to detect the presence of a new or an updated file.
  • Event Based: An event-based File Watcher leverages Oracle Object Storage events to receive near real-time notifications when files are added, modified, or deleted.
  • If the file is detected within the specified waiting period, the activity is marked as Success, and the pipeline proceeds to the next step in execution.
  • If the file is not detected within the specified waiting period, the activity is marked as Failed, and the pipeline flow stops at failure.
  • If the file detection is still in progress within the specified waiting period, the activity is marked as In progress.

This widget can monitor only one file at a time and if multiple files are to be detected, users must configure separate instances of the File Watcher.

To configure this widget, complete the following steps:

  1. On the Process Flow page, from the Start node, click the Add icon, expand Widget and select this widget.
  2. Double-click the widget on the canvas. The configuration window is displayed with the Activity tab selected.
  3. Under Dynamic Parameters, configure the settings described in the following table.
  4. Click Save to save your changes. To close the configuration window, click anywhere outside the window on the canvas.

Table 17-19 Dynamic Parameters for File Watcher

Property Description
Type Select any one of the File watcher type:
  • Polling- Select this type to periodically check the Oracle Object Storage at defined intervals to detect the presence of new or updated files.
  • Event- Select this type for the Oracle Object Storage events to receive near real-time notifications when files are added, modified, or deleted.
File Name Enter the name of the file that you wish to search in the Object Storage.
Maximum Waiting Period (minutes) It is mandatory to enter the waiting period until which the file must be detected in the object storage location.
Rename File (s) Select any one of the options:
  • True- Renames the file after detection and deletes the original file.
  • False- Retains the original file name.
This option is only supported for files lesser than 1 MB in size.
Bucket name Enter the object storage information where the file must be detected.