Connect to Paylocity Data in Claris FileMaker Pro

Claris FileMaker is a low-code database application development tool that allows users to create custom apps for managing and organizing data. It combines a powerful relational database engine with an intuitive interface, enabling both technical and non-technical users to design and deploy applications across desktop, web, and mobile platforms.

In this article, we'll explore how to use the CData ODBC Driver for Paylocity in FileMaker to connect to Paylocity data.

Create an ODBC Data Source for Paylocity

If you have not already, first specify connection properties in an ODBC DSN (data source name). This is the last step of the driver installation. You can use the Microsoft ODBC Data Source Administrator to create and configure ODBC DSNs.

Set the following to establish a connection to Paylocity:

• RSAPublicKey: Set this to the RSA Key associated with your Paylocity, if the RSA Encryption is enabled in the Paylocity account.

  This property is required for executing Insert and Update statements, and it is not required if the feature is disabled.

• UseSandbox: Set to true if you are using sandbox account.
• CustomFieldsCategory: Set this to the Customfields category. This is required when IncludeCustomFields is set to true. The default value for this property is PayrollAndHR.
• Key: The AES symmetric key(base 64 encoded) encrypted with the Paylocity Public Key. It is the key used to encrypt the content.

  Paylocity will decrypt the AES key using RSA decryption.
  It is an optional property if the IV value not provided, The driver will generate a key internally.

• IV: The AES IV (base 64 encoded) used when encrypting the content. It is an optional property if the Key value not provided, The driver will generate an IV internally.

Connect Using OAuth Authentication

You must use OAuth to authenticate with Paylocity. OAuth requires the authenticating user to interact with Paylocity using the browser. For more information, refer to the OAuth section in the Help documentation.

The Pay Entry API

The Pay Entry API is completely separate from the rest of the Paylocity API. It uses a separate Client ID and Secret, and must be explicitly requested from Paylocity for access to be granted for an account. The Pay Entry API allows you to automatically submit payroll information for individual employees, and little else. Due to the extremely limited nature of what is offered by the Pay Entry API, we have elected not to give it a separate schema, but it may be enabled via the UsePayEntryAPI connection property.

Please be aware that when setting UsePayEntryAPI to true, you may only use the CreatePayEntryImportBatch & MergePayEntryImportBatchgtable stored procedures, the InputTimeEntry table, and the OAuth stored procedures. Attempts to use other features of the product will result in an error. You must also store your OAuthAccessToken separately, which often means setting a different OAuthSettingsLocation when using this connection property.

When you configure the DSN, you may also want to set the Max Rows connection property. This will limit the number of rows returned, which is especially helpful for improving performance when designing reports and visualizations.

Connect and sync Paylocity data with FileMaker using the CData ODBC Driver for Paylocity

Once you configure the CData ODBC Driver for Paylocity, you can connect to live Paylocity data in FileMaker and use it in your applications. In this section, we'll walk through the steps to connect live Paylocity data to FileMaker.

You can download and install the latest version of FileMaker Pro for your Mac/Windows/Linux systems here: https://www.claris.com/resources/downloads/.

Importing Paylocity data using FileMaker's ODBC Import Function

Follow the steps below to easily import Paylocity data using the ODBC import feature:

1. Open FileMaker Pro. Navigate to Create from the left panel and select Blank > Create.
👁 Create a new application in FileMaker

2. Enter a desired filename and click Save.
3. In the Manage Database window, go to the Tables tab and create or rename the table where you want to display Paylocity data.
👁 Create or edit a table.

4. In the Fields tab, add the required fields to the table.
👁 Create the fields for the table.

5. In the Relationships tab, define table relationships if your database has multiple tables, then click OK.
6. To reopen and modify the table structure later, go to File > Manage > Database.
7. To import Paylocity data via the CData ODBC Driver for Paylocity, navigate to File > Import Records > ODBC Data Source.
👁 Select ODBC Data Source from Import Records.

8. In the Select ODBC Data Source window, choose CData ODBC Driver for Paylocity and click Create. Enter your Paylocity username and password, then click OK.
👁 Select CData Paylocity Sys.
👁 Enter the Paylocity username and password.

9. In the SQL Query Builder window, select the desired table from the Tables section and choose the relevant columns from the Columns section. Click Insert into SQL Query after each selection to automatically generate a query that retrieves data from Paylocity. You can also manually edit the query using WHERE and ORDER BY clauses or use the tabs provided in the SQL Query Builder. Click Execute to run the query.
👁 Choose the columns to generate the SQL Query.

10. In the Specify Import Order window, define the import order for the target fields. Select Add between source and target to add new records to the target table from the selected fields. Click Import.
👁 Specify the import order.

You have now successfully imported Paylocity data into FileMaker Pro using the CData ODBC Driver for Paylocity. To perform incremental updates, change the import order to "Update" or use "Replace" based on your use case.

Process Paylocity data at design time

You can sort and aggregate data, as well as calculate summary functions while browsing tables. To manipulate the view of data at design time, complete the following steps:

• Switch to Preview Mode: Click the Preview at the top to check how the Paylocity data with look before you print it.
• Switch to Table View: Click the table icon in the View As menu in the main toolbar of the application.

Aggregate and summarize

Follow the steps below to group column values and display summaries, as shown in the screenshot:

• Sort: Click the arrow in the NumberOfEmployees column header and choose Sort Ascending from the menu.
• Group: In the same menu, click Add Trailing Group by Industry to group the values and insert a summary row. Alternatively, click Add Leading Group to add a summary row at the beginning.
• Summarize: Select a summary option from the Trailing Subtotals menu for a grouped column.

Create a bar chart

Use the following steps to create a simple bar chart showing the total NumberOfEmployees for each Industry:

1. Click the arrow in the NumberOfEmployees column header and select Chart by NumberOfEmployees.
   • If you've already grouped the table by a column (e.g., Industry), you can chart NumberOfEmployees by that column.
   👁 Create the chart from Paylocity data.
   
2. In the Chart Setup window:
   • Click the button next to the Data box to add the x-axis column.
   • Choose the appropriate column in the dialog that appears.
   • For the y-axis, select a summary option from the Summary menu.

Get Started Today

Download a free 30-day trial of the CData ODBC Driver for Paylocity to integrate Paylocity data into Claris FileMaker and work with Paylocity data in your FileMaker applications.

Reach out to our Support Team if you have any questions.