Map Entity Attribute

1. UI Üzerinde Alan Seçimi

• Kullanıcıya bir entity seçimi yapılabilecek alan sunulur.
• Ardından, sistemde tanımlı attribute’lar listelenir.
• Çoklu attribute seçimi yapılsa da, MapEntityAttribute aksiyonu yalnızca tek bir attribute için çalışır. Bu nedenle seçilen her attribute için ayrı ayrı aksiyon tetiklenmelidir.

2. Aksiyon Tanımlama

“Attribute Ekle” ya da “Alanları Eşleştir” butonuna şu aksiyon eklenir:

• + ADD ACTION > OnClick > EAV > Entity Attributes > MapEntityAttribute

Parametreler şu şekilde yapılandırılır:

• EntityId: Symbol Picker > Select Box / Dynamic Form
• AttributeId: Symbol Picker > Select Box
• SortOrder: Symbol Picker > Optional > Fixed / Numeric Input

3. Aksiyon Sonucunun Kullanımı

• Eşleşme tamamlandıktan sonra kullanıcıya bildirim gösterilebilir (Show Toast).
• İlgili entity için GetEntityAttributes aksiyonu çalıştırılarak yeni attribute’lar gösterilebilir.

Bir CRM uygulamasında kullanıcı, müşteri kartlarına “Doğum Tarihi”, “Müşteri Notları” gibi alanlar eklemek ister.

• Kullanıcı ilgili müşteri entity’sini seçer.
• Sistemde tanımlı attribute’lardan birini seçer.
• “Alanı Ekle” butonuna tıklayınca MapEntityAttribute aksiyonu çalışır.
• Seçilen attribute ilgili entity’ye bağlanır.
• Dynamic Form, bu yeni attribute’a göre yeniden oluşturulur.
• Her bir attribute için bu işlem tekrarlanır.

‍

• Tek Tek Attribute Ekleme: Aksiyon her seferinde yalnızca bir attribute için çalışır. Çoklu ekleme yapılmak isteniyorsa, seçim sonrası döngü ile tek tek MapEntityAttribute aksiyonu tetiklenmelidir.
• Koşullu SortOrder Atama: Attribute türüne göre SortOrder değeri dinamik olarak belirlenebilir.
• Ön İzleme: Attribute eklenmeden önce, kullanıcıya form ön izlemesi sunulabilir.

Teknik Riskler

• Geçersiz ID’ler: EntityId veya AttributeId eksik veya hatalıysa eşleştirme başarısız olur.
• Yinelenen Eşlemeler: Daha önce aynı attribute aynı entity’ye eşlendiyse, sistem çakışma verebilir veya eşlemeyi yoksayabilir.
• Sıra Çakışması: Aynı SortOrder farklı attribute’lara verilirse, UI'da beklenmeyen sıralama hataları oluşabilir.

MapEntityAttribute aksiyonu, Kuika platformunun EAV tabanlı mimarisinde, entity’lere esnek alan tanımlamaları yapılmasını sağlayan temel yapı taşlarından biridir. Özelleştirilebilir veri modelleri oluşturmak ve kullanıcıya özel formlar geliştirmek için idealdir.