Workday integration
Integration with Workday is a BigPicture Enterprise feature available for:
Jira Cloud
Jira Data Center
Before you continue, make sure you have BigPicture Enterprise installed.
Integrating BigPicture with Workday allows for automated synchronization of employee absences, ensuring that project timelines are always up to date.
Integrate BigPicture with Workday
After integration, Workday data becomes the primary source of absences. Resources are matched based on their work email in both Atlassian and Workday. Absences need to be approved in Workday to be reflected in BigPicture.
Full integration
When all resources are managed in Workday, integration with Workday fully replaces BigPicture absences. Once the integration is active, manual adjustments in BigPicture are disabled to prevent inconsistencies.
Partial integration
If some resources are not in Workday, you can still manage their data manually in BigPicture. Partial integration lets you be flexible in resource management across systems. Users who are in Workday are mapped with BigPicture by their email addresses.
Step-by-step instructions
To integrate BigPicture with Workday:
Make sure you have BigPicture Enterprise installed. Integration with Workday is a BigPicture Enterprise feature.
Now, you need to configure Workday integration.
Go to App Configuration > Integrations > Workday.
To get your Workday credentials, follow the steps described in the Configure REST API in Workday section below.
Once you completed the steps in the Configure REST API in Workday section below and have all the credentials, provide:
Client ID
Client Secret
Refresh Token
Workday REST API Endpoint
Token Endpoint
Specify a start date for the Start sync with Workday from field. From that date onward, BigPicture absences will be replaced, and Workday data will become the primary source of absences.
When ready, click Save.
Configure REST API in Workday
Register API client for integrations
You need to be a Workday administrator to complete the following steps:
Search for Register API Client for Integrations in Workday's search field.
Select the Register API Client for Integrations task to access the registration page.
Enter a name for your API client in the Client Name field.
Select the Non-Expiring Refresh Tokens option.
Select Scope (Functional Areas).
Click OK to generate the Client ID and Client Secret.
Save the Client Secret and Client ID.
When saved, click Done.
Navigate to the API Clients for Integrations tab.
Select the API client you registered in the previous steps.
Click the … More actions menu next to the client name and go to API Client > Manage Refresh Tokens for Integrations.
Use your existing Integration System User (ISU) account or create a new one for the integration. When ready, click OK.
Select the Generate New Refresh Token option and click OK.
Copy the Refresh token from the Successfully Regenerated Refresh Token page.
Click Done to complete the process. After completing the steps above, you should have the Client ID, Client Secret, and Refresh Token.
Get Workday REST API endpoint
To understand where the API endpoints come from, refer to the Workday REST API page.
The Workday REST API base path format is:
https://{tenantHostname}/api/{serviceName}/{version}/{tenant}
How to determine your tenant’s REST API path:
{tenantHostname}
The hostname of the Workday REST web service. You can use the View API Clients task to get the hostname.
Example: If the Workday REST API Endpoint on View API Clients displays https://services1.myworkday.com/ccx/api/v1/gms
the hostname is services1.myworkday.com
.
{serviceName}
The name of the Workday REST web service. You can find the service names in the Workday REST Services Directory.
{version}
The version of the Workday REST web service. You can find the service versions in the Workday REST Services Directory.
{tenant}
The name of your tenant.
Workday REST API for time off details
Go to the Workday REST Services Directory and find the path for absence details.
This example will use the path:
/workers/{ID}/timeOffDetails
Add the above path to your tenant’s API endpoint. It should look similar to:
https://services1.myworkday.com/ccx/api/absenceManagement/v1/gma/workers/{ID}/timeOffDetails
Use an API platform (e.g. Postman) to retrieve the access token.
Use the access token to GET REST API time off details.
Synchronization rules
Synchronization takes place automatically once a day.
If you want to manually synchronize data:
Go to BigPicture Administration > Resources > Individuals.
Click the Synchronize with Workday button.
The synchronization is in progress. You will be informed when the process is completed.
Remove Workday integration
To remove Workday integration:
Go to App Configuration > Integrations > Workday.
Click Remove integration at the bottom of the page.
When you remove Workday integration, the absences already synchronized will remain in BigPicture, so none of your data will be lost. However, the integration will be removed, and new data will no longer be synchronized.
To confirm, click Remove.
Absences management in BigPicture
After integration with Workday, you can’t manually add absences for users managed by Workday in BigPicture. If a user isn’t managed in Workday, you can still manually manage their absences in BigPicture.
The Add absence button is disabled on:
My settings > Absences
BigPicture Administration > Resources > Individuals > Resource’s page
Resources module > Right-click on a task > Add absence
Resources module > Right-click on an individual > Add absence