Configure webhooks para o. WorkdayRH spoke

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 15 min. de leitura
  • Recupere os detalhes dos funcionários necessários no WorkdayRH aplicação para seu ServiceNowconfigurando os webhooks.

    Antes de Iniciar

    Função necessária: administrador

    Configure o cliente da API ServiceNow Webhook para OAuth 2,0 em Workday

    Configure o cliente de API no Workday para autenticar solicitações de webhook.

    Antes de Iniciar

    Função necessária: Função de administrador do Workday ou a função com permissão concedida para configurar o cliente OAuth 2,0 no Workday.

    Por Que e Quando Desempenhar Esta Tarefa

    Você só precisa configurar esta etapa se quiser usar a plataforma ServiceNow como um endpoint de ouvinte e receber notificações de eventos do Workday. Se você não precisar receber notificações de eventos do Workday, poderá ignorar as configurações mencionadas nesta seção.
    Nota:
    Essas configurações devem ser executadas no Workday.

    Procedimento

    1. No Workday, um acesso A tarefa Editar configuração do locatário - Segurança.
    2. Selecione OAuth 2,0 clients habilitados . Configurações do OAuth 2,0 seção.
    3. Acesse a tarefa Registrar cliente da API.
    4. Insira o. Nome do cliente .
    5. Selecione Tipo de concessão do cliente Concessão do código de autorização AS.
    6. Selecione Tipo de token de acesso Como portador.
    7. Insira um URI de redirecionamento válido.
      Nota:
      Certifique-se de que o URI de redirecionamento do OAuth 2,0 seja um URL HTTPS válido.
    8. Opcional: Selecione o Tempo limite de atualização do token em dias.
    9. Opcional: Selecione a opção Tokens de atualização que não expiram para impedir que o token de atualização expire.
    10. Selecione Conceder consentimento administrativo Opção para conceder permissão OAuth a um locatário do cliente da REST API em todo o locatário.
      Ao selecionar esta opção, você não precisa conceder acesso de cliente explicitamente às áreas funcionais do Workday.
    11. No prompt Áreas funcionais, selecione as áreas funcionais às quais o cliente OAuth 2,0 precisa de acesso.
    12. Opcional: Se o cliente OAuth 2,0 exigir acesso aos domínios principais do Workday que não estão em nenhuma área funcional, selecione Incluir escopo de propriedade do Workday opção.

    Configure CreateUser webhook para Spoke de RH do Workday

    Use o webhook CreateUser para obter os detalhes do funcionário recém-integrado do Workday para sua instância da ServiceNow.

    Gere nome de usuário e senha em ServiceNowInstância para Criar webhook do usuário

    Gere nome de usuário e senha em ServiceNowInstância para autenticar solicitações para Criar webhook do usuário e recuperar os dados necessários do Workday aplicação.

    Antes de Iniciar

    Função necessária: administrador do ServiceNow

    Nota:
    Essas configurações devem ser executadas em ServiceNowinstância.

    Procedimento

    1. Faça login em ServiceNowinstância como administrador.
    2. Navegar até Tudo > Definição do Sistema > Tabela.
    3. Filtre e pesquise WorkdayRH tabela de registro do webhook do spoke.
      Por exemplo, Registro do Webhook do Workday .
    4. Clique em Mostrar lista lista relacionada.
    5. Clique em Nova.
    6. No formulário, preencha estes valores.
      Campo Descrição
      Descrição Descrição do registro de registro do webhook. Insira Autenticação e evento do Workday para Criar usuário .
      UserName Workday usuário que tem direitos de integração usando Workday Serviços da Web.
      Senha Senha do Workday usuário.
      Evento do Workday Evento para o qual o webhook está configurado. Insira Desligamento .
      Instância do Workday Workday URL do host e nome do locatário. Insira o URL neste formato: https://<workday_host_url>/<workday_tenant_name>
    7. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    8. Clique em Gere nome de usuário e senha .
      Copie e registre os valores de nome de usuário e senha. Esses valores devem ser especificados em Workday instância para autenticar as solicitações de webhook.
      Nota:
      Se você tiver mais de um BP de CONTRATAÇÃO em seu ambiente, configure todos os BPs DE CONTRATAÇÃO para habilitar o webhook Criar usuário para todas as transações de funcionários CONTRATADOS.

    Recupere o caminho do recurso do seu ServiceNowInstância para Criar webhook do usuário

    Recupere o caminho do recurso do seu ServiceNowInstância para uso posterior para autenticar solicitações de webhook de criação de usuário e recuperar os dados necessários do Workday aplicação

    Antes de Iniciar

    Função necessária: ServiceNowadministrador.

    Nota:
    Essas configurações devem ser executadas em ServiceNowinstância.

    Procedimento

    1. Faça login em ServiceNowinstância como administrador.
    2. Navegar até Tudo > Serviços web do sistema > Serviços web com script > Scripted REST APIs.
    3. Abra o registro do WorkdayRH spoke.
    4. Em Recursos clique em Retorno de chamada registro.
    5. Registre e salve o valor de Caminho do recurso para uso posterior.

    Importe o arquivo clar para seu Workday Instância para Criar webhook do usuário

    Arquivo CLR de importação disponível em ServiceNow StorePara configurar Criar webhook de usuário e autenticar solicitações de ServiceNowinstância.

    Antes de Iniciar

    • Workday O Studio deve ser instalado.
    • Acesso à política de criação de relatório personalizado.

      Crie relatório personalizado no Workday com base na estrutura de relatório New_Hire_record e compartilhe o relatório com o usuário da ISU.

    • Acesso para editar a definição do processo de negócios.
    • Acesso para criar e editar o sistema de integração.
    • Função necessária: administrador
    Nota:
    • Exceto nome da integração, campo de relatório XPath (se necessário) e. Workday Cabeçalho da instância, os usuários são advertidos contra modificar os valores de campos ou propriedades no arquivo CLAR.
    • Essas configurações devem ser realizadas no Workday Studio.

    Procedimento

    1. Em Spoke de RH do Workday página em ServiceNow Store, baixe o. Workday-HR-webhook-Studio-Sample arquivo de Documentos e links de suporte .
    2. Descompacte o arquivo de amostra para obter o arquivo clar.
    3. Importe o arquivo clar para Workday Estúdio.
    4. Em Propriedades da IniciarHere componente, navegue até Serviços E selecione o relatório RaaS criado para este webhook.
      Configure o componente Iniciar Here
    5. Escolha o ambiente em que seu relatório existe, como implementação ou sandbox, e configure o relatório de acordo com sua necessidade.
    6. Forneça um nome de relatório e selecione o relatório necessário.
      Nome do relatório
    7. Forneça o nome do alias do relatório.
      Nome do alias
    8. Depois que o alias do relatório for adicionado, adicione o caminho selecionado do relatório em Caminho extra que é usado para executar o relatório com base no prompt.
      Caminho extra
    9. Em Defina cabeçalhos componente, forneça seu Workday instância do WorkdayInstance cabeçalho.
      Configure o componente Definir cabeçalhos
    10. Nas propriedades de Httpout , preencha estes valores.
      Campo Valor
      Endpoint Endpoint REST
      Nota:
      Para obter mais informações, consulte Recupere o caminho do recurso do seu ServiceNowinstância.
      Método HTTP POST
      Configure as propriedades de HttpOut
    11. Salve as mudanças.
    12. No explorador de projetos, selecione a integração e implante-a no Workday sistema.
    13. Faça login em Workday e navegue até Integração > Sistema de integração > Configure atributos de integração.
      Configure atributos de integração
    14. Forneça o nome de usuário e a senha em Configure atributos de integração que você gerou em Gere nome de usuário e senha em ServiceNowinstância.
      Configure atributos de integração
    15. Modifique um processo de negócios e adicione esta integração ao seu processo de negócios.
      1. Edite a definição do processo de negócios.
        Editar definição
      2. Selecione a data de vigência e clique em OK .
      3. Clique no sinal de adição e adicione uma nova etapa do processo de negócios no BP.
      4. Selecione um pedido, que é após a etapa de conclusão do processo de negócios.
      5. Adicione o processo de negócios e selecione Tipo como Integração .
        Selecione o tipo de integração
      6. Forneça o nome de usuário ISU em Executar como usuário e clique em OK .
      7. Clique em Configure a integração Na etapa do processo de negócios recém-adicionada em Contratar BP.
        Configure a integração
      8. Em Critérios de integração, selecione o tipo de valor como Determine o valor no tempo de execução e selecione valor como ID do funcionário .
        Determine o valor no tempo de execução

        Selecionado ID do funcionário o campo em valor é exibido.

        ID do funcionário
      9. Clique em OK.
      10. Crie um relatório para o webhook com estes detalhes:

        Definição de relatório:

        Definição de relatório

        Rótulos de coluna:

        Rótulos de colunas

        Detalhes do campo calculado:

        Detalhes do campo calculado

        Detalhes do filtro e prompt:

        Filtrar e solicitar detalhes

    Configure o webhook de desligamento para Spoke de RH do Workday

    Use o webhook de desligamento para obter os detalhes do funcionário desligado do Workday para sua instância da ServiceNow.

    Gere nome de usuário e senha em ServiceNowInstância para webhook de desligamento

    Gere nome de usuário e senha em ServiceNowInstância para autenticar solicitações de desligamento do webhook e recuperar os dados necessários do Workday aplicação.

    Antes de Iniciar

    Função necessária: administrador

    Nota:
    Essas configurações devem ser executadas em ServiceNowinstância.

    Procedimento

    1. Faça login em ServiceNowinstância como administrador.
    2. Navegar até Tudo > Definição do Sistema > Tabela.
    3. Filtre e pesquise WorkdayRH tabela de registro do webhook do spoke.
      Por exemplo, Registro do Webhook do Workday .
    4. Clique em Mostrar lista lista relacionada.
    5. Clique em Nova.
    6. No formulário, preencha estes valores.
      Campo Descrição
      Descrição Descrição do registro de registro do webhook. Insira Autenticação e evento do Workday para desligamento .
      UserName Workday usuário que tem direitos de integração usando Workday Serviços da Web.
      Senha Senha do Workday usuário.
      Evento do Workday Evento para o qual o webhook está configurado. Insira Desligamento .
      Instância do Workday Workday URL do host e nome do locatário. Insira o URL neste formato: https://<workday_host_url>/<workday_tenant_name>
    7. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    8. Clique em Gere nome de usuário e senha .
      Copie e registre os valores de nome de usuário e senha. Esses valores devem ser especificados em Workday instância para autenticar as solicitações de webhook.
      Nota:
      Se você tiver mais de um BP de CONTRATAÇÃO em seu ambiente, configure todos os BPs DE CONTRATAÇÃO para habilitar o webhook Criar usuário para todas as transações de funcionários CONTRATADOS.

    Recupere o caminho do recurso do seu ServiceNowInstância para webhook de desligamento

    Recupere o caminho do recurso do seu ServiceNowInstância para uso posterior para autenticar solicitações de webhook off-board e recuperar os dados necessários do Workday aplicação

    Antes de Iniciar

    Função necessária: administrador

    Nota:
    Essas configurações devem ser executadas em ServiceNowinstância.

    Procedimento

    1. Faça login em ServiceNowinstância como administrador.
    2. Navegar até Tudo > Serviços web do sistema > Serviços web com script > Scripted REST APIs.
    3. Abra o registro do WorkdayRH spoke.
    4. Em Recursos clique em Retorno de chamada registro.
    5. Registre e salve o valor de Caminho do recurso para uso posterior.

    Importe o arquivo clar para seu Workday Instância para webhook de desligamento

    Arquivo CLR de importação disponível em ServiceNow StorePara configurar o webhook de desligamento e autenticar solicitações de ServiceNowinstância.

    Antes de Iniciar

    • Workday O Studio deve ser instalado.
    • Acesso à política de criação de relatório personalizado.

      Crie relatório personalizado no Workday com base na estrutura de relatório New_terminated_record e compartilhe o relatório com o usuário da ISU.

    • Acesso para editar a definição do processo de negócios.
    • Acesso para criar e editar o sistema de integração.
    • Função necessária: administrador
    Nota:
    • Exceto nome da integração, campo de relatório XPath (se necessário) e. Workday Cabeçalho da instância, os usuários são advertidos contra modificar os valores de campos ou propriedades no arquivo CLAR.
    • Essas configurações devem ser realizadas no Workday Studio.

    Procedimento

    1. Em Spoke de RH do Workday página em ServiceNow Store, baixe o. Workday-RH-offboarding-webhook-Studio-Sample arquivo de Documentos e links de suporte .
    2. Descompacte o arquivo de amostra para obter o arquivo clar.
    3. Importe o arquivo clar para Workday Estúdio.
    4. Em Propriedades da IniciarHere componente, navegue até Serviços E selecione o relatório RaaS criado para este webhook.
      Relatório do RaaS para spoke de desligamento
    5. Escolha o ambiente em que seu relatório existe, como implementação ou sandbox, e configure o relatório de acordo com sua necessidade.
    6. Forneça um nome de relatório e selecione o relatório necessário.
      Relatório de RAAS personalizado para webhook de desligamento
    7. Forneça o nome do alias do relatório.
      Relatório de alias para webhook de desligamento
    8. Depois que o alias do relatório for adicionado, adicione o caminho selecionado do relatório em Caminho extra que é usado para executar o relatório com base no prompt.
      caminho extra para desligar o webhook
    9. Selecione o alias do relatório.
    10. Em Defina cabeçalhos componente, forneça seu Workday instância do WorkdayInstance cabeçalho.
      Webhook de desligamento do componente de cabeçalhos
    11. Nas propriedades de Httpout , preencha estes valores.
      Campo Valor
      Endpoint Endpoint REST
      Nota:
      Para obter mais informações, consulte Recupere o caminho do recurso do seu ServiceNowinstância.
      Método HTTP POST
      htttout propriedades para desligamento
    12. Salve as mudanças.
    13. No explorador de projetos, selecione a integração e implante-a no Workday sistema.
    14. Faça login em Workday e navegue até Integração > Sistema de integração > Configure atributos de integração.
      configure o desligamento de atributos de integração
    15. Forneça o nome de usuário e a senha em Configure atributos de integração que você gerou em Gere nome de usuário e senha em ServiceNowInstância para webhook de desligamento.
      webhook de desligamento da configuração de atributos de integração
    16. Modifique um processo de negócios e adicione esta integração ao seu processo de negócios.
      1. Edite a definição do processo de negócios.
      2. Selecione o usuário ISU na caixa Conta do Workday.
      3. Selecione a data de vigência e clique em OK .
      4. Clique no sinal de adição e adicione uma nova etapa do processo de negócios no BP.
      5. Selecione um pedido, que é após a etapa de conclusão do processo de negócios.
      6. Adicione o processo de negócios e selecione Tipo como Integração .
      7. Forneça o nome de usuário ISU em Executar como usuário e clique em OK .
      8. Clique em Configure a integração Na etapa do processo de negócios recém-adicionada em Contratar BP.
        configure o webhook de desligamento de integração
      9. Em Critérios de integração, selecione o tipo de valor como Determine o valor no tempo de execução e selecione valor como ID do funcionário .
        valor dos critérios de integração no tempo de execução

        O selecionado ID do funcionário o campo em valor é exibido.

        ID do funcionário de critérios de integração para webhook de desligamento
      10. Clique em OK.
      11. Aberto Criar relatório personalizado tarefa.
      12. Insira o nome do relatório, por exemplo, ENTER New_TERMINATED_RECORD .
      13. Selecione Tipo de relatório Avançado.
      14. Desmarque a opção Otimizado para desempenho.
      15. Selecione Fonte de dados como Todos os trabalhadores.
        Exibir relatório personalizado para desligamento
      16. Crie um relatório conforme mostrado abaixo:
        Relatório de amostra para webhook de desligamento

        Agrupar cabeçalhos de coluna em relatórios Agrupar cabeçalhos de coluna no relatório

        Classificar seção em relatórios

        Filtrar seção em relatórios filtrar seção em relatórios

      17. Selecione Preencher padrões de prompt não definidos . Prompts .
      18. Selecione Habilitar como serviço web . Avançado .

    Configure o Webhook LeaveofAbsence para Spoke de RH do Workday

    Use o webhook LeaveofAbsence para obter detalhes de licença de um funcionário do Workday para sua instância da ServiceNow.

    Gere nome de usuário e senha em ServiceNowInstância do webhook LeaveofAbsence

    Gere nome de usuário e senha em ServiceNowInstância para autenticar solicitações para o webhook LeaveofAbsence e recuperar os dados necessários do Workday aplicação.

    Antes de Iniciar

    Função necessária: administrador

    Nota:
    Essas configurações devem ser executadas em ServiceNowinstância.

    Procedimento

    1. Faça login em ServiceNowinstância como administrador.
    2. Navegar até Tudo > Definição do Sistema > Tabela.
    3. Filtre e pesquise WorkdayRH tabela de registro do webhook do spoke, por exemplo, Registro do Webhook do Workday .
    4. Clique em Mostrar lista lista relacionada.
    5. Clique em Nova.
    6. No formulário, preencha estes valores.
      Campo Descrição
      Descrição Descrição do registro de registro do webhook. Insira Autenticação e evento do Workday para licença .
      UserName Workday usuário que tem direitos de integração usando Workday Serviços da Web.
      Senha Senha do Workday usuário.
      Evento do Workday Evento para o qual o webhook está configurado. Insira LeavedeAusência .
      Instância do Workday Workday URL do host e nome do locatário. Insira o URL neste formato: https://<workday_host_url>/<workday_tenant_name>
    7. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
    8. Clique em Gere nome de usuário e senha .
      Copie e registre os valores de nome de usuário e senha. Esses valores devem ser especificados em Workday instância para autenticar as solicitações de webhook.
      Nota:
      Se você tiver mais de um BP de CONTRATAÇÃO em seu ambiente, configure todos os BPs DE CONTRATAÇÃO para habilitar o webhook Criar usuário para todas as transações de funcionários CONTRATADOS.

    Recupere o caminho do recurso do seu ServiceNowInstância do webhook LeaveofAbsence

    Recupere o caminho do recurso do seu ServiceNowInstância para uso posterior para autenticar solicitações de webhook off-board e recuperar os dados necessários do Workday aplicação

    Antes de Iniciar

    Função necessária: administrador

    Nota:
    Essas configurações devem ser executadas em ServiceNowinstância.

    Procedimento

    1. Faça login em ServiceNowinstância como administrador.
    2. Navegar até Tudo > Serviços web do sistema > Serviços web com script > Scripted REST APIs.
    3. Abra o registro do WorkdayRH spoke.
    4. Em Recursos clique em Retorno de chamada registro.
    5. Registre e salve o valor de Caminho do recurso para uso posterior.

    Importe o arquivo clar para seu Workday Instância do webhook LeaveofAbsence

    Arquivo CLR de importação disponível em ServiceNow StorePara configurar o webhook LeaveofAbsence e autenticar solicitações de ServiceNowinstância.

    Antes de Iniciar

    • Workday O Studio deve ser instalado.
    • Acesso à política de criação de relatório personalizado.

      Crie relatório personalizado no Workday com base na estrutura de relatório leave_of_absence_request e compartilhe o relatório com o usuário da ISU.

    • Acesso para editar a definição do processo de negócios.
    • Acesso para criar e editar o sistema de integração.
    • Função necessária: administrador
    Nota:
    • Exceto nome da integração, campo de relatório XPath (se necessário) e. Workday Cabeçalho da instância, os usuários são advertidos contra modificar os valores de campos ou propriedades no arquivo CLAR.
    • Essas configurações devem ser realizadas no Workday Studio.

    Procedimento

    1. Em Spoke de RH do Workday página em ServiceNow Store, baixe o. Workday-HR-Leave-of-absence-webhook-Studio-Sample arquivo de Documentos e links de suporte .
    2. Descompacte o arquivo de amostra para obter o arquivo clar.
    3. Importe o arquivo clar para Workday Estúdio.
    4. Em Propriedades da IniciarHere componente, navegue até Serviços E selecione o relatório RaaS criado para este webhook.
      Relatório do RAAS para webhook de licença
    5. Escolha o ambiente em que seu relatório existe, como implementação ou sandbox, e configure o relatório de acordo com sua necessidade.
    6. Forneça um nome de relatório e selecione o relatório necessário.
      Relatório de RAAS personalizado para webhook de licença
    7. Forneça o nome do alias do relatório.
      Alias para o nome do relatório
    8. Depois que o alias do relatório for adicionado, adicione o caminho selecionado do relatório em Caminho extra que é usado para executar o relatório com base no prompt.
      Caminho extra para o alias do relatório
    9. Selecione o alias do relatório.
    10. Em Defina cabeçalhos componente, forneça seu Workday instância do WorkdayInstance cabeçalho.
      Defina cabeçalhos para a instância do Workday
    11. Nas propriedades de Httpout , preencha estes valores.
      Campo Valor
      Endpoint Endpoint REST
      Nota:
      Para obter mais informações, consulte Recupere o caminho do recurso do seu ServiceNowinstância.
      Método HTTP POST
      propriedades de saída http para webhook de licença
    12. Salve as mudanças.
    13. No explorador de projetos, selecione a integração e implante-a no Workday sistema.
    14. Faça login em Workday e navegue até Integração > Sistema de integração > Configure atributos de integração.
      Configure atributos de integração para webhook de licença
    15. Forneça o nome de usuário e a senha em Configure atributos de integração que você gerou em Gere nome de usuário e senha em ServiceNowInstância do webhook LeaveofAbsence.
      nome de usuário e senha para configuração de atributos de integração
    16. Modifique um processo de negócios e adicione esta integração ao seu processo de negócios.
      1. Edite a definição do processo de negócios.
        Definição do processo de negócios
      2. Selecione o usuário ISU na caixa Conta do Workday.
      3. Selecione a data de vigência e clique em OK .
      4. Clique no sinal de adição e adicione uma nova etapa do processo de negócios no BP.
      5. Selecione um pedido, que é após a etapa de conclusão do processo de negócios.
      6. Adicione o processo de negócios e selecione Tipo como Integração .
        Integração de tipo de processo de negócios
      7. Forneça o nome de usuário ISU em Executar como usuário e clique em OK .
      8. Clique em Configure a integração Na etapa do processo de negócios recém-adicionada em Contratar BP.
        Configure a integração para o processo de negócios
      9. Em Critérios de integração, selecione o tipo de valor como Determine o valor no tempo de execução e selecione valor como ID do funcionário .
        Valor dos critérios de integração no tempo de execução

        Selecionado ID do funcionário o campo em valor é exibido.

        ID do funcionário selecionado para critérios de integração
      10. Clique em OK.
      11. Aberto Criar relatório personalizado tarefa.
      12. Insira o nome do relatório, por exemplo, Leave_of_absence_request .
      13. Selecione Tipo de relatório Avançado.
      14. Desmarque a opção Otimizado para desempenho.
      15. Selecione Fonte de dados como Todos os trabalhadores ativos e encerrados .
      16. Crie um relatório conforme mostrado abaixo:
        Relatório de amostra

        Seção de cabeçalho da coluna do grupo no relatório Agrupar cabeçalhos de coluna no relatório

        Filtrar seção no relatório Filtrar seção no relatório

      17. Selecione Preencher padrões de prompt não definidos . Prompts .
      18. Selecione Habilitar como serviço web . Avançado .