Close Smart Views müssen s_query nutzen, nicht query
Mit dem Lucene-Query bleibt die Smart View in der UI uneditierbar. Nur das strukturierte s_query-Format lässt sich später wieder anfassen.
Beim Anlegen von Smart Views in Close CRM über die API gibt es zwei Wege, das Filterkriterium zu setzen: query (ein Lucene-String) und s_query (strukturiertes JSON). Beide funktionieren beim Erstellen. Der Unterschied zeigt sich erst später, an genau der Stelle, an der es weh tut.
Das Problem
Legst du die Smart View mit query als Lucene-String an, ist sie in der Close-Oberfläche nicht mehr editierbar. Der Nutzer öffnet die Filter-Ansicht, will eine Kleinigkeit ändern, und die UI kann den String nicht in ihre Bausteine zurückübersetzen. Die View ist praktisch eingefroren.
Der Fix
Immer s_query (structured JSON) nutzen. Dann bleibt die Smart View in der UI voll bearbeitbar.
{
"type": "and",
"queries": [
{ "type": "object_type", "object_type": "lead" },
{
"type": "field_condition",
"field": { "type": "custom_field", "custom_field_id": "cf_XXXX" },
"condition": { "type": "text", "mode": "full_words", "value": "Webinar" }
}
]
}
Ein paar Close-Fallen gleich mit
Wer an der Close-API arbeitet, sollte diese kennen: Lucene tokenisiert E-Mail-Adressen und produziert False Positives; Datumsbereiche und Trailing-Slash sind pingelig; nach Schreibzugriffen gibt es kurze Eventual Consistency, ein sofortiger Read-Back kann veraltet sein. Und Telefonnummern immer vor dem Matching normalisieren.