z New Contact Matching 2021

When a Summit Events Registration record is created several fields about the person registering are populated. These values only exist in the Summit Events Registration object unless you select a Contact Matching Rule on the Summit Events record. If you select a Contact Matching Rule on the Summit Events record this rule will check to see if a Contact record exists in Salesforce for this person:

• If the Contact Matching Rule finds a Contact record that matches the rule logic, it matches this Contact with the Summit Events Registration record.
• If the Contact Matching Rule does not find a Contact record that matches the rule logic, it will create a new Contact record and match this newly created Contact with the Summit Events Registration record.

Matching Rules

Contact Matching Rules in Summit Events utilizes native Salesforce Duplicate Rules and Custom Matching Rules. This allows an organization to create their own matching logic. You can learn more about this at Salesforce Duplicate Rule and Matching Rule documentation

Note that any fields mapped using Custom Metadata (as detailed in the "Adding Additional Field Values When Matching Rules Create New Contacts" section below) are also available to be included in your Salesforce Duplicate Rule.

Note that when using a Salesforce Duplicate Rule it is important that you set the "Record-Level Security" field value to "Bypass sharing rules" so the guest user profile used for registration can see the Contacts in the org, and also that the "Alert" checkboxes are unchecked so the registrant does not receive alert messages:

Field Values Automatically Added to Contacts When Matching Rules Create New Contacts

When a new Contact is created by the Contact Matching Rule the following fields from the Summit Events Registration record are automatically added to the Contact record:

Adding Additional Field Values When Matching Rules Create New Contacts

If you want additional field values to be added to the Contact record you can use the "Custom Metadata Contact Matching Method" on Summit Events to do this. Custom Metadata Types is the Salesforce tool that allows an admin to create field mappings that are read by the code in the managed package - for details take a look at More Info On Custom Metadata Types.

To setup your custom field mappings:

1. Select a "Custom Metadata Contact Matching Method" value on the Summit Events record (The only Matching Method available in the current version is "Admissions", additional options will be added soon)
2. Follow the instructions here to access the Custom Metadata records in Setup to Add or Edit Custom Metadata Records
   • Go to "Setup", then in the Quick Find box at the top of the setup menu type "Custom Metadata Types
   • Click on the "Custom Metadata Types" link and find the "Summit Events Contact Matching Mapping" section
   • Click on "Manage Records" link before this section (don't click on the Summit Events Contact Matching Mapping" link)
3. Create a Custom Metadata record for each field value you want to be added to the Contact record. Note that you have the option to either map values from the Summit Events Registration record or add hardcoded values that will be added to the Contact record.
   • If you are mapping field values from Summit Events Registration make sure you use the field API name, not the field label.

Here is an example of what the Custom Metadata records look like: