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.