教學課程：設定從 Microsoft Entra ID 至 Workday 的屬性回寫

發行項
11/23/2024

本教學課程旨在說明將屬性從 Microsoft Entra ID 回寫到 Workday 時所需執行的步驟。 Workday 回寫佈建應用程式支援將值指派給下列 Workday 屬性：

公司電子郵件
Workday 使用者名稱
工作有線電話的電話號碼 (包括國碼 (地區碼)、區碼、號碼和分機)
工作有線電話的電話號碼主要旗標
工作行動電話的電話號碼 (包括國碼 (地區碼)、區碼、號碼)
工作行動電話主要旗標

概觀

當您使用 Workday 至內部部署 AD 佈建應用程式或 Workday 至 Microsoft Entra ID 佈建應用程式來設定輸入佈建整合之後，您可以選擇性地設定 Workday Writeback 應用程式來將連絡資訊 (例如工作電子郵件和電話號碼) 寫入 Workday。

誰最適合使用此使用者佈建解決方案？

此 Workday Writeback 使用者佈建解決方案最適合下列對象：

使用 Microsoft 365 且想要將由 IT 管理的授權屬性 (例如電子郵件地址、電話、使用者名稱) 回寫到 Workday 的組織

在 Workday 中設定整合系統使用者

請參閱設定整合系統使用者一節，以建立具有取得員工資料權限的 Workday 整合系統使用者帳戶。

設定 Microsoft Entra 屬性回寫至 Workday

請遵循下列指示，設定將使用者電子郵件地址和使用者名稱，從 Microsoft Entra ID 回寫至 Workday。

新增回寫連接器應用程式和建立 Workday 連線
設定回寫屬性對應
啟用及啟動使用者佈建

第 1 部分：新增回寫連接器應用程式和建立 Workday 連線

設定 Workday 回寫連接器：

以至少雲端應用程式系統管理員的身分登入 Microsoft Entra 系統管理中心。
瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。
搜尋 Workday Writeback，並從資源庫新增該應用程式。
新增應用程式且出現應用程式詳細資料畫面之後，請選取 [佈建]。
將 [布建模式] 變更為 [自動]。
完成 [系統管理員認證] 區段，如下所示：
- 系統管理員使用者名稱 – 輸入 Workday 整合系統帳戶的使用者名稱，並附加租用戶網域名稱。看起來應該像這樣：username@contoso4
- 管理員密碼 – 輸入 Workday 整合系統帳戶的密碼
- 租用戶 URL – 輸入租用戶 Workday Web 服務端點的 URL。此值應該看起來像這樣：https://wd3-impl-services1.workday.com/ccx/service/contoso4/Human_Resources，其中會以您的正確租用戶名稱取代 contoso4，以及以正確的環境字串取代 wd3-impl (如有必要)。
- 通知電子郵件 – 輸入您的電子郵件地址，然後勾選 [發生失敗時傳送電子郵件] 核取方塊。
- 按一下 [測試連線] 按鈕。如果連線測試成功，請按一下頂端的 [儲存] 按鈕。如果失敗，請仔細檢查 Workday URL 和認證在 Workday 中是否有效。

不 2 部分：不設定回寫屬性對應

在本節中，您會設定回寫屬性從 Microsoft Entra ID 流向 Workday 的方式。

在 [佈建] 索引標籤的 [對應] 下，按一下對應名稱。
在 [來源物件範圍] 欄位中，您可以視需要篩選 Microsoft Entra ID 中應加入回寫的使用者集合。預設範圍為 Microsoft Entra ID 中的所有使用者。
在 [屬性對應] 區段中，更新相符的識別碼，代表 Microsoft Entra ID 中儲存了 Workday 人員識別碼或員工識別碼的屬性。常用的比對方法是將 Workday 人員識別碼或員工識別碼同步至 Microsoft Entra ID 中的 extensionAttribute1-15，然後在 Microsoft Entra ID 中使用此屬性再次比對 Workday 的使用者。
通常您會將 Microsoft Entra ID userPrincipalName 屬性對應至 Workday UserID 屬性，並將 Microsoft Entra ID mail 屬性對應至 Workday EmailAddress 屬性。

