Referenciando Propriedades de Primeira Classe de Pessoa em Expressões de Pesquisa

Ao criar Propriedades Personalizadas que buscam valores de um registro de Pessoa ou Recurso, é essencial usar as chaves de campo corretas. As expressões de busca dependem de chaves internas no nível do código, não dos rótulos amigáveis exibidos na interface. Usar um nome de campo incorreto fará com que sua busca falhe ou retorne resultados vazios.

Este artigo explica quais nomes de campo (chaves) são suportados e como usá-los corretamente.

As expressões de busca são analisadas pelo código de backend que corresponde a chaves de string específicas, como:

• engagementtype

• ratecard

• reference

Essas chaves não são as mesmas que os rótulos legíveis da interface (por exemplo, Engagement Type).
Se você referenciar o rótulo da interface em vez da chave do campo, a expressão não corresponderá a nada.

✔️ Use:
engagementtype

❌ Não use:
Engagement Type

A correspondência de busca não diferencia maiúsculas de minúsculas, portanto os seguintes são equivalentes:

• engagementtype

• EngagementType

• ENGAGEMENTTYPE

No entanto, espaços não são suportados, portanto:

❌ Engagement Type não corresponderá.

Recomendação:
Sempre use chaves em letras minúsculas, sem espaços: engagementtype

Ao configurar uma Propriedade Personalizada para buscar um valor de uma Pessoa/Recurso, as seguintes chaves são suportadas:

Exemplo