Ir para o conteúdo principal
Documentação
Documentação
Administrator Guide
Última atualização: 2025-04-04
Conceito: objetos de negócios relacionados em WQL

Conceito: objetos de negócios relacionados em WQL

Você pode acessar campos de um objeto de negócios relacionado (RBO) no
SELECT
 cláusula usando colchete
{}
 Notação
Você também pode filtrar os resultados da consulta por campos de RBO usando o
WHERE ON
 cláusula Entrada
WHERE ON
 cláusulas, omitir o colchete
{}
 para os campos de RBO.
As respostas destes pontos de extremidade agora retornam o objeto de negócios relacionado a cada campo:
  • GET /dataSources/{ID}/fields
  • GET /dataSources/{ID}/dataSourceFilters/{subresourceID}

Sintaxe

SELECT
field1
{
relatedBusinessObjectField1, relatedBusinessObjectField2
} FROM
dataSource
Exemplo:
SELECT dependents{age} FROM allWorkers
Você pode fazer referência a um único campo ou a vários campos separados por vírgulas de um campo RBO.
Você também pode atribuir um alias personalizado a um campo RBO. Exemplo:
dependents{age} as DependentsAge

Exemplos

Retornar o trabalhador e vários campos da função RBO
de dependentes
 em um grupo:
SELECT worker, dependents{legalName_FirstName, legalName_LastName, age}
FROM allWorkers
Retorna o trabalhador e vários campos do RBO
de dependentes
 como grupos separados: 
SELECT worker, dependents{legalName_FirstName} as FirstName, dependents{legalName_LastName} as LastName, dependents{age} as Age
FROM allWorkers
Quando você chama vários campos separadamente do mesmo campo de consulta, use um alias de campo exclusivo.

Limitações

Quando o campo de consulta de RBO tem várias instâncias, o Workday só oferece suporte a até 500 valores para o campo de RBO. Exemplo: você especifica um trabalhador como o objeto de negócios principal e os dependentes do trabalhador como a RBO. Quando a consulta retorna mais de 500 dependentes para um trabalhador, o WQL exibe um erro. Considere usar uma fonte de dados baseada em uma fonte de dados Dependents.
Você não pode acessar campos de RBOs:
  • Em consultas que usam um
    GROUP BY
     cláusula
  • Fora da
    SELECT
     e
    WHERE ON
     cláusulas
Quando você usa um cliente de API de terceiros, pode ser necessário codificar a consulta primeiro. Alguns clientes de terceiros não processam colchetes
{}
 Notação
Exemplo de consulta antes da codificação: 
SELECT worker, dependents{legalName_FirstName} as FirstName FROM allWorkers
Exemplo de consulta após a codificação:
SELECT%20worker%2C%20dependents%7BlegalName_FirstName%7D%20as%20FirstName%20FROM%20allWorkers