使用下列指導，將電話號碼屬性值從 Microsoft Entra ID 對應至 Workday。請參閱回寫運算式對應範例，以設定每個屬性的正確運算式對應。

Workday 電話屬性	預期值	對應指引
WorkphoneLandlineIsPrimary	true/false	其輸出為 "true" 或 "false" 字串值的常數或運算式對應。
WorkphoneLandlineCountryCodeName	三個字母的 ISO 3166-1 國碼 (地區碼)	其輸出為三字母國碼 (地區碼) 的常數或運算式對應。
WorkphoneLandlineCountryCodeNumber	國際電話區號	其輸出為有效國碼 (地區碼) 的常數或運算式對應 (不包含 + 符號)。
WorkphoneLandlineNumber	完整的電話號碼，包括區碼	對應至 telephoneNumber 屬性。使用 RegEx 移除空白字元、括弧和國碼 (地區碼)。
WorkphoneLandlineExtension	分機號碼	如果 telephoneNumber 包含分機，請使用 RegEx 來擷取該值。
WorkphoneMobileIsPrimary	true/false	其輸出為 "true" 或 "false" 字串值的常數對應或運算式對應
WorkphoneMobileCountryCodeName	三個字母的 ISO 3166-1 國碼 (地區碼)	其輸出為三字母國碼 (地區碼) 的常數或運算式對應。
WorkphoneMobileCountryCodeNumber	國際電話區號	其輸出為有效國碼 (地區碼) 的常數或運算式對應 (不包含 + 符號)。
WorkphoneMobileNumber	完整的電話號碼，包括區碼	對應至 mobile 屬性。使用 RegEx 移除空白字元、括弧和國碼 (地區碼)。

注意

叫用 Change_Work_Contact Workday Web 服務時，Microsoft Entra ID 會傳送下列常數值：

Communication_Usage_Type_ID 會設定為常數字串 WORK
Phone_Device_Type_ID 會針對行動電話號碼設定為常數字串 Mobile，而針對有線電話的電話號碼設為 Landline。

如果您的 Workday 租用戶使用不同的 Type_ID，您將會遇到回寫失敗。若要避免這類失敗，您可以使用 Workday 維護參考識別碼工作並更新 Type_ID，以符合 Microsoft Entra ID 所使用的值。

若要儲存您的對應，請按一下 [屬性對應] 區段頂端的 [儲存]。

回寫運算式對應範例

本節提供針對常見整合案例設定 Workday Writeback 應用程式的範例。

為預先雇用的回寫計時
使用國家/地區代碼和電話號碼處理電話號碼
從 Microsoft Entra ID usageLocation 屬性衍生國家/地區代碼
擷取 10 位數的電話號碼
移除電話號碼中的空格、虛線和括弧
處理內嵌電話號碼分機

為預先雇用的回寫計時

在典型的 Workday 與 Microsoft Entra ID 整合中，輸入使用者佈建應用程式 - Workday 至內部部署的 Active Directory 或 Workday 至 Microsoft Entra ID - 為預先雇用建立新的 Microsoft Entra ID 帳戶，為使用者產生唯一的電子郵件和 userPrincipalName。

根據預設，Workday Writeback 應用程式會在 Microsoft Entra ID 中建立使用者之後，立即嘗試在 Workday 帳戶上設定工作電子郵件和 userID 值。

若要延遲 UserID 或電子郵件回寫，使其在雇用日期或之後發生，請遵循這些步驟：

