Skip to content

Add Recipe Files

You can upload files directly into a recipe's folder structure.

  • Use the Node Editor, File Editor, or DKCloudCommand CLI to upload a single file at a time.
  • Use the File Editor or CLI to upload multiple files at once.

Tip

Upload files for multiple variations: If you choose the /resources directory as the target for an upload, the new files can be shared among all variations within that recipe.

Add a file from the Node Editor

Only SQL files are accepted when uploading a single file from the Node Editor. Use the File Editor to upload other types of files.

These SQL files are stored in the recipe's /resources directory as shared files.

  1. Open the Node Editor.

  2. Navigate to a SQL field.

    Note that container files added in the Configuration tab of a container node are node-specific and not shared. See Container Nodes for more information.

    • For an action node with a database source: Locate the SQL field in the Steps tab.
    • For a DataMapper node with a database source: Locate the SQL field in the Mappings tab.
    • For a DataMapper node with a database sink: Click Sink and select Create table by executing DDL when you create a mapping.
    • For a container node with a database source: Locate the SQL field when you create an input mapping.
    • For a container node with a database sink: Click Sink and select Create table by executing DDL field when you create an output mapping.

  3. Select Shared Recipe File.

  4. Click the arrow to open the drop-down file list.
  5. Click Add File.
  6. In the Add File dialog:
    1. Provide a file name.
    2. Select the Upload Existing radio button.
    3. Drop or browse to add an external SQL file.
    4. Click Add.

Visual example in Automation

(Screenshot of the Node Editor)

Upload multiple files from the File Editor

You can upload all file types from the File Editor.

  1. Open the File Editor.
  2. Click Add Files.

  3. In the Add Files dialog:

    1. Select Upload Existing.

    2. Drop or browse to add one or more external files.

      Warning

      If there are duplicate file names, existing files will be overwritten by newer files (both within the dialog's file list and within the recipe).

    3. Optional. If uploading a single file, edit the file name.

      Note

      Bulk upload uses existing filenames. The system retains the original filenames when multiple files are uploaded at the same time.

  4. Optional. In the Folder field, select a target recipe folder for the new files.

    If you leave this field blank, the files will upload to the root of the recipe.

  5. Click Add.

  6. Select Add notes for changelog , describe the changes, then click Update.

Visual example in Observability

(Screenshot of the File Editor)

Upload one or more files in the CLI

Use the command line interface in your local environment to retrieve a kitchen and recipe, copy the files to the appropriate location in the /resources directory, then update the recipe.