A função de pesquisa: Comandos e sintaxe
Use a função de pesquisa para retornar informações de uma tabela gerenciada pelo usuário.
CPQ Usa uma linguagem de consulta baseada em SQL para pesquisar tabelas gerenciadas pelo usuário.
A função de pesquisa retorna até 10 000 linhas de uma tabela e expira após 30 segundos se a pesquisa ainda estiver consultando. Para obter informações sobre como carregar arquivos CSV em tabelas gerenciadas, consulte Carregador de matriz: Carregamento de tabela CSV.
Para saber mais sobre diretrizes gerais para usar a função de pesquisa, consulte Minimizando consultas de tabela.
Comandos compatíveis
- SELECIONAR Seleciona colunas de uma tabela (separadas por ",")
- DE seleciona a tabela da qual a consulta usará os dados
- ONDE define as condições de onde as outras colunas serão pesquisadas
- E une duas condições WHERE (ambas devem ser verdadeiras)
- OU une duas condições EM QUE (qualquer uma pode ser verdadeira)
Sintaxe
Consulta de exemplo:
var tableResults = lookup("SELECT column1, column2 FROM tableName WHERE column3 = :key1 OR (column4 != :key2 AND column5 IN :list)", {"key1": "value", "key2":cfg.[singleFieldName], "list":cfg.[multiFieldName]});O primeiro parâmetro é a cadeia de caracteres de comando baseada em SQL usada para consultar a tabela gerenciada.
O segundo parâmetro é o mapa de chave-valor a ser inserido na consulta. Os valores podem ser constantes, variáveis ou campos.
A variável tableResults contém a matriz resultante. Esta variável não pode ser retornada sozinha. Os resultados devem ser referenciados pelo índice ( TableResults[0], tableResults[1]... ) e pode conter qualquer número de resultados ou nenhum.
Se você receber o erro "...O índice "0" está fora dos limites..." ao trabalhar com pesquisa de tabela, você provavelmente está tentando fazer referência a uma matriz vazia. Recomendamos executar uma verificação nula nos resultados da tabela.
Comparadores:
- =
- É igual a
- !=
- Não é igual a.
- >
- É maior que
- <
- É menor que
- >=
- É maior que ou igual a.
- IN
- É igual a QUALQUER (em um conjunto)
O formato para EM obras para qualquer coleção no seguinte formato:
lookup("SELECT column1 FROM table WHERE column2 IN (:options)",{options = cfg. [multi picklistField]});