Microsoft Entra ID 中有一個名為 employeeHireDate 的屬性，您可以在其中擷取使用者的雇用開始日期。
如果您使用 Workday 至內部部署 Active Directory 佈建作業，請將其設定為將 Workday StatusHireDate 欄位流向內部部署 Active Directory 中的屬性 (例如 extensionAttribute8)。設定 Microsoft Entra Connect 將內部部署值同步至 Microsoft Entra ID 中的 employeeHireDate。
如果您使用 Workday 至 Microsoft Entra ID 佈建作業，請將其設定為將 Workday StatusHireDate 欄位直接流向 Azure AD 中的 employeeHireDate 屬性。

注意

如果您要將員工開始日期儲存在任何其他Microsoft Entra ID extensionAttribute中，您可以在下一個運算式中使用該屬性，而不是 employeeHireDate。
在您的 Workday Writeback 應用程式中，使用下列運算式規則將 Microsoft Entra userPrincipalName 匯出至 Workday UserID 欄位。
```
IgnoreFlowIfNullOrEmpty(IIF(DateDiff("d", Now(), CDate([employeeHireDate])) >= 0, "", [userPrincipalName]))
```
上一個運算式會使用 DateDiff 函式來評估 employeeHireDate 與使用 Now 函式取得的今天日期 (UTC) 之間的差異。如果 employeeHireDate 大於或等於今天的日期，則會更新 UserID。否則會傳回空值，而 IgnoreFlowIfNullOrEmpty 函式會從 Writeback 排除中此屬性。

重要

為了讓延遲的 Writeback 如預期般運作，內部部署 Active Directory 或 Microsoft Entra ID 中的作業必須在抵達前一天或雇用日期觸發對使用者的變更，以便更新此使用者的設定檔並考慮回寫。必須變更，且會更新使用者設定檔上的屬性值，其中新的屬性值與舊的屬性值不同。

使用國家/地區代碼和電話號碼處理電話號碼

若要讓電話號碼回寫作業成功，請務必傳送正確的國家/地區代碼名稱和國家/地區代碼號碼。國家/地區代碼名稱是符合 ISO 3166-1 格式的三個字母代碼，而國家/地區代碼號碼則是指該國家/地區的通話代碼國際用戶撥號 (ISD) 代碼。

此範例假設 Microsoft Entra ID 中 telephoneNumber 或 mobile 的電話號碼值採用 +<isdCode><space><phoneNumber> 格式。
範例：如果電話號碼值設定為 +1 1112223333 或 +1 (111) 222-3333，則 1 是 ISD 代碼，而其對應的國家/地區代碼名稱為 USA。

使用這些規則運算式對應，將正確的國家/地區代碼名稱和國家/地區代碼號碼傳送至 Workday。您可以使用 telphoneNumber 或 mobile 作為來源屬性。下列範例會使用 telephoneNumber。此處的所有運算式都會使用 Replace 函式。

WorkphoneLandlineNumber 或 WorkphoneMobileNumber 的範例對應

Replace(Replace([telephoneNumber], , "\\+(?<isdCode>\\d* )(?<phoneNumber>.*)", , "${phoneNumber}", , ), ,"[()\\s-]+", ,"", , )

WorkphoneLandlineCountryCodeNumber 或 WorkphoneMobileCountryCodeNumber 的範例對應

Replace([telephoneNumber], , "\\+(?<isdCode>\\d*) (?<phoneNumber>.*)", , "${isdCode}", , )

WorkphoneLandlineCountryCodeName 或 WorkphoneMobileCountryCodeName 的範例對應

下一個運算式會擷取 isdCode，並使用 Switch 函式來查閱正確的國家/地區代碼名稱以傳送至 Workday。

