Parameters
  • 23 Dec 2022
  • 2 Minutes to read
  • Dark
    Light

Parameters

  • Dark
    Light

Article summary

Parameter Usage

Parameters allow you to specify values through nodes in your flow that can easily change. Examples of this might be the database connection you choose to use for database nodes, or the name of a file which you plan to use in a flat file node.

Example

Here we are using a parameter for the database connection and the SQL Script. The parameters are named dev and TABLE_NAME respectively. To use a parameter in a field surround the name with two # characters as such ##PARAMETER_NAME##. To use a parameter in a database connection simple select it from the drop down (it will be prefixed with Parameter:)

using_parameters.png


Parameters Types

TypeDescriptionUsage
IntegerUsed to specify a number using the integer data type. This number cannot contain a decimal value.This parameter type might be used to specify the number of records to display within a SQL query.
FloatUsed to specify a number using the float data type. This number can contain decimal values.This parameter type might be used to specify a specific filter on values in a data set.
StringUsed to specify a text value using the string data type.This parameter type might be used to specify the name of a file or the name of a table in a SQL query.
Database ConnectionUsed to specify a database connection. This value can only be set to connections that are first added to the flow.This parameter type might be used on nodes that have database connections to allow for easy use between a development and production environment.

Supported Nodes

Node NameTypeSupported Fields
Flat FileSourceFile Name
DatabaseSourceDatabase Connection, SQL Script
ScriptSourceScript
DatabaseOutputDatabase Connection, SQL Script
Rest CommandOutputRequest URL, Body, Key, Value
ScriptOutputScript
SelectRowScript
Flat FileExportFile Name
DatabaseExportDatabase Connection, Table Name
DeriveColumnScript
FillerColumnScript
ScriptColumnScript

Adding a parameter

Open the Run Profiles menu and click on the Add button in the Parameters section.

run_profile_parameters.png

  1. Specify the Parameter name and type values and select OK.

add_new_parameter.png

  1. Click OK and be sure to click Save on the Run Profiles screen as well.

How to override a parameter

There are two ways to override a parameter. Currently you can create a new Run Profile and override the values for parameters when running as that Run Profile, or you can override parameters via the Rest API. Either method allows you to specify values that override those used in the selected Run Profile and they will default to the values in the Default Run Profile if not set.

Run Profile Override

Please see the Run Profiles documentation for details on Parameter Overrides using run profiles.

Rest API Override

Please see the REST API documentation for details on Parameter Overrides using the API.


Was this article helpful?

What's Next