分享方式：

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

  • 文章

本教學課程的目的是要說明您需要執行的步驟，以將屬性從 Microsoft Entra ID 回寫至 Workday。 Workday 回寫布建應用程式支援將值指派給下列 Workday 屬性：

  • 公司電子郵件
  • Workday 用戶名稱
  • 工作蘭地電話（包括國碼、分區代碼、號碼和延伸模組）
  • 工地電話電話號碼主要旗標
  • 工作行動電話號碼（包括國家/地區代碼、區碼、號碼）
  • 工作行動主要旗標

概觀

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

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

此 Workday 回寫使用者布建解決方案最適合：

  • 使用Microsoft 365 的組織，其想要回寫IT所管理的授權屬性（例如電子郵件地址、使用者名稱和電話號碼）回到Workday

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

請參閱設定整合系統使用者一節，以建立具有擷取背景工作數據許可權的 Workday 整合系統使用者帳戶。

設定 entra 屬性回寫至 Workday Microsoft

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

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

若要設定 Workday 回寫連接器：

  1. 以至少 雲端應用程式系統管理員 的身分登入 Microsoft Entra 系統管理中心。

  2. 瀏覽至 [身分識別] > [應用程式] > [企業應用程式] > [新增應用程式]。

  3. 搜尋 Workday 回寫，並從資源庫新增該應用程式。

  4. 新增應用程式並顯示應用程式詳細數據畫面之後，請選取 [ 布建]。

  5. 將 [布建模式] 變更為 [自動]。

  6. 完成 [系統管理員認證] 區段，如下所示：

    • 管理員使用者 名稱 – 輸入 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。

  1. 在 [對應] 底下的 [布建] 索引標籤上，按兩下對應名稱。

  2. 在 [ 來源物件範圍 ] 字段中，您可以選擇性地篩選Microsoft Entra ID 中的使用者集合應該是回寫的一部分。 預設範圍為「Microsoft Entra ID 中的所有使用者」。

  3. 在 [ 屬性對應] 區 段中，更新比對標識符，以指出儲存 Workday 背景工作標識碼或員工標識碼 Microsoft之 entra ID 中的屬性。 熱門的比對方法是將 Workday 背景工作識別碼或員工標識碼同步處理至 Microsoft Entra ID 中的 extensionAttribute1-15，然後在 Microsoft Entra ID 中使用這個屬性來比對 Workday 中的使用者。

  4. 一般而言，您會將 Microsoft Entra ID userPrincipalName 屬性對應至 Workday UserID 屬性，並將 Microsoft Entra ID 郵件 屬性對應至 Workday EmailAddress 屬性。

    Microsoft Entra 系統管理中心的螢幕快照。

  5. 使用下列指引，將電話號碼屬性值從 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 包含分區代碼的完整電話號碼 對應至 行動 屬性。 使用 regex 移除空格符、方括弧和國家/地區代碼。

    注意

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

    • Communication_Usage_Type_ID設定為常數位串 WORK
    • Phone_Device_Type_ID設定為固定字串 Mobile for mobile phone numbers and Landline for landline for landline phone numbers.

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

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

回寫表達式對應範例

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