Switch(Replace([telephoneNumber], , "\\+(?<isdCode>\\d*) (?<phoneNumber>.*)", , "${isdCode}", , ), "USA",
"93", "AFG", "355", "ALB", "213", "DZA", "376", "AND", "244", "AGO",  "54", "ARG", "374", "ARM", "297", "ABW", "61", "AUS", "43", "AUT", "994", "AZE", "973", "BHR", "880", "BGD", 
"375", "BLR", "32", "BEL", "501", "BLZ", "229", "BEN", "975", "BTN", "591", "BOL", "599", "BES", "387", "BIH", "267", "BWA", "55", "BRA", "246", "IOT", "673", "BRN", "359", "BGR", 
"226", "BFA", "257", "BDI", "238", "CPV", "855", "KHM", "237", "CMR", "236", "CAF", "235", "TCD", "56", "CHL", "86", "CHN", "57", "COL", "269", "COM", "242", "COG", "243", "COD", 
"682", "COK", "506", "CRI", "225", "CIV", "385", "HRV", "53", "CUB", "357", "CYP", "420", "CZE", "45", "DNK", "253", "DJI", "593", "ECU", "20", "EGY", "503", "SLV", "240", "GNQ", 
"291", "ERI", "372", "EST", "268", "SWZ", "251", "ETH", "500", "FLK", "298", "FRO", "679", "FJI", "358", "FIN", "33", "FRA", "594", "GUF", "689", "PYF", "241", "GAB", "220", "GMB", 
"995", "GEO", "49", "DEU", "233", "GHA", "350", "GIB", "30", "GRC", "299", "GRL", "590", "GLP", "502", "GTM", "224", "GIN", "245", "GNB", "592", "GUY", "509", "HTI", "504", "HND", 
"852", "HKG", "36", "HUN", "354", "ISL", "91", "IND", "62", "IDN", "98", "IRN", "964", "IRQ", "353", "IRL", "972", "ISR", "39", "ITA", "81", "JPN", "962", "JOR", "254", "KEN", "686", 
"KIR", "850", "PRK", "82", "KOR", "383", "XKX", "965", "KWT", "996", "KGZ", "856", "LAO", "371", "LVA", "961", "LBN", "266", "LSO", "231", "LBR", "218", "LBY", "423", "LIE", "370", 
"LTU", "352", "LUX", "853", "MAC", "261", "MDG", "265", "MWI", "60", "MYS", "960", "MDV", "223", "MLI", "356", "MLT", "692", "MHL", "596", "MTQ", "222", "MRT", "230", "MUS", "262", 
"REU", "52", "MEX", "691", "FSM", "373", "MDA", "377", "MCO", "976", "MNG", "382", "MNE", "212", "MAR", "258", "MOZ", "95", "MMR", "264", "NAM", "674", "NRU", "977", "NPL", "31", 
"NLD", "687", "NCL", "64", "NZL", "505", "NIC", "227", "NER", "234", "NGA", "683", "NIU", "672", "NFK", "389", "MKD", "47", "NOR", "968", "OMN", "92", "PAK", "680", "PLW", "970", 
"PSE", "507", "PAN", "675", "PNG", "595", "PRY", "51", "PER", "63", "PHL", "870", "PCN", "48", "POL", "351", "PRT", "974", "QAT", "40", "ROU", "7", "RUS", "250", "RWA", "290", "SHN", 
"508", "SPM", "685", "WSM", "378", "SMR", "239", "STP", "966", "SAU", "221", "SEN", "381", "SRB", "248", "SYC", "232", "SLE", "65", "SGP", "421", "SVK", "386", "SVN", "677", "SLB", 
"252", "SOM", "27", "ZAF", "211", "SSD", "34", "ESP", "94", "LKA", "249", "SDN", "597", "SUR", "46", "SWE", "41", "CHE", "963", "SYR", "886", "TWN", "992", "TJK", "255", "TZA", "66", 
"THA", "670", "TLS", "228", "TGO", "690", "TKL", "676", "TON", "216", "TUN", "90", "TUR", "993", "TKM", "688", "TUV", "256", "UGA", "380", "UKR", "971", "ARE", "44", "GBR", "1", 
"USA", "598", "URY", "998", "UZB", "678", "VUT", "58", "VEN", "84", "VNM", "681", "WLF", "967", "YEM", "260", "ZMB", "263", "ZWE"
)

