Compartilhar via


Tutorial: Configurar o write-back de atributo de Microsoft Entra ID para o Workday

O objetivo deste tutorial é mostrar as etapas que você precisará executar para fazer write-back dos atributos do Microsoft Entra ID para o Workday. O aplicativo de provisionamento de Write-back do Workday dá suporte à atribuição de valores aos seguintes atributos do Workday:

  • Email comercial
  • Nome de usuário do Workday
  • Número de telefone comercial fixo (incluindo código do país, código de área, número e ramal)
  • Sinalizador primário do número de telefone comercial fixo
  • Número de celular comercial (incluindo código do país, código de área e número)
  • Sinalizador primário de celular comercial

Visão geral

Depois de configurar a integração de provisionamento de entrada usando o aplicativo de provisionamento Workday para o AD local ou Workday para o Microsoft Entra ID, opcionalmente, você pode configurar o aplicativo de Write-back do Workday para gravar informações de contato, como email de trabalho e número de telefone no Workday.

Para quem é mais recomendada essa solução de provisionamento de usuário?

Essa solução de provisionamento de usuário de Write-back do Workday é ideal para:

  • As organizações que usam o Microsoft 365 que desejam fazer write-back de atributos autoritativos gerenciados pela TI (como endereço de email, nome de usuário e número de telefone) no Workday

Configurar o usuário do sistema de integração no Workday

Veja a seção Configurar usuário do sistema de integração para criar uma conta de usuário do sistema de integração do Workday com permissões para recuperar os dados dos trabalhadores.

Configurando Microsoft Entra write-back de atributo para o Workday

Siga essas instruções para configurar o write-back de endereços de email do usuário e o nome de usuário do Microsoft Entra ID para o Workday.

Parte 1: Adicionar o aplicativo conector de write-back e criar a conexão com o Workday

Para configurar o conector de Write-back do Workday:

  1. Entre no Centro de administração do Microsoft Entra como pelo menos Administrador de Aplicativo de nuvem.

  2. Navegue até Identidade>Aplicativos>Aplicativos empresariais>Novo aplicativo.

  3. Pesquise por Fazer write-back de Workday e adicione esse aplicativo da galeria.

  4. Depois de adicionar o aplicativo e a tela de detalhes do aplicativo for exibida, selecione Provisionamento.

  5. Altere o Modo de Provisionamento para Automático.

  6. Conclua a seção Credenciais de Administrador, conforme a seguir:

    • Nome de Usuário Administrador – Digite o nome de usuário da conta do sistema de integração do Workday com o nome de domínio do locatário acrescentado. Ele deve ser semelhante a: username@contoso4

    • Senha do administrador – digite a senha da conta do sistema de integração do Workday

    • URL do locatário – Digite a URL para o ponto de extremidade de serviços Web do Workday para seu locatário. Esse valor deve ser semelhante a: https://wd3-impl-services1.workday.com/ccx/service/contoso4/Human_Resources, onde contoso4 é substituído pelo seu nome de locatário correto e wd3-impl é substituído pela cadeia de caracteres de ambiente correta (se necessário).

    • Email de Notificação – Digite seu endereço de email e marque a caixa de seleção “enviar email se ocorrer falha”.

    • Clique no botão Conexão de Teste. Se o teste de conexão for bem-sucedido, clique no botão Salvar na parte superior. Se falhar, verifique novamente se o URL do Workday e as credenciais são válidas no Workday.

Parte 2: Configurar mapeamentos de atributos de write-back

