Humanity Connector
Intro
Humanity (formerly called ShiftPlanning) is an online workforce management and scheduling system designed to help users easily manage time clock, attendance, human resources and payroll. Use Domo's Humanity connector to retrieve data about schedules, employees, notifications, and so on. For more information about the Humanity API, visit their website. (https://www.Humanity.com/api/)
The Humanity connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking Cloud App in the toolbar at the top of the window.
You connect to your Humanity account in the Data Center. This topic discusses the fields and menus that are specific to the Humanity connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.
Prerequisites
To connect to your Humanity account and create a DataSet, you must have the following:
-
A Humanity username and password.
-
The API key for your Humanity account. You can find this by logging into your Humanity account and navigating to Admin > Data API.
Connecting to Your Humanity Account
This section enumerates the options in the Credentials and Details panes in the Humanity Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.
Credentials Pane
This pane contains fields for entering credentials to connect to your Humanity account. The following table describes what is needed for each field:
Field |
Description |
---|---|
Username |
Enter your Humanity username. |
Password |
Enter your Humanity password. |
API Key | Enter the API key for your Humanity account. For information about obtaining an API key, see "Prerequisites," above. |
Once you have entered valid Humanity credentials, you can use the same account any time you go to create a new Humanity DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.
Details Pane
This pane contains a primary Report menu in which you select a report category and an Action menu in which you select a specific report within that category. For example, if you selected Admin in the Report menu, you could then select Backups, Files, or Settings in the Action menu as your specific report. Depending on the options you select in these menus, other options may be available.
Menu |
Description |
||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report/Action |
Select a Humanity report category and report within that category. The following reports are available:
|
Other Panes
For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.