Page tree

Versions Compared

Key

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

...

  • Dev instance: If you are using an instance of the platform for developing and testing your flows, you can import a new flow through the Flows page. 

    Info

    NOTE: Unless your instance of the platform has been specifically configured to support deployment management, you are using a Dev instance of the platform.


    Info

    NOTE: If you are attempting to share a flow with other users on the same instance of the platform, you should use the sharing functions. See Overview of Sharing.


  • Prod instance: If you are importing a flow into a Production instance of the platform, you import it as a package through the Deployments page.

    Info

    NOTE: Deployment management is a feature that enables segmentation of platform usage between Dev instances and Prod instances. This feature must be enabled and configured. For more information, see Overview of Deployment Management.


 

Limitations

Warning

You cannot import flows that were exported from a different edition, release, or build of the product.

Imported flows do not contain the following objects:

  • Reference datasets
  • Samples
  •  

    Connections

    Info

    NOTE: Exported flows do not contain connections. If your flow relies on a connection to the source, you must create the connection in the new environment and create an import mapping rule to assign the local connection ID to the import package. Flows that do not require connections may not require remapping before import. See Define Import Mapping Rules.


    Info

    NOTE: If the flow's output object uses connections that are not used for importing datasets in the flow, the output is broken on import. Those outputs and their associated connections must be recreated in the environment into which the flow is imported.


 

Define import rules

Before you import a package, you may need to create import mapping rules to apply to your package. For example, if the Development data is stored in a different location than the Production data, you may need to create import rules to remap paths and connections to use to acquire the data from the Production environment. 

Info

NOTE: Import rules are applied at the time of import. They cannot be retroactively applied to releases that have already been imported.

 

For more information, see Define Import Mapping Rules.

 

Import

Info

NOTE: You cannot import into a Dev instance if your account for the instance contains the Deployment role.


Info

NOTE: When you import a package, you import a ZIP file. You cannot import the contents of the ZIP. If your local environment automatically unzips ZIP files, please re-ZIP before you import.

...

The flow is imported and available for use in the Flows page.

Info

NOTE: After import, the createdAt timestamp for the flow references the date of creation of the flow that was originally exported. This is a known issue.

Import into Prod instance

...

Tip

Tip: After you import, you should open the flow in Flow View and run a job to verify that the import was successful and the rules were applied. See Flow View Page.

Troubleshooting

Problem - Imported flow containing imported Excel dataset fails to load

If you have loaded an imported flow that contains an imported Excel dataset, the recipe for it may fail to load in the Transformer page with the following error:

Code Block
Input validation failed: (Cannot read property 'filter' of undefined)

Additionally, the preview in Flow View may not display any sampled data.

Solution:

Info

NOTE: This is a known issue that will be addressed in a future release.

For now, the workaround is the following:

  1. Open the imported flow.
  2. If a recipe doesn't exist that depends on this dataset, create a new one for it.
  3. Click the recipe for the imported Excel dataset.
  4. Click the output object for the recipe.
  5. Run the job. The success and results of the job are immaterial.
  6. After the job completes, load the recipe in the Transformer page.
  7. If no data appears in the grid, create a new sample. See Samples Panel.

For more information, see Flow View Page.