從 Microsoft Entra ID usageLocation 屬性衍生國家/地區代碼

如果您想要根據 usageLocation 屬性，在 Workday 中設定國家/地區代碼名稱和國家/地區代碼號碼，請使用下列運算式對應，將兩個字母的國家/地區代碼轉換成適當的三個字母國家/地區代碼名稱和國家/地區代碼號碼。

WorkphoneLandlineCountryCodeNumber 或 WorkphoneMobileCountryCodeNumber 的範例對應

Switch([usageLocation], "1", "AF", "93", "AX", "358", "AL", "355", "DZ", "213", "AS", "1", "AD", "376", "AO", "244", "AI", "1", "AG", "1", "AR", "54", "AM", "374", "AW", "297", "AU", 
"61", "AT", "43", "AZ", "994", "BS", "1", "BH", "973", "BD", "880", "BB", "1", "BY", "375", "BE", "32", "BZ", "501", "BJ", "229", "BM", "1", "BT", "975", "BO", "591", "BQ", "599", 
"BA", "387", "BW", "267", "BR", "55", "IO", "246", "VG", "1", "BN", "673", "BG", "359", "BF", "226", "BI", "257", "CV", "238", "KH", "855", "CM", "237", "CA", "1", "KY", "1", "CF", 
"236", "TD", "235", "CL", "56", "CN", "86", "CX", "61", "CC", "61", "CO", "57", "KM", "269", "CG", "242", "CD", "243", "CK", "682", "CR", "506", "CI", "225", "HR", "385", "CU", "53", 
"CW", "599", "CY", "357", "CZ", "420", "DK", "45", "DJ", "253", "DM", "1", "DO", "1", "EC", "593", "EG", "20", "SV", "503", "GQ", "240", "ER", "291", "EE", "372", "SZ", "268", "ET", 
"251", "FK", "500", "FO", "298", "FJ", "679", "FI", "358", "FR", "33", "GF", "594", "PF", "689", "GA", "241", "GM", "220", "GE", "995", "DE", "49", "GH", "233", "GI", "350", "GR", 
"30", "GL", "299", "GD", "1", "GP", "590", "GU", "1", "GT", "502", "GG", "44", "GN", "224", "GW", "245", "GY", "592", "HT", "509", "VA", "39", "HN", "504", "HK", "852", "HU", "36", 
"IS", "354", "IN", "91", "ID", "62", "IR", "98", "IQ", "964", "IE", "353", "IM", "44", "IL", "972", "IT", "39", "JM", "1", "JP", "81", "JE", "44", "JO", "962", "KZ", "7", "KE", 
"254", "KI", "686", "KP", "850", "KR", "82", "XK", "383", "KW", "965", "KG", "996", "LA", "856", "LV", "371", "LB", "961", "LS", "266", "LR", "231", "LY", "218", "LI", "423", "LT", 
"370", "LU", "352", "MO", "853", "MG", "261", "MW", "265", "MY", "60", "MV", "960", "ML", "223", "MT", "356", "MH", "692", "MQ", "596", "MR", "222", "MU", "230", "YT", "262", "MX", 
"52", "FM", "691", "MD", "373", "MC", "377", "MN", "976", "ME", "382", "MS", "1", "MA", "212", "MZ", "258", "MM", "95", "NA", "264", "NR", "674", "NP", "977", "NL", "31", "NC", 
"687", "NZ", "64", "NI", "505", "NE", "227", "NG", "234", "NU", "683", "NF", "672", "MK", "389", "MP", "1", "NO", "47", "OM", "968", "PK", "92", "PW", "680", "PS", "970", "PA", 
"507", "PG", "675", "PY", "595", "PE", "51", "PH", "63", "PN", "870", "PL", "48", "PT", "351", "PR", "1", "QA", "974", "RE", "262", "RO", "40", "RU", "7", "RW", "250", "BL", "590", 
"SH", "290", "KN", "1", "LC", "1", "MF", "590", "PM", "508", "VC", "1", "WS", "685", "SM", "378", "ST", "239", "SA", "966", "SN", "221", "RS", "381", "SC", "248", "SL", "232", "SG", 
"65", "SX", "1", "SK", "421", "SI", "386", "SB", "677", "SO", "252", "ZA", "27", "SS", "211", "ES", "34", "LK", "94", "SD", "249", "SR", "597", "SJ", "47", "SE", "46", "CH", "41", 
"SY", "963", "TW", "886", "TJ", "992", "TZ", "255", "TH", "66", "TL", "670", "TG", "228", "TK", "690", "TO", "676", "TT", "1", "TN", "216", "TR", "90", "TM", "993", "TC", "1", "TV", 
"688", "VI", "1", "UG", "256", "UA", "380", "AE", "971", "GB", "44", "UM", "246", "US", "1", "UY", "598", "UZ", "998", "VU", "678", "VE", "58", "VN", "84", "WF", "681", "EH", "212", 
"YE", "967", "ZM", "260", "ZW", "263")

