How can I customize the error messages displayed in the user interface of Service Catalog?

Document ID:  TEC1907979
Last Modified Date:  10/13/2017
{{active ? 'Hide' : 'Show'}} Technical Document Details

Products

  • CA Service Catalog

Releases

  • CA Service Catalog:Release:14.1
  • CA Service Catalog:Release:17.0

Components

  • CA SERVICE CATALOG:USVCT
Introduction:

Sometimes you may like to customize the user interface, to make the generic messages for the attachment file size error more relevant to their site, for example. This document provides information on how to accomplish this.

Instructions:

Default text displayed to the users in the UI is stored in the XML files found under the folder structure

USM_HOME\view\webapps\usm\locale\<locale_id>

Where <locale_id> is the language requested by the browser - icusen for English, icsesv for Swedish, etc. If you're making changes for more than one language, you'll want to ensure all those that you handle for are updated.

Next, you'll want to find the file that contains the string you're interested in changing - for our example of an attachment error, it's "error.xml" so we'll open that. In it, the relevant lines for file size problems are:

    <error_filesize1>The uploading file size of </error_filesize1>
    <error_filesize2> exceeds limit of </error_filesize2>
    <error_filesize3>. Please reconfig the size in the config.properties.</error_filesize3>   

As you can see, it's split into three parts, where the actual values of the file size and the limit would be inserted by the application.

However, it is generally considered poor practice to edit this file directly. If you do, it's both hard to track which files you've customized, and you run the risk of losing those changes if they get overwritten during the application of a patch. Instead, copy the file to the equivalent folder in your File Store. This location will vary from installation to installation, as it is common practice to move it to a common server if you have multiple View servers configured, for example. You'll find the correct root set in the user interface, at

Administration > Configuration > File Store Information > File Store Location

Once you have that root, you'd copy this example file from

USM_HOME\view\webapps\usm\locale\icusen\error.xml

to the filestore in

filestore\custom\locale\icusen\error.xml

Once it is there, you'll be able to change the text to the custom message you need.

Additional Information:

Please help us improve!

Will this information enable you to resolve your issue?

Please tell us what we can do better.

{{feedbackText.length ? feedbackText.length : '0'}}/255

{{status}}

Not what you were looking for?

Search Again >

Product Information

Support by Product >

Communities

Join a Community >