Create a Routing Rule

When a routing rule is evaluated, Mailbox searches the mailboxes defined in the rule for message names that match the pattern defined in the rule. When a match is found, the routing rule notifies the business process or contract specified in the routing rule.

About this task

Depending on how the business process is defined, it may extract and process the message, extract the message and pass it to another system for processing, or notify another system to extract and process the message.

If routing rules are set to be evaluated manually, they can be evaluated by a user or a business process.

Use the following procedure to create a routing rule:

Procedure

  1. From the Deployment menu, select Mailboxes and Routing Rules.
  2. In the Create section, click Go!
  3. Specify a Name for the routing rule. This name must be unique for each routing rule. It is used to identify the routing rule in other parts of Application.
  4. In the Rule Application page, select the Evaluation Mode:
    • Evaluate Manually - The rule must be evaluated manually or evaluated using a scheduled business process.
    • Evaluate Automatically - The rule is evaluated every minute.
  5. Select the Action Type:
    • Business Process - The rule notifies a business process when a match is found.
    • Contracts - The rule notifies a business process associated with a contract when a match is found.
  6. Click Next.
  7. In the Rule Pattern page, use the arrows to add the mailboxes to the Selected Mailboxes list.
    All groups in the Selected Mailboxes list are searched by the routing rule. Click the double arrow to add all available groups to the Selected Mailboxes list.
    Note: If you do not specify a mailbox within the routing rule configuration, then upon evaluation, the routing rule is evaluated against all mailboxes.
  8. Specify the Message Name Pattern and click Next.
    This is the message name or pattern that the routing rule searches for in the mailboxes specified. You can use an asterisk for a wildcard. You must specify a mailbox, a message name pattern, or both.
  9. In the Rule Action page, select the associated business process (or filter by name) and click Next.
  10. In the Run Rule as User page, select the user ID that is associated with the routing rule when it is run.
  11. In the Confirm page, verify the parameters and click Finish.
  12. When the system update is complete, click Return.