Sözlük
Synergy geliştirirken sık karşılaşacağınız terimlerin kısa, sade açıklamaları.
- Nesne
- Form ya da akış tasarımcısındaki araç kutusundan sürüklediğiniz bileşen (TextBox, ComboBox, Pozisyon vb.). Bu wiki'de "kontrol" yerine "nesne" terimi kullanılır.
- Akış (Flow)
- Bir formun kimlere, hangi sırayla gideceğini ve her adımda ne olacağını belirleyen iş akışı şeması.
- Form / eForm
- Kullanıcının veri girdiği ve gördüğü ekran. Nesneleri sürükleyerek tasarlanır.
- Sunucu kodu
- C# ile yazılan, sunucuda çalışan kod (Form kodu ve Akış kodu). Bu wiki'de turuncu çerçeveyle gösterilir.
- İstemci kodu
- Tarayıcıda çalışan TypeScript kodu. Kırmızı çerçeveyle gösterilir; nesnelere "this." ile, özellik adları küçük harfle erişilir (this.TextBox1.value).
- .Value ve .Text
- .Value saklanan değerdir, .Text ekranda görünen metindir. Çoğu giriş nesnesinde değeri okurken .Value kullanırsınız.
- BaseControl
- Tüm form nesnelerinin en temel sınıfı. OnInit / OnLoad / OnPreRender / OnRender yaşam döngüsü kancaları buradan miras gelir; bu yüzden her nesnede bulunur.
- VisualControl
- Görsel nesnelerin tabanı (BaseControl'den türer). OnClick / OnDoubleClick olayları ile Loading özelliği ve ShowLoading() / HideLoading() metotları buradan gelir.
- EditControl
- Değer tutan giriş nesnelerinin (TextBox, NumberBox, DateTimePicker...) tabanı. .Value / .Text ile OnValueChanging / OnValueChanged olayları buradadır.
- DataBoundControl / CompositeDataBoundControl
- Veri kaynağına bağlı, satır/koleksiyon tutan nesnelerin (DataGrid, TreeList, Lookup...) tabanı. OnDataLoad olayı ve Rows / GetAllRows / SelectedRows koleksiyonları buradadır. Bu nesnelerin tek bir .Value değeri yoktur.
- MultiLanguageText
- Birden çok dilde metin tutan tip. Title, Caption gibi alanlar bu tiptedir; GetText("tr-TR") ile belirli bir dildeki metni okursunuz.
- DataSource
- Bir nesneyi besleyen veri kaynağı (.mssqlds SQL sorgusu ya da .restds REST servisi). ComboBox, Lookup, DataGrid gibi nesneler buradan dolar.
- Field Name / EntityPath
- Nesnenin değerinin veritabanında saklandığı alanın adı. Yalnızca veriye bağlanan giriş nesnelerinde bulunur; salt görüntüleme nesnelerinde (Label, FormMetadata vb.) yoktur.
- Document1.Controls
- Akış kodunda form alanlarına erişmenin yolu: Document1.Controls["Alan"].Value. Genel bir erişimcidir; güçlü tipli nesneye özgü üyeleri (ör. grafiklerdeki Charts/Reload) sunmaz, bunlar Form kodunda kullanılır.
- ProcessRequestItem
- Akış motorunun bir onay/işlem isteğini temsil eden nesne. Motor geri çağırımlarında (SendMail, SendPushNotification vb.) parametre olarak gelir.
- FlowPosition / FlowGroup
- Tek onaycı (Pozisyon) ve grup onayı (Pozisyon Grubu) düğümleri. Onaycıyı koddan SetFromUser / AddConstantUser ile atarsınız.
- FlowScript (Fonksiyon)
- Akışta C# kod çalıştıran adım. Kod, adımın fnc_ad_Execute olay bloğunda yer alır; form okuma, değişken/pozisyon atama, servis çağırma burada yapılır.
- Variable (Değişken)
- Akışta değer taşıyan nesne; genellikle bir yönlendirme kodu tutar ve Karşılaştırma adımı bu değeri okuyarak akışı dallandırır.
- ServiceAPI
- Sunucu kodundan Synergy servislerine (doküman yönetimi, İK, mail, datasource, iş akışı) erişim katmanı.
- Yaşam döngüsü olayları
- Nesne açılırken belirli bir sırayla çalışan kancalar: OnInit → OnLoad → OnPreRender → OnRender. BaseControl'den gelir ve her nesnede bulunur.
- OnValueChanging / OnValueChanged
- Değer değişmeden hemen önce (iptal edilebilir) ve değiştikten sonra çalışan olaylar. Giriş nesnelerinde en sık kullanılan olaylardır.
- ShowMessage / AlertType
- Kullanıcıya mesaj gösterir. AlertType değerleri: Success, Error, Warning, Info, Validation, Blocked, SevereWarning. (Dikkat: "Information" diye bir değer yoktur; "Info" kullanılır.)
- GridData
- DataGrid / TreeList verisini koddan kurmak ve okumak için kullanılan yapı: GridData.FromControl(kontrol) ile satır ve hücreleri gezer, MergeData / Save ile yazarsınız.
- ParentIdExpr
- TreeList'te her satırın hangi satırın altında olduğunu gösteren alan. Synergy ağacı bu alanla kurar; kök satırlar RootValue ile belirlenir.
- Reload()
- Bir nesnenin verisini ya da görünümünü yeniden yükler (grafikler, listeler vb. için).
- Required
- Bir alanı zorunlu yapar; boşsa form kaydedilmez. Kod ile boş/dolu kontrolü yazmaya gerek kalmaz.