Connecting Snaps

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, Birst 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, Gate, Union



Format

Changes the data format.

Examples: CSV Formatter, JSON Formatter, Excel Formatter



Write

Specifies data destinations in a Pipeline.

Examples: File Writer, REST Post, Email Delete

Connect Snaps 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.





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.





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

Remote-connect link Snaps

You can also connect to Snaps that are not next to each other by using a Remote-Connect Link.

For example, click and hold on the Mapper Snap connector until it turns Yellow,then drag it to the Copy Snap connector. When both connections turn Blue, release the mouse button. A number is placed in both connectors to let you know they are connected.



Note: 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.



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.
    Tip:

    Snap Execution Mode Setting

    When a Snap is disabled, clicking the Enable Snap option returns the Execution Mode to the default setting for that 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.



Note: When a Snap is no longer available, the schema for that Snap is not available to provide specific details for the info-box, so field labels do not display in a user-readable format.

Video demonstration

Watch the following video to link two distant Snaps in a complex pipeline.