Workday

使用 Workday 连接器调用 Workday SOAP 和 REST 服务来执行各种按需业务管理服务。

此连接器在以下产品和区域中可用：

服务	Class	区域
Copilot Studio	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
逻辑应用程序	标准	除以下各项外的所有逻辑应用区域： - Azure 政府区域 - Azure中国区域 - 美国国防部（DoD）
Power Apps	高级	除以下各项外的所有 Power Apps 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）
Power Automate	高级	除以下各项外的所有 Power Automate 区域： - 美国政府（GCC） - 美国政府（GCC High） - 由世纪互联运营的中国云 - 美国国防部（DoD）

联系人
Name	Microsoft
URL	https://support.microsoft.com

连接器元数据
Publisher	Microsoft
网站	https://www.workday.com/
隐私策略	https://www.workday.com/en-us/privacy.html
类别	人力资源

正在创建连接

连接器支持以下身份验证类型：


基本	提供用户名和密码以访问 Workday 服务。	所有区域	不可共享
Microsoft Entra ID 集成	使用 Microsoft Entra ID访问 Workday 实例。	所有区域	不可共享
Microsoft Entra ID与 API 管理集成	通过 API 管理服务通过 Microsoft Entra ID 访问 Workday 实例。	所有区域	不可共享
OAuth 2.0	使用 OAuth 2.0 身份验证访问 Workday 实例。	所有区域	不可共享
默认值 [已弃用]	此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。	所有区域	不可共享

基本

身份验证 ID：基本

适用：所有区域

提供用户名和密码以访问 Workday 服务。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
SOAP 基 URL	字符串	Workday 实例终结点 URL（格式：https://< workday-host-name.workday.com/ccx/service>）	True
租户名称	字符串	Workday 实例租户名称	True
用户名	securestring	Workday 帐户用户名（格式： <user>@<tenant-name>）	True
密码	securestring	Workday 帐户密码	True

Microsoft Entra ID集成

身份验证 ID：oauth

适用：所有区域

使用 Microsoft Entra ID访问 Workday 实例。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
Microsoft Entra资源 URL （应用程序 ID URI）	字符串	目标资源的Microsoft Entra ID中的 URL 标识符	True
Workday OAuth 令牌 URL	字符串	Workday OAuth 令牌终结点 URL （格式：https://< workday-host-name.workday.com/ccx/oauth2/> tenant-name<>/token）	True
Workday OAuth 客户端 ID	字符串	Workday OAuth 客户端 ID	True
SOAP 基 URL	字符串	Workday 实例终结点 URL（格式：https://< workday-host-name.workday.com/ccx/service>）	True
REST 基 URL	字符串	Workday REST API 根 URL（格式：https://< workday-host-name.workday.com/ccx/api/>< tenant-name>）
租户名称	字符串	Workday 实例租户名称	True

Microsoft Entra ID与 API 管理集成

身份验证 ID：oauthapim

适用：所有区域

通过 API 管理服务通过 Microsoft Entra ID 访问 Workday 实例。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
Microsoft Entra资源 URL （应用程序 ID URI）	字符串	目标资源的Microsoft Entra ID中的 URL 标识符	True
API 管理服务基 URL	字符串	API 管理的终结点 URL（格式：https://< apim-host-name.azure-api.net/>< APIM URL 后缀>）	True
REST 基 URL	字符串	Workday REST API 根 URL（格式：https://< workday-host-name.workday.com/ccx/api/>< tenant-name>）
租户名称	字符串	Workday 实例租户名称	True

OAuth 2.0

身份验证 ID：oauth2generic

适用：所有区域

使用 OAuth 2.0 身份验证访问 Workday 实例。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
OAuth 授权 URL	字符串	Workday 中的 OAuth 授权终结点 URL（格式：https://< workday-host-name>/workday/<tenant-name>/authorize）	True
OAuth 令牌 URL	字符串	Workday 中的 OAuth 令牌终结点 URL（格式：https://< workday-host-name>/ccx/oauth2/<tenant-name>/token）	True
OAuth 客户端 ID	字符串	Workday 中的 OAuth 客户端 ID	True
OAuth 客户端密码	securestring	Workday 中的 OAuth 客户端机密	True
SOAP 基 URL	字符串	Workday 实例终结点 URL（格式：https://< workday-host-name.workday.com/ccx/service>）	True
REST 基 URL	字符串	Workday REST API 根 URL（格式：https://< workday-host-name.workday.com/ccx/api/>< tenant-name>）
Workday 租户名称	字符串	Workday 实例租户名称	True

默认值 [已弃用]

适用：所有区域

