Referências técnicas

Referências técnicas para as atividades do conector Workday REST.

Esta seção inclui informações úteis que você pode precisar ao interagir com as atividades Workday REST .

Uso da atividade Execute WQL Query

Importante:

Para usar a atividade Execute a consulta WQL , você deve configurar o escopo Sistema - Idioma de consulta do Workday . Para obter mais informações, consulte Autenticação do Workday.

A Linguagem de Consulta do Workday ou WQL é uma linguagem de consulta semelhante à SQL que fornece recursos melhorados para consultar dados do Workday. Como ele se parece com o SQL, você pode criar consultas manualmente dentro do Workday ou converter um relatório existente para WQL usando a atividade Execute WQL Query .

Você pode converter relatórios avançados e de matriz para Workday Query Language (WQL) e, em seguida, usar a consulta resultante na atividade Execute WQL Query para extrair dados do Workday.

Use o exemplo abaixo para referência:

1. No Workday, pesquise a tarefa Converter relatório em WQL .

   

2. Selecione o relatório que deseja converter e selecione String de consulta WQL convertida.

   

   

3. Em seguida, insira a consulta copiada na atividade Execute WQL Query e selecione o botão Gerar esquema de saída .

   

4. Essa ação gera uma lista de campos de saída.

   

Você também pode explorar tabelas do Workday usando o objeto Origens de dados e criar suas próprias consultas. Você pode acessar as colunas da tabela por meio do objeto Campos de origem de dados e os campos filtráveis estão disponíveis no objeto Filtros de origem de dados . Para obter mais informações, consulte a documentação Workday REST em dataSources.

Fatores importantes a considerar

1. Você deve primeiro gerar o esquema de saída dos resultados da consulta e, em seguida, substituir quaisquer valores de coluna por variáveis, no tempo de design.
2. Você pode usar os parâmetros LIMIT e OFFSET para paginar através de grandes conjuntos de dados.
3. Você pode encontrar a seguinte mensagem de erro se:

   1. O escopo do sistema está ausente do cliente da API. Verifique os escopos (área funcional) do seu cliente de API.

   2. Sua consulta está incorreta ou contém variáveis. Certifique-se de executar com sucesso a tarefa Exibir resultado da consulta WQL no Workday e use a consulta correta na atividade Execute WQL Query .

      

Referência de origens de dados WQL

As tabelas a seguir listam os alias de fontes de dados WQL selecionados disponíveis na atividade List Records , organizados por objeto de negócios principal. Todas as fontes de dados listadas são objetos padrão entregues pelo Workday que existem em todos os tenants e podem ser consultados sem parâmetros adicionais.

Para descobrir todas as fontes de dados disponíveis em seu tenant específico, chame:

GET /api/wql/v1/dataSources

Trabalhador

Alias da origem de dados	Description	Caso de uso comum
allWorkers	Todos os trabalhos	Sincronização completa da força de trabalho, provisionamento de identidade
allActiveEmployees	Funcionários ativos no momento	Relatórios de número ativo, feeds de folha de pagamento
allContingentWorkers	Trabalhadores provisórios e terceirizados	Gerenciamento de fornecedores, provisionamento de acesso
allTerminatedWorkers	Trabalhadores encerrados	Deslocamento, auditorias de conformidade
allPreHires	Registros pré-contratação	Fluxos de trabalho de integração
allLeaveOfAbsenceWorkers	Trabalhadores em licença no momento	Rastreamento de saída, continuidade dos benefícios
allRetiredWorkers	Aposentados	Feeds de benefícios de pendências e aposentados
workerHistory	Registros históricos de alterações do trabalho	Trilha de auditoria, rastreamento de alterações
workerCompensation	Dados de remuneração por funcionário	Integrações de folha de pagamento, recompensas totais
workerBenefitElections	Detalhes do registro do benefício	Feed da transportadora, relatórios de benefícios
workerTimeOff	Saldos e entradas de tempo fora	Sair relatório de saldo
workerPersonalData	Informações pessoais ( seu endereço, data de nascimento e assim por diante)	Sincronização de dados de RH, conformidade
workerDocuments	Documentos de trabalho anexados	Integrações de gerenciamento de documentos
workerAccountProvisioning	Dados de provisionamento de conta e identidade	Sincronização do IAM (por exemplo, Okta, Azure AD)

