> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Generic parameters
> Generic parameters are variables or settings that are used to control the behavior of a software application or system. These parameters are designed to be flexible and adaptable, allowing users to customize the software to their specific needs.
Through the **FlowX Designer**, you can create, edit, import, or export these generic parameters. You can also assign the relevant environment(s) to these parameters, ensuring they are applied exactly where they are needed.
Generic parameters can be defined and used in many scenarios. Here are a few examples of useful generic parameters:
| Parameter | Description |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **baseURL** | This parameter can be used to define the base URL of an API or website, which can be utilized across multiple environments |
| **redirectURL** | This parameter can be used to define the URL to which a user should be redirected after completing a certain action or process. This can save time and effort by avoiding the need to hardcode multiple redirect URLs. |
| **envFilePath** | This parameter can be used to define the path of the environment file that stores a document uploaded |
To add a new generic parameter, follow the next steps:
1. Go to **FlowX Designer** and select the **General Settings** tab.
2. Select **Generic Parameters** from the list.
3. Click **New parameter**.
4. Fill in the details.
5. Click **Save**.
## Configuring a generic parameter
To configure a generic parameter you need to fill in the following details:
* **Key** - the key that will be used in a process to call the generic parameter
* **Value** - the value that will replace the key depending on the defined parameters
* **Environment** - set the environment where you want to use the generic parameter (❗️leave empty to apply to all environments)
* **Add a new value** - to add a new value for the same key but for a different environment
For example, if you want to set a `baseURL` generic parameter (the URL will be different, depending on the environmaent).
## Using generic parameters
### Use case
Imagine that you need to create a process in which you need to upload an image or a document. We will define a generic parameter called `envfilePath` that will represent the path where the document/image will be uploaded.
The minimum requirement to build an upload doc/image process:
* a start node
* a task node
* a user task node
* an end node
### Configuring the task node
Set a **business rule** action on the task node with the following properties:
#### Action Edit
* **Name** - used internally to make a distinction between different actions on nodes in the process - example *getGenericParameters*
* **Order** - if multiple actions are defined on the same node, the running order should be set using this option
* **Action type** - should be set to **Business Rule**
* **Trigger type** - Automatic - choose if this action should be triggered automatically (when the process flow reaches this step)
* **Required type** - automatic actions can only be defined as mandatory
#### Parameters
* **Language** - we will choose **MVEL** for this business rule example
* **Message body** - MVEL expression
```java theme={"dark"}
output.put("envfilePath", additionalData.applicationConfiguration.get("envfilePath"));
```
This MVEL business rule assigns a value to a key, `envFilePath` (our defined generic parameter) in the "output" map object. The value assigned to the key is retrieved from another object, `additionalData.applicationConfiguration`, using the "get" method and passing the key `envFilePath` as the parameter.
In other words, this rule extracts the value of the `envFilePath` generic parameter from the `additionalData.applicationConfiguration` object and assigns it to the `envFilePath` key in the "output" map object.
It is important to note that the `additionalData.applicationConfiguration` object and the "output" map object must be previously defined and accessible in the current context for this rule to work.
### Configuring the user task node
On this node we will define the following:
* an Upload File action with two child actions:
* a Business Rule
* a Send data to user interface action
Child actions can be marked as callbacks to be run after a reply from an external system is received. They will need to be set when defining the interaction with the external system (the Kafka send action).
For example, a callback function might be used to handle a user's interaction with a web page, such as upload a file. When the user performs the action, the callback function is executed, allowing the web application to respond appropriately.
#### Configuring Upload file action
Set an Upload file action on the task node with the following properties:
##### Action Edit
* **Name** - *uploadDocument*
* **Order** - if multiple actions are defined on the same node, the running order should be set using this option
* **Action type** - should be set to **Upload File**
* **Trigger type** - manually (triggered by the user)
* **Required type** - optional
* Repeatable - yes - should be checked if the action can be triggered multiple times
* **Autorun Children** - when this is switched on, the child actions (the ones defined as mandatory and automatic) will run immediately after the execution of the parent action is finalized
##### Parameters
* **Address** - the Kafka topic where the file will be posted - `ai.flowx.in.devmain.document.persist.v1`
In this example we used an environment called `devmain`, topic naming convention is different depending on what environment you are working.
* **Document Type** - other metadata that can be set (useful for the document plugin) - example: `BULK`
* **Folder** - allows you to configure a value by which the file will be identified in the future - example: `1234_${processInstanceId}`
* **Advanced configuration (Show headers)** - this represents a JSON value that will be sent on the headers of the Kafka message
```json theme={"dark"}
{"processInstanceId": ${processInstanceId}, "destinationId": "Upload document", "callbacksForAction": "uploadDocument"}
```
* `callbacksForAction` - the value of this key is a string that specifies a callback action associated with the `Upload document` destination ID (node). This is part of an event-driven system (Kafka send action) where this callback will be called once the `uploadDocument` action is completed.
#### Configuring Business rule action
```java theme={"dark"}
envfilePath = input.?envfilePath;
uploadedDocument = input.?uploadedDocument;
if(uploadedDocument.?downloadPath != null && uploadedDocument.?downloadPath != ""){
filePath = envfilePath + uploadedDocument.?downloadPath;
uploadedDocument.filePath = filePath;
output.put("uploadedDocument", uploadedDocument);
}
```
1. The business rule is expecting two inputs: `envfilePath` and `uploadedDocument`.
2. It is checking if the `downloadPath` property of the `uploadedDocument` input is not null and not an empty string. If it's not, then it proceeds to the next steps.
3. It concatenates the `envfilePath` and the `downloadPath` to form the full file path (filePath) where the uploaded document is expected to be located.
4. It updates the `uploadedDocument` input by adding a new property called `filePath` with the value of `filePath`.
5. It puts the updated `uploadedDocument` object into the output object as a key-value pair, with the key being "uploadedDocument".
In summary, the code seems to be processing an uploaded document by checking its download path, constructing a full file path, and updating the document object with the new file path. Finally, it outputs the updated document object.
#### Configuring a Send data to user interface action
```json theme={"dark"}
{"uploadedDocument":
{
"filePath": "${uploadedDocument.filePath}"
}
}
```
* `filePath`: This is a key in the object which holds the value `${uploadedDocument.filePath}`. The syntax `${...}` suggests that it's a variable placeholder that will be replaced with the actual value at runtime.
After configuring all the nodes and parameters, run the process:
## Related topics
- [Configuration and migration guide](/release-notes/v4.x/v4.6.x/v4.6.0-january-2025/migrating-from-v4.1.x-to-v4.6.0/process-configuration.md)
- [FlowX.AI 5.3.0 Release Notes](/release-notes/v5.x/v5.3.0-december-2025/v5.3.0-december-2025.md)
- [FlowX.AI 5.7.0 Release Notes](/release-notes/v5.x/v5.7.0-april-2026/v5.7.0-april-2026.md)
- [FlowX.AI 5.8.0 Release Notes](/release-notes/v5.x/v5.8.0-may-2026/v5.8.0-may-2026.md)
- [FlowX.AI 5.5.0 Release Notes](/release-notes/v5.x/v5.5.0-february-2026/v5.5.0-february-2026.md)