Workday

使用 Workday 連接器呼叫 Workday SOAP 與 REST 服務,執行各種按需的業務管理服務。

此連接器適用於以下產品和區域:

服務 Class Regions
Copilot Studio 進階 除以下部分外,所有Power Automate區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
邏輯應用程式 標準 所有 Logic Apps 區域, 但下列區域除外:
     - Azure Government regions
     - Azure中國地區
     - 美國國防部 (DoD)
Power Apps 進階 除以下部分外,所有Power Apps區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
Power Automate(自動化服務) 進階 除以下部分外,所有Power Automate區域
     - 美國政府 (GCC)
     - 美國政府(海灣合作委員會高中)
     - 由 21Vianet 營運的中國雲
     - 美國國防部 (DoD)
連絡人​​
名稱 Microsoft
URL https://support.microsoft.com
連接器中繼資料
Publisher Microsoft
網站 https://www.workday.com/
隱私策略 https://www.workday.com/en-us/privacy.html
類別 人力資源

正在建立連線

連接器支援下列驗證類型:

[variables('aadAuthDefaultDisplayName')] [variables('aadAuthDefaultDescription')] 所有區域 不可共享
基本 請提供使用者名稱和密碼以使用 Workday 服務。 所有區域 不可共享
Microsoft Entra ID 整合 使用 Microsoft Entra ID 存取您的 Workday 實例。 只有 不可共享
Microsoft Entra ID 與 API 管理整合 透過 API 管理服務,使用 Microsoft Entra ID 存取您的 Workday 實例。 所有區域 不可共享
OAuth 2.0 使用 OAuth 2.0 驗證存取您的 Workday 執行個體。 所有區域 不可共享
預設值 [已棄用] 此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。 所有區域 不可共享

[variables('aadAuthDefaultDisplayName')]

驗證 ID:oauth

適用:所有地區

