Compartilhar via


Opção 5: execute a solução Node para obter tokens e, em seguida, crie uma integração numa origem externa, como o Workday para importação baseada em API

Depois de registar uma nova aplicação no Centro de administração do Microsoft 365, ter gerado um segredo do cliente e configurado a importação no Centro de administração do Microsoft 365, pode executar a nossa solução de Nó para obter tokens na consola do . A execução desta solução gera os tokens de que precisa para criar a integração da API na sua origem externa, como o Workday. Saiba como no GitHub.

1. Executar a solução

  1. Clone esta aplicação para o seu computador ao executar o seguinte comando na linha de comandos:

    git clone https://github.com/microsoft/orgdata_apibasedimport.git

  2. Inclua os seguintes valores da consola:

  • AppID/ClientID
  • Segredo do cliente
  • ID do inquilino do Microsoft Entra
  • ID do Conector
  • Unidade de dimensionamento
  1. O script será executado e abrirá uma nova janela do browser. Inicie sessão com o mesmo e-mail que introduziu em ID da Aplicação ou UPN ao configurar a importação no Centro de administração do Microsoft 365.

  2. Na página Configuração de Integração do HRIS , copie de forma segura os seguintes valores, que irá utilizar para criar a integração na sua origem externa , como o Workday Report as a Service (RaaS):

  • Endereço HTTP
  • Token de Acesso
  • Atualizar Token
  • Atualizar URL do Token

2. Criar um relatório personalizado no Workday

Aplica-se a: Administrador Global do Microsoft 365 ou Administrador de Origem de Dados Organizacional

  1. Abra o Workday, procure "Criar relatório personalizado" e selecione-o.

    Uma captura de ecrã mostra como procurar um relatório personalizado.

  2. Introduza um nome para o relatório.

  3. Junto a Tipo de Relatório, selecione Avançadas.

  4. Junto a Origem de Dados, selecione Trabalhos para Relatórios de HCM.

  5. Deixe Otimizado para Desempenho desmarcado para filtrar as funções de trabalho que não têm um endereço de e-mail. A Microsoft identifica os trabalhadores por endereço de e-mail, pelo que é um campo obrigatório.

    Uma captura de ecrã mostra a página de detalhes do relatório.

  6. Na parte inferior da página, selecione OK.

  7. Para adicionar campos de e-mail do gestor:

    1. Selecione o menu de três pontos à direita do nome do relatório.

    2. Selecione Campo Calculado paraCriar Campo Calculado do Relatório>.

      Uma captura de ecrã mostra como criar um campo calculado.

    3. Introduza um nome para o novo campo, como "Gestor Email".

    4. Junto a Objeto de Negócio, introduza "Trabalho".

    5. Junto a Função, introduza "Valor Relacionado com Pesquisa".

      Uma captura de ecrã mostra os detalhes do campo calculado.

    6. Selecione OK.

    7. No ecrã seguinte, junto a Campo de Pesquisa, introduza "Gestor – Nível 01".

    8. Junto a Devolver Valor, introduza o campo de e-mail pretendido, tal como Trabalho Primário Público Email Endereço.

      Uma captura de ecrã mostra os detalhes de pesquisa do campo calculado.

    9. Na parte inferior da página, selecione OK.

  8. Adicione campos e personalize o relatório com base nas necessidades da sua organização:

    1. Selecione o menu de três pontos à direita do nome do relatório.

    2. SelecioneEdiçãode Relatório> Personalizado.

    3. Junto a Filtro de Origem de Dados, introduza "Todos os Trabalhos Ativos (Todos os Tipos)".

    4. No separador Colunas , selecione o ícone "+" no canto superior esquerdo para adicionar campos.

      Uma captura de ecrã mostra como personalizar o relatório.

Exemplo de mapeamentos para a maioria dos campos reservados listados aqui

  • O campo Email Do Gestor referencia o campo calculado que configurou acima.

  • Esta é a melhor estimativa para o mapeamento de cada campo; Poderão existir mapeamentos mais adequados para o seu inquilino especificamente.

  • Qualquer um dos campos reservados associados acima pode ser adicionado aqui se ainda não o tiver feito. Também pode adicionar quaisquer campos personalizados que pretenda com qualquer nome e estes podem ser importados para quaisquer aplicações que utilizem campos personalizados.