此选项仅适用于没有显式身份验证类型的较旧连接，并且仅用于向后兼容性。

这是不可共享的连接。如果 Power App 与另一个用户共享，系统会提示其他用户显式创建新连接。

Name	类型	Description	必选
SOAP 基 URL	字符串	Workday 实例终结点 URL（格式：https://< workday-host-name.workday.com/ccx/service>）	True
租户名称	字符串	Workday 实例租户名称	True
用户名	securestring	Workday 帐户用户名（格式： <user>@<tenant-name>）	True
密码	securestring	Workday 帐户密码	True

限制

名称	调用	续订期
每个连接的 API 调用数	200	60 秒

操作

执行 RaaS 操作	执行 RaaS（报告即服务）作。
执行 SOAP 操作	执行 SOAP作。
搜索工作者（预览版）	按名称搜索辅助角色。使用搜索参数查找人员选取器方案。需要 OAuth 2.0 身份验证。
获取反馈模板（预览版）	返回租户中配置的反馈模板。使用 templateType 按“辅助角色反馈”或“自我反馈”进行筛选。需要 OAuth 2.0 身份验证。
获取工人工资单（预览版）	返回指定辅助角色的工资单摘要，包括薪酬组件、总计和日期。需要 OAuth 2.0 身份验证。
获取我的辅助角色配置文件（预览版）	返回经过身份验证的辅助角色的 Workday 配置文件。需要 OAuth 2.0 身份验证。
获取由辅助角色管理的监督组织（预览版）	返回由指定辅助角色管理的监督组织。使用此 ID 可将经理的工作 ID 解析为其主管组织 ID 进行传输操作。需要 OAuth 2.0 身份验证。
获取辅助角色收件箱任务（预览版）	返回分配给指定辅助角色的收件箱任务。按状态筛选以查看打开或已完成的任务。需要 OAuth 2.0 身份验证。
获取辅助角色直接报告（预览版）	返回直接向指定辅助角色报告的工作器的列表。需要 OAuth 2.0 身份验证。
请求有关辅助角色的反馈（预览版）	从一个或多个响应方请求对指定辅助角色的反馈。需要 OAuth 2.0 身份验证。
转移员工（预览版）	为指定的辅助角色启动作业更改（转移）到新的监督组织。需要 OAuth 2.0 身份验证。

执行 RaaS 操作

操作 ID:: RaaS_Operation

执行 RaaS（报告即服务）作。

参数

名称	密钥	必需	类型	说明
帐户名	accountName	True	string	Workday 报表帐户名称。
报告名	reportName	True	string	Workday 报表名称。
SOAP 请求正文	requestBody	True	binary	SOAP 请求正文。
报表实例名称	reportInstanceName	True	string	Workday 报表实例名称（例如：Report2 或 customReport2）。

返回

SOAP 响应正文。

SOAP 响应正文: binary

执行 SOAP 操作

操作 ID:: SOAP_Operation

执行 SOAP作。

参数

名称	密钥	必需	类型	说明
服务名称	service	True	string	Workday Web 服务名称。
服务版本	version	True	string	服务版本。
SOAP 请求正文	requestBody	True	binary	SOAP 请求正文。

返回

SOAP 响应正文。

SOAP 响应正文: binary

搜索工作者（预览版）

操作 ID:: SearchWorkers

按名称搜索辅助角色。使用搜索参数查找人员选取器方案。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
搜寻	search		string	按名称筛选辅助角色的搜索词（不区分大小写）。
限度	limit		integer	要返回的最大工作器数。默认值为 20。最大值为 100。
Offset	offset		integer	响应中第一个辅助角色的从零开始的索引。与分页的限制一起使用。

返回

分页的辅助角色列表。

Body: WorkerSummaryResponse

获取反馈模板（预览版）

操作 ID:: GetFeedbackTemplates

返回租户中配置的反馈模板。使用 templateType 按“辅助角色反馈”或“自我反馈”进行筛选。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
搜寻	search		string	按名称筛选模板的搜索词。
模板类型 ID	templateType		string	反馈模板类型 ID。使用 133de7d11fea10001dbb45973dec0097 for Feedback on Worker 或 133de7d11fea10001dbb45a701140098 for Feedback on Self.
辅助角色 ID	worker		string	辅助角色 WID。有关辅助角色模板类型的反馈是必需的。
限度	limit		integer	要返回的最大模板数。默认值和最大值为 1000。
Offset	offset		integer	响应中第一个模板的从零开始的索引。与分页的限制一起使用。

返回

反馈模板列表。

Body: FeedbackTemplatesResponse

获取工人工资单（预览版）