WorkphoneLandlineCountryCodeName 或 WorkphoneMobileCountryCodeName 的範例對應

Switch([usageLocation], "USA", "AF", "AFG", "AX", "ALA", "AL", "ALB", "DZ", "DZA", "AS", "ASM", "AD", "AND", "AO", "AGO", "AI", "AIA", "AG", "ATG", "AR", "ARG", "AM", "ARM", "AW", 
"ABW", "AU", "AUS", "AT", "AUT", "AZ", "AZE", "BS", "BHS", "BH", "BHR", "BD", "BGD", "BB", "BRB", "BY", "BLR", "BE", "BEL", "BZ", "BLZ", "BJ", "BEN", "BM", "BMU", "BT", "BTN", "BO", 
"BOL", "BQ", "BES", "BA", "BIH", "BW", "BWA", "BR", "BRA", "IO", "IOT", "VG", "VGB", "BN", "BRN", "BG", "BGR", "BF", "BFA", "BI", "BDI", "CV", "CPV", "KH", "KHM", "CM", "CMR", "CA", 
"CAN", "KY", "CYM", "CF", "CAF", "TD", "TCD", "CL", "CHL", "CN", "CHN", "CX", "CXR", "CC", "CCK", "CO", "COL", "KM", "COM", "CG", "COG", "CD", "COD", "CK", "COK", "CR", "CRI", "CI", 
"CIV", "HR", "HRV", "CU", "CUB", "CW", "CUW", "CY", "CYP", "CZ", "CZE", "DK", "DNK", "DJ", "DJI", "DM", "DMA", "DO", "DOM", "EC", "ECU", "EG", "EGY", "SV", "SLV", "GQ", "GNQ", "ER", 
"ERI", "EE", "EST", "SZ", "SWZ", "ET", "ETH", "FK", "FLK", "FO", "FRO", "FJ", "FJI", "FI", "FIN", "FR", "FRA", "GF", "GUF", "PF", "PYF", "GA", "GAB", "GM", "GMB", "GE", "GEO", "DE", 
"DEU", "GH", "GHA", "GI", "GIB", "GR", "GRC", "GL", "GRL", "GD", "GRD", "GP", "GLP", "GU", "GUM", "GT", "GTM", "GG", "GGY", "GN", "GIN", "GW", "GNB", "GY", "GUY", "HT", "HTI", "VA", 
"VAT", "HN", "HND", "HK", "HKG", "HU", "HUN", "IS", "ISL", "IN", "IND", "ID", "IDN", "IR", "IRN", "IQ", "IRQ", "IE", "IRL", "IM", "IMN", "IL", "ISR", "IT", "ITA", "JM", "JAM", "JP", 
"JPN", "JE", "JEY", "JO", "JOR", "KZ", "KAZ", "KE", "KEN", "KI", "KIR", "KP", "PRK", "KR", "KOR", "XK", "XKX", "KW", "KWT", "KG", "KGZ", "LA", "LAO", "LV", "LVA", "LB", "LBN", "LS", 
"LSO", "LR", "LBR", "LY", "LBY", "LI", "LIE", "LT", "LTU", "LU", "LUX", "MO", "MAC", "MG", "MDG", "MW", "MWI", "MY", "MYS", "MV", "MDV", "ML", "MLI", "MT", "MLT", "MH", "MHL", "MQ", 
"MTQ", "MR", "MRT", "MU", "MUS", "YT", "MYT", "MX", "MEX", "FM", "FSM", "MD", "MDA", "MC", "MCO", "MN", "MNG", "ME", "MNE", "MS", "MSR", "MA", "MAR", "MZ", "MOZ", "MM", "MMR", "NA", 
"NAM", "NR", "NRU", "NP", "NPL", "NL", "NLD", "NC", "NCL", "NZ", "NZL", "NI", "NIC", "NE", "NER", "NG", "NGA", "NU", "NIU", "NF", "NFK", "MK", "MKD", "MP", "MNP", "NO", "NOR", "OM", 
"OMN", "PK", "PAK", "PW", "PLW", "PS", "PSE", "PA", "PAN", "PG", "PNG", "PY", "PRY", "PE", "PER", "PH", "PHL", "PN", "PCN", "PL", "POL", "PT", "PRT", "PR", "PRI", "QA", "QAT", "RE", 
"REU", "RO", "ROU", "RU", "RUS", "RW", "RWA", "BL", "BLM", "SH", "SHN", "KN", "KNA", "LC", "LCA", "MF", "MAF", "PM", "SPM", "VC", "VCT", "WS", "WSM", "SM", "SMR", "ST", "STP", "SA", 
"SAU", "SN", "SEN", "RS", "SRB", "SC", "SYC", "SL", "SLE", "SG", "SGP", "SX", "SXM", "SK", "SVK", "SI", "SVN", "SB", "SLB", "SO", "SOM", "ZA", "ZAF", "SS", "SSD", "ES", "ESP", "LK", 
"LKA", "SD", "SDN", "SR", "SUR", "SJ", "SJM", "SE", "SWE", "CH", "CHE", "SY", "SYR", "TW", "TWN", "TJ", "TJK", "TZ", "TZA", "TH", "THA", "TL", "TLS", "TG", "TGO", "TK", "TKL", "TO", 
"TON", "TT", "TTO", "TN", "TUN", "TR", "TUR", "TM", "TKM", "TC", "TCA", "TV", "TUV", "VI", "VIR", "UG", "UGA", "UA", "UKR", "AE", "ARE", "GB", "GBR", "UM", "UMI", "US", "USA", "UY", 
"URY", "UZ", "UZB", "VU", "VUT", "VE", "VEN", "VN", "VNM", "WF", "WLF", "EH", "ESH", "YE", "YEM", "ZM", "ZMB", "ZW", "ZWE")

