Github Search Users aksiyonu, GitHub üzerinde kullanıcı aramak için kullanılır. Bu aksiyon sayesinde belirli kriterlere uyan kullanıcı profilleri bulunabilir ve uygulama içinde listelenebilir. Özellikle geliştirici keşfi, proje işbirliği ya da organizasyon yapılarının görüntülenmesi senaryolarında tercih edilir.
Teknik Özellikler
Kullanıcı Arama İşlemi (Search Paneli): Bu aksiyon, verilen sorgu parametrelerine göre GitHub kullanıcılarını arar ve Github_search_users_Result nesnesi döner.
Parametreler:
settings (Object – zorunlu): GitHub API bağlantısı için gerekli ayarları içerir. Config Manager üzerinden tanımlanmış GitHub ayarı seçilmelidir.
query (String – zorunlu): Kullanıcı aramak için gerekli sorgu ifadesi. (örn. location:turkey language:python)
page (Decimal – opsiyonel): Sayfalama için geçerli sayfa numarası.
Veri Kaynağı Uyumluluğu: Tüm parametreler sabit (Fixed) olarak girilebileceği gibi, Symbol Picker aracılığıyla Form Input, Current, Action Result, Method Input gibi dinamik kaynaklardan da bağlanabilir.
Web & Mobil Destek: Github Search Users aksiyonu, hem web hem de mobil uygulamalarda kullanılabilir.
page & perPage: Büyük veri setleri için sayfalama yapmak üzere opsiyonel olarak kullanılabilir.
Enable Audit Log (Opsiyonel): Aksiyonun çalıştırılması sırasında gerçekleştirilen işlemlerin audit log kayıtlarına eklenmesini sağlar. Bu sayede sistem üzerinde yapılan değişikliklerin ne zaman, hangi kullanıcı tarafından ve hangi işlem kapsamında gerçekleştiği izlenebilir.
Kullanım Senaryosu: GitHub Kullanıcılarını Arama
Bir iş ilanı uygulamasında, kullanıcı “React developer Turkey” yazıp arama yaptığında GitHub üzerinde bu kritere uyan profiller listelenir.
Adımlar:
TextInput alanı ile kullanıcıya arama sorgusu girme imkanı verin.
“Ara” butonunu ekleyin.
OnClick → Github Search Users aksiyonunu ekleyin.
Dönen sonuçları Table elementi ile ekranda gösterin.
Github Search Users İleri Seviye Özelleştirmeler
Filtreli Arama: query parametresinde GitHub’ın gelişmiş arama operatörleri (örn. location:, language:, followers:>100) kullanılabilir.
Dinamik Sıralama: Arama sonuçları popülerliğe veya takipçi sayısına göre filtrelenebilir.
Sonucun Kullanımı: Bulunan kullanıcılar proje daveti, işbirliği veya takip etme gibi sonraki aksiyonlara bağlanabilir.
Sayfalama Desteği: Çok fazla sonuç döndüğünde page ve perPage parametreleriyle sonuçlar parça parça alınabilir.
Teknik Riskler ve Kontroller
query boş olmamalıdır. Aksi halde arama yapılmaz.
settings doğru yapılandırılmalıdır. Configuration Manager’da GitHub API ayarı yapılmazsa aksiyon çalışmaz.
GitHub rate limit: Çok sık sorgu yapılırsa GitHub API limitine takılabilirsiniz.
Geniş sonuç seti: Çok fazla kullanıcı dönebilir; bu nedenle perPage parametresi dikkatli ayarlanmalıdır.