Sync Employee data automatically

Connecting an example Data Source

This guide will help you seamlessly connect a data source using Introist's interface, specifically focusing on incorporating a Google Drive Sheet as the data source. Follow the video and these steps to ensure your setup is successful. As a bonus, at the end of this article, there is an additional section dedicated to instructing you on how to create a Google Sheets Employee Data Source, providing you with a practical example to enhance your understanding and application of these integration techniques.

Accessing Data Source Settings

Begin by navigating to the Data sources section within Introist. You can find this by clicking on "Data" from the left-side navigation menu, then selecting "Data sources."

Connecting Your Data Source

Click "Connect data source" to start the setup. Introist supports various data systems such as HRIS and ATS, and continuously adds new integrations. If you can't find your desired data source, email tech@introist.com for assistance.

Selecting the Data Source Type

Select "Google Drive Sheet" from the list of data sources.

Name your data source for internal identification. Use a clear, descriptive name to simplify future management.

Open your Google Sheets file and locate the File ID in the URL, found between "d/" and "/edit". For instance, the ID in https://docs.google.com/spreadsheets/d/139faNDksl-q_glajsJSANsdafkon2313/edit#gid=0 is 139faNDksl-q_glajsJSANsdafkon2313. Copy this ID.

Note the name of the sheet from the bottom of your Google Sheets interface, defaulting to "Sheet1" unless changed. Ensure you provide the correct sheet name if your document contains multiple sheets.

Setting up data mapping

In this section, we will guide you through configuring Introist to accurately pull and synchronize data from a Google Sheets spreadsheet, ensuring all employee details are correctly mapped and integrated. Follow these steps alongside the instructional video for a visual walkthrough.

Updating Data Source Settings

Initially, we need to update the settings in Introist to sync all employee records from the data source accurately. This ensures that each employee is identified correctly within the system.

Access the options menu of your data source and select "Edit connection." Here, adjust the sync mode setting to "All employees in data source" to ensure that Introist captures every entry from your spreadsheet.

After setting the appropriate sync mode, focus on mapping the identifier field. This field is pivotal as it allows Introist to uniquely recognize and match each employee across different data sources. Typically, this could be an email address or employee ID. In the mapping settings, link the identifier field from Google Sheets (for instance, "Email (Work)") to the corresponding identifier field in Introist (like "Employee Email").

Mapping Fields

Continue by adding field mappings to ensure all relevant employee information from Google Sheets is aligned with the corresponding fields in Introist. For each field listed in your Google Sheets, click "add mapping," select the Google Sheets field, and then choose its matching field in Introist. Repeat this for each data field you wish to synchronize.

Testing the connection

With all mappings configured, it's important to verify the setup. Utilize the "run sample" feature to test the integration. Select "final" and choose an employee to see a preview of how Introist processes and maps the data. This step confirms whether Introist correctly identifies and places each piece of information into the appropriate fields based on your mappings.

With these steps, you have effectively set up and tested your Google Drive Sheet as a data source within Introist. This configuration ensures that your data is not only synchronized but also accurately mapped and integrated, streamlining the management of employee information across various platforms.

Activate auto-sync

The final step in optimizing your data integration with Introist involves activating the auto-sync feature. This ensures that your system remains current with any updates or changes made to the data source. Here’s how to enable this functionality:

Begin by going to the 'Data sources' section within Introist. This area is where you can manage all your existing data connections.

Find the data source you've set up and click on the options menu associated with it. From here, select "Activate auto-sync." This action will enable continuous synchronization, automatically updating Introist whenever there are changes to your Google Sheets data source.

With auto-sync activated, Introist will consistently reflect the most current data, minimizing the need for manual updates and ensuring your workflows are always based on the latest information. This feature is crucial for maintaining the accuracy and efficiency of your data-driven processes.

Bonus: Setting up example Google Sheets spreadsheet

In the following guide, we will walk you through the steps of building an example Google Sheets spreadsheet to serve as a data source for employees. This sheet will contain essential information such as names, emails, and start dates. Additionally, we'll cover how to configure the spreadsheet to ensure Introist has the necessary access for integration.

Setting Up the Spreadsheet

Begin by creating a new Google Sheets document. Title your spreadsheet appropriately to reflect its purpose, such as "Employee Data Source." Once created, start by filling in the column titles to organize the employee data effectively. These titles should include

  • First Name

  • Last Name

  • Email (Work)

  • Email (Private)

  • Start Date

Entering Employee Data

With the columns set up, proceed to enter the data for your employees. Start with the first employee by filling out their first name, last name, both work and private emails, and the start date.

Sharing the Spreadsheet with Introist

To integrate the spreadsheet with Introist, you need to share it with the Introist service user. Click on the "Share" button located at the top right corner of the Google Sheets interface. In the sharing settings, add the Introist service user email:

  • introist-data-loader@introist-prod.iam.gserviceaccount.com.

Make sure to turn off the "Notify People" option to avoid sending an automatic email. Finally, click "Share," and if prompted, confirm by clicking "Share Anyway" to grant Introist the necessary access to the spreadsheet.

Last updated