Objeto de Negócio Campo Substituição do Cabeçalho de Coluna Alias XML de Substituição de Cabeçalhos de Coluna
Função de trabalho ID do Funcionário Microsoft_EmployeeID Defina esta coluna como sendo o mesmo valor que a Substituição do Cabeçalho de Coluna
Função de trabalho Endereço de Email de Trabalho Primário Público Microsoft_PersonEmail
Função de trabalho Email do gestor Microsoft_ManagerEmail
Função de trabalho Organização de Supervisão Microsoft_Organization
Função de trabalho Nível de Gestão Microsoft_LevelDesignation
Função de trabalho Família de Trabalho Único Microsoft_JobDiscipline
Função de trabalho Título da Empresa Microsoft_JobTitle
Função de trabalho Localização - Nome Microsoft_CompanyOfficeLocation
Função de trabalho Data de Contratação Microsoft_HireDate
Função de trabalho Nome Microsoft_FirstName
Função de trabalho Sobrenome Microsoft_LastName
Função de trabalho Nome Legal no Formato de Apresentação de Relatórios Microsoft_DisplayName
Função de trabalho Empresa - Nome Microsoft_Company
Função de trabalho Endereço de Trabalho - Linha Formatada 1 Microsoft_CompanyOfficeStreet
Função de trabalho Endereço do Trabalho - Cidade Microsoft_CompanyOfficeCity
Função de trabalho Endereço do Trabalho - Estado/Província Microsoft_CompanyOfficeState
Função de trabalho Endereço do Trabalho - Código Postal Microsoft_CompanyOfficePostalCode
Função de trabalho Endereço do Trabalho - País/Região Microsoft_CompanyOfficeCountryOrRegion
Função de trabalho Tipo de Trabalho - Texto Microsoft_EmploymentType
Função de trabalho Competências Ativas Microsoft_UserSkillNames
Função de trabalho Número de Telefone do Trabalho Primário Público Microsoft_Phone
Função de trabalho Centro de Custos - ID Microsoft_CostCenter
Função de trabalho Divisão Microsoft_Division

Filtre as funções de trabalho que não têm um e-mail ao adicionar ao separador Filtro , como:

Uma captura de ecrã mostra como filtrar os trabalhadores que não têm um e-mail.

Depois de personalizar o relatório, selecione Avançadas. Em seguida, em Opções dos Serviços Web, selecione Ativar Como Serviço Web.

3. Criar a integração na sua origem externa

Utilize estes passos para criar a integração da API no Workday.

  1. Na parte superior do ecrã do Workday, procure "Criar BEI" e selecione-o.

  2. Na página Criar BEI :

    1. Introduza um nome para a integração.
    2. Selecione Saída.
    3. Selecione OK.
  3. Reveja e confirme os detalhes na página Definições Gerais . Se tudo estiver correto, selecione Seguinte.

  4. Na página Obter Dados :

    1. Junto a Tipo de Origem de Dados, selecione Relatório Personalizado.

    2. Junto a Relatório Personalizado, selecione o relatório que pretende integrar no conector Armazenamento de Blobs do Azure.

    3. Em Detalhes, junto a Formato de Saída Alternativo, selecione CSV.

      Uma captura de ecrã mostra como introduzir detalhes na página Obter Dados.

    4. Na parte inferior da página, selecione Seguinte.

  5. Na página Transformar , não precisa de fazer alterações. Selecione Avançar.

  6. Na página Entregar :

    1. Junto a Método de Entrega, selecione HTTP/SSL.
    2. Junto a Endereço HTTP, introduza o endereço gerado a partir dos passos acima.
    3. Junto a Tipo de Invocação do Serviço Web, selecione OAuth 2.0.
    4. Junto a Token de Acesso, introduza o token de acesso gerado a partir dos passos acima.
    5. Junto a Atualizar Token, introduza o token de atualização gerado a partir dos passos acima.
    6. Junto a Atualizar URL do Token, introduza o URL do token de atualização gerado a partir dos passos acima.
    7. Junto a ID de Cliente, introduza AppID/ClientID.
    8. Junto a Segredo do Cliente, introduza o segredo do cliente.
    9. Junto a Nome do Ficheiro, introduza o nome de ficheiro pretendido, que tem de ser .csv.
    10. Na parte inferior da página Entregar , selecione Seguinte.
  7. Reveja os detalhes na página Rever e Submeter . Se tudo estiver correto, selecione OK.

  8. Junto ao nome da sua integração, selecione Ações.

  9. Paire o cursor do rato sobre Integração e, em seguida, selecione Iniciar/Agendar Integração.

  10. Na página Iniciar/Agendar Integração :

    1. Junto a Integração, selecione o nome da integração que criou.
    2. Junto a Frequência de Execução, selecione a frequência pretendida.
    3. Selecione OK.

    Uma captura de ecrã mostra como introduzir os detalhes da integração iniciada.