Skip to main content
Version: Latest (4.59.0)

Configuration

Flow Configuration

Flow configuration is done using variables. This section explains how to create them, how they work and how to use them to configure flows.

Variable scoping​

Flow variables Flow variables are accessible throughout components within the same flow. If a percentage sign is part of the string and not meant to reference a variable, it can be escaped with a backslash. If a backslash in front of a percentage sign is part of the string, the backslash itself can be escaped as well.

Example of escaping characters

something%Variable%Something = somethingValueSomething

something\%Variable\%Something = something%Variable%Something

something\\\%Variable\%Something = something\%Variable%Something

something\\%Variable%Something = something\ValueSomething

Environment variables Environment variables are accessible directly from within components or through referencing them within flow variables. To reference a variable, use the variable syntax (%variableName%).

Project environment secrets and variables Project environment secrets and variables are accessible directly from within components. To reference a project environment secret or variable, use the variable syntax (%variableName%). Please refer to the project environment overview for more information.

Scope consideration​

  • Create flow variables for values that are commonly used within a flow.
  • Use environment variables for storing sensitive information.

Variable management​

The image below shows the variable management window.

From this menu different configurations can be created, each one holding different variables. Only one configuration can be active at a time.

To create a new variable, select the configuration you want to modify and then click Create new.

Enter a key (the name of the variable) and the value.

Make sure to click the save button to save the variable before hitting submit.

To access an existing variable click on its key or value. The variable will expand and can be edited or deleted from here.

  Variables

mongoConnectionTarget%XILL4_DATABASE_CONNECTION_EXPORT%
fileNetDBConnection%filenet_connectionString%
fileNetDBSchemaNameXILLIODEV3
fileNetDBEngineDb2
retrieveAnnotationstrue
originFileNet

Using variables​

To access variables from within components use the variable syntax (%variableName%).

note

Variables don't have any types and it is up to the component to parse them into a certain type before usage.

Example using variables​

The image below shows an example of variables being used in a component configuration.

It also shows a variable being used as part of an array. To make this work, the value of the variable must contain a comma-separated list using the following syntax "value1", "value2".

  Configuration: Document Retrieve

General