Create and Edit Messages

You can create messages or edit the predefined messages stored in the message dictionary.

Creating a Message

To create a message, perform the following steps:

1. In the Setup and Maintenance work area, go to the Manage Messages task.

2. On the Manage Messages page, click the New icon.

3. On the Create Message page, enter details in each section.

4. In the Message Properties section, do these.

   1. Enter a unique message name that helps you find the messages you create and avoid name conflicts with predefined messages. Use underscore as a separator if the name contains multiple parts.

   2. Select the application and module to associate the message with.

   3. Enter a unique number that can be used as an identifier for the message. Users can quote this number when they contact the help desk for assistance.

      Note: You can use any number between 10,000,000 and 10,999,999. This number range is allocated for the messages you create. At runtime, this number appears along with the application code after the message text, for example FND-2774.

   4. In the Translation Notes field, enter a description of the message indicating its use.

   5. Select the relevant message type, category, and severity.

   6. Select the Logging Enabled check box to create incidents or logs when messages appear on the UI.

5. In the Message Text section, do these.

   1. In the Short Text field, provide the actual message text that appears on the page at runtime.

      The short text can include tokens that are placeholders for displaying dynamic values at runtime. However, to support easy translation, keep the message length (including values of tokens) within 160 characters in American English.

   2. In the User Details field, enter information for the users to know why the message appeared. You can also include information for the users to resolve the issue themselves.

      If your Short Text component has tokens that expand the text beyond the 160-character limit, move that portion of text here.

   3. In the Administrator Details field, provide a detailed technical explanation of the message. This field is only visible to the help desk.

   4. In the Cause field, provide a concise explanation of why the message appears. This text is visible to the users.

      This information is optional and is only applicable to messages of type Error and Warning. However, if you mention the cause, you must mention in the User Action field the action that users must take.

   5. In the User Action field, enter the user action to guide the users with steps to respond to the message and complete the task.

   6. In the Administrator Action field, provide information that the help desk can use to resolve the problem.

6. In the Message Tokens section, define tokens that you want to use in this message.

7. Click Save and Close.

Editing a Message

You can edit a predefined message or a message that you created.

To edit a message, search for a message on the Manage Messages page and perform the following steps:

1. Select the existing message and click the Edit icon.

2. On the Edit Message page, modify the existing details according to the instructions provided in the Creating a Message procedure.

   Note: Don't edit the message number for predefined messages.

3. Click Save and Close.

While creating and editing messages, you can translate the message details to the preferred languages without changing the language session of the application. To specify the translations in all the enabled language rows, use the Translation Editor option. Once the updates are made, users can view the translated text for the specific details.