Organização

Alias da origem de dados	Description	Caso de uso comum
allOrganizations	Todos os tipos de organização	Sincronização da estrutura da organização
allSupervisoryOrganizations	Hierarquia da organização de supervisão	Hierarquia de gerente, gráficos organizacionais
allCostCenters	Lista de Centros de Custo	Relatórios financeiros, alocação de custos
allCompanies	Entidade jurídica e lista de empresas	Relatórios com várias entidades
allRegions	Estruturas regionais	Relatórios baseados em geografia
allCustomOrganizations	Tipos de organizações personalizados	Estruturas da organização específicas do cliente
organizationHierarchies	Árvore da organização completa	Feeds de hierarquia para sistemas downstream
allBusinessUnits	Estrutura da unidade de negócios	Relatórios no nível do segmento

Posição

Alias da origem de dados	Description	Caso de uso comum
allPositions	Todas as posições	Sincronização do catálogo de posições
allOpenPositions	Posições não preenchidas e abertas	Pipeline de recrutamento, planejamento da força de trabalho
allFilledPositions	Posições preenchidas no momento	Relatórios de pessoal
positionBudget	Dados de orçamento de posição	Integração de planejamento financeiro
positionRestrictions	Restrições de posições	Conformidade e governança
allHeadcountGroups	Grupos de rastreamento de pessoal	Análise da força de trabalho

Requisito de trabalho

Alias da origem de dados	Description	Caso de uso comum
allJobApplications	Solicitações de recrutamento	Integração do ATS, análise de contratação
allJobRequisitions	Abrir requisições	Rastreamento de requisição
allCandidates	Pool de candidatos	Relatórios do pipeline candidato
allOffers	Ofertas de trabalho	Feeds de gerenciamento de ofertas
allInterviews	Registros de entrevista	Análise de agendamento de entrevista
allReferrals	Referências de funcionários	Rastreamento do programa de referência

Compensação

Alias da origem de dados	Description	Caso de uso comum
allCompensationPlans	Estruturas do plano de compensação	Administração do plano
allCompensationGrades	Definições de nota e faixa	Integrações de mapeamento de classe
allCompensationPackages	Compensação empacotada	Relatório de recompensas totais
allBonusPlans	Estruturas de bônus	Feeds de pagamento de bônus
allStockPlans	Planos de ações e ações	Administração de ações
allMeritPlans	Planos de aumento por métricas	Feeds de ciclo de excelência anual

Benefícios

Alias da origem de dados	Description	Caso de uso comum
allBenefitPlans	Catálogo de planos de benefícios	Validação de configuração do plano
allBenefitGroups	Grupos de elegibilidade do benefício	Revisão das regras de elegibilidade
allHealthCareCoverage	Dados de cobertura de saúde	Feeds de registros de transportadoras
allInsuranceCoverage	Seguro de vida e invalidez	Feeds de companhias de seguros
allRetirementPlans	401k e planos de pendente	Feeds de fornecedores de descontinuação
allBenefitElections	Escolhas ativas	Abrir relatório de inscrição

Rastreamento de tempo e ausência

Alias da origem de dados	Description	Caso de uso comum
allTimeEntries	Entradas de horário	Feeds de horário da folha de pagamento
allAbsenceRequests	Solicitações de saída	Sair do gerenciamento
allTimeOffPlans	Definições do plano de tempo de licença	Sincronização de configuração do plano
allLeaveTypes	Sair do catálogo de tipos	Sair do relatório da política
allTimeCalendars	Configurações de calendário	Gerenciamento de agendamento

Habilidade e desempenho

Alias da origem de dados	Description	Caso de uso comum
allPerformanceReviews	Revisar dados do ciclo	Análise de desempenho
allGoals	Metas dos funcionários	Integração de rastreamento de metas
allCompetencies	Estruturas de habilidades	Análise de lacunas de habilidades
allSuccessionPlans	Pools de sucessão	Planejamento de sucessão
allTalentPools	Pipeline de talentos	Gestão de talentos
allLearningCourses	Catálogo de cursos de LMS	Sincronização da plataforma de aprendizado

HTTP Request

Você pode usar a atividade HTTP Request para chamar qualquer API REST do Workday, desde que você atribua as permissões necessárias ao cliente da API usado. Para obter mais informações, consulte o guia de Autenticação do conector Workday REST.