Nesta seção, você irá configurar como os atributos de write-back fluem do Microsoft Entra ID para o Workday.

  1. Na guia Provisionamento, em Mapeamentos, clique no nome do mapeamento.

  2. No campo Escopo do Objeto de Origem, você pode, opcionalmente, filtrar, os conjuntos de usuários do Microsoft Entra ID que devem fazer parte do write-back. O escopo padrão é todos os usuários no Microsoft Entra ID.

  3. Na seção Mapeamentos de atributo, atualize a ID correspondente para indicar o atributo no Microsoft Entra ID em que a ID de trabalho do Workday ou a ID de funcionário é armazenada. Um método de correspondência popular é sincronizar o ID de Trabalho do Workday ou o ID de Funcionário para extensionAttribute1-15 no Microsoft Entra ID e, em seguida, utilizar esse atributo no Microsoft Entra ID para corresponder os usuários no Workday.

  4. Normalmente, você mapeia o atributo do Microsoft Entra ID userPrincipalName para o atributo do Workday UserID e mapeia o atributo mail do Microsoft Entra ID para o atributo EmailAddress do Workday.

    Captura de Tela do Centro de Administração do Microsoft Entra.

  5. Use as diretrizes a seguir para mapear os valores de atributos de número de telefone do Microsoft Entra ID para o Workday. Confira Exemplos de mapeamento de expressão write-back para configurar o mapeamento de expressão correto para cada atributo.

    Atributo de telefone do Workday Valor esperado Diretrizes de mapeamento
    WorkphoneLandlineIsPrimary true/false Mapeamento de constante ou de expressão cuja saída é um valor de cadeia de caracteres "true" ou "false".
    WorkphoneLandlineCountryCodeName Código do país 3166-1 ISO de três letras Mapeamento de constante ou de expressão cuja saída é um código de país de três letras.
    WorkphoneLandlineCountryCodeNumber Código de chamada internacional do país Mapeamento de constante ou de expressão cuja saída é um código de país válido (sem o sinal +).
    WorkphoneLandlineNumber Número de telefone completo, incluindo o código de área Mapeie-o para o atributo telephoneNumber. Use o regex para remover o espaço em branco, os colchetes e o código do país.
    WorkphoneLandlineExtension Número do ramal Se telephoneNumber contiver um ramal, use o regex para extrair o valor.
    WorkphoneMobileIsPrimary true/false Mapeamento de constante ou de expressão cuja saída é um valor de cadeia de caracteres "true" ou "false"
    WorkphoneMobileCountryCodeName Código do país 3166-1 ISO de três letras Mapeamento de constante ou de expressão cuja saída é um código de país de três letras.
    WorkphoneMobileCountryCodeNumber Código de chamada internacional do país Mapeamento de constante ou de expressão cuja saída é um código de país válido (sem o sinal +).
    WorkphoneMobileNumber Número de telefone completo, incluindo o código de área Mapeie-o para o atributo mobile. Use o regex para remover o espaço em branco, os colchetes e o código do país.

    Observação

    Ao invocar o serviço da Web Change_Work_Contact Workday, o Microsoft Entra ID envia os seguintes valores constantes:

    • Communication_Usage_Type_ID é definida como a cadeia de caracteres constante WORK
    • Phone_Device_Type_ID é definida como a cadeia de caracteres constante Mobile para números de telefone celular e Landline para números de telefone fixo.

    Você encontrará falhas de write-back se o seu locatário do Workday usar Type_IDs diferentes. Para evitar essas falhas, use a tarefa Manter as IDs de Referência do Workday e atualize as Type_IDs, de modo que correspondam aos valores usados pelo Microsoft Entra ID.

  6. Para salvar seus mapeamentos, clique em Salvar na parte superior da seção Mapeamento de Atributos.

Exemplos de mapeamento de expressão write-back

Esta seção fornece exemplos para configurar o aplicativo Write-back do Workday para cenários comuns de integração.

Cronometrar o write-back para pré-contratados

Em uma integração típica do Workday com o Microsoft Entra ID, o aplicativo de provisionamento de usuários de entrada – Workday para Active Directory local ou Workday para Microsoft Entra ID – cria uma conta do Microsoft Entra ID para pré-contratados que gera um email exclusivo e userPrincipalName para o usuário.

Por padrão, o aplicativo write-back do Workday tenta definir os valores de email de trabalho e userID na conta do Workday imediatamente após a criação do usuário no Microsoft Entra ID.

