Show TOC

Configuring Matching RulesLocate this document in the navigation structure

Define the parameters and matching rules that determine whether an e-mail message is a regular e-mail, or a Hybrid App e-mail at runtime.


The developer must have created an object query and added an E-mail Subscription starting point when the Hybrid App was designed.


When a multiplexer, which a user configures for a Notification mailbox, retrieves e-mails from the e-mail server, the "Matching rules" are used to determine if an e-mail is a regular e-mail or a Hybrid App e-mail. If the "matching rules" match, then the e-mail is processed as a Hybrid App e-mail. The e-mail is processed for "Extraction rules" (this processing is not visible in SAP Control Center) to extract values from the e-mail. This determines further processing, such as calling MBO object queries, and so forth. Then, a Hybrid App message is constructed with the necessary data of the object query result, and sent to device(s) according to the "Distribution rules" (which determine the devices to which the message should be sent).

You can configure a matching rule at one of two levels:
  • At the inbox level to route e-mails for all Hybrid Apps
  • At the package level to route e-mails only for a specific Hybrid App


  1. In the left navigation pane, click Start of the navigation path Hybrid Apps Next navigation step <Application Name> End of the navigation path.
  2. In the right administration pane, click the Matching Rules tab.
  3. Configure matching rules by either:
    • Clicking New to create a new rule, or,
    • Selecting an existing rule name and clicking Properties.
  4. In the Matching Rules dialog:
    1. Select the field in the e-mail from which the parameter value is extracted. For example, if you choose From, the parameter value is extracted from the line of the e-mail message that indicates the name of the sender of the message.
      You can also select one of the custom parameter values. When registering Hybrid App devices, an administrator can choose one of four device settings. The customer then populates the settings with whatever values they like. Custom parameters can also be set programmatically through Web services.
      Note If you are editing properties of a rule created by a developer, you cannot modify the matching rules.
    2. Choose the type of search expression:
      • Equals – the field must exactly match the text in the label.
      • Begins with – the field must begin with the text in the label.
      • Ends with – the field must end with the text in the label.
      • Contains – the text in the label must exist somewhere in the field.
      • Regular expression – search for text that matches the pattern defined by the regular expression. You can create an expression with Boolean operators, groups, or wildcards like "?" or "*". SAP Mobile Platform uses the Boost regular expression engine. See the Boost documentation on regular expression syntax at published on non-SAP site.
    3. Configure the text to search against, or define a regular expression in the Value field.

Next Steps

Test all new and changed rules to ensure they work as designed.