Partilhar via


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

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

  • E-mail de Trabalho
  • Nome de usuário do dia útil
  • Número de telefone fixo de trabalho (incluindo código do país, código de área, número e extensão)
  • Sinalizador principal do número de telefone fixo de trabalho
  • Número de telemóvel de trabalho (incluindo indicativo do país, indicativo de área, número)
  • Sinalizador principal móvel de trabalho

Descrição geral

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

Para quem essa solução de provisionamento de usuários é mais adequada?

Esta solução de provisionamento de usuário do Workday Writeback é ideal para:

  • Organizações que usam o Microsoft 365 que desejam reescrever atributos autorizados gerenciados pela TI (como endereço de email, nome de usuário e número de telefone) de volta ao Workday

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

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

Configurando o write-back do atributo Microsoft Entra para o Workday

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

Parte 1: Adicionando o aplicativo Conector de write-back e criando 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 um administrador de aplicativos na nuvem.

  2. Navegue até Identity>Applications>Enterprise applications>Novo aplicativo.

  3. Pesquise por Workday Writeback e adicione esse aplicativo da galeria.

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

  5. Altere o modo de provisionamento para automático.

  6. Preencha a seção Credenciais de administrador da seguinte maneira:

    • Nome de usuário do 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 anexado. Deve ser algo como: username@contoso4

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

    • URL do locatário – Insira a URL para o ponto de extremidade dos 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 nome de locatário correto e wd3-impl é substituído pela cadeia de caracteres de ambiente correta (se necessário).

    • E-mail de notificação – Digite seu endereço de e-mail e marque a caixa de seleção "enviar e-mail se ocorrer uma falha".

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

Parte 2: Configurar mapeamentos de atributos de write-back

Nesta seção, você configura como os atributos de write-back fluem da ID do Microsoft Entra 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 quais conjuntos de usuários no ID do Microsoft Entra 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 na ID do Microsoft Entra onde a ID do trabalhador do dia de trabalho ou a ID do funcionário está armazenada. Um método de correspondência popular é sincronizar o ID do trabalhador do Workday ou o ID do funcionário com extensionAttribute1-15 no Microsoft Entra ID e, em seguida, usar esse atributo no ID do Microsoft Entra para corresponder aos usuários no Workday.

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

    Captura de ecrã do centro de administração do Microsoft Entra.

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

    Atributo de telefone do dia útil Valor esperado Diretrizes de mapeamento
    WorkphoneLandlineIsPrimary verdadeiro/falso Mapeamento de constante ou expressão cuja saída é o valor da cadeia de caracteres "true" ou "false".
    WorkphoneLandlinePaísCodeName Código do país ISO 3166-1 de três letras Mapeamento constante ou de expressão cuja saída é um código de país de três letras.
    WorkphoneLandlinePaísCodeNumber Código telefónico internacional do país Mapeamento constante ou de expressão cuja saída é um código de país válido (sem o sinal +).
    WorkphoneNúmero de telefone fixo Número de telefone completo, incluindo o indicativo de área Mapeie para o atributo phoneNumber . Use regex para remover espaços em branco, colchetes e código de país.
    WorkphoneLandlineExtensão Número do ramal Se phoneNumber contiver extensão, use regex para extrair o valor.
    WorkphoneMobileIsPrimary verdadeiro/falso Mapeamento constante ou mapeamento de expressão cuja saída é o valor da cadeia de caracteres "true" ou "false"
    WorkphoneMobileCountryCodeName Código do país ISO 3166-1 de três letras Mapeamento constante ou de expressão cuja saída é um código de país de três letras.
    WorkphoneMobileCountryCodeNumber Código telefónico internacional do país Mapeamento 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 indicativo de área Mapeie para o atributo móvel . Use regex para remover espaços em branco, colchetes e código de país.

    Nota

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

    • Communication_Usage_Type_ID é definido como a cadeia de caracteres constante WORK
    • Phone_Device_Type_ID está definido como cadeia constante Mobile para números de telefone celular e Fixo para números de telefone fixo.

    Você encontrará falhas de write-back se o locatário do Workday usar Type_IDs diferentes. Para evitar essas falhas, você pode usar a tarefa Workday Maintain Reference IDs e atualizar o Type_IDs para corresponder 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 de write-back

Esta seção fornece exemplos para configurar o aplicativo Workday Writeback para cenários comuns de integração.

Cronometrando o write-back para pré-contratações

Em uma integração típica do Workday com o Microsoft Entra ID, o aplicativo de provisionamento de usuário de entrada - Workday para Ative Directory local ou Workday para Microsoft Entra ID - cria uma nova conta do Microsoft Entra para pré-contratações, gerando email exclusivo e userPrincipalName para o usuário.

