Configure the Data Synchronization Task for Event-Driven Integrations

The Data Synchronization Task Wizard enables you to define how data from UKG Pro moves to your target when an UKG Pro Event occurs (such when an employee's address or name changes, or when a new employee is hired).

Navigation:Informatica > Data Integration > Data Synchronization

Prior to beginning this task, the UKG Pro and target connections must be created. Log in to Informatica using the login credentials provided by UKG.

Note

Data synchronization tasks do not support complex filtering or the use of parameters. If you want to use complex filters or parameters to only export the employee or payroll records that triggered the event, configure a data mapping task.

From the Data Integration page, select New. The New Asset pop-up page displays.
Select the Tasks link.
From the Tasks page, select Synchronization Task.
Select Create. The New Synchronization Task Wizard appears.
From the Definition page, enter a unique name and optional description. At the Location field, select Browse to choose a Project folder.
From the Task Operation drop-down list, select the operation you want to perform.
Select Next. The Source page appears.
From the Connection drop-down list, select the UKG Pro connection. For integration tasks that are automatically triggered by the UKG Pro event, be sure to select the UKG Pro connection that uses the HR, Payroll Talent, Benefits application module.
From the Source Type radio buttons, select Single Object if the field data to be extracted exists in a single UKG Pro object.
From the Source Object field, use the Select button to select the UKG Pro object and select OK. The object appears in Object field.

Note
To reference the fields contained in each object, view the UKG Pro Fields Listing for Informatica spreadsheet available in the UKG Community Library.

Note
If the fields to be included in the integration exist in multiple related UKG Pro objects, select Multiple Objects from the Source Type radio buttons. Then, use the Add Primary and Add Sibling buttons in the Source Objects section to add multiple objects based on their relationship.

When adding two objects that have a one-to-many relationship, which is referred to as a collection, a specific order must be followed. The object identified as the collection must be added as the primary object. Otherwise, the integration may contain duplicate records. To view the objects with related collections, refer to the job aid titled, UKG Pro Objects and Related Collections in Informatica Cloud.
Select Next. The Target page appears.
From the Connection drop-down list, select the target to which the UKG Pro data is to be exported.
From the Target Object field, use the Select button to select the target object and select OK.

Note
When selecting a database target, you must first create the database tables and database user before completing the data synchronization task. Database user accounts must have DELETE, INSERT, SELECT, and UPDATE privileges.
Select Next. The Data Filters page appears.
Create an optional data filter to filter the UKG Pro data prior to import into your target. For example, you can extract only employees whose last names begin with the letter, G.
Select Next. The Field Mapping page appears.
Map the fields by dragging the fields from the Source column on the left to the corresponding fields in the Target column. Only mapped fields are included in the integration.
Select Save.
Select Finish. The new data synchronization task appears. You can now attach this task to an UKG Pro event so that when the event occurs, the data is exported from UKG Pro and imported into your target automatically.

Important
It may take up to five minutes for newly-added tasks to appear for selection in UKG Pro Integration Events.

This document and all information contained herein are provided to you "AS IS" and UKG Inc. and its affiliates (collectively "UKG") make no representation or warranties with respect to the accuracy, reliability, or completeness of this document, and UKG specifically disclaims all warranties, including, but not limited to, implied warranties of merchantability and fitness for a particular purpose. The information in this document is subject to change without notice. The document and its content are confidential information of UKG and may not be disseminated to any third party. No part of this document or its content may be reproduced in any form or by any means or stored in a database or retrieval system without the prior written authorization of UKG. Nothing herein constitutes legal, tax, or other professional advice. All legal, tax, or other questions or concerns should be directed to your legal counsel, tax consultant, or other professional advisor. All company, organization, person, and event references are fictional. Any resemblance to actual companies, organizations, persons, and events is entirely coincidental.