Corticon Studio provides properties that specify property names and default values of user-configurable behaviors.

The settings file brms.properties is installed at the root of [CORTICON_WORK_DIR] for each Corticon Studio installation. If you install Corticon Studio and Corticon Server on one machine and accept the default colocating paths, one brms.properties file is installed to be shared by Studio and Server:



About the brms.properties file

  • It is good practice to back up the file before you start to make changes.
  • When installed separately, the Studio and Server brms.properties files are identical.
  • If you delete the file, it does not get re-created if you restart. However, because these are overrides to default properties, there is no loss of features or functionality when the file is not present.
  • In the absence of a brms.properties file, you can simply list the property settings in a text file, and then save it to its proper location as brms.properties.
  • An update of the installation preserves a modified brms.properties file, and adds the default file if none is present.

Enabling settings listed in the default brms.properties file

The file lists properties that users commonly want to change. Each group of properties provides descriptive comments and the commented default name=value pair.

To specify a preferred value for a listed property, edit the file, remove the# tag from the beginning of a property's line, and then add your preferred value after the equals sign (=). For example, to express a preference for decimal values displayed and rounded to two places instead of the six places preset for this property, locate the line: 
#decimalscale=6
Change the line to: 
decimalscale=2

Add unlisted settings to brms.properties file

Some locations in the documentation tell you about other property settings that you might want to add to the settings file. Or, you might be directed by technical support or your Progress representative to add or change settings to provide certain behaviors or functions.
For example, to change the interval of diagnostic readings from five minutes to two minutes, add the following line to the brms.properties file—it does not matter where in the file as long as it is on a separate line: 
com.corticon.server.DiagnosticWaitTime=120000
If you add the same property more than once in the settings file, the last instance takes precedence.

Save and apply the revised Studio property settings

When your changes are complete, you can choose to save the settings file with its default name and location, but you could save a copy with a useful name, such as debuggingLogSettingsbrms.properties.

In Studio, you can save multiple settings files, and then use Studio's Preferences to specify the Override Properties File for the brms.properties file to use, as shown:


Note: The overrides and license specified are stored in the Studio Workspace. If you change the Workspace, then those overrides or defaults take effect.

For the revised settings to take effect, save the edited file, and then restart the Corticon Studio.

Note: Property settings you list in your brms.properties file replace the corresponding properties that have default settings. They do not append to an existing list. For example, if you want to add a new DateTime mask to the built-in list, be sure to include all the masks you intend to use, not just the new one. If your brms.properties file contains only the new mask, then it is the only mask that Corticon uses.

The following properties are settings you can apply to your Corticon Studio installation by adding the properties and appropriate values as lines in its brms.properties file, and then restarting Studio.

GENERAL

Decimal scale sets the default precision for Decimal values. All Decimal values are rounded to the specified number of decimal places. The default value is 6. For example, 4.6059556 is rounded, displayed, and returned as 4.605957. In the brms.properties file, set the Studio Test's decimal scale: 
decimalscale=2
When the Decimal scale is set to 2, the rounded value is 4.61.

------------------------------------------------------------

To property sets the default character encoding for objects, such as Vocabulary, Rulesheet, and Ruletest XML files. Examples: UTF-8, UTF-16, ISO-8859-1, US-ASCII. Default value is UTF-8.

 com.corticon.encoding.standard=UTF-8

RULESHEETS

Specifies the number of rows that are added to the end of a Rulesheet section when Rulesheet > Add Rows to End is selected from the Corticon Studio menubar or popup menu. Default is 10.

com.corticon.designer.corticon.insertrowstoend=10

------------------------------------------------------------

Specifies the number of columns that are added to the end of a Rulesheet section when Rulesheet > Add Columns to End is selected from the Corticon Studio menubar or popup menu. Default is 10.

com.corticon.designer.corticon.insertcolumnstoend=10

------------------------------------------------------------

