Object Name

Specify the name of the message object. This Object Name is used, along with the Message Type, as the key that the application uses to find and display the message. Therefore, the combination of Object Name and Message Type must be unique.

  • If the message name refers to a base message (that is, a message that could be used globally), then we recommend that you use object names that start with one of these designations:
    • E= (error)
    • I= (informational)
    • Q= (question, as a multi-button prompt)
    • W= (warning)

    If you use these naming conventions, the system can automatically display the appropriate icon when the message is displayed.

  • If the message name refers to a table or column where translated text resides, use an object name that starts with @, followed by either of these values:
    • tableName: Name of the table
    • tableName.columnName: Name of the table where the column resides, followed by a period and the name of the column
  • If the message name is translated text that does not map to a specific object, use an object name that starts with @!
  • If the message is a list item pair (that is, a property class name and its value), use an object name that starts with @: followed by the property class name, another colon, and the value.

    For example, if several application database tables include a Status column, and each is associated in the IDO layer with a property class called CoStatus (for Customer Order Status), then a list item pair allows you to retrieve the translatable text that relates to a given customer order status value. Thus, the list item pair object message name @:CoStatus:C could reference a translatable string value of "Complete" for a status value of "C".

  • If the message refers to a constraint (Message Type 17) or the deletion of a constraint (Message Type 18), the object name must match a database constraint name; for example, ApplicationMessagesIx0 or apparmsFk1.  Then, if the IDO framework layer catches a database constraint exception, the framework performs a message table lookup for ObjectName = ConstraintName and MessageType.