Trigger types for mediation and output contracts

Incoming Transfer trigger

The Incoming Transfer trigger requires a VirtualPath. The instance starts when a TransferEvent is triggered on the STENG, indicating that a file has been received in the VirtualPath specified in the Contract.

• Execution Variable:

  • file of type FileDetail

    • File descriptor of the actual file on which the trigger was fired.

Outgoing Transfer trigger

The Outgoing Transfer trigger requires a VirtualPath. The instance is triggered when a TransferEvent is fired on STENG, indicating that a file is leaving the VirtualPath specified in the Contract to reach its destination.

• Execution Variable:

  • file of type FileDetail

    • File descriptor of the actual file on which the trigger was fired.

Incoming Update Metadata trigger

The Incoming Update Metadata trigger requires a Virtual Path. It activates when an UpdateMetadata event is triggered by STENG, following any metadata update on a FileSet during a transport in the specified Virtual Path.

• Execution Variable:

  • file of type FileDetail

    • File descriptor of the actual file on which the trigger was fired.

New file trigger

The New File trigger is activated when the file is stored in the system. The FileSet is generated by the FileBox component in the VirtualPath defined in the Contract.

• Execution Variable:

  • file of type FileDetail

    • File descriptor of the actual file on which the trigger was fired.

On Demand trigger

The On Demand trigger is initiated through a direct API invocation via REST, specifically the Job Manager Submit API. 🚀 See the Job Manager APIs page for more details.

The API accepts variables, which are passed to the instance as process variables. Any variables specifically declared in the template when creating a contract are combined with the set of variables supplied through the REST call. If the same variable name appears in both the contract template and the REST request, the value from the REST request takes precedence.

Time trigger

Time-based actions are executed at specific times, like daily at 6 a.m. When the designated time is reached, the workflow rule reassesses the record to verify that it still meets the rule criteria. If it does, the workflow rule performs the specified actions.

• Trigger Requirements: A cron expression is needed. The workflow instance starts when the time specified in the cron expression matches the current time. No additional variables are introduced to the workflow instance.

Contract Variables:

• cronExpression - required

  • Type: plain text [STRING]

  • Example: * * * _ ? _

• systemEnableLogDebugToFile - optional

  • Type: Enabled/Disabled [BOOLEAN]

• systemErrorHandlingWorkflowTemplateName - optional

  • Type: Enabled/Disabled [BOOLEAN]

• jobManagerPriorityQueueName - required

  • Type: WUI custom [QUEUE]

  • Default: Default Queue

• systemWorkflowInstanceSingletonMode - optional

  • Type: Enabled/Disabled [BOOLEAN]

Additional Variables Provided by Data Mover:

• contractNameThisInstanceBelongsTo

  • Type: plain text [STRING]

  • Example: ContractName

• templateNameThisInstanceBelongsTo

  • Type: plain text [STRING]

  • Example: TemplateName

• centralLogCorrelationId

  • Type: plain text [STRING]

  • Example: d90fef7b-1517-4ad6-b836-18b6b4645be7:0

Virtual Box Bind trigger

The Virtual Box Bind trigger requires a VirtualBox. The instance starts when a VirtualBoxEvent is generated by FileBox, as a consequence of the association of a FileSet to the configured VirtualBox in the Contract.

• Execution Variable:

  • file of type FileDetail

    • File descriptor of the actual file on which the trigger was fired.

Virtual Box Unbind trigger

The Virtual Box Unbind requires a VirtualBox. It starts when a VirtualBoxEvent is triggered by FileBox, indicating that the FileSet and the configured VirtualBox in the Contract are no longer associated.

• Execution Variable:

  • file of type FileDetail

    • File descriptor of the actual file on which the trigger was fired.