SnapLogic Create

On this Page

Snap type:

Write


Description:

This Snap lets you create a SnapLogic asset of type TASK, ACCOUNT, PROJECT, or PIPELINE. 

For pipelines, you can use a SnapLogic Read Snap to read one pipeline and the SnapLogic Create to copy that pipeline.

Pipeline import rules apply.

Prerequisites:

[None]


Support and limitations:Works in Ultra Task Pipelines.
Account: 

Accounts are not used with this Snap.


Views:
InputThis Snap has exactly one document input view.
OutputThis Snap has at most one document output view.
ErrorThis Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label


Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline.

Asset type


Required. Select the type of asset to create. Options available include:

  • TASK
  • ACCOUNT
  • PIPELINE
  • PROJECT (used for both projects and Project Spaces)
  • SNAPLEX

Default value: ACCOUNTIf your org is configured for Enhanced Account Encryption, the information you use to create an account is automatically encrypted.

Asset path

Required. Absolute path for the asset in the form of: <org>/<project_space>/<project>/<asset>

Depending on which asset you are trying to create, the leading forward slash ( / ) in an asset path may or may not be required. If the path fails, try entering it without the leading slash.


Examples: myorg/Engineering/Status/LatestDefects

Default value: [None]

Snap Execution

Select one of the three modes in which the Snap executes. Available options are:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Starting from version 4.27, Metadata Snaps validate Pipeline fields against the schema. If a SnapLogic Create Snap or a SnapLogic Update Snap would modify an existing Pipeline schema, an error is thrown to avoid affecting downstream processes that depend on the same Pipeline schema.

Examples

Create a Pipeline

You can create a pipeline from an existing pipeline by using a pipeline containing SnapLogic Read + SnapLogic Create.

  • In the SnapLogic Read Snap, set the Asset Path to the pipeline that you want to copy from the org name down to the pipeline name, such as org/project_space/project/pipeline.
  • In the SnapLogic Create Snap, set the Asset Path to the location and pipeline name that create, such as org/project_space/new_project/pipeline.

Create a Project

To create a project, you must have a SnapLogic Read Snap that feeds into a SnapLogic Create Snap as the SnapLogic Read Snap is responsible for passing metadata related information (Org names, users, ACLs) to the downstream SnapLogic Create Snap.

The same practice should also be used for Project Spaces.

Create a Snaplex

Support for Groundplex Only

You can use this method for programmatically creating a Groundplex when designing a Pipeline.

You can create a Snaplex programmatically with this Snap by building a Pipeline that creates the Snaplex, creating a Triggered Task (API) based on this Pipeline, and then sharing the URL with your users. Now users in your Org that do not have Admin privileges can create a Snaplex by using the Task URL. 

To create a Snaplex, use a File Reader or a JSON Generator Snap to specify, at a minimum, the following details:

  • Snaplex Name
  • Snaplex Location
  • Snaplex Environment

The following example shows default Snaplex settings in JSON format in a JSON Generator Snap.

In the SnapLogic Create Snap, specify the following details:

  • Asset Type: Snaplex.
  • Asset Path: The absolute path to the Snaplex.

Once you execute the Pipeline, go to Manager and check in your target Project folder to verify that the Snaplex asset has been created. You can also programmatically delete the Snaplex by using the Delete Snap in the same way.

Snap Pack History

 Click to view/expand
ReleaseSnap Pack VersionDateTypeUpdates

4.29

main15993

   

Stable

Upgraded with the latest SnapLogic Platform release.

4.28main14627 StableUpgraded with the latest SnapLogic Platform release.

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.
4.26main11181
 
StableUpgraded with the latest SnapLogic Platform release.
4.25main9554
 
StableUpgraded with the latest SnapLogic Platform release.
4.24main8556
 
StableUpgraded with the latest SnapLogic Platform release.
4.23main7430
 
Stable

Upgraded with the latest SnapLogic Platform release.

4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21snapsmrc542
StableUpgraded with the latest SnapLogic Platform release.
4.20snapsmrc535
StableUpgraded with the latest SnapLogic Platform release.
4.19snapsmrc528
Stable

The SnapLogic Read Snap now features the Normalization checkbox, which, when selected, makes Pipeline comparisons easier.

4.18snapsmrc523
Stable

Enhanced all the Snaps in this Snap Pack with the capability to create, delete, and update Snaplexes directly inside the Pipeline. This feature facilitates administrative tasks if you are running your Pipelines on a Groundplex.

4.17 PatchALL7402
Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17snapsmrc515
Stable

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during the preview check box.

4.16 snapsmrc508
StableUpgraded with the latest SnapLogic Platform release.
4.15snapsmrc500
StableUpgraded with the latest SnapLogic Platform release.
4.14 snapsmrc490
StableUpgraded with the latest SnapLogic Platform release.
4.13snapsmrc486
StableUpgraded with the latest SnapLogic Platform release.
4.12snapsmrc480
StableUpgraded with the latest SnapLogic Platform release.
4.11snapsmrc465
Stable

Read Task output includes task history.

4.10snapsmrc414
StableUpgraded with the latest SnapLogic Platform release.
4.9snapsmrc405
StableUpgraded with the latest SnapLogic Platform release.
4.8.0snapsmrc398
Stable
  • Support for Project and Project Spaces as an Asset Type added to SnapLogic Create, SnapLogic Delete, SnapLogic Read, and SnapLogic Update. This is used for both projects and Project Spaces.

  • Support for the pipeline as an Asset Type added to SnapLogic Update.

  • Support for enabling/disabling tasks added to SnapLogic Update.

4.7snapsmrc382
StableUpgraded with the latest SnapLogic Platform release.
4.6snapsmrc362
Stable

Upgraded with the latest SnapLogic Platform release.

4.5.0snapsmrc344
Stable

Introduced in Release 4.5. This Snap Pack contains the following Snaps: SnapLogic Create, SnapLogic Delete, SnapLogic List, SnapLogic Read, SnapLogic Update.