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.

IconSnap TypeDescription

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 mismatchConnection 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 connectionUnlinked connection

To disconnect linked Snaps, click on the blue connector. This clears the color and allows you to rearrange the Snaps. 

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.