技术参考

Workday REST 连接器活动的技术参考。

本节包含与 Workday REST 活动进行交互时可能需要的有用信息。

使用“执行 WQL 查询”活动

重要提示：

要使用“执行 WQL 查询”活动，您必须配置“系统 - Workday 查询语言”作用域。有关更多信息，请参阅Workday 身份验证。

Workday 查询语言或 WQL是一种类 SQL 查询语言，提供查询 Workday 数据的增强功能。由于它类似于 SQL，您可以在 Workday 中手动创建查询，或使用“执行 WQL 查询”活动将现有报告转换为 WQL。

您可以将高级报告和矩阵报告转换为 Workday 查询语言 (WQL)，然后在“执行 WQL 查询”活动中使用生成的查询从 Workday 中提取数据。

可以参考以下示例：

1. 在 Workday 中，搜索 “将报告转换为 WQL”任务。

   

2. 选择要转换的报告，然后选择“转换的 WQL 查询字符串” 。

   

   

3. 接下来，在“执行 WQL 查询”活动中输入复制的查询，然后选择“生成输出架构”按钮。

   

4. 此操作会生成一个输出字段列表。

   

您还可以使用数据源对象探索 Workday 表并创建自己的查询。您可以通过“数据源字段”对象访问表格的列，并且“数据源筛选器”对象中提供可筛选字段。有关更多信息，请参阅有关数据源的 Workday REST 文档。

需要考虑的重要事项

1. 您必须首先生成查询结果的输出架构，然后在设计时将任何列值替换为变量。
2. 您可以使用LIMIT和OFFSET参数对大型数据集进行分页。
3. 如果出现以下情况，您可能会遇到以下错误消息：

   1. API 客户端中缺少系统作用域。检查 API 客户端的作用域（功能领域） 。

   2. 您的查询不正确或包含变量。请确保您在 Workday 中成功运行“查看 WQL 查询结果”任务，并在“执行 WQL 查询”活动中使用正确的查询。

      

WQL 数据源参考

下表列出了列出记录活动中可用的策划 WQL 数据源别名，并按主要业务对象组织。所有列出的数据源都是 Workday 提供的标准对象，这些对象存在于所有租户中，无需其他参数即可查询。

要发现特定租户中的所有可用数据源，请调用：

GET /api/wql/v1/dataSources

工作器

数据源别名	描述	常见用例
allWorkers	所有工作人员（员工和团队）	完全劳动力同步，身份配置
allActiveEmployees	当前在职的员工	在职员工报告、工资单订阅源
allContingentWorkers	临时工和合同工	供应商管理、访问配置
allTerminatedWorkers	已终止的工作器	离职、合规性审核
allPreHires	预租用记录	入门工作流
allLeaveOfAbsenceWorkers	当前正在休假的员工	请假跟踪，收益连续性
allRetiredWorkers	退休人员	退休金和退休人员福利订阅源
workerHistory	历史工作器变更记录	审核线索，变更追踪
workerCompensation	每个工作器的薪酬数据	薪资集成、总奖励
workerBenefitElections	权益注册详情	运营商订阅源，收益报告
workerTimeOff	请假余额和条目	请假余额报告
workerPersonalData	个人信息（地址、出生日期等）	人力资源数据同步，合规性
workerDocuments	附加的工作器文档	文档管理集成
workerAccountProvisioning	帐户和身份配置数据	IAM 同步（例如，Okta、Azure AD）

组织

数据源别名	描述	常见用例
allOrganizations	所有组织类型（默认）	组织结构同步
allSupervisoryOrganizations	主管组织层次结构	经理层次结构、组织图表
allCostCenters	成本中心列表	财务报告、成本分摊
allCompanies	法人实体和公司列表	多实体报告
allRegions	区域结构	基于地理位置的报告
allCustomOrganizations	自定义组织类型	特定于客户的组织结构
organizationHierarchies	完整组织树	提供给下游系统的层次结构订阅源
allBusinessUnits	业务单元结构	段级别报告

位置

数据源别名	描述	常见用例
allPositions	所有位置	位置目录同步
allOpenPositions	空缺职位和空缺职位	招聘管道、劳动力规划
allFilledPositions	当前职位空缺	人数报告
positionBudget	职位预算数据	财务规划集成
positionRestrictions	职位限制	合规性和监管
allHeadcountGroups	人数跟踪组	劳动力分析

招聘（职位申请）

数据源别名	描述	常见用例
allJobApplications	正在招聘应用程序	ATS 集成、招聘分析
allJobRequisitions	未结申请	请购单追踪
allCandidates	候选对象池	候选管道报告
allOffers	职位邀请	产品管理订阅源
allInterviews	采访记录	面试安排分析
allReferrals	员工推荐	推荐计划追踪

补偿

数据源别名	描述	常见用例
allCompensationPlans	薪酬计划结构	计划管理
allCompensationGrades	等级和级别定义	成绩映射集成
allCompensationPackages	打包薪酬	总回报报告
allBonusPlans	奖励结构	红利支付订阅源
allStockPlans	股票和权益计划	权益管理
allMeritPlans	绩效提升计划	年度绩效周期订阅源

收益

数据源别名	描述	常见用例
allBenefitPlans	福利计划目录	计划设置验证
allBenefitGroups	福利资格组	资格规则审核
allHealthCareCoverage	健康覆盖数据	运营商注册订阅源
allInsuranceCoverage	人寿与残障保险	保险公司订阅源
allRetirementPlans	401k 和退休金计划	停用的供应商订阅源
allBenefitElections	有效选择	公开注册报告

时间追踪和缺勤

数据源别名	描述	常见用例
allTimeEntries	打卡时间条目	工资单时间订阅源
allAbsenceRequests	请假	假期管理
allTimeOffPlans	休假计划定义	计划配置同步
allLeaveTypes	假期类型目录	假期策略报告
allTimeCalendars	日历配置	计划管理

人才与绩效

数据源别名	描述	常见用例
allPerformanceReviews	审核周期数据	性能分析
allGoals	员工目标	目标跟踪集成
allCompetencies	能力框架	技能差距分析
allSuccessionPlans	继任者池	继任计划
allTalentPools	人才管道	人才管理
allLearningCourses	LMS 课程目录	学习平台同步

HTTP 请求

您可以使用“HTTP 请求”活动调用任何 Workday REST API，只要为所使用的 API 客户端分配所需的权限即可。有关更多信息，请参阅 Workday REST 连接器身份验证指南。