Define message attributes

Attributes are used for setting up conditions for message actions. For information about message actions and default attributes, see Define message actions.

Use the following procedure to define message attributes:

Note   Multiple attribute definitions for a single attribute: If you add multiple message attribute definitions that have criteria for the same attribute, the definitions are all applied in the order in which they are listed in the user interface. This means that the last listed definition is the last one applied, and is the one that provides the value for the attribute.
  1. In the navigation graphic, click the Message Handler icon.
  2. Click the Manage message attributes link.
  1. Click Add a new message attribute definition with criteria.
  2. Select an attribute from the drop-down list and click Next.
  3. If the attribute you want to add is not listed, click Add attribute, select an attribute and click Next or Add followed by Next.
  4. Alternately, you can type the name of your own custom attribute. Click Add attribute, select the name field, type the name and click Add and Next.
  5. If adding a custom attribute, follow these guidelines: Make attribute names a single text string. For names that use multiple words, do not use spaces between the words. Use camel case for names that include two or more words (for example, AttributeName). Avoid using non-alphanumeric characters in attribute names (for example, commas, periods, asterisks, ampersands and so on).
  • TIP: Include a prefix for the custom attribute name to make it easy to identify as a user-defined attribute. For example, you could use a company name as the prefix (CompanyAttributeName).
    1. (Optional) Enter a Friendly name for the attribute. This name is displayed in the user interface.
    2. (Optional) Select Change attribute name, choose a name from the list and click Add. The Change attribute name option lets you make an on-the-fly decision to define a different attribute. For example, on the first wizard page you select the SenderRoutingId attribute and click Next. However, then you decide you want to instead define the ReceiverRoutingId attribute. Rather than click Cancel and start over, select Change attribute name and select the ReceiverRoutingId attribute.
    3. On the Source tab, the presumption is the attribute value is attached to the message (for example, contained in a message header or added with an in-line processing action). That is the meaning of The value comes from an external source option.
    4. Alternately, you can define a value for the attribute, whether by parsing an XML document or setting a constant (fixed) value.
    5. Note: If you select The value comes from an external source, you must add at least one condition. Otherwise, Activator does not add the definition. It does, however, add the attribute to the list at System management > Manage message attributes.
    6. On the Conditions tab, set up one or more conditions for the attribute. Although optional, without at least one condition Activator tries to parse all messages or apply the fixed value. See Set up message-processing actions.
    7. Click Save changes to keep your change.

    Related topic

    Related Links