Integrate Kronos Workforce Central 编辑

Deploy the Kronos Workforce Central integration template to access Kronos anywhere through Citrix Workspace. With this template integration:

• Managers can easily view and respond to potential workforce management activities.
• Employees can perform time management tasks and submit requests.

Note:

We want your feedback! Please provide feedback for this integration template as you use it. For any issues, our team will also monitor our dedicated forum on a daily basis.

For comprehensive details about these microapps, see Use Kronos microapps.

Review prerequisites

After you set up this integration with Kronos Workforce Central, you need these artifacts to add the integration in Citrix Workspace Microapps:

• Base URL: http://kronos-server.workspaceintelligent.com
• Kronos Username: This is the name of the Kronos Superuser.
• Kronos Password: This is the Kronos Superuser password.
• Kronos Date Format: Enter the date format available in Kronos setup. See Verify date format in Kronos.

User account

The integration requires regular access to your Kronos Workforce Central instance. We recommend creating a dedicated Superuser account. This Superuser account must have full administrator privileges and permissions.

This Superuser account is created by an administrator of Kronos. For more information about the Kronos Partner Account, see https://www.kronos.com/kronos-partner-network/become-partner and https://www.kronos.com/2018/blogs/working-smarter-cafe/2020-ukg-kronos-community-superusers-announced.

API access

The Kronos Workforce Central APIs are enabled by default through web services for a partner account. This may require a separate agreement with the vendor in order to get SUPER USER credentials for setting up the integration.

Authentication is not enabled for this template. Kronos does not support O-AUTH 2.0 (that is, write-back for users is not supported by Kronos). Each service action (such as approve and refuse) performed using our Citrix Kronos Workforce Central integrations will be registered under the “SUPER USER” credential user authentication. As a workaround, our custom function in this integration can capture the name of the approver in the comments session.

Add the integration to Citrix Workspace Microapps

Add the Kronos Workforce Central integration to Citrix Workspace Microapps to connect to your application. This delivers out-of-the-box microapps with pre-configured notifications and actions, which are ready to use within your Workspace.

Follow these steps:

1. From the Microapp Integrations page, select Add New Integration, and Add a new integration from Citrix-provided templates.
2. Choose the Kronos Workforce Central tile.
3. Enter an Integration name for the integration.
4. Enter Connector parameters.
   • Enter the instance Base URL:
   • Select an Icon for the integration from the Icon Library, or leave this as the default icon.
5. Enter your super user credential for Kronos Username. We recommended this to be the provide SUPERUSER credentials.
6. Enter your Kronos Password.

7. Enter your Kronos Date Format. Ensure that the format that you select is used in Kronos as well. See Verify date format in Kronos.

   Service authentication and Service action authentication are not enabled.

8. Select the Enable request rate limiting toggle. Enter 320 for Number of requests and 1 second for Time interval.
9. Request timeout is set to 120 by default.
10. (Optional) Enable Logging toggle to keep 24 hours of logging for support purposes.
11. Select Save to proceed.

The Microapp Integrations page opens with your added integration and its microapps. From here you can add another integration, continue setting up your out-of-the-box microapps, or create a new microapp for this integration.

Verify date format in Kronos

Follow these steps to configure date format in Kronos. Our Kronos Workforce Central integration template supports these date formats: ‘YYYY/MM/DD’, ‘MM/DD/YYYY’, ‘YYYY-MM-DD’, ‘MM-DD-YYYY’, ‘M/DD/YYYY’, ‘DD-MM-YYYY’.

Ensure the date format here is entered in the Kronos Date Format field as well when you add the integration.

1. Log in with your super user account to Kronos UI.
2. Follow the navigation path:Setup > System Configuration > System Settings > Locale
3. Get the display format for long date from the site.local.LONG_DATE field.

You are now ready to set and run your first data synchronization. For complete information about synchronization rules, synchronization that does not meet its schedule and veto rules, see Synchronize data.

Note:

We recommend running full sync once a day.

The Kronos SoR does not support incremental synchronization. Using scripting, we have implemented custom sync function to cover notification use cases for better user experience.

For more details of API endpoints and table entities, see Kronos connector specifications.

Note:

The Kronos SoR does not support pagination. Thus we have limited the cache accordingly. This template integration stores only two months of data into the cache for most use cases.

The Record Timestamp microapp can hold up to 2 days of data into cache.

Use Kronos microapps

Existing application integrations come with out-of-the-box microapps. Start with these microapps and customize them for your needs.

My Accrual Balance: View accrual balance for different days instantly.

My Time Off History: Allows users to view their history of time off data available for current month.

Record Timestamp: Register their punch in and out date and time.

Request Time Off: Submit application for time off.

Paid Time Off Request Approval: Receive notifications for all time off requests to managers and push notifications for all approved or refused time off requests back to the original requester.

Time Log: Receive notifications for all Work Time requested. Approve or refuse for the single user or group of users.