Package Settings

◷ Reading Time: 6 minutes

If you want to pass parameter values to a package without adding them as an input or local parameter, you can use the package settings.

For example, if you want to add a password that you don’t want to be passed as an input or hard-code in the project as a local parameter, you can define it as a setting value.

Properties

  • Parameter Name: Name of the parameter that holds the settings
  • Name: Name of the setting
  • Value: Value of the setting

Make sure to Save after adding new settings to the package.

How to Set Package Settings

Let’s see how you can add a connection string of a database as a setting.

1. In your project, add an Input parameter called Settings.

You can use any name (i.e. config, constants) although we used the name Settings by default.

Note that the settings parameter must be an input parameter.

Variable definition modal in FlexRule designer showing how to add a variable for settings

2. Add Settings.ConnectionString as the connection string.

You can add any name under Settings although we used the name ConnectionString.

There is no need to define the parameter name ConnectionString or Settings.ConnectionString in the designer project.

Variable definition modal in FlexRule designer showing how to add a database connection string as a setting

3. Then deploy your package in the FlexRule server workbench.

4. Click on Settings under the package Actions column.

5. Add these Settings values.

  • Parameter Name: Settings
  • Name: ConnectionString
  • Value: <connection string to your database>
    Data Source=.SqlExpress01;Initial Catalog=customer;Trusted_Connection=True

6. Click on Add New Setting

7. Once you add all the settings, click on Update to save the added settings.

8. Now run the service without adding Settings as an input parameter. In this example, we don’t have any other input parameters. Therefore, we pass an empty array [].

If you pass the Setting as an input, it will automatically replace the input Settings with the Package settings.
[
{
Name: "Settings",
Value: null
}
]

9. Now, if you test run the project, you will see the settings have been assigned during runtime.

How to Test Settings in FlexRule Designer

You can test the Settings in FlexRule Designer before publishing it to the server. This will ensure that the setting values are correct.

  1. Click on Debug with JSON Composer.
FlexRule Designer view showing the Debug with JSON composer button selected

2. Go to Text Mode

FlexRule Designer view showing the Text Mode option selected

3. Edit the Settings parameter to add Connection String value and click OK (Note that in the string should be replaced with \ in the Designer).

FlexRule Designer view showing the Text Mode edit of the settings

You will be able to see the output in the Parameter window.

FlexRule Designer view showing the Parameters view

Setting Values as a Fact Concept

Additionally, if you have multiple settings, you can set the settings as a Fact Concept.

FlexRule Designer Fact Concept view for the settings

You can reference the settings from the fact concept as an input parameter.

FlexRule Designer view showing the Variable definition modal

Download Sample Project

The downloadable sample project is attached at the end of the page.

  • To create the database, you can use the script, script.sql inside the folder.
Updated on February 18, 2026

Article Attachments

Was this article helpful?

Related Articles