İfade sözdizimi ({{ }})

Bu rehberde: Kutuların alanlarına yazdığınız {{ ... }} kalıplarını öğrenirsiniz. Bu kalıplar "önceki kutudan gelen veriyi buraya koy" demenin yoludur. 25 hazır örnek var.

⏱ 15 dakika

İfade nedir?#

Bir kutunun metin alanına {{ $json.body }} yazarsanız, çalışma anında bu kalıp önceki kutudan gelen gönderi metniyle değiştirilir. Kalıba ifade denir.

İfadeler Excel formüllerine benzer: alan okuma, karşılaştırma, basit metin işlemleri. Kod yazmanız gerekmez.

Kural: Bir alan yalnızca tek bir {{ }} içeriyorsa değer olduğu gibi geçer (liste, sayı, evet/hayır). Etrafında metin varsa hepsi metne çevrilir. Bu yüzden mediaUrls: {{ $json.mediaUrls }} bir liste olarak geçer.

En kolay yol: fx yardımcısı#

1. Bir metin alanının yanındaki fx düğmesine basın. ②'de önceki kutuların gerçek çıktıları listelenir.
2. İstediğiniz alana tıklayın. İfade ①'e otomatik yazılır.
3. Yardımcı, ifadeyi son çalıştırmanın gerçek verisiyle anında değerlendirir. Sonucu görürsünüz.

İpucu: İlk kez ifade yazıyorsanız önce bir test çalıştırması yapın. Böylece fx yardımcısında gerçek veri görünür.

Kullanabileceğiniz değişkenler#

Olmayan bir alanı okursanız hata çıkmaz; boş döner. Zorunlu bir alanın boş kalması ise kutuyu hata ile durdurur.

Yapabileceğiniz işlemler#

• Karşılaştırma: === (eşit), !== (eşit değil), >, >=, <, <=
• Mantık: && (ve), || (veya), ! (değil), a ? b : c (şart), ?? (boşsa şunu kullan)
• Aritmetik: + - * / %
• Metin: .toLowerCase(), .toUpperCase(), .trim(), .includes(), .startsWith(), .slice(), .replace(), .split()
• Liste: .length, .map(), .filter(), .find(), .join(), .slice(), .some(), .every()
• Nesne: Object.keys(), Object.values(), JSON.stringify()
• Sayı/tarih: Number(), Math.round/min/max, new Date(), Date.now()
• Yardımcılar: $date(değer, "DD.MM.YYYY") (YYYY, MM, DD, HH, mm, ss kullanılabilir; saatler UTC'dir), $truncate(metin, 120), $slug(metin), $pick(nesne, ["alan1", "alan2"]), $first(liste), $last(liste)

Fonksiyon tanımlama, döngü (for, while), require, fetch, process engellenmiştir. Karmaşık dönüşümler için Kod kutusunu kullanın.

25 örnek#

Temel alan okuma#

1. Gönderi metni: {{ $json.body }}
2. İç içe alan: {{ $json.body.email }} (webhook tetikleyicisinde form verisi body altında gelir)
3. Liste elemanı: {{ $json.hashtags[0] }}
4. Boşsa varsayılan: {{ $json.name ?? "Değerli müşterimiz" }}

Başka kutuya başvurma#

5. İlk öğe: {{ $node["Müşteri Adayı Puanlayıcı"].json.reportMarkdown }}
6. Tüm öğelerden alan toplama: {{ $node["Content Creator"].all().map(i => i.json.platform).join(", ") }}
7. Sayım: {{ $node["Find leads"].all().length }} aday bulundu
8. Eşleşen öğe: {{ $node["Görsel üret"].item.binary.image.url }}

Değişkenler ve proje#

9. Hedef profil: Find prospects matching: {{ $vars.icp }}
10. Marka adı: {{ $project.name }} için samimi destek asistanı
11. Ton: Şu tonda yaz: {{ $project.brandVoice.tone }}
12. UTM'li link: {{ $project.websiteUrl }}/blog?utm_source={{ $json.platform.toLowerCase() }}&utm_medium=social

Koşullar (Eğer, Süz, olay filtresi)#

13. Puan eşiği ve durum: {{ $json.score >= 70 && $json.status === "NEW" }}
14. Devir kontrolü: {{ $json.handoff === true }}
15. Anahtar kelime: {{ $json.text.toLowerCase().includes("fiyat") || $json.text.toLowerCase().includes("ücret") }}
16. Görsel yok mu: {{ !$json.mediaUrls || $json.mediaUrls.length === 0 }}
17. Etiket var mı: {{ ($json.tags ?? []).includes("vip") }}

Zaman#

18. Tarihli başlık: Adaylar – hafta {{ $today }}
19. Yarın 09:00: {{ new Date(Date.now() + 24*60*60*1000).toISOString().slice(0,10) }}T09:00:00+03:00
20. Biçimli tarih: {{ $date($now, "DD.MM.YYYY HH:mm") }}

Metin işleme#

21. Kısaltma: {{ $truncate($json.body, 250) }}
22. Çok satırlı e-posta gövdesi:

Merhaba {{ $json.name.split(" ")[0] }},

{{ $project.name }} olarak {{ $vars.offer }} konusunda yardımcı olabiliriz.
{{ $json.company ? "Özellikle " + $json.company + " gibi şirketler için." : "" }}

Saygılarımızla

23. JSON gövdesi (HTTP kutusu): { "text": "{{ $json.body }}", "platform": "{{ $json.platform }}", "runId": "{{ $run.id }}" }
24. Dinamik kanal: Mesaj gönder kutusunda channel: {{ $json.channel }}, to: {{ $json.contactId }}
25. Görsel açıklaması: {{ $json.imagePrompt ?? "Minimal flat illustration about " + $json.topic }}

Öğe eşleştirme kuralları#

• Bir kutuya 3 öğe gelirse alanlar 3 kez, her öğe için ayrı çözümlenir. Çoğu kutu öğe başına bir çıktı üretir.
• $node["X"].json her zaman X'in ilk öğesini verir. Öğeleri birebir eşlemek için .item kullanın. Emin değilseniz gereken alanı Alan ayarla kutusuyla öğeye taşıyın; sonra $json ile okuyun.
• Birleştir kutusundan sonra öğeler birleşir.
• Ajan kutuları gelen tüm öğeleri bağlam olarak alır; görev metnindeki ifadeler yalnızca ilk öğe için çözümlenir.

Hata ayıklama#

Sık sorulan sorular#

Kod bilmeden ifade yazabilir miyim? Evet. fx düğmesi ifadeyi sizin için yazar. Karşılaştırma ve ?? gibi birkaç kalıbı öğrenmeniz yeterlidir.

Kutu adını değiştirdim; ifadeler bozulur mu? Editör $node["Eski ad"] başvurularını otomatik günceller. Yalnızca Kod kutusundaki metinleri elle düzeltin.

Gizli bir anahtarı ifadede kullanabilir miyim? $env kapalıdır. Anahtarı Ayarlar → Değişkenler altına yazıp {{ $vars.anahtar }} ile kullanın; daha iyisi, entegrasyon olarak bağlayın.

Tarih neden UTC? $now her zaman UTC'dir. Yerel tarih için $today (iş akışı saat dilimi) veya $date kullanın.

Sonraki adım#

• İş akışı editörü
• Veri node'ları – Alan ayarla ve Kod
• Mantık node'ları