Configure webhooks para seu Workday RH spoke

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 16 min. de leitura

    • Recupere os detalhes dos funcionários necessários no Workday RH aplicação para seu ServiceNow configurando os webhooks.

    Antes de Iniciar

    Função necessária: administrador

    Configurar o cliente da API do webhook da ServiceNow 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 evento do Workday. Se você não precisar receber notificações de evento do Workday, poderá ignorar as configurações mencionadas nesta seção.
    Nota:
    Essas configurações devem ser realizadas no Workday.

    Procedimento

    1. No Workday, um acesso A tarefa Editar configuração do locatário - Segurança.
    2. Selecione OAuth 2,0 clientes habilitados . Configurações do OAuth 2,0 seção.
    3. Acesse a tarefa Registrar cliente da API.
    4. Insira Nome do cliente .
    5. Selecione Tipo de concessão do cliente Concessão de código de autorização.
    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 do token de atualização em dias.
    9. Opcional: Selecione a opção Tokens de atualização não expirando para impedir que o token de atualização expire.
    10. Selecione Conceder consentimento administrativo Opção para conceder permissão OAuth a um 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.

    Configurar o webhook CreateUser 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 seu ServiceNow Instância do webhook Criar usuário

    Gere nome de usuário e senha em seu ServiceNow Instâ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 seu ServiceNow instância.

    Procedimento

    1. Faça login no seu ServiceNow instância como administrador.
    2. Navegar até Tudo > Definição do Sistema > Tabela.
    3. Filtre e pesquise Workday RH 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 Evento do Workday e autenticação 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 CreateUser .
      Instância do Workday URL do host do Workday 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 Gerar 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 do webhook.
      Nota:
      Se você tiver mais de um BP DE CONTRATAÇÃO em seu ambiente, deverá configurar todos os BPs DE CONTRATAÇÃO para habilitar o webhook Criar usuário para todas as transações de funcionário DE CONTRATAÇÃO.

    Recupere o caminho do recurso do seu ServiceNow Instância do webhook Criar usuário

    Recupere o caminho do recurso do seu ServiceNow Instâ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: ServiceNow administrador.

    Nota:
    Essas configurações devem ser executadas em seu ServiceNow instância.

    Procedimento

    1. Faça login no seu ServiceNow instâ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 Workday RH 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 Criar usuário

    Importar arquivo CLAR disponível em ServiceNow Store Para configurar Criar webhook de usuário e autenticar solicitações de ServiceNow instâ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 ISU.

    • Acesso para editar a definição do processo de negócios.
    • Acesso para criar e editar 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 . IniciarHere componente, navegue até Serviços E selecione o relatório RaAS criado para este webhook.
      Configure o componente StartHere
    5. Escolha o ambiente em que seu relatório existe, como implementação ou área restrita, e configure o relatório de acordo com seu requisito.
    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 usado para executar o relatório com base no prompt.
      Caminho extra
    9. Em Cabeçalhos definidos componente, forneça seu Workday instância do WorkdayInstance cabeçalho.
      Configure o componente Definir cabeçalhos
    10. Nas propriedades de HttpOut preencha esses valores.
      Campo Valor
      Endpoint Endpoint REST
      Nota:
      Para obter mais informações, consulte Recupere o caminho do recurso do seu ServiceNow instância.
      Método HTTP POST
      Configure as propriedades do HttpOut
    11. Salve as mudanças.
    12. No gerenciador de projetos, selecione a integração e implante-a em seu Workday sistema.
    13. Faça login no seu Workday e navegue até Integração > Sistema de integração > Configurar atributos de integração.
      Configurar atributos de integração
    14. Forneça o nome de usuário e a senha em Configurar atributos de integração que você gerou em Gere nome de usuário e senha em seu ServiceNow instância.
      Configurar 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 efetivação 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 . Integração .
        Selecione 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 Configurar integração Na etapa do processo de negócios recém-adicionada em Contratar BP.
        Configurar 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.

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

        Definição do relatório:

        Definição de relatório

        Rótulos de coluna:

        Rótulos de colunas

        Detalhes do campo calculado:

        Detalhes do campo calculado

        Filtrar e solicitar detalhes:

        Filtrar e solicitar detalhes

    Configurar 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 seu ServiceNow Instância para webhook de desligamento

    Gere nome de usuário e senha em seu ServiceNow Instâ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 seu ServiceNow instância.

    Procedimento

    1. Faça login no seu ServiceNow instância como administrador.
    2. Navegar até Tudo > Definição do Sistema > Tabela.
    3. Filtre e pesquise Workday RH 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 Evento do Workday e autenticação 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.
      Instância do Workday URL do host do Workday 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 Gerar 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 do webhook.
      Nota:
      Se você tiver mais de um BP DE CONTRATAÇÃO em seu ambiente, deverá configurar todos os BPs DE CONTRATAÇÃO para habilitar o webhook Criar usuário para todas as transações de funcionário DE CONTRATAÇÃO.

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

    Recupere o caminho do recurso do seu ServiceNow Instância para uso posterior para autenticar solicitações de webhook de desligamento 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 seu ServiceNow instância.

    Procedimento

    1. Faça login no seu ServiceNow instâ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 Workday RH 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

    Importar arquivo CLAR disponível em ServiceNow Store Para configurar o webhook de desligamento e autenticar solicitações de ServiceNow instâ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 ISU.

    • Acesso para editar a definição do processo de negócios.
    • Acesso para criar e editar 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 . 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 área restrita, e configure o relatório de acordo com seu requisito.
    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 usado para executar o relatório com base no prompt.
      caminho extra para desligamento do webhook
    9. Selecione o alias do relatório.
    10. Em Cabeçalhos definidos 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 esses valores.
      Campo Valor
      Endpoint Endpoint REST
      Nota:
      Para obter mais informações, consulte Recupere o caminho do recurso do seu ServiceNow instância.
      Método HTTP POST
      htttout propriedades para desligamento
    12. Salve as mudanças.
    13. No gerenciador de projetos, selecione a integração e implante-a em seu Workday sistema.
    14. Faça login no seu Workday e navegue até Integração > Sistema de integração > Configurar atributos de integração.
      configurar o desligamento de atributos de integração
    15. Forneça o nome de usuário e a senha em Configurar atributos de integração que você gerou em Gere nome de usuário e senha em seu ServiceNow Instâ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 efetivação 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 . Integração .
      7. Forneça o nome de usuário ISU em Executar como usuário e clique em OK .
      8. Clique em Configurar integração Na etapa do processo de negócios recém-adicionada em Contratar BP.
        configurar 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

        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

        Seção de filtro em relatórios seção de filtro em relatórios

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

    Configurar 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 seu ServiceNow Instância do webhook LeaveofAbsence

    Gere nome de usuário e senha em seu ServiceNow Instâ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 seu ServiceNow instância.

    Procedimento

    1. Faça login no seu ServiceNow instância como administrador.
    2. Navegar até Tudo > Definição do Sistema > Tabela.
    3. Filtre e pesquise Workday RH 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 Evento do Workday e autenticação 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 URL do host do Workday 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 Gerar 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 do webhook.
      Nota:
      Se você tiver mais de um BP DE CONTRATAÇÃO em seu ambiente, deverá configurar todos os BPs DE CONTRATAÇÃO para habilitar o webhook Criar usuário para todas as transações de funcionário DE CONTRATAÇÃO.

    Recupere o caminho do recurso do seu ServiceNow Instância do webhook LeaveofAbsence

    Recupere o caminho do recurso do seu ServiceNow Instância para uso posterior para autenticar solicitações de webhook de desligamento 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 seu ServiceNow instância.

    Procedimento

    1. Faça login no seu ServiceNow instâ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 Workday RH 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

    Importar arquivo CLAR disponível em ServiceNow Store Para configurar o webhook LeaveofAbsence e autenticar solicitações de ServiceNow instâ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 ISU.

    • Acesso para editar a definição do processo de negócios.
    • Acesso para criar e editar 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 . 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 área restrita, e configure o relatório de acordo com seu requisito.
    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 usado para executar o relatório com base no prompt.
      Caminho extra para alias de relatório
    9. Selecione o alias do relatório.
    10. Em Cabeçalhos definidos 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 esses valores.
      Campo Valor
      Endpoint Endpoint REST
      Nota:
      Para obter mais informações, consulte Recupere o caminho do recurso do seu ServiceNow instância.
      Método HTTP POST
      propriedades de saída de http para webhook de licença
    12. Salve as mudanças.
    13. No gerenciador de projetos, selecione a integração e implante-a em seu Workday sistema.
    14. Faça login no seu Workday e navegue até Integração > Sistema de integração > Configurar atributos de integração.
      Configurar atributos de integração para webhook de licença
    15. Forneça o nome de usuário e a senha em Configurar atributos de integração que você gerou em Gere nome de usuário e senha em seu ServiceNow Instâ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 efetivação 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 . 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 Configurar 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 . Todos os trabalhadores ativos e encerrados .
      16. Crie um relatório conforme mostrado abaixo:
        Relatório de amostra

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

        Seção de filtro no relatório Seção de filtro no relatório

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