擷取 10 位數的電話號碼

如果 Microsoft Entra ID 中的電話號碼是使用自助式密碼重設 (SSPR) 所需的格式來設定，請使用規則運算式。
例如：如果電話號碼的值是 +1 111222-3333 -> 則 RegEx 運算式會輸出 1112223333

Replace([telephoneNumber], , "\\+(?<isdCode>\\d* )(?<phoneNumber>\\d{10})", , "${phoneNumber}", , )

移除電話號碼中的空格、虛線和括弧

如果 Microsoft Entra ID 中的電話號碼是使用 (XXX) XXX-XXXX 格式來設定，請使用規則運算式。
例如：如果電話號碼的值是 (111) 222-3333 -> 則 RegEx 運算式會輸出 1112223333

Replace([mobile], , "[()\\s-]+", , "", , )

處理內嵌電話號碼分機

假設 Microsoft Entra ID 中所有的電話號碼都有分機號碼，而且您想要在 Workday 中填入分機號碼。此範例假設電話號碼會以下列格式儲存：+<isdCode><space><phoneNumber><space>x<extensionNumber>，而分機號碼會出現在 x 字元後面。

若要擷取此電話號碼的元件，請使用這些運算式：

WorkphoneLandlineNumber 的範例對應

如果 telephoneNumber 具有 +1 (206) 291-8163 x8125 值，則此運算式會傳回 2062918163。

