Articles in this section

See more

Clone, Export, and Import Flows with All Connections and Formats

  • Updated
Follow

Etlworks makes it easy to copy, export, and import Flows — including all related Connections, Formats, Macros, and Listeners. This is useful for:

  • Duplicating an existing Flow.
  • Migrating Flows between environments.
  • Backing up or sharing Flows with others.

Duplicate a Flow

To quickly clone an existing Flow:

Step 1. Go to the Flows page.

Step 2. Click Duplicate Flow.

Step 3. Enter a new name for the Flow.

mceclip0.png

The duplicate will retain all original settings.

Export Flow(s)

To export one or more Flows:

Step 1. Navigate to the Flows page.

Step 2. Click Export/Import Flow and choose Export.

mceclip3.png

Step 3. Select one or more Flows to export.

Step 4. Click Export Selected or Export All.

You’ll download a.etld file containing the selected Flows and all related Connections, Formats, Macros, and Listeners.

Note: If the Flow is nested, all subflows and dependencies will be included in the export.

Import Flow(s)

Step 1. Go to the Flows page → Export/Import Flow → Import.

Step 2. Click Choose the flow file to import, then select a.etld file.

Step 3. Select which Flows to import.

Step 4. Choose a collision policy (see below).

Step 5. Optionally expand the flow to import and replace connections and formats with connections and formats that already exist in your system. 

Step 6. Optionally, add tags.

Step 7. Optionally, if you don't want to import credentials enable Do not import connection credentials. This is useful when importing flows from different environments. 

Step 8. Optionally, enable Import schedules. This will import schedules (if exist) from flows included in the import file. 

Step 9. Click Import Selected or Import All.

Note: If importing a nested Flow, all related resources (Connections, Formats, Macros, Listeners) will be imported automatically.

Collision Policies

When importing, choose how Etlworks should handle naming conflicts:

  • Add: Create entirely new objects with a timestamp suffix.

    Example: My Flow [05-17-2024_14-52-41].

    • You can rename these later (ensure uniqueness).
    • If the Flow uses an HTTP Listener, update the URL Pattern (must be globally unique).
  • Replace: Replace existing Flows, Connections, Formats, Macros, and Listeners that match by name and type.
  • Keep: Keep existing artifacts and skip importing duplicates.

  • Keep all, replace Flows and Macros: Replace only Flows and Macros. Keep existing Connections, Formats, and Listeners.

    Ideal for migrating between environments.

Add Tags on Import

If selected, Etlworks will add the chosen tags to all Flows, Connections, Formats, and Listeners created or updated during import.

Cannot import a Flow

If the Connection or Listener used in the Flow contains the IP address 127.0.0.1 or localhost, it cannot be imported to the tenant or the account on the shared instance.

Workaround

The solution is to replace 127.0.0.1 or localhost with something else.

Export File Encryption

All exported.etld files are encrypted by default.

To use your own encryption key:

Step 1. Go to Settings → Security → Export/Import Encryption.

Step 2. Upload a private key in PEM format (-----BEGIN RSA PRIVATE KEY-----).

Step 3. Optionally, add a passphrase.

How To Generate Key

You can generate a key using:

ssh-keygen -t rsa -m PEM
  • On Linux/Mac: Use directly in terminal.
  • On Windows: Use PowerShell (if OpenSSH is installed) or PuTTY.

Related articles