Kuika’nın PA Interaction Buttons elementi, Process Automation (PA) süreçlerinde yer alan kullanıcı görevlerinin (User Task) toplu olarak yönetilmesini sağlar. Aynı sürece (process) ait birden fazla görevi tek seferde onaylama ve reddetme işlemlerini yönetmek için kullanılır.

PA Interaction Buttons elementi, yoğun görev akışlarının bulunduğu süreçlerde kullanıcı etkileşimini hızlandırmak ve iş yükünü azaltmak için kullanılabilir. 

PA Interaction Buttons elementi şu anda yalnızca web projelerinde desteklenmektedir.

PA Interaction Buttons Elementini Ekleyin

1. Kuika platformuna giriş yapın.
2. Apps ekranından çalışmak istediğiniz projeyi seçin.
3. UI Design modülüne girin.

4. Sol kenardaki Elements panelinde, Process Automation kategorisi altından PA Interaction Buttons elementini bulun.
5. Elementi sürükleyip ekranınıza bırakın.

Bu element, yalnızca User Interaction içeren bir process’e bağlı ekranlarda çalışır. Eğer ilgili task’ta interaction tanımlı değilse, butonlar otomatik olarak görüntülenmez.

PA Interaction Buttons Nasıl Çalışır?

PA Interaction Buttons elementi, bir görevler (User Tasks) tablosunda satır seçimi yapıldıkça SetValueOf aksiyonu ile kendisine aktarılan value üzerinden çalışır.
Elementin kendi içinde görünen ek bir özelliği yoktur; tamamen kendisine verilen value’ya göre davranır.

Bu değer, tabloda seçilmiş görevlerin listesidir. Element, bu seçili görevlerin ortak olarak sahip olduğu interaction’ları tespit eder ve yalnızca bu ortak interaction’lar için birer buton oluşturur.

Kullanıcı bu butonlardan birine tıkladığında, element seçili tüm görevlerde ilgili interaction’ı çalıştırmayı dener. İşlem sonucunda her bir görev için başarı veya hata durumu kullanıcıya bir notification ile bildirilir.

Aşağıdaki durumlarda buton oluşturulmaz:

• Eğer seçili görevlerin bir kısmında ilgili interaction hiç tanımlanmamışsa,
• Interaction tanımlı olsa bile outputMapping içerisinde BO parametreleri varsa ve bu parametreler için default mail değerleri tanımlı değilse.

Bu element şu anda sadece web’de kullanılabilir; mobil desteği henüz aktive edilmemiştir.

Toplu Task İşlemleri (Claim, Release, Assign, Approve vb.)

• Aynı process’e ait birden fazla User Task seçildiğinde, yalnızca bu görevlerin ortak interaction’ları PA Interaction Buttons üzerinde görünür.
• Kullanıcı bu butonları kullanarak yalnızca ortak etkileşim gerektiren işlemleri seçtiği tüm görevler üzerinde toplu şekilde gerçekleştirebilir.
• Eğer farklı process’lere ait görevler seçilmişse ve bunların hiçbir ortak interaction’ı yoksa, element tarafından hiçbir buton render edilmez.
• İşlem tamamlandığında sistem, her bir görevin ilgili durumunu otomatik olarak günceller ve sonuçları kullanıcıya bildirir.

Davranış ve Kısıtlamalar

• İlgili task için interaction tanımlı değilse, butonlar görünmez.
• Aynı process’e ait görevlerde interaction butonları listelenir.
• Farklı process’lerdeki görevler arasında ortak interaction yoksa butonlar görüntülenmez.

Adım Adım: PA Interaction Buttons ile Toplu İşlem Ekranı Oluşturma

1. Görev Tablosunu Hazırlayın

• UI Design modülünde, Process Automation görevlerinizi göstereceğiniz ekranı açın.
• Ekrana bir Table elementi ekleyin.
• Tabloyu, ilgili “Get My Tasks” veya benzeri PA aksiyonunun çıktısına bağlayın.
• Tablo ayarlarında:
  
  • Seçim modunu Multiselect olacak şekilde (birden fazla satır seçilebilecek şekilde) yapılandırın.
  • Kolonlarda şu alanlar olsun:
    
    • Process no
    • Process name
    • Step name / Step description
    • Assigned user / Due date vb.

2. PA Interaction Buttons Elementini Ekleyin

• Sol panelde Elements → Special →  PA Interaction Buttons elementini görev tablosunun hemen altına sürükleyip bırakın.
• Tasarım ekranında bu elementin içinde sadece bir placeholder metni göreceksiniz: “Your Interaction Buttons will be rendered here” Bu metin, Preview’da gerçek butonlarla değişecektir.