When there are any null attributes on the right hand side of a clone assignment expression, the assignment does not occur because it will not override the cloned value. If the null result is preferred, add this property set to true so that the null checks are removed. Be aware that using this setting on a Studio machine should be applied on any other machine that will work on a related project, and that Decision Services created when the property is true have the setting embedded in the Decision Service. Default is false.

com.corticon.reactor.rulebuilder.DisableNullCheckingOnClone=false

------------------------------------------------------------

RULETESTS

Specifies how the Rule Messages are displayed in the Tester after execution based on the data in the columns. The options are ExecutionOrder, Severity, and Entity. Default value is ExecutionOrder.

com.corticon.tester.result.messages.sorting=ExecutionOrder

-----------------------------------------------------------------------------

Option to specify how many variable substitutions could be applied to an ADC PreparedStatement. The restriction on how many PreparedStatement variables is controlled by the Database Driver. Different Databases have different maximums.

Default value is 1000

com.corticon.server.adc.preparedstatements.maxvariables=1000

-------------------------------------------------------------------------------

Specifies whether String attribute values should be trimmed in the Tester Expected tree. When set to false, suppresses trimming of leading and trailing whitespaces.

Default value is true.

com.corticon.tester.trimstringvalues=true

-------------------------------------------------------------------------------

By default, Corticon Studio uses the Corticon Server’s REST API to run ruletests against a remote server. You can change this property to use the SOAP API by setting the following property to XML. Note that setting this property to XML will disable the Rule Trace Viewer. Default value is JSON:
com.corticon.tester.ccserver.execute.format=JSON
-------------------------------------------------------------------------------

When using the SOAP API and testing against an IIS server you also need to set this property for Corticon Studio (Default value is JAVA): 

com.corticon.studio.client.soap.clienttype=IIS

-------------------------------------------------------------------------------

Sets the Studio Test's XML messaging style:Hier (hierarchical), Flat, or AutodetectDefault value is Hier.

com.corticon.designer.tester.xmlmessagingstyle=Hier

RULEFLOWS: Packaging

Corticon Studio uses the following properties when compiling assets into a Decision Service through the “Package and Deploy” wizard. (Corticon Server utilities also use these properties when compiling a Decision Service.)

-------------------------------------------------------------------------------

Compile option: This property lets you configure memory settings for compiling the Rule Assets into an EDS file.

Default value is -Xms256m -Xmx1g

com.corticon.ccserver.compile.memorysettings=-Xms256m -Xmx1g

-------------------------------------------------------------------------------

Compile option: Add the Rule Asset's Report to the compiled EDS file. By having the Report inside the EDS file, any user can get the report for a deployed Decision Service through an in-process or a SOAP call to the Corticon Server. Including the Report in the EDS file will increase the EDS file significantly.

Default value is false

com.corticon.server.compile.add.report=true

-------------------------------------------------------------------------------

Compile option: Add the Rule Asset's WSDL to the compiled EDS file. By having the WSDL inside the EDS file, any user can get the WSDL for a deployed Decision Service through an in-process or a SOAP call to the Corticon Server. Including the WSDL in the EDS file will increase the EDS file significantly.

Default value is false

com.corticon.server.compile.add.wsdl=true
Note: In prior releases, the default action was to automatically produce the WSDL and reports to add to the EDS. Given the techniques to produce WSDL and reports without having them in the EDS, the option to suppress the WSDL and reports in packaging unless explicitly requested, results in smaller packages and better compilation performance.
-------------------------------------------------------------------------------

GRAPHIC VISUALIZER

Sets the font type and size used by the Graphic Visualizer. Default values are Helvetica-Narrow.ttc and 9, respectively.

com.corticon.crml.CrmlGraphVisualizer.fontname=Helvetica-Narrow.ttc
com.corticon.crml.CrmlGraphVisualizer.fontname.ja=msgothic.ttc
com.corticon.crml.CrmlGraphVisualizer.fontsize=9