Brave News Search aksiyonu, Brave arama motorunun haber arama özelliğini kullanarak kullanıcıların güncel ve geçmiş haber içeriklerine erişmesini sağlar. Belirlenen anahtar kelimelerle yapılan sorgular sonucunda, ilgili haber başlıkları, açıklamalar ve bağlantılar döndürülür. Özellikle medya, analiz, gündem takibi ve içerik üretimi odaklı uygulamalarda tercih edilir.

Teknik Özellikler

Arama İşlemi (Search Paneli): Brave News Search aksiyonu, verilen anahtar kelimelere uygun haberleri listeler. Dönen sonuçlar genellikle çoklu kayıt içerir ve liste (Many) formatında kullanılabilir.

Parametreler:

• settings (Object – zorunlu): Brave API için gerekli ayarlardır. Configuration Manager üzerinden tanımlanmış Brave ayarları bu alanda seçilmelidir.
• query (String – zorunlu): Haberlerde aranacak anahtar kelime veya ifade. (Ör. “global economy”, “AI trends”, “election results”).
• count (Int32 – zorunlu): Döndürülecek haber sayısını belirtir. 0 verilirse sonuç dönmez, minimum 1 veya daha büyük bir sayı olmalıdır.

Veri Kaynağı Uyumluluğu: Parametreler sabit (Fixed) olarak tanımlanabileceği gibi, Symbol Picker aracılığıyla Form Input, Current, Action Result, Method Input gibi dinamik kaynaklardan da bağlanabilir.

Web & Mobil Destek: Brave News Search aksiyonu, hem web hem de mobil uygulamalarda sorunsuz şekilde çalışır.

Brave News Search Uygulama Adımları

1. UI Design’da Aksiyon Tanımlama

• Kuika projenizi açın.
• UI Design modülünde haberlerin listeleneceği sayfayı seçin.
• Bir Text Input (arama kutusu) ve Button (ör. “Haber Ara”) elementi ekleyin.
• Butona tıklayın ve + ADD ACTION → Brave Search →  Brave News Search aksiyonunu seçin.

2. Parametreleri Yapılandırma

• settings: Configuration Manager’da oluşturduğunuz Brave API ayarını seçin.
• query: Kullanıcının girdiği arama terimini Text Input’a bağlayın.
• count: Döndürülecek haber sayısını belirleyin (örn. 10).
• Enable Audit Logs: Aktif edildiğinde, kullanıcı yetki devri güncelleme işlemi audit log kayıtlarına eklenir. Bu sayede delegasyonun hangi kayıt üzerinde, hangi alanlarda, ne zaman ve hangi kullanıcı tarafından güncellendiği izlenebilir.

Kullanım Senaryosu: Güncel Haberleri Çekme

Bir haber uygulamasında kullanıcı, “teknoloji” yazarak güncel teknoloji haberlerini görmek ister.

Adımlar:

1. Text Input elementi ekleyin (ör. “Anahtar Kelime”).
2. “Haber Ara” butonu ekleyin.
3. OnClick → Brave News Search aksiyonunu tanımlayın.
4. Query alanına Text Input elementine bağlayın, count değerini 10 yapın.
5. Sonuçları Table elementi içinde başlık, açıklama ve link ile görüntüleyin.

Brave News Search İleri Seviye Özelleştirmeler

• Kategoriye Göre Filtreleme: Arama terimleri belirli kategorilerle (ekonomi, spor, teknoloji vb.) sınırlandırılabilir.
• Tarih Aralığı: Haberlerin yalnızca belirli bir tarih aralığındaki versiyonları listelenebilir.
• Sonuçların Kaydedilmesi: Kullanıcı favorilerine haber kaydedebilir veya bunları veritabanına aktarabilir.
• Bağlantı ile Açma: Dönen haberlerin link alanı, kullanıcıyı doğrudan haber kaynağına yönlendirebilir.

Teknik Riskler ve Kontroller

• query boş olmamalıdır. Zorunlu parametre olduğu için boş bırakıldığında sonuç dönmez.
• count = 0 verilirse sonuç alınamaz. Minimum 1 veya daha büyük değer girilmelidir.
• settings doğru yapılandırılmalıdır. Configuration Manager’da Brave News Search ayarı yapılmazsa aksiyon çalışmaz.
• Sonuç Formatı: Dönen sonuçlarda başlık, açıklama ve URL alanları JSON formatında geleceğinden doğru bağlanmalıdır.