教學課程:設定從 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 整合系統使用者帳戶。

設定 Microsoft Entra 屬性回寫至 Workday

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

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

若要設定 Workday 回寫連接器:

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

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

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

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

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

  6. 完成 [管理員 認證] 區段,如下所示:

    • 管理員 Username – 輸入 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 標識符中的 extensionAttribute1-15,然後在 Microsoft Entra ID 中使用這個屬性,將 Workday 中的使用者比對回來。

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

    Azure portal

  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”
    • 電話_Device_Type_ID 設定為行動電話號碼的常數位串 「Mobile」,而 [蘭地線] 則設定為陸線電話號碼。

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

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

回寫表達式對應範例

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

預先僱用的回寫時間

在典型的 Workday 與 Microsoft Entra ID 整合中,輸入使用者布建應用程式 - Workday 以 內部部署的 Active DirectoryWorkday 至 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 連線 將內部部署值同步處理至 Microsoft Entra ID 中的 employeeHireDate

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

    注意

    如果您要將員工開始日期儲存在任何其他 Microsoft Entra ID extensionAttribute 中,您可以在下列表達式中使用該屬性, 而不是 employeeHireDate

  4. 在您的 Workday 回寫應用程式中,使用下列表示式規則將 Microsoft Entra userPrincipalName 導出至 Workday UserID 字段。

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

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

重要

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

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

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

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

使用下面的正規表達式對應,將正確的國家/地區代碼名稱和國家/地區代碼號碼傳送至 Workday。 您可以使用 telphoneNumbermobile 作為來源屬性。 下列範例使用 telephoneNumber。 此處的所有表達式都會使用 Replace 函式。

WorkphoneLandlineNumberWorkphoneMobileNumber 的範例對應

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

WorkphoneLandlineCountryCodeNumberWorkphoneMobileCountryCodeNumber 的範例對應

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

WorkphoneLandlineCountryCodeNameWorkphoneMobileCountryCodeName 的範例對應

下列表達式會擷取 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 中設定國家/地區代碼名稱和國家/地區代碼編號,請使用下列運算式對應,將雙字母國家/地區代碼轉換成適當的三個字母國家/地區代碼名稱和國家/地區代碼編號。

WorkphoneLandlineCountryCodeNumberWorkphoneMobileCountryCodeNumber 的範例對應

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")

WorkphoneLandlineCountryCodeNameWorkphoneMobileCountryCodeName 的範例對應

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 中的電話號碼,請使用下列正則表達式。
範例:如果電話號碼值為 +1 1112223333 -> 則 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 數據問題發生錯誤,布建作業可能會失敗並進入隔離狀態。 若要避免這種情況,最佳做法是建議您先設定來源物件範圍篩選,並使用一些測試用戶測試屬性對應,再針對所有用戶啟動完整同步處理。 一旦確認對應正常運作,併為您提供所需的結果,您就可以移除篩選條件,或逐漸展開以包含更多使用者。

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

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

    Select Writeback scope

    注意

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

  3. 按一下 [檔案] 。

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

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

  6. 完成初始同步處理之後,它會在 [布建] 索引標籤中撰寫摘要報告,如下所示。

    Provisioning progress bar

已知問題與限制

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

下一步