3. Tablo Seçimini PA Interaction Buttons’a Bağlayın (SetValueOf)

PA Interaction Buttons’ın çalışması için, tablodaki seçili satırları elementin value alanına göndermeniz gerekir.

• Görev tablosunu seçin.
• Tablo için satır seçimi değiştiğinde tetiklenecek bir aksiyon ekleyin:
• Bu event altına bir SetValueOf aksiyonu ekleyin:
  
  • Component to Change: PA Interactions Button
  • Value: Tablo üzerindeki Selected Rows (seçili görevler listesi)

Bu ayar ile:

• Kullanıcı tabloda görev seçtikçe
• Seçili görevlerin listesi PA Interaction Buttons elementine gönderilir
• Element de bu listeyi kullanarak uygun butonları üretir.

4. Preview Modunda Test Edin

• Ekranı kaydedin ve Preview moduna geçin.
• Görev tablosundan en az bir task seçin.
• Seçilen task’in sahip olduğu interaction’lara göre PA Interaction Buttons alanında dinamik butonlar oluşur.

5. Toplu İşlem Çalışmasını Gözlemleyin

• Birden fazla satır (aynı process’e ait User Task’lar) seçin.
• Ortak interaction’lara göre butonların güncellendiğini göreceksiniz:
  
  • Ortak olanlar: örneğin birden fazla göreve aynı anda uygulanabilen işlemler (Approve, Reject, Complete gibi)
  • Ortak olmayanlar: örn. sadece bazı task’larda olan Reject görünmez.
• Örneğin Approve butonuna bastığınızda:
  
  • Seçili tüm görevlerde Approve interaction’ı tetiklenir.
  • İşlem sonucunda her bir görev için başarı/hata bilgisi kullanıcıya notification ile gösterilir
  • Görevlerin durumları (status) otomatik güncellenir.

Element Ayarları ve Özelleştirme

‍

Authorization (Yetkilendirme)

Element düzeyindeki erişim kontrolünü yönetmek için, Properties panelindeki Authorization bölümünü kullanabilirsiniz.

Erişim Tipleri

Anonymous

Elementin tüm kullanıcılar tarafından, giriş yapmadan görüntülenmesine izin verir.

Restricted

Erişimin yalnızca doğrulanmış kullanıcılara veya belirli rollere göre sınırlandırılmasını sağlar.

• Everyone: Aktif edildiğinde, giriş yapmış tüm kullanıcılar elemente erişebilir.
• Roles: Elemente erişmesine izin verilen roller buradan seçilir. Rol listesini düzenlemek için Roles alanının yanındaki dişli (⚙️) ikonuna tıklayarak Role Management penceresini açabilirsiniz. Bu pencereden yeni rol ekleyebilir, klasör oluşturabilir veya mevcut rolleri yönetebilirsiniz.

Unauthorized Behavior (Hide / Disable)

Kullanıcı gerekli role sahip değilse, elementin nasıl davranacağını Choose alanından belirleyebilirsiniz:

• Hide: Kullanıcı yetkili değilse element tamamen gizlenir ve ekranda görünmez.
• Disable: Element görünür kalır ancak tıklanamaz / kullanılamaz hâle gelir.

Bu ayar, yetkisiz kullanıcıların elementle nasıl karşılaşacağını yönetmeniz için kullanılır.

Visibility (Görünürlük)

• Always Visible: Element her zaman görünür.
• Hidden: Element gizlenir.
• Sometimes Visible: Element, belirli bir koşula bağlı olarak görünür.

Ayarı yapılandırmak için:

1. Ekrandaki elementi seçin.
2. Sağ kenardaki Properties panelini açın.
3. Visibility alanında ihtiyacınıza göre bir seçenek belirleyin.

Editability (Düzenlenebilirlik)

• Enabled: Element düzenlenebilir.
• Disabled: Element düzenlenemez.
• Sometimes Enabled: Element, belirli koşullara göre düzenlenebilir veya düzenlenemez.

Style Panel ile Arayüz Tasarımı

Elementlerinizi Styling Panel ile özelleştirerek, web ve mobil uygulamalarınız için etkileyici arayüzler oluşturabilirsiniz. Bu bölümde, aşağıdaki ayarları yapılandırabilirsiniz:

• Layout (Düzen): Boyutlandırma, hizalama ve iç boşluk (padding) ayarları. Ayarlar arasında Size, Min Size ve Align bulunur.
• Text (Metin): Yazı tipi, stil, renk, boyut ve aralık ayarları.
• Fill (Dolgu): Arka planı renk veya görsellerle özelleştirme.
• Border (Kenarlık): Kenarlık ekleme ve köşe yarıçapı ayarları.
• Shadow (Gölge): Elementlere derinlik katmak için gölge efekti ekleme.