教程:配置从 Microsoft Entra ID 到 Workday 的属性写回

本教程的目的是演示将属性从 Microsoft Entra ID 写回到 Workday 需要执行的步骤。 Workday 写回预配应用支持为以下 Workday 属性分配值:

  • 工作电子邮件
  • Workday 用户名
  • 工作座机电话号码(包括国家/地区代码、区号、号码和分机号码)
  • 工作座机电话号码主标志
  • 工作手机号码(包括国家/地区代码、区号和号码)
  • 工作手机主标志

概述

使用Workday 到本地 AD预配应用或Workday 到 Microsoft Entra ID预配应用设置入站预配集成之后,可以选择性地配置 Workday 写回应用,以将联系信息(如工作电子邮件和电话号码)写入 Workday。

此用户预配解决方案最适合哪些对象?

此 Workday 写回用户预配解决方案非常适合以下对象:

  • 需要将 IT 管理的官方属性(如电子邮件地址、用户名和电话号码)写回 Workday 的使用 Microsoft 365 的组织

在 Workday 中配置集成系统用户

若要创建 Workday 集成系统用户并使其具有检索工作人员数据的权限,请参阅配置集成系统用户部分。

配置 Microsoft Entra 属性写回到 Workday

遵照以下说明,配置将用户电子邮件地址和用户名从 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 中的 Workday URL 和凭据是否有效。

第 2 部分:配置写回属性映射

在此部分,你会配置写回属性从 Microsoft Entra ID 流到 Workday 的方式。

  1. 在“映射”下的“预配”选项卡上,单击映射名称。

  2. 在“源对象范围”字段中,可以有选择性地在 Microsoft Entra ID 中筛选应属于写回的一部分的用户集。 默认范围是“Microsoft Entra ID 中的所有用户”

  3. 在“属性映射”部分中,更新匹配的 ID 以指明 Microsoft Entra ID 中存储着 Workday 工作人员 ID 或员工 ID 的属性。 常用的匹配方法是将 Workday 工作人员 ID 或员工 ID 同步到 Microsoft Entra ID 中的 extensionAttribute1-15,然后使用 Microsoft Entra ID 中的此属性来重新匹配 Workday 中的用户。

  4. 通常,将 Microsoft Entra ID userPrincipalName 属性映射到 Workday UserID 属性,并将 Microsoft Entra ID mail 属性映射到 Workday EmailAddress 属性。

    Microsoft Entra 管理中心的屏幕截图。

  5. 使用以下指南将电话号码属性值从 Microsoft Entra ID 映射到 Workday。 请参阅写回表达式映射示例,为每个属性配置正确的表达式映射。

    Workday 电话属性 预期值 映射指导
    WorkphoneLandlineIsPrimary true/false 其输出为“true”或“false”字符串值的常数或表达式映射。
    WorkphoneLandlineCountryCodeName 三字母 ISO 3166-1 国家/地区代码 其输出为三字母国家/地区代码的常数或表达式映射。
    WorkphoneLandlineCountryCodeNumber 国际国家/地区呼叫代码 其输出为有效国家/地区代码(没有 + 号)的常数或表达式映射。
    WorkphoneLandlineNumber 包含区号的完整电话号码 映射到 telephoneNumber 属性。 使用正则表达式删除空格、括号和国家/地区代码。
    WorkphoneLandlineExtension 分机号码 如果 telephoneNumber 包含分机号码,请使用正则表达式提取值。
    WorkphoneMobileIsPrimary true/false 其输出为“true”或“false”字符串值的常数映射或表达式映射
    WorkphoneMobileCountryCodeName 三字母 ISO 3166-1 国家/地区代码 其输出为三字母国家/地区代码的常数或表达式映射。
    WorkphoneMobileCountryCodeNumber 国际国家/地区呼叫代码 其输出为有效国家/地区代码(没有 + 号)的常数或表达式映射。
    WorkphoneMobileNumber 包含区号的完整电话号码 映射到 mobile 属性。 使用正则表达式删除空格、括号和国家/地区代码。

    注意

    调用 Change_Work_Contact Workday Web 服务时,Microsoft Entra ID 发送以下常数值:

    • Communication_Usage_Type_ID设置为常数字符串WORK
    • Phone_Device_Type_ID对于移动电话号码设置为常数字符串Mobile,对于座机电话号码设置为Landline

    如果 Workday 租户使用不同 Type_ID,则会遇到写回失败。 为了防止此类失败,可以使用 Workday“维护首选项 ID”任务,并更新 Type_ID 以匹配 Microsoft Entra ID 使用的值。

  6. 若要保存映射,请单击“属性映射”部分顶部的“保存”。

写回表达式映射示例

本节提供了多个为常见集成方案配置 Workday 写回应用程序的示例。

对预聘人员的写回进行计时

在与 Microsoft Entra ID 的典型 Workday 集成中,入站用户预配应用 - Workday 到本地 Active DirectoryWorkday 到 Microsoft Entra ID - 为预聘人员新建 Microsoft Entra 帐户,并为用户生成唯一的电子邮件和 userPrincipalName。

默认情况下,在 Microsoft Entra ID 中创建用户之后,Workday 写回应用会立即尝试在 Workday 帐户上设置工作电子邮件和 userID 值。

要延迟用户 ID 或电子邮件回写,以便在聘用日期当天或之后生效,请按照以下步骤操作:

  1. Microsoft Entra ID 中有一个名为 employeeHireDate 的属性,该属性可捕获用户的就业开始日期。

  2. 如果使用的是Workday 到本地 Active Directory预配作业,请将其配置为将 Workday StatusHireDate字段流向本地 Active Directory 中的属性(例如,extensionAttribute8)。 配置 Microsoft Entra Connect 以将本地值同步到 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 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 1112223333 ->,则正则表达式会输出 1112223333

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

删除电话号码中的空格、破折号和括号

如果 Microsoft Entra ID 中的电话号码使用格式 (XXX) XXX-XXXX 进行设置,请使用此正则表达式。
示例:如果电话号码值为 (111) 2223333 ->,则正则表达式会输出 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_ID。
  • 写回应用配置为更新辅助电话号码时,不会在 Workday 中替换现有辅助电话号码。 它会向工作人员记录额外添加一个辅助电话号码。 没有针对此行为的解决方法。

后续步骤