Por padrão, o aplicativo Workday Writeback tenta definir os valores de email de trabalho e userID na conta Workday imediatamente após o usuário ser criado no Microsoft Entra ID.

Para atrasar o write-back de UserID ou Email para que isso aconteça na data de contratação ou após ela, siga estas etapas:

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

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

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

    Nota

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

  4. No seu aplicativo Workday Writeback, use a seguinte regra de expressão para exportar o campo 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, ele retorna um valor vazio e a função IgnoreFlowIfNullOrEmpty exclui esse atributo de Writeback.

Importante

Para que o Writeback atrasado funcione conforme o esperado, uma operação no Ative Directory local ou no ID do Microsoft Entra deve disparar uma alteração para o usuário apenas um dia antes da chegada ou na data de contratação, para que o perfil desse usuário seja atualizado e considerado para Write-back. Essa deve ser uma alteração que atualiza um valor de atributo no perfil de usuário, onde o novo valor de atributo é diferente do valor de atributo antigo.

Manipulação do número de telefone com código do país e número de telefone

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

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

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

Exemplo de mapeamento para WorkphoneLandlineNumber ou WorkphoneMobileNumber

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

Exemplo de mapeamento para WorkphoneLandlineCountryCodeNumber ou WorkphoneMobileCountryCodeNumber

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

Exemplo de mapeamento para WorkphoneLandlineCountryCodeName ou WorkphoneMobileCountryCodeName

A próxima expressão extrai o isdCode e usa a função Switch para procurar o nome de código de país correto para enviar ao 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 usageLocation do ID do Microsoft Entra

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 de expressão a seguir para converter o código de país de duas letras em nome de código de país de três letras apropriado e número de código de país.

Exemplo de mapeamento 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")

Exemplo de mapeamento 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")

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

Use esta expressão regular, se o número de telefone no Microsoft Entra ID estiver definido usando o formato necessário para Self Service Password Reset (SSPR).
Exemplo: se o valor do número de telefone for +1 1112223333 -> então a expressão regex sai 1112223333

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

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

Use esta expressão regular, se o número de telefone no Microsoft Entra ID estiver definido usando o formato (XXX) XXX-XXXX.
Exemplo: se o valor do número de telefone for (111) 222-3333 -> então a expressão regex sai 1112223333

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

Tratamento de extensões de número de telefone fixo

Digamos que todos os números de telefone no Microsoft Entra ID tenham números de ramal e você queira preencher os números de ramal 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 do ramal aparece após o x caractere.

Para extrair os componentes deste número de telefone, use estas expressões:

Exemplo de mapeamento para WorkphoneLandlineNumber

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

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

Exemplo de mapeamento para WorkphoneLandlineCountryCodeNumber

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

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

Exemplo de mapeamento para WorkphoneLandlineExtension

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

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

Habilitar e iniciar o provisionamento de usuários

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

Gorjeta

Por padrão, quando você ativa o serviço de provisionamento, ele inicia as operações de provisionamento para todos os usuários no escopo. Se houver erros no mapeamento ou problemas de dados do Workday, o trabalho de provisionamento poderá falhar e entrar no estado de quarentena. Para evitar isso, como prática recomendada, recomendamos 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. Depois de verificar se os mapeamentos funcionam e estão dando 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 como Ativado.

  2. Na lista suspensa Escopo, selecione Sincronizar todos os usuários e grupos. Com essa opção, o aplicativo Writeback grava atributos mapeados de todos os usuários do ID do Microsoft Entra para o Workday, sujeito às regras de escopo definidas em Mapeamentos -> Escopo do objeto de origem.

    Selecionar escopo de write-back

    Nota

    O aplicativo de provisionamento Workday Writeback não suporta a opção Sincronizar apenas usuários e grupos atribuídos.

  3. Clique em Guardar.

  4. Esta operação inicia a sincronização inicial, que pode levar um número variável de horas, dependendo de quantos usuários estão no diretório de origem. Você pode verificar 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 Entra para ver quais ações o serviço de provisionamento executa. Os logs de auditoria listam todos os eventos de sincronização individuais executados pelo serviço de provisionamento, como quais usuários são importados da origem e exportados para o aplicativo de destino.

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

    Barra de progresso de provisionamento

Problemas e limitações conhecidos

  • O aplicativo Writeback usa um valor predefinido para parâmetros Communication_Usage_Type_ID e Phone_Device_Type_ID. Se o locatário do Workday estiver usando um valor diferente para esses atributos, a operação de write-back não terá êxito. Uma solução sugerida é atualizar o Type_IDs no Workday.
  • Quando o aplicativo Writeback é configurado para atualizar 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 do trabalhador. Não há solução alternativa para esse comportamento.

Próximos passos