操作 ID:: GetWorkerPaySlips

返回指定辅助角色的工资单摘要，包括薪酬组件、总计和日期。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
辅助角色 ID	workerID	True	string	Workday 辅助角色 ID。
限度	limit		integer	要返回的最大工资单数。默认值为 20。最大值为 100。
Offset	offset		integer	响应中第一个工资单的从零开始的索引。与分页的限制一起使用。

返回

分页工资单列表。

Body: PaySlipsResponse

获取我的辅助角色配置文件（预览版）

操作 ID:: GetWorkerMe

返回经过身份验证的辅助角色的 Workday 配置文件。需要 OAuth 2.0 身份验证。

返回

Workday 辅助角色摘要。

Body: WorkerSummary

获取由辅助角色管理的监督组织（预览版）

操作 ID:: GetSupervisoryOrganizationsManaged

返回由指定辅助角色管理的监督组织。使用此 ID 可将经理的工作 ID 解析为其主管组织 ID 进行传输操作。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
辅助角色 ID	workerID	True	string	管理器的 Workday 辅助角色 ID。
限度	limit		integer	要返回的最大组织数。默认值为 20。最大值为 100。
Offset	offset		integer	响应中第一个组织的从零开始的索引。与分页的限制一起使用。

返回

监督组织的分页列表。

Body: SupervisoryOrganizationsResponse

获取辅助角色收件箱任务（预览版）

操作 ID:: GetWorkerInboxTasks

返回分配给指定辅助角色的收件箱任务。按状态筛选以查看打开或已完成的任务。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
辅助角色 ID	workerID	True	string	Workday 辅助角色 ID。
限度	limit		integer	要返回的最大任务数。默认值为 20。最大值为 100。
Offset	offset		integer	响应中第一个任务的从零开始的索引。与分页的限制一起使用。

返回

收件箱任务的分页列表。

Body: InboxTasksResponse

获取辅助角色直接报告（预览版）

操作 ID:: GetWorkerDirectReports

返回直接向指定辅助角色报告的工作器的列表。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
辅助角色 ID	workerID	True	string	管理器的 Workday 辅助角色 ID。
限度	limit		integer	要返回的直接报告的最大数目。默认值为 20。最大值为 100。
Offset	offset		integer	响应中第一个直接报表的从零开始的索引。与分页的限制一起使用。

返回

直接报表的分页列表。

Body: DirectReportsResponse

请求有关辅助角色的反馈（预览版）

操作 ID:: RequestFeedback

从一个或多个响应方请求对指定辅助角色的反馈。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
辅助角色 ID	workerID	True	string	正在请求工作线程反馈的 Workday 辅助角色 ID。
ID	id		string	Workday 资源 ID。
ID	id		string	Workday 资源 ID。
Confidential	feedbackConfidential		boolean	如果为 true，则提供程序和经理之间的反馈是机密的。工作人员看不到机密反馈。
显示提供程序名称	showFeedbackProviderName		boolean	如果为 true，则显示响应者的名称。如果为 false，则保持匿名。
到期日期	expirationDate		date	反馈请求过期的日期（YYYY-MM-DD）。

返回

创建的反馈请求事件。

Body: RequestFeedbackResponse

转移员工（预览版）

操作 ID:: TransferEmployee

为指定的辅助角色启动作业更改（转移）到新的监督组织。需要 OAuth 2.0 身份验证。

参数

名称	密钥	必需	类型	说明
辅助角色 ID	workerID	True	string	要转移的员工的 Workday 辅助角色 ID。
ID	id		string	Workday 资源 ID。
ID	id		string	Workday 资源 ID。
生效日期	effective	True	date	转移生效的日期（YYYY-MM-DD）。
移动经理的团队	moveManagersTeam		boolean	如果为 true，则将工人的报告团队移动到新的监督组织。

返回

启动的作业更改过程。

Body: JobChangeResponse

定义

WorkdayObjectReference

Workday 资源参考。

名称	路径	类型	说明
ID	id	string	Workday 资源 ID。

InboxTask

单个 Workday 收件箱任务。

名称	路径	类型	说明
任务标识	id	string	收件箱任务的 Workday ID。
任务标题	descriptor	string	收件箱任务的显示名称。
Workday 链接	href	string	指向 Workday 门户中任务的链接。
已指定日期	assigned	date	分配任务的日期。
截止日期	due	date	此任务的截止日期。
状态	status	WorkdayObjectReference	Workday 资源参考。
stepType	stepType	WorkdayObjectReference	Workday 资源参考。
发起程序	initiator	WorkdayObjectReference	Workday 资源参考。
主题	subject	WorkdayObjectReference	Workday 资源参考。
overallProcess	overallProcess	WorkdayObjectReference	Workday 资源参考。

