Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version next

D toc

Excerpt

You can define parameters that are applicable across the entire project or workspace environment.

An environment parameter is a variable of String type defined by an administrator that any user of the environment can reference in their flows and flow-related objects.

Info

NOTE: You must be a project owner or workspace administrator to manage environment parameters.

For more information on parameters, see Overview of Parameterization.

Create Environment Parameter

Steps:

  1. A project owner or workspace administrator can select User menu > Admin console > Environment parameters.
  2. In the Environment Parameters page, click Create.
  3. Specify the parameter:
    1. Name: Enter the display name for the parameter.

      Info

      NOTE: All environment parameter names are automatically prepended with env..

    2. Default value: Enter the default value. 

      Info

      NOTE: The default value is stored as a String value.

  4. To create another environment parameter, click Add another.
  5. To save your changes, click Save.

Use Environment Parameter

Environment parameters can be referenced in the following locations:

Tip

Tip: When specifying a variable, enter $env to see the list of available environment parameters.

Limitations

  • You cannot use environment parameters in recipes.
  • You cannot use environment parameters in plans.
  • Environment parameter names must be unique within the project or workspace. You can apply override values to them at runtime. 

Edit Environment Parameter Value

Administrators can change the default value for an environment parameter.

Info

NOTE: Modifying the default value of an environment parameter immediately applies the change across the entire environment. All subsequent job and plan runs are affected.


Info

NOTE: After you have created an environment parameter, you cannot change the name. You must create a new environment parameter.

Steps:

  1. In the Environment Parameters page, locate the parameter whose default value you wish to modify. 
  2. In the More menu, select Edit value.
  3. Enter a new value, and click Save.

Delete Environment Parameter

Warning

When you delete an environment parameter, all references to the parameter are converted to empty string values. Job executions can fail, and recipe steps can break.


Tip

Tip: If you delete an environment parameter and then recreate it using the exact same name, references to the parameter are updated with the new default value, which replaces the empty string value for the deleted parameter.

Steps:

  1. In the Environment Parameters page, locate the parameter whose default value you wish to modify. 
  2. In the More menu, select Delete.

Export Environment Parameters

You can export the environment parameters from your project or workspace. 

Info

NOTE: All environment parameters are exported at the same time into a ZIP file. Do not modify this file outside of the

D s webapp
.

Steps:

  1. In the Environment Parameters page, select More menu > Export.
  2. The ZIP file is downloaded to your local desktop.

Import Environment Parameters

If you have exported a set of environment parameters, you can import them into another workspace or project. 

Info

NOTE: If an environment parameter that you are importing has a name that conflicts with an environment parameter that already exists, you must either rename the imported parameter or delete it from the import set.

Steps:

  1. In the Environment Parameters page, select More menu > Import.
  2. Select or drag-and-drop the ZIP file. Click Import.

    Info

    NOTE: Select the ZIP file or its embedded JSON5 file for import.

  3. The Import environment parameters dialog is displayed:


    D caption
    Import environment parameters dialog
  4. Review each environment variable and its assigned value from the import package:

    1. Modify values as needed.

    2. To delete a parameter from the import process, click the Trash icon.
    3. To add another parameter as part of the import package, click Add another.

  5. To save your changes and complete the import, click Save.

  6. The environment parameters and your modifications to them are imported.

D s also
inCQLtrue
label(label = "parameter_ui")