Para atrasar o write-back do UserID ou do email para que ele aconteça na data de contratação ou após a contratação, siga essas etapas:

  1. Há um atributo no Microsoft Entra ID chamado employeeHireDate no qual você pode capturar a data de início do trabalho do usuário.

  2. Se você estiver usando o trabalho de provisionamento do Workday para Active Directory local, configure-o para fluir o campo StatusHireDate do Workday para um atributo no Active Directory local (por exemplo extensionAttribute8). Configure Microsoft Entra Connect para sincronizar o valor local com employeeHireDate no Microsoft Entra ID.

  3. Se você estiver usando o trabalho de provisionamento Workday para Microsoft Entra ID, configure-o para fluir o campo StatusHireDate do Workday diretamente para o atributo employeeHireDate no Microsoft Entra ID.

    Observação

    Se você estiver armazenando a data de início do funcionário em qualquer outro extensionAttribute do Microsoft Entra ID, poderá usar esse atributo em vez de employeeHireDate na próxima expressão.

  4. Em seu aplicativo Write-back do Workday, use a regra de expressão a seguir para exportar userPrincipalName do Microsoft Entra para o campo UserID do Workday.

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

    A expressão anterior usa a função DateDiff para avaliar a diferença entre employeeHireDate e a data de hoje em UTC obtida usando a função Now. Se employeeHireDate for maior ou igual à data de hoje, ele atualizará o UserID. Caso contrário, retorna um valor vazio e a função IgnoreFlowIfNullOrEmpty exclui esse atributo do Write-back.

Importante

Para que o write-back atrasado funcione conforme o esperado, uma operação no Active Directory local ou no Microsoft Entra ID precisa disparar uma alteração para o usuário apenas um dia antes de sua chegada ou na data da contratação, para que o perfil desse usuário seja atualizado e levado em conta para o write-back. Essa deve ser uma alteração que atualize um valor de atributo no perfil do usuário, e o novo valor de atributo seja diferente do valor de atributo antigo.

Manipular número de telefone com código de país e número de telefone

Para que a operação de write-back de número de telefone seja bem-sucedida, é importante enviar o nome de código do país e o número de código do país certos. O nome do código de país é um código de três letras que está em conformidade com o formato ISO 3166-1, enquanto o número de código do país refere-se ao código de chamada do país ou código ISD (discagem de assinante internacional) para esse país.

Este exemplo pressupõe que o valor do número de telefone no Microsoft Entra ID para telephoneNumber ou mobile tem o formato +<isdCode><space><phoneNumber>.
Exemplo: se o valor do número de telefone estiver definido como +1 1112223333 ou +1 (111) 222-3333, então 1 será o código ISD, e o nome de código do país correspondente a ele é USA.

Use esses mapeamentos de expressão regular para enviar o nome de código do país e o número do código do país certos para o Workday. Você pode usar telphoneNumber ou mobile como o atributo de origem. Os exemplos a seguir usam telephoneNumber. Todas as expressões aqui usam a função Replace.

Mapeamento de exemplo para WorkphoneLandlineNumber ou WorkphoneMobileNumber

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

Mapeamento de exemplo para WorkphoneLandlineCountryCodeNumber ou WorkphoneMobileCountryCodeNumber

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

Mapeamento de exemplo para WorkphoneLandlineCountryCodeName ou WorkphoneMobileCountryCodeName

A próxima expressão extrai o isdCode e usa a função Switch para pesquisar o nome de código do país certo a ser enviado para o 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"
)

Derivar códigos de país do atributo Microsoft Entra ID usageLocation

Se você quiser definir o nome do código do país e o número do código do país no Workday com base no atributo usageLocation, use os mapeamentos da seguinte expressão para converter o código de país de duas letras no nome de código do país de três letras apropriado e o número do código do país.

Mapeamento de exemplo para WorkphoneLandlineCountryCodeNumber ou 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")

Mapeamento de exemplo para WorkphoneLandlineCountryCodeName ou 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")

Extrair um número de telefone de 10 dígitos

Use essa expressão regular se o número de telefone no Microsoft Entra ID for definido com o formato exigido para a SSPR (redefinição de senha por autoatendimento).
Exemplo: se o valor do número de telefone for + 1 1112223333 ->, a expressão regex produz 1112223333

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

Remover espaços, barras e colchetes em um número de telefone

