Configure Future Hires or Terminations

How to configure hyperfind queries and the HCM People Import-v1 integration to accurately import records for future hires or terminated employees.

(Optional)

You can configure hyperfinds and the HCM People Import integration to accurately import records for employees who will start work in the future or who have been terminated.

Examples:

  • An employee will start work 2 weeks from the date the integration runs.
  • An employee has been terminated, and the integration must update that person's records.

Hyperfind to account for future hires or terminations

The All Employees Including Future Hires hyperfind returns all employees who have been hired since the beginning of time, that is, all employees including employees who have been hired but will start work in the future.

  • Any hyperfind can return a maximum threshold of 50,000 records. The default maximum is 3500 records.
  • To increase the maximum threshold, edit the global.LongList.ManagerSummaryEmployeeThreshold system setting.

To configure hyperfinds, do the following:

  1. Log in with a user account that allows access to hyperfind setup.
  2. Create a hyperfind for employees who will start work at a future date or for employees who have been terminated. Select Main Menu Administration > Application Setup > Common Setup > Hyperfinds.
  3. Add the hyperfind to a hyperfind profile. Select Administration > Application Setup > Common Setup > Hyperfind Profiles.
  4. Assign the hyperfind profile to a display profile. Select Administration > Application Setup > Display Preferences > Display Profiles.

  5. Assign the display profile to the relevant employees.

    1. Click Tap Main Menu . Select Maintenance > People Information. Select a person.
    2. In Employee, select Access Profiles.
    3. Select the Display Profile.
    4. Click Tap Save .
    5. Repeat for other people.

Configure system settings for future hires

  1. Log in with a user account that allows access to system settings.
  2. Select Main Menu Administration > Application Setup > System Configuration > System Settings > Global Values tab.

  3. Edit the following system settings:

    global.people.support.futurehire.enabled

    Enables the Person APIs to search all employees in the past, present, and future including employee records with hire dates in the future and terminated employees.

    • True(default): Hyperfinds can search for all employees
    • False: Hyperfinds can search only for current employees.

    global.LongList.ManagerSummaryEmployeeThreshold

    • Default = 3500 employee records
    • To change the default, enter a new value.
      Caution: Higher threshold values can slow system performance.
    • Maximum = 50,000 employee records.
  4. Click Tap Save.

Configure the integration

Future hires or terminations.
  1. Log in with a user account that allows you access to the Integration Template Designer.
  2. Select Main Menu Administration > Application Setup > Integrations Setup > Design Integration Templates.
  3. Select the Manage tab > Atom Management.
  4. Select your environment.
  5. In Administration, click tap Environment Extensions.
    1. In Process Filter, click tap the magnifying glass
      Search button
      .
    2. Scroll to and select the integration pack: Dimensions HCM People Import > HCMPersonImport-v1.
  6. Select Process Properties.
    1. From the Process Property dropdown list, select HCMPeopleImport-v1_ProcessProperties.
    2. For _Hyperfind, clear Use Default. Enter the name of the hyperfind query exactly.
  7. Click Tap OK.
  8. To verify, see Run and Test Integrations.