Kuika’nın Month Picker elementi, kullanıcıların yalnızca ay seçmesini sağlar. Kullanıcılar, manuel giriş yapabileceği gibi ay seçici aracılığıyla da seçim yapabilir. Bu element, ay bazlı planlama, raporlama ve filtreleme işlemleri için idealdir.

Month Picker elementi yalnızca web uygulamalarında desteklenmektedir.

Kullanım Alanları

• Aylık satış raporlarının filtrelenmesi,
• Takvim bazlı görev planlama,
• Abonelik başlangıç ve bitiş aylarının seçimi,
• Aylık KPI veya performans takibi vb. 

Aylık Satış Raporu Seçimi

Statik Kullanım Senaryosu – Sabit Ay Seçimi

Bir satış raporlama ekranında kullanıcıya sabit bir ay atanır. Örneğin, sistem varsayılan olarak Eylül 2023 ayını gösterebilir.

Özelliklerin Kullanımı

• Value → 2023-10 (Ekim 2023)
• Placeholder → “Ay Seçin”
• Allow Clear → Kullanıcı isterse seçimi (X) ikonuyla temizleyebilir.
• Disable Before Date → Örn. 2023-01 girilirse, Ocak 2023’ten önceki aylar seçilemez.

Senaryo Adımı Tamamlandığında

• Kullanıcıya varsayılan olarak Eylül 2023 atanır.
• Seçilen ay YYYY-MM formatında ekranda görünür (örn. 2023-10).
• Kullanıcı isterse (X) ikonuna basarak temizleyebilir.
• Geçmiş aylar engellendiği için kullanıcı yalnızca 2023 ve sonrası ayları görebilir.

Dinamik Kullanım Senaryosu – Aylık Satış Raporu

Bir satış raporlama ekranında kullanıcı, rapor almak istediği ayı seçer. Bu bilgi veritabanı veya API’den gelen aylık satış bilgisine bağlanır.

Veri Kaynağı Bağlama 

• Datasources modülüne gidin. 
• Ardından Tables başlığı yanındaki + ikonuna tıklayın ve tabloya “SalesData” ismini verin. 
• Aşağıdaki tabloyu oluşturun. 

• Ardından SQL Actions’a tıklayın ve aksiyona “SalesData” ismini verin. C# ile de oluşturabilirsiniz.
• Aşağıdaki SQL komutunu girin. 

SELECT '2025-07' AS SalesMonth, 1200 AS SalesCount, 150000.00 AS SalesRevenueUNION ALLSELECT '2025-08', 1400, 170000.00UNION ALLSELECT '2025-09', 1600, 200000.00

UI Design Modülü işlemleri

• Uygulama ekranında sağ kenarda bulunan Add Action butonuna tıklayın. 
• Ardından Custom > SalesData’yı seçin. 

Özelliklerin Kullanımı

• Value → SalesData.SalesMonth (Symbol Picker’dan bağlanır)
• Placeholder → “Ay Seçin”
• Allow Clear → Kullanıcı seçimi sıfırlayabilir.
• Disable Before Date → Örn. 2025-01 girilirse, Ocak 2025’ten önceki aylar seçilemez.

Senaryo Adımı Tamamlandığında

• Kullanıcı açılır pencereden istediği ayı seçer.
• Seçilen ay ekranda YYYY-MM formatında görünür (örn. 2025-09).
• Kullanıcı isterse (X) ikonuna basarak temizleyebilir.
• Sistem, seçilen ayı SalesData.SalesMonth kolonuna bağlar ve ilgili satış raporlarını getirir.
• Geçmiş aylar devre dışı bırakılmıştır, yalnızca geçerli ve ileri aylar seçilebilir.

Kısıtlamalar

• Yalnızca web uygulamalarında kullanılabilir.
• Format, sadece ay/yıl bilgisi ile sınırlıdır (gün seçilemez).

İpuçları ve Best Practices

• Raporlama senaryolarında, varsayılan değeri mevcut ay olacak şekilde ayarlayın.
• Kullanıcı deneyimini artırmak için Placeholder değerini açıklayıcı yapın (örn. “Rapor Ayını Seçin”).
• Performans için gereksiz ay aralıklarını Disable Before Date ile kapatın.