Match rule collections


Administrators can create match rule collections to use in source subscriptions and in the Match API.

By default, source subscriptions and the Match API uses the country default match rules for your Network instance. You can create and use match rule collections that contain country groups that share custom match rules and data groups. Match rule collections are independent of subscriptions and other Network processes, so you can customize them for specific purposes.


Source subscriptions

Configure match rules in a match rule collection and use it in multiple source subscription configurations. Often source subscriptions have common match configurations, but each source subscription had to be configured with its own match rules. Simplify match configurations by applying a match rule collection to any source subscription.

Match API

The Match API can be used to match data immediately for a single record. This is helpful when you need to verify data in real-time, for example, when you are registering HCPs in a portal. You can match the data using an API call instead of trying to verify the data using Network Search which requires multiple searches, filtering, and field queries.

Creating match rule collections

To create a match rule collection:

  1. In the Admin console, click System Interfaces > Match Rule Collections.

  2. On the Match Rule Collections page, click Add Collection.

  3. In the Details section, define a Name and Description.

    The name must be unique. Letters, numbers, and underscore (_) characters are supported for the name.

  4. Click Create Collection to save it. The collection must be saved before you can add country groups.

  5. Click Add Country Group . Match collection rules are specific to country groups. Country groups are countries that use the same match rules and data groups.

  6. On the New Country Group page, define the following:

    • Country Group Name - The name of the group.

    • Countries - Add the countries that apply to this group. A country can belong in one country group for each match rule collection.

  7. In the Match Rules and Data Groups section, select the entity that will use custom match rules and data groups. For example, click Health Care Professional.

  8. Beside Match Configuration, the option Use country default rules is defined by default. Click View Rules to see a read-only preview of the current default rules.

    If the country group contains multiple countries, use the Country list to see each country's default rules.

    These are the rules that are currently the default for your Network instance for the country (System Interfaces > Match Default Configuration).

    Note: They are not necessarily the default rules that Network provided when you received your Network instance. If you have made any changes to those rules, those changes are considered the default rules for your Network instance now.

  9. Choose Customize rules to start defining the custom match rules.

  10. On the Load Country Template pop-up, select a country from the list. The default rules for the selected country will be used as a starting point for the custom match rules. The countries that are defined for the country group are available in the list.

    The template (country default match rules) that you choose will be applied to each object in the country group if you customize rules for other objects.

    Note: After you save the country group, the template cannot be changed and the country cannot be removed from the country group.

    Click Preview to open and review a read-only version of the default match rules and data groups for that country. Close the pop-up and click Continue.

  11. The match configuration tabs display: Match Rules, Data Groups, Match Filters, and Ranked Filter Groups. Customize the match rules, data groups, and match filters for the selected object. For example, if you want the match collection to match by IDs only, you might disable all of the match rules that are not for IDs.

    For details, see Match configuration.

    By default, Basic mode is selected for HCPs and HCOs. You can edit the rules in Basic or Advanced mode. Only Advanced mode is supported for custom objects.

    Notice that the Custom Rules label displays below the selected object. Also, the country group is updated to display country that the Base Template uses.

  12. Save the country group.

    Note: If you have customized rules for an object, after the match rule collection is saved, the entities cannot be set back to use Default Rules.


    • To save the country group, at least one object must have custom rules defined. If all of the objects in the match rule collection are set to use default rules, a message displays: No changes in match rules detected. Please customize an entity's match rules before saving a country group.

    • If the country group contains multiple countries and you customize a rule for an object but there isn't a rule for that object in one of the countries, a message displays: At least one field is not available or not enabled in this country. For example, if you use the default match rules for Mexico as your template and there isn't a rule for that object for Brazil, the message displays. The rule must be removed before the country group can be saved.

  13. Optional Add more country groups to the match rule collection.

  14. Save the match rule collection.

Edit country groups

Country groups can be edited or deleted.

  • Add or remove countries to the country group.

    When you save the country group, a pop-up displays. Click Change to confirm that you want to update the country group. Network validates the features, feature sets, and data groups to update the fields used in the rules.

Delete country groups

You can delete a country group from the match group selection. If you delete a country group, the default match rules for the countries in the group will apply. A message displays to confirm that you want to delete the group.