Actions14
- Entidades Actions
- Documentos Actions
- Relacionamentos Actions
- Metadata Actions
Entidades → Procurar registro por campo(s)
AI-generatedSummary
Procura registros de uma entidade do EspoCRM usando um ou mais filtros e parâmetros opcionais de listagem. Retorna a resposta da API com a lista e o total, ou um item por registro se essa opção estiver ativada.
Inputs
- Entidade (required) — Entidade do EspoCRM a consultar.
- Filtros (required) — Adicione uma ou mais condições por campo, como igualdade, comparação, intervalo, lista, texto, data, valor nulo ou booleano. Filtros de relacionamento usam um atributo de relacionamento; uma expressão usa o campo Expressão. Cada condição precisa dos valores exigidos pelo tipo, e não pode haver mais de uma condição para o mesmo campo.
- Opções — Configure paginação automática, tamanho máximo por página (até 200), deslocamento, ordenação, filtros primário, booleanos e de texto, atributos a selecionar e um Where Group em JSON. A opção de não calcular total envia o cabeçalho X-No-Total.
Output shape
Uma resposta de listagem em um item, ou vários itens JSON, um por registro.
Por padrão, cada item contém a resposta da API, incluindo list e total. Com “Retornar lista como itens”, cada registro de list vira um item e o total é descartado. “Retornar tudo” pagina automaticamente e agrega os registros; sem essa opção, a consulta retorna uma página.
