Pesquisar Dados da Empresa
Use esta ação quando precisar de uma lista de registros correspondentes em vez de um registro específico.
Melhor para
- Procurar contatos, serviços, eventos ou workflows por filtros
- Encontrar o registro correspondente mais recente ou mais antigo
- Direcionar passos posteriores com base na existência ou não de correspondências
Campos principais
| Campo | O que faz |
|---|---|
| Dynadata Item Type | Escolhe que tipo de registros pesquisar |
| filter (CEL -> Mongo filter) | Define quais registros devem corresponder. Não use $regex aqui — é rejeitado com um erro 400; use Busca + Campos de busca para correspondência de texto parcial |
| Busca | Termo de substring ("contém") sem distinção de maiúsculas e minúsculas, comparado literalmente contra os campos listados em Campos de busca |
| Campos de busca | Os nomes de campo contra os quais o termo de Busca é comparado, p. ex. ["name","email"] |
| sort (CEL -> sort object) | Controla a ordem com um mapa de um campo ou pares [field, direction] ordenados |
| Limite | Controla quantos registros retornar. Se deixar vazio, o padrão é 50 |
| Pular | Permite paginar os resultados |
Ordem de classificação
Para um campo, um mapa é aceito:
{'createdAt': -1}
Para vários campos, use uma lista ordenada de pares. O primeiro par tem a maior
prioridade: este exemplo ordena por priority decrescente e depois por
createdAt crescente quando as prioridades são iguais.
[['priority', -1], ['createdAt', 1]]
1 significa crescente e -1 significa decrescente. Mapas CEL não têm ordem,
por isso uma ordenação composta em mapa é rejeitada. Informe no máximo 32
campos, sem nomes de campo duplicados; pares malformados são rejeitados.
O que passos posteriores podem usar
Os registros correspondentes estão disponíveis em:
workflow.step(N).dataworkflow.step(N).data[0]
Dicas
- Use ordenação junto com um limite baixo quando precisar apenas da primeira correspondência relevante.
- Verifique se
workflow.step(N).dataestá vazio antes de assumir que um resultado existe. - Este é frequentemente o primeiro passo correto antes de uma ação posterior de atualização ou notificação.
- Para correspondência de texto parcial / "contém", use Busca + Campos de busca em vez de um filtro
$regex(que é rejeitado com um erro 400).