Ir para o conteúdo principal
Administrator Guide
Última atualização: 2024-02-09
ONDE

ONDE

Especifica uma ou mais expressões condicionais que filtram os resultados da consulta. O Workday avalia primeiro as expressões entre parênteses em expressões condicionais. Use as teclas
AND
e
OR
operadores lógicos para separar expressões condicionais no Workday Query Language (WQL).

Sintaxe

WHERE field1 = value1 AND field2 IN (instance1, instance2) OR field3 IN (inst_refId = referenceID)

Argumentos

Argumento
Descrição
field1
,
field2
, ...
fieldN
O alias para um campo na expressão condicional.
value1
,
value2
, ...
valueN
O valor do campo que você quer fazer a correspondência.
instance1
,
instance2
, ...
instanceN
A ID Workday do valor do campo com o qual você quer fazer a correspondência.
Quando você executa uma consulta, o Workday valida o formato da ID Workday e falha na consulta quando o formato é inválido.
inst_refId
O tipo de ID de referência de um campo na expressão condicional.
referenceID
A ID de referência do valor do campo com o qual você quer fazer a correspondência.
Você pode filtrar pela ID de referência com ou sem aspas duplas.
Exemplos
  • (inst_refId = "referenceID")
  • (inst_refId = referenceID)

Operadores de comparação

Operador
Compatibilidade de tipos de dados do campo
Descrição
=
Booliano
Data
Numérico
Texto
Equal.
>
Data
Numérico
Maior que
>=
Data
Numérico
Maior ou igual a.
<
Data
Numérico
Menor que
<=
Data
Numérico
Menor ou igual a.
!=
Booliano
Data
Numérico
Texto
Diferentes.
contains
Texto
O valor de comparação é um subconjunto do valor do campo.
Não diferencia maiúsculas de minúsculas.
Exemplo: Cat contém AT.
not contains
Texto
O valor de comparação não é um subconjunto do valor do campo.
Não diferencia maiúsculas de minúsculas.
Exemplo: O gato não contém o cão.
endswith
Texto
O valor de comparação é um subconjunto do valor do campo. O último caractere do valor do campo corresponde ao último caractere do valor de comparação.
Não diferencia maiúsculas de minúsculas.
Exemplo: Cat termina com AT.
in
Instância
Texto
O campo corresponde a um ou mais valores possíveis para uma condição.
is empty
Booliano
Data
Instância
Numérico
Texto
O campo não tem valor.
is not empty
Booliano
Data
Instância
Numérico
Texto
O campo tem um valor.
not in
Instância
Texto
O campo não corresponde a nenhum valor possível de uma condição.
startswith
Texto
O valor de comparação é um subconjunto do valor do campo. O primeiro caractere do valor do campo corresponde ao primeiro caractere do valor de comparação.
Não diferencia maiúsculas de minúsculas.
Exemplo: Cat começa com CA.

Formatos de data e hora

O WQL oferece suporte a datas e horas na hora universal coordenada (UTC) ou na hora padrão do Pacífico (PST).
Data e hora
Formato
Data
DD-MM-AAAA
Hora (mostrador de 24 horas)
HH:MM:SS
Data e hora com fuso horário
PST: YYYY-MM-DD HH:MM:SS
UTC: YYYY-MM-DD HH:MM:SSZ

Exemplos

Retorna os campos de trabalhador e local da fonte de dados
allWorkers
em que o local é São Francisco e a ID Workday é um trabalhador específico:
SELECT worker, location FROM allWorkers WHERE location in (Location_ID = San_Francisco_site) AND worker in (3895af7993ff4c509cbea2e1817172e0)
Retornar transações faturáveis que foram aprovadas entre 7h15 de 1º de agosto de 2020 e 7h45 de 30 de agosto de 2020 usando tempo universal coordenado (UTC), adicionando Z aos valores de data e hora:
SELECT billableProject, projectCompany, approvalDate FROM billableProjectTransactions WHERE (approvalDate >= '2020-08-01 07:15:00Z' AND approvalDate <= '2020-08-30 07:45:00Z')

Limitações

As cláusulas WHERE ON devem vir antes das cláusulas WHERE.