預先僱用的回寫時間

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

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

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

  1. Microsoft Entra ID 中有一個稱為 employeeHireDate 的屬性，您可以在其中擷取使用者的雇用開始日期。

  2. 如果您使用 Workday 來 內部部署的 Active Directory 布建作業，請將它設定為將 Workday StatusHireDate 字段流至 內部部署的 Active Directory 中的屬性（例如 extensionAttribute8）。 設定 Microsoft Entra Connect，以將內部部署值同步至 entra ID Microsoft employeeHireDate 。

  3. 如果您使用 Workday 來Microsoft Entra ID 布建作業，請將它設定為將 Workday StatusHireDate 字段直接流向 entra ID Microsoft 中的 employeeHireDate 屬性。

    注意

    如果您要將員工開始日期儲存在任何其他Microsoft Entra ID extensionAttribute 中，您可以在下一個運算式中使用該屬性， 而不是 employeeHireDate 。

  4. 在您的 Workday 回寫應用程式中，使用下列表示式規則將 entra userPrincipalName 導出至 Workday UserID 欄位Microsoft。

    IgnoreFlowIfNullOrEmpty(IIF(DateDiff("d", Now(), CDate([employeeHireDate])) >= 0, "", [userPrincipalName]))

    上一個表達式會使用 DateDiff 函式來評估 employeeHireDate 與使用 Now 函式取得的 UTC 日期之間的差異。 如果 employeeHireDate 大於或等於今天的日期，則會更新 UserID。 否則它會傳回空值，而 IgnoreFlowIfNullOrEmpty 函式會從回寫中排除此屬性。

重要

若要讓延遲回寫如預期般運作，內部部署的 Active Directory 或Microsoft Entra ID 中的作業必須在抵達前一天或雇用日期前觸發對使用者的變更，以便更新此使用者的配置檔，並視為回寫。 這必須是更新使用者配置檔屬性值的變更，其中新的屬性值與舊的屬性值不同。

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

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

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

使用這些正則表達式對應，將正確的國家/地區代碼名稱和國家/地區代碼號碼傳送至 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 位數的電話號碼

如果使用自助式密碼重設 （SSPR） 所需的格式設定Microsoft Entra ID 中的電話號碼，請使用這個正則表達式。
範例：如果電話號碼值為 +1 1112223333 -> 則 regex 表達式會輸出1112223333

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

拿掉電話號碼中的空格、破折號和括弧

如果使用格式 （XXX） XXX-XXXX 來設定Microsoft Entra ID 中的電話號碼，請使用這個正則表達式。
範例：如果電話號碼值為 （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 數據問題發生錯誤，布建作業可能會失敗並進入隔離狀態。 若要避免這種情況，最佳做法是，建議您先設定 來源物件範圍 篩選，並使用一些測試用戶測試屬性對應，使用 隨選 布建功能，再啟動所有使用者的完整同步處理。 確認對應能夠運作且提供您所需的結果之後，您便可以移除篩選，或逐漸擴大篩選來包含更多使用者。

  1. 在 [佈建] 索引標籤中，將 [佈建狀態] 設定為 [開啟]。

  2. 在 [ 範圍] 下拉式清單中，選取 [ 同步所有使用者和群組]。 使用此選項時，回寫應用程式會將所有用戶的對應屬性從 Microsoft Entra ID 寫回 Workday，受限於 [對應 -> 來源物件範圍] 下定義的範圍規則。

    選取回寫範圍

    注意

    Workday 回寫布建應用程式不支援 [僅同步指派的使用者和群組] 選項。

  3. 按一下 [檔案] 。

  4. 此作業會啟動初始同步處理，視來源目錄中有多少使用者而定，可能需要可變的時數。 您可以檢查進度列來追蹤同步週期的進度。

  5. 隨時檢查 Entra 系統管理中心的 [布建記錄 ] 索引標籤，以查看布建服務執行的動作。 稽核記錄會列出布建服務所執行的所有個別同步事件，例如使用者從來源匯入並匯出至目標應用程式。

  6. 完成初始同步處理之後，它會在 [布建] 索引標籤中寫入摘要報告。

    佈建進度列

已知問題與限制

  • 回寫應用程式會針對參數 使用預先定義的值， Communication_Usage_Type_ID和 Phone_Device_Type_ID。 如果您的 Workday 租使用者針對這些屬性使用不同的值，則回寫作業將不會成功。 建議的因應措施是更新 Workday 中的Type_IDs。
  • 當回寫應用程式設定為更新次要電話號碼時，它不會取代 Workday 中現有的次要電話號碼。 它會將另一個次要電話號碼新增至背景工作記錄。 此行為沒有因應措施。

下一步