Workday
Workday Connector for Leena AI
The Workday connector for Leena AI allows you to index and search knowledge articles from your Workday tenant. This integration makes published help content easily discoverable across the organization, improving access to policies and internal guidance.
The connector focuses on ingesting knowledge articles and provides configuration options to ensure only relevant content is made searchable.
Prerequisites
Ensure the following details are available before proceeding:
- Integration System User (ISU) Credentials (Username & Password).
- Properly configured Integration System Security Group (ISSG).
- Necessary Domain Security Policies activated in Workday.
Workday Setup Guide
1. Create the Integration System User (ISU)
-
Search for the Create Integration System User (ISU) task.
-
Create a new ISU and securely record the Username and Password.
-
Confirm the ISU has default permissions assigned.
2. Create an Integration System Security Group (ISSG)
-
Search for Create Security Group.
-
Select Integration System Security Group (Unconstrained).
-
Name:
ISSG_connector_leena_ai(or follow company naming conventions).
3. Add ISU to ISSG
-
Run the All Workday Accounts report to find your ISU.
-
Select Assign Integration System Security Groups from the action menu.
-
Add the ISU to your newly created ISSG.
4. Configure Domain Security Policies
Access the ISSG via View Security Group and perform the following:
-
Maintain Domain Permissions: Add the "Workday Accounts" permission.
-
Knowledge Access: Search for Assign Users to User-Based Security Group, enter "Workday knowledge help domain", and add your ISU.
"Workday knowledge help domain" is not a exact domain name, it can vary, this is configured when the user enabled knowledge help articles in their tenent. -
Security Configuration: Add "Security Configuration" and "Security Activation" domains to your ISSG. Add the ISSG to both Report/Task Permissions and Integration Permissions.
-
Activation: Run the Activate Pending Security Policy Changes task to apply updates.
Custom Report Configurations (RaaS)
You must create several reports. Ensure Enable as Web Service is checked for all.
Report 1: All Articles
-
Follow these steps to initialize the attachment-specific report required for the connector:
- Task: Navigate to the Create Custom Report task.
- Report Configuration: Enter the following header details:
Field Value Report Name All Articles – AttachmentReport Type AdvancedData Source Knowledge Base Article Versions🔍 VerificationEnsure the following settings are correctly applied before proceeding to the columns:
- Data Source Type:
Indexed - Primary Business Object:
Article Version
In the columns tab map the following table in your report.
| Business Object | Field | Column Heading Override XML Alias |
|---|---|---|
| Article Version | Article | articleVersionArticle |
| Article Version | Article Version Content Plain Text | Article_Version_Content_Plain_Text |
| Article Version | Article Version Created By | articleVersionCreatedBy |
| Article Version | Article Version Created Date | articleVersionCreatedDate |
| Article Version | Article Version Audiences | articleVersionAudience |
| Article Version | Article Version Language | articleVersionLanguage |
| Article Version | Workday ID | workdayID |
| Article Version | Article Version Attachments | articleVersionAttachments |
| Article Version | Article Version | Article_Version |
| Article Version Attachments | Attachment | Attachment |
| Article Version Attachments | File Name | fileName |
| Article Version | Article Status (REST) | Article_Status__REST_ |
| Article Version | Article Version Category | articleVersionCategory |
| Article Version | Article Version Title | articleVersionTitle |
| Article Version | Article Version Effective Expiration Date | Article_Version_Effective_Expiration_Date |
| Article Version | Article Version Last Updated Date | articleUpdateDate |
| Article Version | Article Version Last Updated Date | articleVersionLastUpdateDate |
-
Group Column Headings: Add the following info under group column heading.
-
Filter: In the Filter tab, add the following information.
-
Prompts
-
Go to Prompts tab and add the prompts as mentioned below.
Share
-
Go to Report Definition Sharing Options within **Share **Tab.
-
Select Share with authorised groups and Share.
-
Within Authorised User share add your ISU user that you created before.
-
Within Authorised Groups selected ISSG group that you created above.
-
-
Finalizing
-
Output Tab: Ensure the output type is set to table.
-
Click OK to save and then **Run **to verify the data.
-
Report 2: All Articles – Attachment
Follow these steps to configure the attachment-specific report for the Workday connector.
1. Initial Setup
- Navigate to the Create Custom Report task in Workday.
- Enter the following header details:
| Field | Value |
|---|---|
| Report Name | All Articles – Attachment |
| Report Type | Advanced |
| Data Source | Knowledge Base Article Versions |
2. Verification
Before proceeding to columns, verify the following data source attributes:
- Data Source Type:
Indexed - Primary Business Object:
Article Version
Next Step: Under columns tab, map the following table.
| Business Object | Field | Column Heading Override XML Alias |
|---|---|---|
| Article Version | Article | articleVersionArticle |
| Article Version | Article Status (REST) | Article_Status__REST_ |
| Article Version | Article Share Assignment | Article_Share_Assignment |
| Article Version | Article Version Audiences | articleVersionAudience |
| Article Version | Article Version Language | articleVersionLanguage |
| Article Version | Article Version Category | articleVersionCategory |
| Article Version | Article Version Title | articleVersionTitle |
| Article Version Attachments | Attachment | Attachment |
| Article Version Attachments | File Name | fileName |
| Article Version Attachments | Active Base64 Image Data | activeAttachmentContent |
| Article Version Attachments | Reference ID | referenceID |
| Article Version Attachments | Workday ID | workdayID |
| Article Version | Workday ID | workdayID |
| Article Version | Current Effective Date | Current_Effective_Date |
| Article Version | Article Version Last Updated By | articleVersionLastUpdatedBy |
| Article Version Attachments | Content Type | contentType |
| Article Version | Article Version Created Date | articleVersionCreatedDate |
| Article Version | Article Version Last Updated Date | lastUpdateDate |
| Article Version | Article Version Last Updated Date | articleVersionLastUpdatedDate |
- Group Column Headings:
To maintain the correct data structure for the Workday connector, configure the following in the Group Column Headings section at the bottom of the Columns tab:
| Business Object | Group Column Heading XML Alias |
|---|---|
| Article Version Attachments | articleVersionAttachments_group |
-
Filters: Map the following information under Filters tab.
-
Sub-filters:
File Namedoes not containpng,jpg, orgif.
-
Prompt
- Go **Prompts tab **and add the prompts as mentioned below.
-
Share
- Go to Report Definition Sharing Options within **Share **Tab.
- Select Share with authorised groups and Share.
- Within Authorised User share add your ISU user that you created before.
- Within Authorised Groups selected ISSG group that you created above.
-
Finalizing
- Output Tab: Ensure the output type is set to table.
- Click OK to save and then **Run **to verify the data.
Report 3: CR_Security Group Members
Follow these steps to set up the security group membership report in Workday:
1. Task Initialization
- Task: Search for and select Create Custom Report.
2. Report Details
Enter the following information in the header:
| Field | Value |
|---|---|
| Report Name | CR_Security Group Members |
| Report Type | Advanced |
| Data Source | All Workday Accounts |
| Report Tags | Security |
Next Step: List the Defining Report Columns and their corresponding XML Aliases for this security report.
| Business Object | Field | Column Heading Override XML Alias |
|---|---|---|
| Worker | Worker | Worker |
| Worker | Email - Work | Email_Work |
| Worker | Workday ID | workdayID |
-
Group Column Headings: Set Business Object: Worker | XML Alias: Worker_group
-
Sort: On the Sort tab, ensure Sort by first accessible column is checked.
-
Filter: Add
Security Groupsfield as shown below.
-
Sub-filter: Within the Subfilter tab, select Security Groups as the Business Object and add the condition: Security Group Name | contains | Prompt the user for the value.
-
Prompts and Output
-
Configure the following settings to ensure the report handles parameters and data display correctly:
1. Prompts- Date Settings: Set both Effective Date and Entry Date to
Use date and time at runtime. - Display Settings: Enable the checkbox for Display Prompt Values in Subtitle.
- Prompt Defaults: Add the following default configuration:
Field Prompt Qualifier XML Alias Security Group Name Default PromptSecurity_Group_Name
2. Output- Navigate to the Output tab.
- Output Type: Select
Table.
- Date Settings: Set both Effective Date and Entry Date to
-
-
Report Sharing Configuration
To ensure Leena AI can access the generated data, configure the security settings as follows:
-
Navigate to the Share tab.
-
Select the radio button: Share with specific authorized groups and users.
-
In the Authorized Users field, add:
leena-km-connector. -
Click OK to save and finalize the report.
-
-
Fetching API URLs
-
Search for View Custom Report.
-
Navigate to Web Service > View URLs.
-
Right-click JSON and select Copy URL.
Required Report names for Integration:
- All Article report
- All Article Attachment report
- CR_Security Group report
Leena AI Configuration
- Go to the Knowledge Management Dashboard.
- Navigate to Settings > Integrations > Workday Connector.
- Click Connect and enter:
- ISU Username & Password
- Base_url":
- Tenant ID
- The names of 3 RaaS Reports
- Set to Manual Sync or Auto Sync.
Updated about 10 hours ago
