Understanding Search/Match

To use the full functionality of your system, you must maintain the integrity of your database. With users from many departments entering data into your system, you want to minimize the entry of duplicate or multiple records. Search/Match enables you to define criteria to check for duplicate or multiple ID records. The searchable ID types (called Search Types) are:

  • Person (Empl ID)

  • Applicant (HRS_PERSON_ID within PeopleSoft Talent Acquisition Manager)

Note: PeopleSoft delivers these ID types as translate values inside the SM_TYPE field. They are delivered as Active, but you can inactivate them depending on the applications that you license. Do not, however, add or delete ID type values.

For each of these ID types, departments or business areas can, based on user security roles, define their own search criteria to perform a search. The criteria can include defining search rules and placing them in the desired order within a search parameter. Each department or business area can also set what data to display in the results to identify a possible matching ID. Departments and business areas can set up multiple search result codes and give security access to all users or restrict it to specific users who have a certain security role assigned.

You can also set rules and parameters to permit only ad hoc searches to enable users with the appropriate security to perform ad hoc searches without the constraints of predefined criteria.

Data returned in a search result can contain sensitive information. You can control whether to entirely or partially mask a field or display the entire field. The masking configuration can be controlled with user security access. With search results and display controls defined, users can perform Search/Match to determine if a record already exists before adding one.

You can also enforce the use of Search/Match by setting Search/Match to trigger when a user enters data and saves a new ID by transferring the user directly to the list of IDs that match the criteria. When you enforce Search/Match at save time, the user does not need to navigate to the Search/Match component and reenter the data to determine whether the ID exists.

You define search rules to identify which fields to search for and how to use them to perform the search. You can use one or multiple search rules. If you use multiple search rules, Search/Match applies the rules in the order that you define. Starting with the first rule, if the system finds at least one match according to that rule, it will stop searching. However, if it finds no match for that rule, it will continue to the next rule, and so on.

Also, if you use multiple search rules, you should order the rules from the most restrictive to the least restrictive. For example, rule 1 could return matching IDs when first name, last name, phone number and national ID exactly match. Rule 4 could return matching IDs when only the first and last name match. In this example, rule 4 could return more potential matching IDs than rule 1. The search rule used by Search/Match could therefore be used as an indicator to users of how significant the returned results are.

A search parameter is a set of one or more search rules that you order sequentially with the lowest (or first) search order level as the most restrictive, and the highest (or last) search order level as the least restrictive. A search parameter must be created even if it contains only one search rule.

When a user runs the search, the system searches according to these rules and search orders until it either encounters a potential duplicate or executes all search sequences and finds no potential duplicate.

Use search result codes to specify the data that you want Search/Match to return in the grids on the Search Results page for the potential matching IDs that it finds. You can define field-level security for fields that you consider sensitive. For example, you might allow some users to see the full birth date, but restrict other users to see only the year (or nothing at all), depending on the Primary Permission List in their user profile.

Some search rules, search parameters, and search results are delivered with your system. You can use these as they are, modify them, or add as many as you need.

Warning! Adding new search fields require significant programming effort and is not recommended.

Automatic search reinforces the use of Search/Match when you create a new ID in a transaction page. To trigger an automatic search from the transaction page, associate the component that contains that page with an active search parameter. When the user enters all of the necessary data to create a new ID on that page and saves the transaction record, Search/Match begins automatically. The system uses the predefined search parameter and the data entered by the user as search criteria. If Search/Match does not find matching IDs, the system saves the transaction successfully. If Search/Match finds at least one matching ID, the system displays the search results inside a grid on the Search Results page.

If the component name is associated with a search parameter code and a search result code, Search/Match displays the search results inside a grid on the Search Results page. This enables users to review the potential duplicate IDs without having to manually navigate to the Search/Match page. After reviewing the results on the Search Results page, the user clicks Return and is instructed to either click OK to continue saving the new ID or to click Cancel to avoid saving the transaction and investigate further.

Note: This setup is valid only when creating person IDs from HRS_PREP_FOR_HIRE component.

Warning! To display the Search Results page at save time, you must have a security role with access to the component interface HCR_SM_SEARCH.

See Search Results Page.

See PeopleTools: Security Administration

Note: This setup is valid only when creating person IDs from the Personal Data (PERSONAL_DATA) component for commercial HCM and the Employee Hire (EE_HIRE) component for Federal HCM.

Enabling the Auto Search/Match Feature

You enable Automatic Search/Match processing in HCM by selecting the Perform Automatic Search/Match check box on the Person Object Installation page (INSTALL_PERSON).

When you select the check box, the system checks to see if a Search Parameter and a Search Result code have been associated with the PERSONAL_DATA component (or the EE_HIRE component for Federal). If it finds codes, it displays these rule names. If not, the system generates a warning informing you that Automatic Search/Match processing will not occur until you associate Search Parameter and a Search Result code with the PERSONAL_DATA or EE_HIRE components.

See Setting Up Person of Interest Types.

Search/Match uses phone and email values to perform the search only when a phone or email value is marked as preferred. Therefore, to use PhoneRule and EmailAddressRule inside a search rule triggered automatically when you save a new ID, the ID must have a preferred phone number and preferred email address.

When Address1Rule, Address2Rule, Address3Rule, Address4Rule, CityRule, CountryRule, CountyRule, PostalRule or StateRule are inside a search rule triggered when you save a new person ID, Search/Match uses the address fields for only the home address type to perform the search. That is, if any address type other than HOME is entered, Search/Match does not use the address fields as search criteria.