Package Settings

Contents

◷ Reading Time: 5 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.

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.

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 Updaate 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.

Click on Debug with JSON Composer.

2. Go to Text Mode

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