Cómo hacer referencia a propiedades de primera clase de Persona en expresiones de búsqueda

Al crear propiedades personalizadas que buscan valores en un registro de Persona o Recurso, es fundamental usar las claves de campo correctas. Las expresiones de búsqueda dependen de claves internas a nivel de código, no de las etiquetas descriptivas que se muestran en la interfaz. Usar un nombre de campo incorrecto hará que la búsqueda falle o devuelva resultados vacíos.

Este artículo explica qué nombres de campo (claves) son compatibles y cómo usarlos correctamente.

Las expresiones de búsqueda son procesadas por código de backend que coincide con claves de cadena específicas, como:

• engagementtype

• ratecard

• reference

Estas claves no son lo mismo que las etiquetas de la interfaz legibles por humanos (por ejemplo, Tipo de compromiso).
Si hace referencia a la etiqueta de la interfaz en lugar de la clave de campo, la expresión no coincidirá con nada.

✔️ Use:
engagementtype

❌ No use:
Tipo de compromiso

La coincidencia de búsqueda no distingue mayúsculas y minúsculas, por lo que lo siguiente es equivalente:

• engagementtype

• EngagementType

• ENGAGEMENTTYPE

Sin embargo, no se admiten espacios, por lo que:

❌ Tipo de compromiso no coincidirá.

Recomendación:
Use siempre claves en minúsculas y sin espacios: engagementtype

Al configurar una propiedad personalizada para buscar un valor de un registro de Persona/Recurso, se admiten las siguientes claves:

Ejemplo