RulesEngine.TranslateMessage

Allows an external component connecting to the Rules Engine in a non-interactive setting (that is, through a programmatic call not involving a human interface) to make use of USoft's localisation/translation capabilities.

External components generate their own log information and error messages. These messages are often hard-coded in the component and by default do not take advantage of USoft's translation capability. The TranslateMessage method offers translated messages in this setting.

Returns a USoft-defined or user-defined message text translated into the runtime language if a translation in that language is available for the message.

Syntax

SELECT RulesEngine.MessageLanguage (

category

, name

[, parameter ... ]

)

The required category is the category that the message belongs to, as specified in the System Messages record for the message. The required name is the logical name of the message as specified in the System Messages record for the message. Name is unique within the message category.

Parameters are required for messages that have defined parameters. The number of parameters required in the calling statement must be equal to the number of parameters defined for the system message. Parameter values in the call are assigned to defined parameters by position. The position is indicated by the Seqno attribute of the defined parameters.

Example

INVOKE RulesEngine.TranslateMessage WITH

SELECT 'Frequent End User Msg'

, 'COMMIT'

, '15'

This results in the information message: "15 record(s) committed" or, if Dutch is set as the runtime language, in the information message "15 rijen opgeslagen".