Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

In this article

Table of Contents
maxLevel2
absoluteUrltrue

Overview

SnapLogic Manager supports Project Import and Export operations. This enables you to copy SnapLogic Assets across Orgs. You can export a Project in the form of a Zip file containing all of the Pipelines, files, Flows, Accounts, and Tasks associated with the Project. Pipeline dependencies, such as child Pipelines and related accounts, are maintained during export. If you use different Orgs for development, testing, and production, you can then import the Project into the target Org. An accounts_template.json file is included in the exported JSON file. The Project Import wizard supports uploading the accounts template and a global expression file that defines variables for Account access. This enables you, as an Org admin, to maintain a master file for your account information and then change the variables across Orgs without changing the master file, supporting Continuous Integration and Continuous Development (CI/CD).

Info

SnapLogic Accounts

Accounts are exported only when the Org supports encryption. SnapLogic, by default, has

...

Standard Account Encryption (SAE) across all Orgs, unless an Org has opted for Enhanced Account Encryption.

...

In SAE,

...

accounts are encrypted with

...

keys managed

...

Pipeline dependencies such as nested pipelines within that project and accounts are maintained. Once the project is imported, you will need to add any files that were previously referenced, configure the Snaplex the pipeline should run on, and re-add any Snaps that were specific to the project.

Step-by-step guide

To export a project:

...

You can then choose to export all assets that make up the project, or to exclude certain assets like files, to limit the size of the resulting compressed file.

Note

When exporting large projects, there is no indicator to inform you that the project is being exported. You will need to wait for the .zip file to be downloaded to know it has completed.

To import a project:

  • Hover over the Projects header, then select Import from the drop-down menu.

...

in the cloud. 

Export Projects

Note
  • Before exporting a Project, ensure that all the Pipelines in the Project are saved and closed.

  • The maximum number of files you can export at one time is 200.

To export a Project:

  1. In SnapLogic Manager, hover your cursor over the Project to export, and click the arrow. The Project menu opens:

    apigee-proxy-removed.pngImage Added

  2. Select Export. The Export <Project Space>/<Project Name> dialog opens:

    Image Added
  3. Select the Asset types that you want to export. Pipeline, Task, Account, and Flows options are selected by default. You can select All to export all assets or deselect any asset types from the project export. 

  4. Click Export to download the Project as a Zip file.

Import Projects

Known Issue

While importing a project with same name as an existing project and with the same assets tracked in Azure, the status for the updated assets is changed to Untracked.

To import a Project:

  1. In SnapLogic Manager, hover your cursor over the Project Space to open the menu:

    Image Added
  2. Select Import to open the Import Project dialog:

    Image Added
    1. Click Choose File to upload the Project files:

      • Import Project Zip File*

      • Import Account JSON File (optional)

      • Import Expression Library Zip File (optional)

    2. Select one of the following methods for handling duplicate assets within the project space or global shared folder:

      • Keep existing assets: Creates a new project and marks the duplicate imported assets with a number 1 at the end of the asset name.

      • Create a new project: Creates a new project with a number 1 at the end of the name and all assets from the import with their names intact. The Activity Log records the new project and/or pipeline and indicates that they are created by the import operation.

        Image Added
      • Overwrite existing assets: Allows you to select which assets (files, pipelines, tasks, accounts, and flows if applicable) to import and replaces any duplicate existing assets with the imported ones. The Activity Log records the new project and/or pipeline and indicates that they are created by the import operation.

  3. When the file upload is complete, click Import. A confirmation message appears on the page, and the new project appears in the list of projects on the left. 
    You might need to do the following:

    • Add files that are referenced if they were not a part of the project's export.

    • Edit the Tasks to select the Snaplex on which they must run. 

Note

Important

  • References to assets in the project remain unchanged.

  • If you are importing a project with the same name as one that already exists, (n)

...

  •  is appended to the project name for each time it is imported, starting with n=1.

  • The

...

  • platform reports an error if you try to import a project Zip file > 100MB

Export Selected Assets

To export selected assets in Manager:

  1. In SnapLogic Manager, hover your cursor over the project to export and click the arrow to open the menu. From the toolbar, click the Export icon.

    apigee-proxy-removed.pngImage Addedimage-20240410-142753.pngImage Added

  2. Select Export. The Export <Project Space>/<Project Name> dialog opens:

    image-20240410-142038.pngImage Added

  3. Select the Asset types that you want to export. Pipeline, Task, and Account are selected by default. Select All to export all assets or deselect any asset types from the project export. 

  4. Click Export to download the Project as a Zip file.

  5. Using the export icon on the project panel, the user can export selected assets.

Import Selected Assets

To import selected assets in Manager:

  1. In SnapLogic Manager, hover your cursor over the project space to open the menu. Alternatively, you can use the import icon from the toolbar.

    image-20240410-130223.pngImage Addedapigee-proxy-removed-wizard.pngImage Added

  2. Select Import to open the Import project dialog.

  3. Under the project space dropdown, the import user can import a project and under the project dropdown import, the user can import individual assets.

  4. Click Choose file to upload the project files:

    • Import project ZIP file*

    • Import account JSON file (optional)

    • Import expression library ZIP file (optional)

  5. Select one of the following methods for handling duplicate assets within the project space or global shared folder:

    • Keep existing assets: Creates a new project and marks the duplicate imported assets with a number 1 at the end of the asset name.

    • Overwrite existing assets: This allows you to select which assets (files, pipelines, tasks, accounts, and flows, if applicable) to import and replace any duplicate existing assets with the imported ones. The Activity Log records the new project and/or pipeline and indicates that the import operation creates them. When the file upload is complete, click Import. A confirmation message appears on the page, and the new assets appear in the list of projects on the left. 

import-project.pngImage Added
image-20240410-125144.pngImage Added