Liste Düzenle adımı nasıl kurulur?

Ne işe yarar?

“Liste Düzenle” bir listeyi düzenler ve sonucu yeni bir değişkene yazar. Liste çoğunlukla bir Araç Çağrısı'nın ya da Entegrasyon Eylemi'nin cevabından gelir; çoklu seçimin cevabı da bir listedir.

Ziyaretçi bu adımı görmez, avatar bir şey söylemez; asistan ziyaretçiyi beklemeden devam eder.

Adımı eklemek için “Akış” sekmesinde “Adım ekle”ye basın ve “Mantık” kategorisinde “Liste Düzenle”ye tıklayın; adım kanvasın ortasına eklenir. Ayarları, adıma tıklayınca sağda açılan adım panelinin “İçerik” sekmesindedir.

Bu adımda “Ekranda görünen metin” yoktur; panelin en altında “Adım notu” durur. Not yalnız sizin içindir: ziyaretçi görmez, seslendirilmez ve çevrilmez.

Değerlere önceki adımlardan değişken yazarsınız: {sehir} gibi. Bir cevabın içindeki alan için alanın adını noktayla ekleyin: {siparis.durum}. Kutulardaki “Değişken ekle” düğmesi o noktada kullanabileceğiniz değişkenleri listeler. Henüz dolmamış bir değişken boş metin sayılır.

Adımı kurmak

1. “Liste” kutusuna listenin kendisine giden yolu yazın: {cevap.items} gibi; cevabın tamamı liste değildir. Liste bir Araç Çağrısı'nın cevabındaysa “Örnek veriyi getir” ile aracı bir kez çağırın: “Cevaptaki listeler”den birini seçer, “İlk satırın alanları”nı görürsünüz.
2. Kullanmak istediğiniz işlemleri açın (aşağıda).
3. Sonucun yazılacağı “Değişken adı”nı verin. {liste} listenin tamamını, {liste.1.alan} ilk öğenin bir alanını verir.

İşlemler

İşlemler her zaman bu sırayla uygulanır; böylece “en ucuz 5” gibi sonuçlar doğru çıkar:

• “Süz”: yalnız kuralları tutan öğeler kalır. Kurallar Koşul adımındaki gibidir; öğenin alanını {item.alan} diye yazın (öğe düz bir değerse {item}). Kural yoksa süzülmez.
• “Sırala”: açılan kutuya sıralanacak alanı yazın (ör. fiyat) ve “Artan” ya da “Azalan”ı seçin. Değerler sayıysa sayı, tarihse tarih, değilse alfabe sırasıyla sıralanır; değeri boş öğeler sona gider.
• “Tekrarları at”: açılan kutuya karşılaştırılacak alanı yazın; aynı değeri taşıyan öğelerden yalnız ilki kalır. Sıralamadan sonra uygulandığı için öne çıkan kalır. Alan boşsa öğenin tamamı karşılaştırılır.
• “İlk N öğeyi al”: listenin başından yalnız yazdığınız sayı kadar öğe kalır.

Sonucu kullanmak

Sonucu sonraki adımlarda kullanabilirsiniz: Seçim adımında “Seçeneklerin kaynağı” › “Değişkenden” ile seçenek olarak gösterebilir, Döngü adımıyla her öğesi için aynı adımları çalıştırabilir, Değişken Ata'nın “Liste özeti”yle sayabilir ya da toplayabilirsiniz. Sonuç çok uzunsa (yaklaşık 16.000 karakter) sondaki öğeler atılır.

Örnek

Bir Araç Çağrısı müsait randevu saatlerini {cevap} değişkenine yazıyor. Liste Düzenle'de “Liste” {cevap.saatler}; “Süz” {item.kontenjan} · “Sayı” · “büyüktür” · 0; “Sırala” baslangic alanına göre “Artan”; “İlk N öğeyi al” 5; “Değişken adı” ilk_saatler. Ardından bir Seçim adımı “Değişkenden” kaynağıyla en yakın beş saati seçenek olarak sunar.

Dikkat edilecekler

Editör şu durumlarda uyarır: liste seçilmemişse, değişken adı geçersizse ve bir süzgeç kuralı öğenin alanına bakmıyorsa (böyle bir kural her öğede aynı sonucu verir). Yazdığınız yol bir liste göstermiyorsa örnek veride “Bu yol bir liste göstermiyor; sonuç boş kalır.” uyarısı çıkar. Araç Çağrısı için bkz. Entegrasyon Eylemi ve Araç Çağrısı adımları.

Değişken adında yalnız a–z harfleri, rakam ve alt çizgi (_) kullanılır; ç, ğ, ı, ö, ş, ü ve boşluk yazarken kutudan düşer. “system” adı sistem değişkenlerine ayrılmıştır; başka bir ad verin.

Eksikler kaydetmeyi engellemez: asistan kaydedilir, ama eksik adım konuşmada beklendiği gibi çalışmaz. İşaretli adımları düzeltin, sonra asistanı “Önizle” ile deneyin. Sorunlu adımları bulmak için bkz. Akış editörü.