Replace(Replace([telephoneNumber], , "\+(?<isdCode>\d* )(?<phoneNumber>.* )[x](?<extension>.*)", , "${phoneNumber}", , ), ,"[()\\s-]+", ,"", , )

WorkphoneLandlineCountryCodeNumber 的範例對應

如果 telephoneNumber 具有 +1 (206) 291-8163 x8125 值，則此運算式會傳回 1。

Replace(Replace([telephoneNumber], , "\+(?<isdCode>\d* )(?<phoneNumber>.* )[x](?<extension>.*)", , "${isdCode}", , ), ,"[()\\s-]+", ,"", , )

WorkphoneLandlineExtension 的範例對應

如果 telephoneNumber 具有 +1 (206) 291-8163 x8125 值，則此運算式會傳回 8125。

Replace(Replace([telephoneNumber], , "\+(?<isdCode>\d* )(?<phoneNumber>.* )[x](?<extension>.*)", , "${extension}", , ), ,"[()\\s-]+", ,"", , )

啟用及啟動使用者佈建

在 Workday 佈建應用程式設定完成之後，您可以在 Microsoft Entra 系統管理中心中開啟佈建服務。

提示

根據預設，當您開啟佈建服務時，它會為範圍中的所有使用者起始佈建作業。如果有對應錯誤或 Workday 資料問題，則佈建作業可能失敗並進入隔離狀態。為了避免這種情況，建議您設定 [來源物件範圍] 篩選條件，並使用隨選佈建功能來對一些測試使用者測試您的屬性對應，然後再針對所有使用者啟動完整同步。確認對應能夠運作且提供您所需的結果之後，您便可以移除篩選，或逐漸擴大篩選來包含更多使用者。

在 [佈建] 索引標籤中，將 [佈建狀態] 設定為 [開啟]。
在 [範圍] 下拉式清單中，選取 [同步所有使用者和群組]。此選項會讓 Writeback 應用程式將所有使用者的對應屬性從 Microsoft Entra ID 寫回 Workday，但須遵循 [對應] -> [來源物件範圍] 底下所定義的範圍規則。

注意

Workday Writeback 回寫佈建應用程式不支援 [僅同步指派的使用者和群組] 選項。
按一下 [檔案] 。
此作業會啟動初始同步，所需花費的時數會視來源目錄中的使用者人數而定。您可以檢查進度列來追蹤同步週期的進度。
您可隨時檢查 Entra 系統管理中心中的 [佈建記錄] 索引標籤，查看佈建服務執行哪些動作。稽核記錄會列出佈建服務所執行的所有個別同步事件，例如從來源匯入及匯出至目標應用程式的使用者有誰。
在初始同步完成之後，其會在 [佈建] 索引標籤中寫入摘要報告。

已知問題與限制

回寫應用程式會針對 Communication_Usage_Type_ID 和 Phone_Device_Type_ID 參數，使用預先定義的值。如果您的 Workday 租用戶會針對這些屬性使用不同的值，則回寫作業將會失敗。建議的解決方法是更新 Workday 中的 Type_ID。
將 Writeback 應用程式設定為更新次要電話號碼時，其不會取代 Workday 中現有的次要電話號碼。而是會在員工記錄中新增一個次要電話號碼。此行為沒有因應措施。

共用方式為