Triggered Task Architecture
Cloud Triggered Task via the Control Plane
1 | Client uses the Cloud URL to trigger the API call against the control plane over an HTTPS connection |
2 | The Pipeline is prepared and starts running on the Snaplex JCC node over the WebSocket for the input data and output stream. |
Ground Triggered Task
1 | The client triggers the task via the on-premises load balancer URL. |
2 | The load balancer chooses the Snaplex JCC node to run the pipeline. |
3 | The request is sent to the control plane for pipeline preparation. |
4 | The control plane chooses the Snaplex JCC node based on pipeline load, then sends the request over WebSocket. |
5 | Streaming data is sent over HTTPS connection. |
Comparison of Triggered Task Types
Type | Advantages | Disadvantages |
---|---|---|
Cloud Triggered Task |
|
|
Ground Triggered Task |
|
|
Triggered Task Workflow
This workflow represents actions taken by both SnapLogic Org admins and users.
Prerequisites
You must have permissions to Project Space and Project to create and update Triggered Tasks
You must have a Cloudplex or Groundplex set up to run a Triggered Tasks successfully.
Support and Limitations
- Triggered Tasks support the following HTTP Methods:
- GET
- POST
- DELETE
- PUT
- PATCH
- HEAD
- The Open API specification (also known as Swagger) is supported. You can download your Triggered Tasks in API form in SnapLogic Manager > Assets.
- The Cloud URL has a 15-minute connection limit regardless of whether the connection is idle or not, so it should not be used for Tasks that stream data in or out beyond that time period.
- A Snaplex consists of multiple nodes. If the Triggered Task is set to run on a Groundplex (also known as an On-premises Snaplex), options for Task URLs include one that is reachable from the Cloud (Cloud URL), and others that are limited to the on-premise network (On-premises URL and an Override URL).
- A cloud URL Triggered Task will fail when the Task owner's password is expired. The Task execution requires that the Task owner’s password be reset. When using an on-premise URL, you can still trigger the Task with the bearer token (see Task Details), even if the Task owner’s password is expired. However, the Task execution will fail when using an expired password as authentication until the Task owner's password is reset.
- When you access the URL for a Triggered or Ultra Task that is in an Org different from the one you last selected, SnapLogic Manager displays the Task details, but the Org does not automatically change to the one that owns the Task. Use the selector at the top right in Manager to switch to a different Org.
Since the connection to the client has a 15-minute timeout, long running Pipelines invoked as Triggered or Ultra Tasks through a Cloudplex URL might not complete before the timeout occurs. For Groundplex users, this timeout does not apply to the On-premise URL.
Known Issues
When you create a Triggered Task and change the Run Policy to Scheduled, the Triggered Task URLs are not disabled. Therefore, the underlying pipeline is still executable through the Triggered Task URLs, even though the Task is now a Scheduled Task.
Workaround: create a new Scheduled Task asset referencing the target pipeline and disable or delete the Triggered Task.