Use essa expressão regular se o número de telefone no Microsoft Entra ID for definido com o formato (XXX) XXX-XXXX.
Exemplo: se o valor do número de telefone for (111) 222-3333 -> a expressão regex produzirá 1112223333

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

Manipular extensões de número de telefone fixo

Digamos que todos os números de telefone no Microsoft Entra ID têm números de extensão e você deseja preencher esses números de extensão no Workday. Este exemplo pressupõe que os números de telefone são armazenados no formato: +<isdCode><space><phoneNumber><space>x<extensionNumber> e o número de extensão é exibido após o caractere x.

Para extrair os componentes desse número de telefone, use essas expressões:

Mapeamento de exemplo para WorkphoneLandlineNumber

Se telephoneNumber tiver o valor +1 (206) 291-8163 x8125, essa expressão retornará 2062918163.

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

Mapeamento de exemplo para WorkphoneLandlineCountryCodeNumber

Se telephoneNumber tiver o valor +1 (206) 291-8163 x8125, essa expressão retornará 1.

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

Mapeamento de exemplo para WorkphoneLandlineExtension

Se telephoneNumber tiver o valor +1 (206) 291-8163 x8125, essa expressão retornará 8125.

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

Habilitar e iniciar o provisionamento de usuário

Depois que as configurações do aplicativo de provisionamento do Workday forem concluídas, você poderá ativar o serviço de provisionamento no centro de administração do Microsoft Entra.

Dica

Por padrão, ao ativar o serviço de provisionamento, ele inicia as operações de provisionamento para todos os usuários no escopo. Se houver erros em problemas de dados de mapeamento ou Workday, o trabalho de provisionamento pode falhar e prosseguir para o estado de quarentena. Para evitar isso, como prática recomendada, sugerimos configurar o filtro Escopo do Objeto de Origem e testar seus mapeamentos de atributos com alguns usuários de teste usando o recurso de provisionamento sob demanda antes de iniciar a sincronização completa para todos os usuários. Após ter verificado que os mapeamentos funcionam e estão fornecendo os resultados desejados, você pode remover o filtro ou expandi-lo gradualmente para incluir mais usuários.

  1. Na guia Provisionamento, defina o Status de Provisionamento para Em.

  2. Na lista suspensa Escopo, selecione Sincronizar todos os usuários e grupos. Com essa opção, o aplicativo de Write-back faz o write-back dos atributos mapeados de todos os usuários do Microsoft Entra ID para o Workday, sujeito às regras de escopo definidas em Mapeamentos ->Escopo do Objeto de Origem.

    Selecionar escopo de Write-back

    Observação

    O aplicativo de provisionamento de Write-back do Workday não dá suporte à opção Sincronizar apenas usuários e grupos atribuídos.

  3. Clique em Save (Salvar).

  4. Essa operação dá início à sincronização inicial, o que poderá demorar algumas horas dependendo de quantos usuários estiverem no diretório de origem. Verifique a barra de progresso para acompanhar o progresso do ciclo de sincronização.

  5. A qualquer momento, verifique a guia Logs de provisionamento no centro de administração do Entre para ver as ações executadas pelo serviço de provisionamento. Os logs de auditoria lista todos os eventos de sincronização individuais executados pelo serviço de provisionamento, por exemplo, os usuários importados da origem e exportados para o aplicativo de destino.

  6. Depois que a sincronização inicial for concluída, ela gravará um relatório de resumo na guia Provisionamento.

    Barra de progresso do provisionamento

Limitações e problemas conhecidos

  • O aplicativo de Write-back usa um valor predefinido para os parâmetros Communication_Usage_Type_ID e Phone_Device_Type_ID. Se o seu locatário do Workday estiver usando um valor diferente para esses atributos, a operação de write-back não terá sucesso. Uma solução alternativa sugerida é atualizar as Type_IDs no Workday.
  • Quando o aplicativo de Write-back é configurado para atualizar os números de telefone secundários, ele não substitui o número de telefone secundário existente no Workday. Ele adiciona mais um número de telefone secundário ao registro de trabalho. Não há nenhuma solução alternativa para esse comportamento.

Próximas etapas