Get User Tasks

9/3/26

Kuika’nın Get User Tasks aksiyonu, kullanıcıya ait veya havuzda bulunan görevleri listelemek için kullanılır. Bu aksiyon sayesinde süreçlerdeki aktif adımlar görüntülenebilir, inbox ekranı oluşturulabilir ve görev takibi merkezi bir yapı üzerinden yönetilebilir.

Özellikle onay mekanizmaları, görev yönetimi ekranları, süreç bazlı filtreleme ve raporlama senaryolarında tercih edilir.

Teknik Özellikler

Görev Listeleme: Kullanıcının üzerine atanmış (claimed) görevler, havuzdaki görevler veya her ikisi birlikte listelenebilir.
StepInstance (Many) Veri Tipi: Aksiyon çoklu görev kaydı döndürür. Sonuçlar Table, List veya özel tasarlanmış kart yapılarında gösterilebilir.
Filtreleme ve Sayfalama: Opsiyonel parametreler sayesinde süreç bazlı, tarih bazlı, uygulama bazlı ve arama anahtarına göre filtreleme yapılabilir. Page ve PageSize parametreleri ile sayfalama desteklenir.
Süreç Bazlı Listeleme: Belirli bir workflow’a ait görevler ProcessDefinitionId ile filtrelenebilir.
Web ve Mobil Uygulama Desteği: Get User Tasks aksiyonu hem web hem mobil uygulamalarda desteklenmektedir.

Get User Tasks Aksiyonu Uygulama Adımları

Kuika platformuna giriş yapın.
Apps ekranından üzerinde çalıştığınız projeyi açın.
UI Design modülündeyken, görev listesini göstermek istediğiniz ekranı açın.

Sağdaki Properties panelinden + ADD ACTION menüsüne tıklayın.
İlgili tetikleyici olaya göre (pageInit, OnClick vb.) Process Automation > Get User Tasks aksiyonunu ekleyin.

Aksiyon Parametrelerini Yapılandırma

ShowPool (Boolean – Opsiyonel)

Havuzda bulunan ve henüz sahiplenilmemiş görevleri listeler.

True: Pool görevler dahil edilir.
False: Pool görevler dahil edilmez.

ShowClaimed (Boolean – Opsiyonel)

Kullanıcının üzerine aldığı görevleri listeler.

True: Claim edilmiş görevler dahil edilir.
False: Claim edilmiş görevler dahil edilmez.

UserName (String – Zorunlu senaryoya bağlı)

Görevleri getirilecek kullanıcının kullanıcı adı veya e-posta adresidir.
Symbol Picker ile Current User bağlanabilir.

Select from single process (Boolean)

Belirli bir sürece ait görevleri listelemek için kullanılır. Aktif edildiğinde süreç filtresi uygulanabilir.

Opsiyonel Parametreler

ADD OPTIONAL PARAMETER alanından eklenebilir.
- Apps: Belirli bir uygulamaya ait görevleri filtrelemek için kullanılır.
- ProcessDefinitionId: Belirli bir Workflow’un görevlerini getirmek için kullanılır.
- Page: Sayfa numarasını belirler.
- PageSize: Sayfa başına getirilecek kayıt sayısını belirler.
- SearchKey: Görev başlığı veya içeriğine göre arama yapılmasını sağlar.
- CreatedFrom: Belirli bir tarihten sonra oluşturulmuş görevleri getirir.
- CreatedTo: Belirli bir tarihe kadar oluşturulmuş görevleri getirir.
- FilterLate: Gecikmiş görevleri filtrelemek için kullanılır.
- SortBy: Görevlerin hangi kritere göre sıralanacağını belirler.

Kullanım Senaryosu: Kullanıcı Inbox Ekranı

Bir çalışan sisteme giriş yaptığında kendi görevlerini görmek ister.

Yapılandırma:

ShowClaimed: True
ShowPool: False
UserName: Current User

Aksiyon pageInit altında çalıştırılır ve sonuçlar bir Table elementine bind edilir. Kullanıcı sayfayı açtığında görev listesi otomatik yüklenir.

Get User Tasks İleri Seviye Özelleştirmeler

Dinamik Filtreleme: SearchKey parametresi bir arama kutusuna bağlanarak gerçek zamanlı filtreleme yapılabilir.
Süreç Bazlı Yönetim: ProcessDefinitionId ile yalnızca belirli bir iş akışının görevleri getirilebilir.
Sayfalama ve Performans: Page ve PageSize parametreleri ile büyük veri listelerinde performanslı yapı kurulabilir.
Raporlama: CreatedFrom ve CreatedTo parametreleri ile haftalık veya aylık görev raporları oluşturulabilir.

Teknik Riskler

Yanlış Kullanıcı Bilgisi: UserName parametresinin hatalı girilmesi yanlış görev listesinin gelmesine neden olur.
Boş Parametre Kombinasyonu: ShowPool ve ShowClaimed değerlerinin her ikisi False yapılması durumunda sonuç boş döner.
Performans Problemleri: PageSize değerinin çok yüksek girilmesi yoğun veri ortamlarında performans sorunlarına yol açabilir.
Yanlış Süreç Filtreleme: ProcessDefinitionId hatalı girilirse görev listesi boş dönebilir.
Tarih Format Hataları: CreatedFrom ve CreatedTo parametrelerinin DateTime formatında olması gerekir.

Get User Tasks aksiyonu, Kuika platformunda görev listeleme ve inbox yönetimi için temel Process Automation aksiyonlarından biridir. Doğru parametre yapılandırması ile filtrelenebilir, sayfalanabilir ve raporlanabilir görev yönetim ekranları oluşturulabilir.