Referências técnicas

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 WQL Query , você deve configurar o escopo Sistema - Idioma de consulta do Workday . Para obter mais informações, consulte Autenticação do Workday.

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

Você pode converter relatórios avançados e 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 Convert Report to WQL .
   
   

   

   
   
2. Selecione o relatório que você deseja converter e selecione Converted WQL Query String.
   
   

   

   
   
   
   

   

   
   
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.
   
   

   

   
   

Também é possível explorar as tabelas do Workday usando o objeto Origens de dados e criar suas próprias consultas. Você pode acessar as colunas da tabela através 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 no 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 Visualizar Resultado da Consulta WQL no Workday e usar a consulta correta na atividade Executar Consulta WQL .

      
      

      

      
      

HTTP Request

Você pode usar a atividade HTTP Request para chamar qualquer API Workday REST , desde que atribua as permissões necessárias à API cliente usada. Para obter mais informações, consulte o Workday REST Guia de autenticação do conector .