技术参考

本节包含与 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 查询”活动中使用正确的查询。

      
      

      

      
      

HTTP 请求

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