The following properties are used by both Corticon Studio and Corticon Server.
Note: Common properties are stored as a set of defaults in the CcCommon.properties file that is packaged in the CcConfig.jar. Each property's notes, options, and default value are listed in this section. You should always set override values in brms.properties file located at your work directory root --or, in Studio, the preferred location specified in Preferences.
Important - Some properties in the CcCommon.properties file that were used to control logging -- logverbosity, com.corticon.logging.thirdparty.logger.class -- are no longer used. See the topic Changing logging configuration for more information.
logpath - The directory where logs are written. Default value is %CORTICON_WORK_DIR%/logs. Note: Use forward slashes as path separator, as in c:/Users/me/logs
loglevel - The depth of detail in standard logging. Value can be one of:
OFF - Turn off all logging
ERROR - Log only errors
WARN - Log all errors and warnings
INFO - Log all info, warnings and errors (Default value). Include all entry types in thelogFiltersAccept list.
DEBUG - Log all debug infomation and all messages applicable to INFO level. Includes all entry types in thelogFiltersAccept list.
TRACE - Equivalent to DEBUG with some tracing logs. Includes all entry types in thelogFiltersAccept list.
ALL - Maximum detail. Includes all entry types in thelogFiltersAccept list.
logDailyRollover - Specifies whether to rollover the logs on a daily basis. Default value is true.
logRolloverMaxHistory - Specifies the number of rollover logs to keep. Default value is 5.
logFiltersAccept - When the log level is set to INFO or higher, this property allows logging of items that are listed. The filter values that can be in the comma-separated list are:
RULETRACE - Records performance statistics on rules
DIAGNOSTIC - Records service performance diagnostics at a defined interval (default is 30 seconds).
TIMING - Records timing events.
INVOCATION - Records invocation events.
VIOLATION - Records exceptions.
INTERNAL - Records internal debug events
SYSTEM - Records low-level errors and fatal events.
The default logFiltersAccept setting is: DIAGNOSTIC,SYSTEM
The loglevel and logpath can be changed using following methods, which will override this setting.
Handles the default precision for Decimal values in Corticon Studio and Corticon Server . All Decimal values are rounded to the specified number of places to the right of the decimal point. Default is 6 (for example, 4.6056127 will be rounded, displayed, and/or returned as 4.605613).
Determines whether XML responses from Corticon Server include newOrModified attributes indicating which elements of the XML document are new or have been modified. This flag also impacts the generation of service contracts (XSD, WSDL). Setting the flag to false results in more mainstream XML messaging without the newOrModified attributes. Default value is false.
Determines whether the returning XML CorticonResponse document must be valid with respect to the generated XSD/WSDL file. Ensuring compliance may require dynamic sorting which, if necessary, will slow performance. Default value is true (ensure compliance and perform the sorting, if necessary).
The lenientDateTimeFormat sub-property does the following:
When false, forces all dateTime values to Zulu format which is the XML standard
When true, allow any dateTime format supported by Java to be used in the payload
Default for ensureComplianceWithServiceContract is true (sort)
Determines whether the Foundation APIs will perform automatic validation of assets when they are loaded. API-controlled validation can help improve performance by validating assets only when necessary. If this flag is set to true, the APIs will validate assets at load time if: ixia_locid="138">
New validation rules have been added to the APIs.
Related assets have been changed in a manner that justifies revalidation.
For example, if a Rulesheet's Vocabulary has been changed, the API will automatically revalidate the Rulesheet to ensure that all Rulesheet expressions are valid with respect to the Vocabulary changes.
If this flag is set to false, the APIs will not perform any validation when the asset is loaded; thus, the GUI is required to explicitly call the validate API during editor initialization. Default is true.
Control of cross-asset validation behavior. The default setting, false, causes cross-asset validation to occur immediately whenever any change is made. Consider an example where a Vocabulary Editor and three associated Rulesheet Editors are open simultaneously. If this setting is false, a Vocabulary update will cause the Rulesheets to revalidate themselves in real time. This dynamic validation provides instant feedback but carries a performance cost.
The alternative setting, true, causes cross-asset validation to be deferred until the associated editor is activated. In the prior example, a Vocabulary update will trigger only Vocabulary validation rules. Rulesheet Editors will not automatically revalidate themselves until they are activated. This setting can improve performance at the expense of immediate feedback.
Control of vocabulary validation behavior on delete. The default value true ensures that a vocabulary will be in a properly identified state after a delete operator is conducted. This may cause performance issues with very large vocabularies. Default value is true.
Determines whether foundation API method setSupportedLocales will automatically rearrange localizations, potentially changing the base locale of the asset.
The default setting (true) will cause the API to automatically swap localized values into the base slot if the base locale in the input array is different from the asset base language. This allows the client program to designate what was originally an added (non-base) locale as the new base locale of the asset; however, this setting also imposes a precondition: when setSupportedLocales is called, the asset must contain complete localizations for every localizable element, or the API will throw an exception. This precondition is imposed because the API contract always requires a base value for every localizable element; while localizations are optional, a base value must never be null.
If this flag is set to false, the system will allow the client program to indiscriminately change the set of supported locales without preconditions. In this mode, the system will arbitrarily update the asset's language legend and will remove any localizations while leaving the base values unchanged. While this ensures that API contract is not violated (because the base values remain unaffected), it puts the onus on the client program to manually update all base values and localizations to match the specified locale array; failure to do so may leave the language legend and localizations out of synch. Default is true.
Determines whether the Vocabulary API will use a hash map to speed up Vocabulary element lookups. This can improve Rulesheet parsing performance, particularly for applications with larger Vocabularies. Default is true.
List of Corticon Properties that will be used in the Checksum Calculations during the Post Load of the Models. This will help determine if we need to revalidate the Model.
Used in XML translation. Based on this setting, extra processing ensures that the incoming document's Enities, Attributes, and Associations match the namespaces defined in the Vocabulary. If the Vocabulary Entity or Attribute does not have an explicitly set namespace value, the Element's namespace must be the same as the namespace for the WorkDocuments Element. If the namespaces don't match, the Entity, Attribute, or Association will not be read into memory during execution. Also, if new Enitities, Attributes, or Associations are added to the XML because of rules, then explicitly set Vocabulary value will be used, otherwise the WorkDocument's namespace will be used. Default value is false.
Specifies whether the XSD and WSDL generators adds the usage attribute on the CorticonRequest and CorticonResponse definition. The "usage" is deprecated, and no longer used. However, to be backwards compatible with customers that have already generated proxies from older Schemas or WSDLs, the user now has the option to add the usage to the generated .xsd or .wsdl. Default value is false.
logpath - The directory where logs are written. Default value is %CORTICON_WORK_DIR%/logs. Note: Use forward slashes as path separator, as in c:/Users/me/logs