Poetic allows you to edit the content of the error messages that display throughout the system. You can change the language, text, and dynamic values of the error message. You can also create versions of the error message in other languages.
Within an error message, dynamic values (the numbers in braces) display specific text within an error message. For example, an error message may include the name of a company the user selected.
You manage error messages from the Search Error Messages page. To display the page :
Because of the sheer number of error messages, before you can select a message, you must specify search criteria.
You can search for errors based on:
From the Introduced dropdown, select Since, Equal, or Before to determine whether to include messages introduced since the specified build number, in the specified build number, or before the specified build number.
In the Build# field, type the build number.
For example, to include only messages added in build 1555:
After specifying the search criteria, click Search Error Messages.
The list of errors matching your criteria displays.
To edit an error, click its Edit link.
The Error Message Header page displays.
For Poetic errors, the information at the top of the Error Message Header page is not editable. For information on configuring custom errors, see Adding and editing custom error messages.
The table at the bottom of the Error Message Header page contains a list of the customized and localized versions of the error.
To edit the message, click the Edit link for the version of the message you want to edit.
The Error Message Maintenance page displays.
In the Error message content text box, edit the message text.
After you finish editing, click Save.
If the error message includes a number enclosed in braces, such as {0}, it means that the error message displays a specific value.
For example, in a message telling the user that they typed a duplicate company name, {0} is replaced by the actual company name the user typed.
For messages that can display multiple values, the first value is {0}, the second is {1}, and so on.
To ensure that the message remains as clear and helpful as possible, do not remove any of these values.
You can also include formatting in the error messages. The formatting uses HTML tags that use [] instead of <>. For example, to start a new paragraph in an error message, you would use [p] instead of <p>.
The allowed formatting includes:
[p] [/p] | Used to add a paragraph. |
[br] | Used to insert a line break. |
[ol] [/ol] | Used to add an ordered list to the message. |
[li] [/li] | Used to add a list item. |
[table] [/table] [tr] [/tr] [td] [/td] | Used to add a table to the message. |
[b] [/b] | Used to make text bold. |
You can also provide style information. When the message is displayed, Poetic converts the [] back to <> so that the HTML will be processed correctly.
Please note that Poetic changes all instances of [] to <>. When editing the message text, be careful to only use [] for HTML markup.
To create a version of the error message in a new language:
The Error Message Maintenance page displays.
To remove a version of the error message, click the Remove link for the version you want to remove.
Note that you cannot remove the default language version of the message.