[variables('aadAuthDefaultDescription')]

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
Microsoft Entra 資源 URL (Application ID URI) 字串 Microsoft Entra ID 中目標資源的 URL 識別碼
Workday OAuth 權杖 URL 字串 Workday OAuth 權杖端點 URL (格式:https://< workday-host-name.workday.com/ccx/oauth2/>< tenant-name>/token)
Workday OAuth 用戶端識別碼 字串 您的 Workday OAuth 用戶端識別碼
SOAP 基礎 URL 字串 Workday 執行個體端點 URL (格式:https://< workday-host-name.workday.com/ccx/service>)
REST 基礎網址 字串 Workday REST API 根網址(格式:https://< workday-host-name.workday.com/ccx/api>)
租戶名稱 字串 Workday 執行個體租用戶名稱

基本

驗證 ID:基本

適用:所有地區

請提供使用者名稱和密碼以使用 Workday 服務。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
SOAP 基礎 URL 字串 Workday 執行個體端點 URL (格式:https://< workday-host-name.workday.com/ccx/service>)
租戶名稱 字串 Workday 執行個體租用戶名稱
用戶名稱 securestring Workday 帳戶使用者名稱 (格式: <user>@<tenant-name>)
密碼 securestring Workday 帳戶密碼

Microsoft Entra ID 整合

驗證 ID:oauth

適用:僅限

使用 Microsoft Entra ID 存取您的 Workday 實例。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
Microsoft Entra 資源 URL (Application ID URI) 字串 Microsoft Entra ID 中目標資源的 URL 識別碼
Workday OAuth 權杖 URL 字串 Workday OAuth 權杖端點 URL (格式:https://< workday-host-name.workday.com/ccx/oauth2/>< tenant-name>/token)
Workday OAuth 用戶端識別碼 字串 您的 Workday OAuth 用戶端識別碼
SOAP 基礎 URL 字串 Workday 執行個體端點 URL (格式:https://< workday-host-name.workday.com/ccx/service>)
REST 基礎網址 字串 Workday REST API 根網址(格式:https://< workday-host-name.workday.com/ccx/api>)
租戶名稱 字串 Workday 執行個體租用戶名稱

Microsoft Entra ID 與 API 管理整合

驗證識別碼:oauthapim

適用:所有地區

透過 API 管理服務,使用 Microsoft Entra ID 存取您的 Workday 實例。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
Microsoft Entra 資源 URL (Application ID URI) 字串 Microsoft Entra ID 中目標資源的 URL 識別碼
API 管理 服務基底 URL 字串 API 管理 的端點 URL (格式:https://< apim-host-name.azure-api.net/>< APIM URL 尾碼>)
REST 基礎網址 字串 Workday REST API 根網址(格式:https://< workday-host-name.workday.com/ccx/api>)
租戶名稱 字串 Workday 執行個體租用戶名稱

OAuth 2.0

驗證識別碼:oauth2generic

適用:所有地區

使用 OAuth 2.0 驗證存取您的 Workday 執行個體。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
OAuth授權URL 字串 來自 Workday 的 OAuth 授權端點 URL (格式:https://< workday-host-name>/workday/<tenant-name>/authorize)
OAuth權杖URL 字串 來自 Workday 的 OAuth 權杖端點 URL (格式:https://< workday-host-name>/ccx/oauth2/<tenant-name>/token)
OAuth用戶端ID 字串 來自 Workday 的 OAuth 用戶端識別碼
OAuth用戶端密碼 securestring 來自 Workday 的 OAuth 用戶端密碼
SOAP 基礎 URL 字串 Workday 執行個體端點 URL (格式:https://< workday-host-name.workday.com/ccx/service>)
REST 基礎網址 字串 Workday REST API 根網址(格式:https://< workday-host-name.workday.com/ccx/api>)
Workday 租用戶名稱 字串 Workday 執行個體租用戶名稱

預設值 [已棄用]

適用:所有地區

此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
SOAP 基礎 URL 字串 Workday 執行個體端點 URL (格式:https://< workday-host-name.workday.com/ccx/service>)
租戶名稱 字串 Workday 執行個體租用戶名稱
用戶名稱 securestring Workday 帳戶使用者名稱 (格式: <user>@<tenant-name>)
密碼 securestring Workday 帳戶密碼

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 200 60 秒

動作

取得員工收件匣任務(預覽)

回傳分配給指定工作者的收件匣任務。 依狀態篩選以查看已完成或已完成的任務。 需要 OAuth 2.0 認證。

取得員工直接下屬(預覽)

回傳直接向指定員工報告的員工名單。 需要 OAuth 2.0 認證。

取得員工管理的主管組織(預覽)

返回由指定員工管理的管理組織。 利用此資料將經理的員工ID解析為其主管組織ID,以便進行調動作業。 需要 OAuth 2.0 認證。

取得員工薪資單(預覽)

指定員工的薪資單摘要,包括薪資組成部分、總額及日期。 需要 OAuth 2.0 認證。

取得回饋範本(預覽)

回傳租戶中設定的回饋範本。 使用 templateType 來篩選「員工回饋」或「自我回饋」。 需要 OAuth 2.0 認證。

取得我的員工資料(預覽)

回傳已認證工作者的 Workday 設定檔。 需要 OAuth 2.0 認證。

執行 RaaS 操作

執行 RaaS(報告即服務)操作。

執行 REST 請求(預覽版)

利用登入使用者的 OAuth 憑證,對連線的 REST 基址執行 Workday REST 請求。 提供 HTTP 方法及相對路徑(租戶段可使用 {tenant} 佔位符,例如:person/v4/{tenant}/values/commonPhone/phoneDeviceTypes/)。 請求只能針對連線中設定的 Workday 主機,且 Workday 會強制執行已登入使用者的權限。 原始的 Workday 回應狀態和正文都未改變。 寫入方法(POST、PUT、PATCH)的請求實體會以 contentType 參數(預設為 application/json)所給的內容型態發送。 此動作不提供冪性鍵,因此呼叫者需負責寫入操作的重試語意。 需要 OAuth 2.0 認證。

執行 SOAP 操作

執行 SOAP 作業。

搜尋工作者(預覽)

依姓名搜尋工人。 使用搜尋參數來尋找選人情境的工人。 需要 OAuth 2.0 認證。

調動員工(預覽)

啟動指定員工的工作變動(調動)至新的主管組織。 需要 OAuth 2.0 認證。

請求對工人的回饋(預覽)

請求一位或多位回應者提供對指定員工的回饋。 需要 OAuth 2.0 認證。

取得員工收件匣任務(預覽)

回傳分配給指定工作者的收件匣任務。 依狀態篩選以查看已完成或已完成的任務。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
工作人員 ID
workerID True string

Workday 員工身份證。

限制
limit integer

要傳回的工作數目上限。 預設值為 20。 最高可達100。

Offset
offset integer

回應中第一個任務的零基指數。 使用分頁限制。

傳回

收件匣任務分頁清單。

取得員工直接下屬(預覽)

回傳直接向指定員工報告的員工名單。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
工作人員 ID
workerID True string

經理的Workday員工身份證。

限制
limit integer

最多要回來的直屬下屬。 預設值為 20。 最高可達100。

Offset
offset integer

回應中第一位直接報告者的零基指數。 使用分頁限制。

傳回

分頁的直屬下屬名單。

取得員工管理的主管組織(預覽)

返回由指定員工管理的管理組織。 利用此資料將經理的員工ID解析為其主管組織ID,以便進行調動作業。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
工作人員 ID
workerID True string

經理的Workday員工身份證。

限制
limit integer

最多的組織數量。 預設值為 20。 最高可達100。

Offset
offset integer

回應中第一個組織的零基指數。 使用分頁限制。

傳回

分頁的監督組織列表。

取得員工薪資單(預覽)

指定員工的薪資單摘要,包括薪資組成部分、總額及日期。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
工作人員 ID
workerID True string

Workday 員工身份證。

限制
limit integer

最多要歸還的薪資單數量。 預設值為 20。 最高可達100。

Offset
offset integer

回應中第一張薪資單的零基指數。 使用分頁限制。

傳回

分頁的薪資單清單。

取得回饋範本(預覽)

回傳租戶中設定的回饋範本。 使用 templateType 來篩選「員工回饋」或「自我回饋」。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
搜尋
search string

搜尋詞以依範本名稱篩選。

範本類型識別碼
templateType string

回饋範本類型 ID。 請使用 133de7d11fea10001dbb45973dec0097 來回饋員工,或用 133de7d11fea10001dbb45a701140098 來回饋自己。

工作人員 ID
worker string

工人 WID。 員工範本類型回饋的必要條件。

限制
limit integer

最多要回傳的範本數量。 預設且最高為 1000。

Offset
offset integer

回應中第一個範本的零基索引。 使用分頁限制。

傳回

回饋範本清單。

取得我的員工資料(預覽)

回傳已認證工作者的 Workday 設定檔。 需要 OAuth 2.0 認證。

傳回

Workday 員工摘要。

身體
WorkerSummary

執行 RaaS 操作

執行 RaaS(報告即服務)操作。

參數

名稱 機碼 必要 類型 Description
帳戶名稱
accountName True string

Workday 報表帳戶名稱。

報表名稱
reportName True string

Workday 報表名稱。

SOAP 要求內文
requestBody True binary

SOAP 要求內文。

報告執行個體名稱
reportInstanceName True string

Workday 報表執行個體名稱 (例如:Report2 或 customReport2)。

傳回

SOAP 回應主體。

SOAP 回應內文
binary

執行 REST 請求(預覽版)

利用登入使用者的 OAuth 憑證,對連線的 REST 基址執行 Workday REST 請求。 提供 HTTP 方法及相對路徑(租戶段可使用 {tenant} 佔位符,例如:person/v4/{tenant}/values/commonPhone/phoneDeviceTypes/)。 請求只能針對連線中設定的 Workday 主機,且 Workday 會強制執行已登入使用者的權限。 原始的 Workday 回應狀態和正文都未改變。 寫入方法(POST、PUT、PATCH)的請求實體會以 contentType 參數(預設為 application/json)所給的內容型態發送。 此動作不提供冪性鍵,因此呼叫者需負責寫入操作的重試語意。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
相對路徑
relativePath True string

Workday REST 相對路徑,位於 REST 基礎 URL 之後。 租戶區段使用 {tenant} 佔位符(例如:person/v4/{tenant}/values/commonPhone/phoneDeviceTypes/)。 必須是相對路徑;絕對網址會被拒絕。

HTTP 方法
method string

Workday REST 請求的 HTTP 方法。

內容類型
contentType string

寫入方法(POST、PUT、PATCH)請求體的內容型別。

請求主體
body binary

寫入方法(POST、PUT、PATCH)的請求體。 逐字回覆給Workday。 GET 和 DELETE 時留空。

傳回

原始的 Workday REST 回應主體。

回應機構
binary

執行 SOAP 操作

執行 SOAP 作業。

參數

名稱 機碼 必要 類型 Description
服務名稱
service True string

Workday Web 服務名稱。

服務版本
version True string

服務版本。

SOAP 要求內文
requestBody True binary

SOAP 要求內文。

傳回

SOAP 回應主體。

SOAP 回應內文
binary

搜尋工作者(預覽)

依姓名搜尋工人。 使用搜尋參數來尋找選人情境的工人。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
搜尋
search string

搜尋關鍵字以依姓名篩選員工(不區分大小寫字母)。

限制
limit integer

最多員工回來。 預設值為 20。 最高可達100。

Offset
offset integer

回應中第一個工人的零基指數。 使用分頁限制。

傳回

分頁的工人名單。

調動員工(預覽)

啟動指定員工的工作變動(調動)至新的主管組織。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
工作人員 ID
workerID True string

要調動員工的 Workday 員工識別碼。

ID
id string

Workday 資源 ID。

ID
id string

Workday 資源 ID。

生效日期
effective True date

轉移生效日期(YYYY-MM-DD)。

搬家經理團隊
moveManagersTeam boolean

若屬實,則將員工的報告團隊移至新的監督組織。

傳回

啟動的工作轉換流程。

請求對工人的回饋(預覽)

請求一位或多位回應者提供對指定員工的回饋。 需要 OAuth 2.0 認證。

參數

名稱 機碼 必要 類型 Description
工作人員 ID
workerID True string

請用的是員工回饋的 Workday 員工 ID。

ID
id string

Workday 資源 ID。

ID
id string

Workday 資源 ID。

Confidential
feedbackConfidential boolean

如果屬實,回饋資訊在醫療提供者與經理之間是保密的。 員工不會看到機密回饋。

顯示服務提供者名稱
showFeedbackProviderName boolean

若為真,則顯示回應者姓名。 若為錯誤,則保持匿名。

到期日
expirationDate date

回饋請求的到期日期(YYYY-MM-DD)。

傳回

創建的回饋請求事件。

定義

工作日物件參考

Workday 資源參考。

名稱 路徑 類型 Description
ID
id string

Workday 資源 ID。

收件匣任務

一個 Workday 收件匣的任務。

名稱 路徑 類型 Description
工作標識碼
id string

收件匣任務的 Workday ID。

任務名稱
descriptor string

收件匣任務的顯示名稱。

Workday 連結
href string

Workday 入口網站中的任務連結。

指定日期
assigned date

任務分配的日期。

到期日
due date

這項任務的截止日期。

狀態
status WorkdayObjectReference

Workday 資源參考。

步驟類型
stepType WorkdayObjectReference

Workday 資源參考。

啟動器
initiator WorkdayObjectReference

Workday 資源參考。

主旨
subject WorkdayObjectReference

Workday 資源參考。

整體過程
overallProcess WorkdayObjectReference

Workday 資源參考。

收件匣任務回應

收件匣任務分頁清單。

名稱 路徑 類型 Description
工作
data array of InboxTask

收件匣任務清單。

總數
total integer

符合篩選器的任務總數。

工作變動回應

啟動的工作轉換流程。

名稱 路徑 類型 Description
程序識別碼
id string

工作變更流程ID。

任務名稱
descriptor string

一份人手易讀的工作變更描述。

Workday 連結
href string

Workday 入口網站中工作變動的連結。

生效日期
effective date

轉移生效日期。

監督組織
supervisoryOrganization WorkdayObjectReference

Workday 資源參考。

請求回饋回應

創建的回饋請求事件。

名稱 路徑 類型 Description
事件識別碼
id string

回饋請求事件編號。

Description
descriptor string

一份人類可讀的回饋請求描述。

申請日期
requestDate date

回饋請求發起的日期。

現況
feedbackOverallStatus string

整體回饋請求流程的狀態。

回饋 關於
feedbackAbout WorkdayObjectReference

Workday 資源參考。

回饋範本

Workday 回饋範本。

名稱 路徑 類型 Description
範本識別碼
id string

回饋範本 ID。

範本名稱
descriptor string

回饋範本的顯示名稱。

回饋範本回應

回饋範本清單。

名稱 路徑 類型 Description
範本
data array of FeedbackTemplate

回饋範本清單。

總數
total integer

模板總數。

工人摘要

Workday 員工摘要。

名稱 路徑 類型 Description
工作人員 ID
id string

Workday 員工身份證。

工作者姓名
descriptor string

工人的顯示名稱。

工作者網址
href string

一個工人資源的連結。

是經理
isManager boolean

表示該員工是否為經理。

商業名稱
businessTitle string

員工的職稱。

工作電子郵件
primaryWorkEmail string

該員工的主要工作電子郵件地址。

公司電話
primaryWorkPhone string

員工的主要工作電話號碼。

主要監督組織
primarySupervisoryOrganization WorkdayObjectReference

Workday 資源參考。

工人摘要回應

分頁的工人名單。

名稱 路徑 類型 Description
工作者
data array of WorkerSummary

工人名單。

總數
total integer

與搜尋相符的工人總數。

監督組織

一個Workday監督組織。

名稱 路徑 類型 Description
組織識別碼
id string

Workday 管理組織的識別碼。

組織名稱
descriptor string

組織的展示名稱。

組織網址
href string

組織資源連結。

名稱
name string

組織名稱。

Code
code string

組織代碼。

監督機構回應

分頁的監督組織列表。

名稱 路徑 類型 Description
Organizations
data array of SupervisoryOrganization

監督組織名單。

總數
total integer

監督組織總數。

直報

一位直接向指定經理報告的員工。

名稱 路徑 類型 Description
工作人員 ID
id string

Workday 員工身份證。

工作者姓名
descriptor string

工人的顯示名稱。

工作者網址
href string

工作者資源的網址連結。

是經理
isManager boolean

表示該員工是否為經理。

商業名稱
businessTitle string

員工的職稱。

工作電子郵件
primaryWorkEmail string

該員工的主要工作電子郵件地址。

公司電話
primaryWorkPhone string

員工的主要工作電話號碼。

主要監督組織
primarySupervisoryOrganization WorkdayObjectReference

Workday 資源參考。

直接報告回應

分頁的直屬下屬名單。

名稱 路徑 類型 Description
直接報告
data array of DirectReport

直屬下屬名單。

總數
total integer

總直屬下屬人數。

薪資單

一份薪資單摘要。

名稱 路徑 類型 Description
薪資單識別碼
id string

薪資單的身分證。

支薪期間
descriptor string

薪資單的顯示名稱通常會包含薪資期間的日期。

Workday 連結
href string

Workday 入口網站的薪資單連結。

付款日期
date date

付款日期。

毛收入
gross number

毛薪資金額。

淨薪
net number

扣除後的淨薪資金額。

狀態
status WorkdayObjectReference

Workday 資源參考。

薪資單回應

分頁的薪資單清單。

名稱 路徑 類型 Description
薪資單
data array of PaySlip

薪資單清單。

總數
total integer

薪資單總數。

二進位

這是基本數據類型 『binary』。