Modifying or suppressing error messages

How to modify or suppress error messages displayed by the arcplan / Longview Analytics Clients

For the user error messages displayed by the arcplan / Longview Analytics Clients on the client computer are sometimes difficult to understand for the following reasons:

The error message consists of technical text or even only error codes.

The error message is displayed in a language that the user does not understand.

In rare cases it may be even necessary to suppress an error message.

This is why Longview offers the possibility to modify the text of an error message matching a specified search pattern or even suppress its display completely. This applies to error messages being sent from the Server to the Client.

The search pattern and the new message text have to be specified in the file "Langpack.xml" which is located in the following paths:

Windows 7, 2008 Server and newer operating systems:

C:\Users\All Users\arcplan\8\arcDesigner\

or c:\ProgramData\Longview\10\Analytics\arcDesigner\

C:\ProgramData\arcplan\8\arcServer\Settings\

or c:\ProgramData\Longview\10\Analytics\arcServer\Settings\

The file is loaded when the Application Server is started.

For every message to be replaced or suppressed completely a <replace> element has to be inserted manually into the "Langpack.xml" according to the following example:

<errormessages >

…

<replace type="all" lang="en" id="1">

<pattern>*Login not successful*</pattern>

<text>Please enter a valid user name and password.</text>

</replace>

</errormessages >

The <replace> element can have the following attributes:

type can have the values "all" or "part". This attribute is optional. Its default value is "all".

"all": The complete message text is replaced.

"part": Only the text matching the search pattern is replaced.

lang can have the values "de" or "en".

This attribute is optional. If it is not used, replacements are performed regardless the language.

id specifies a unique numeric text id. This text id is displayed in square brackets in front of the message text.

The <pattern> element specifies the search pattern.

The wildcard characters "*" (any zero or more characters) and "?" (any single character) can be used.

The <text> element specifies the new text which is to replace the old text.

Here also wildcard characters can be used.

If only parts of the message are to be replaced, the wildcards have to be set identically in the <pattern> and the <text> element.

Example:

<pattern>*old1?old2*old3</pattern>

<text>*new1?new2*new3</text>

If the <text> is empty, the message will be suppressed and not displayed.

Program execution will continue as if the user had confirmed the message by clicking "OK".

Please note: Any changes made to the file will require a re-start of the arcplan / Longview Analytics service, for the changes to take effect.