Connecting Snaps
In this article
SnapLogic Snaps are modular collections of integration components built for specific applications or data sources. Snaps aid both business users and developers from having to handle much of the complexities in the underlying application, data model, and service.
Snap Types
SnapLogic includes the following basic types of Snaps with distinct icons.
Icon | Snap Type | Description |
---|---|---|
Read | Specifies data sources in the Pipeline. Examples: File Reader, CSV Generator, Query | |
Parse | Takes the input of unstructured data and generates an output of structured data. Examples: XML Parser, Sequence Parser, JSON Parser | |
Transform | Modifies data significantly. Examples: Mapper, Aggregate, Join | |
Flow | Changes the output or direction of data in a Pipeline. Examples: Router, Shuffle, Union | |
Format | Changes the data format. Examples: CSV Formatter, JSON Formatter, Excel Formatter | |
Write | Specifies data destinations in a Pipeline. Examples: Filer Writer, REST Post, Email Delete |
Snaps Connect to Build a Pipeline
The key to creating a Pipeline in SnapLogic is connecting Snaps. There are a few things to consider when placing Snaps in a Pipeline.
Connection Shapes
Like puzzle pieces, only Snaps with matching connection pairs (circles or diamonds) can be connected. Circle connections indicate document data while diamond connections indicate binary data.
|
|
Connection mismatch | Connection match |
When moved to the Pipeline canvas, Snaps may display with an input (the head of the Snap) and output (the tail of the Snap). To modify the input/output properties, click on the Snap and select the Views tab. See Snap Reference for more information on Views.
Disconnect Linked Snaps
Unlinked Snaps can be moved apart or placed next to each other. Make sure the circle or diamond connector is colored blue, which indicates that the Snaps are linked.
Linked connection | Unlinked connection |
To disconnect linked Snaps, click on the blue connector. This clears the color and allows you to rearrange the Snaps.
Go To Links
You can also connect to Snaps that are not next to each other by using a Go To link.
Click and hold on the male connector until it highlights yellow, then drag it to the female connector. When both connections turn blue, release the mouse button. A number is placed in both connectors to let you know they are connected.
The number is only temporary until the Pipeline is saved, at which point a new, permanent number may be assigned to it.
You can also click and hold on one connection and both Snaps connected by this link will darken. This feature is useful for large Pipelines where it may not be easy to quickly visualize the connections.
Refer to the video for details.
Snap Menu Options
The right-click menu displays options available in all Snaps through a dropdown list.
- Edit. Displays the Snap configuration dialog.
- Delete. Removes the Snap from the canvas.
Disable Snap. Sets the Snap execution mode to disabled. Once set, the option becomes Enable Snap on the dropdown list.
Snap Execution Mode Setting
Clicking the Enable Snap option (when a Snap is disabled) returns the Execution Mode to the default setting of that particular Snap, regardless of the Execution Mode previously set for the Snap before being disabled.
- Assistant. Displays suggestions for the connecting Snap. Clicking this option displays the choices Upstream (for preceding Snaps in a Pipeline) or Downstream (for subsequent Snaps in a Pipeline).
- Copy. Duplicates the same Snap.
- Rotate Whole Snap. Rotates the Snap one quarter in the specified direction. Clicking this option displays the selections Rotate Clockwise (to the right) and Rotate Counterclockwise (to the left).
- Rotate Snap Head. Rotates the input of the Snap one quarter in the specified direction. Clicking this option displays the selections Rotate Clockwise (to the right) and Rotate Counterclockwise (to the left).
- Rotate Snap Tail. Rotates the output of the Snap one quarter in the specified direction. Clicking this option displays the selections Rotate Clockwise (to the right) and Rotate Counterclockwise (to the left).
Rotating Snaps
The following rules apply to rotation:
- If a Snap is not connected to another Snap, you can rotate the whole Snap or just the head or tail ends. Snaps with multiple inputs or outputs can only be rotated as a whole.
- If the Snap is connected at the head, you can rotate the tail; if connected at the tail, you can rotate the head.
- If a Snap is connected on both ends, it cannot be rotated.
Missing Snaps
If a Pipeline contains a Snap that is no longer available from the catalog, that Snap is shown in the Pipeline with the central shape colored red.
When a Snap is no longer available, the schema for that Snap is not available to provide specific details for the infobox, so field labels do not display in a user-readable format.