InboxTasksResponse

收件箱任务的分页列表。

名称	路径	类型	说明
任务	data	array of InboxTask	收件箱任务列表。
Total	total	integer	与筛选器匹配的任务总数。

JobChangeResponse

启动的作业更改过程。

名称	路径	类型	说明
进程ID	id	string	作业更改进程 ID。
任务标题	descriptor	string	作业更改的人工可读说明。
Workday 链接	href	string	Workday 门户中作业更改的链接。
生效日期	effective	date	转移的有效日期。
supervisoryOrganization	supervisoryOrganization	WorkdayObjectReference	Workday 资源参考。

RequestFeedbackResponse

创建的反馈请求事件。

名称	路径	类型	说明
事件 ID	id	string	反馈请求事件 ID。
Description	descriptor	string	反馈请求的用户可读说明。
请求日期	requestDate	date	反馈请求启动的日期。
Status	feedbackOverallStatus	string	反馈请求过程的总体状态。
feedbackAbout	feedbackAbout	WorkdayObjectReference	Workday 资源参考。

FeedbackTemplate

Workday 反馈模板。

名称	路径	类型	说明
模板 ID	id	string	反馈模板 ID。
模板名称	descriptor	string	反馈模板的显示名称。

FeedbackTemplatesResponse

反馈模板列表。

名称	路径	类型	说明
Templates	data	array of FeedbackTemplate	反馈模板列表。
Total	total	integer	模板总数。

WorkerSummary

Workday 辅助角色摘要。

名称	路径	类型	说明
辅助角色 ID	id	string	Workday 辅助角色 ID。
工作人员姓名	descriptor	string	辅助角色的显示名称。
辅助角色 URL	href	string	指向辅助角色资源的链接。
Is manager	isManager	boolean	指示辅助角色是否为经理。
业务标题	businessTitle	string	工人的业务标题。
工作电子邮件	primaryWorkEmail	string	辅助角色的主要工作电子邮件地址。
工作电话	primaryWorkPhone	string	辅助角色的主要工作电话号码。
primarySupervisoryOrganization	primarySupervisoryOrganization	WorkdayObjectReference	Workday 资源参考。

WorkerSummaryResponse

分页的辅助角色列表。

名称	路径	类型	说明
工人	data	array of WorkerSummary	辅助角色列表。
Total	total	integer	与搜索匹配的辅助角色总数。

监管机构

Workday 监督组织。

名称	路径	类型	说明
组织 ID	id	string	Workday 监督组织 ID。
组织名称	descriptor	string	组织的显示名称。
组织 URL	href	string	指向组织资源的链接。
Name	name	string	组织名称。
Code	code	string	组织代码。

SupervisoryOrganizationsResponse

监督组织的分页列表。

名称	路径	类型	说明
Organizations	data	array of SupervisoryOrganization	监督组织列表。
Total	total	integer	监督组织总数。

DirectReport

直接向指定经理报告的工作线程。

名称	路径	类型	说明
辅助角色 ID	id	string	Workday 辅助角色 ID。
工作人员姓名	descriptor	string	辅助角色的显示名称。
辅助角色 URL	href	string	指向辅助角色资源的 URL 链接。
Is manager	isManager	boolean	指示辅助角色是否为经理。
业务标题	businessTitle	string	工人的业务标题。
工作电子邮件	primaryWorkEmail	string	辅助角色的主要工作电子邮件地址。
工作电话	primaryWorkPhone	string	辅助角色的主要工作电话号码。
primarySupervisoryOrganization	primarySupervisoryOrganization	WorkdayObjectReference	Workday 资源参考。

DirectReportsResponse

直接报表的分页列表。

名称	路径	类型	说明
直接下属	data	array of DirectReport	直接报告的列表。
Total	total	integer	直接报告总数。

PaySlip

单个工资单单摘要。

名称	路径	类型	说明
付款单 ID	id	string	工资单 ID。
付薪期间	descriptor	string	工资单的显示名称，通常包括工资周期日期。
Workday 链接	href	string	Workday 门户中工资单的链接。
付款日期	date	date	付款日期。
总工资	gross	number	总薪酬金额。
净付款	net	number	扣除后净支付金额。
状态	status	WorkdayObjectReference	Workday 资源参考。

PaySlipsResponse

分页工资单列表。

名称	路径	类型	说明
工资单	data	array of PaySlip	工资单列表。
Total	total	integer	工资单总数。

二进制

这是基本数据类型“binary”。