Formlar¶
Süreç görevinin, ekranın veya veri girişi akışının çalışma zamanı kullanıcı arayüzünü tasarlarken formlar bölümünü kullanın. Emakin'de form bileşenleri görünüm görevi görür; veri modeli XML tabanlı durumu sağlar ve komut dizileri denetleyici tarzı davranışı sunar.
Bileşenler¶
Bileşenler, veri modelindeki verileri görüntüler ve kullanıcı etkileşimlerine (ör. metin girme, açılır listeden seçim yapma, tablo satırı ekleme) göre modeli günceller.
Bileşenler kapsayıcı bileşenler veya denetim bileşenleri olarak sınıflandırılır.
-
Kapsayıcı Bileşenler: Bunlar diğer bileşenleri gruplandırır ve düzenleyerek bir yerleşim yapısı sağlar. Örnek olarak satır kapsayıcıları (bileşenleri yatay olarak düzenler) ve sekme kapsayıcıları (bileşenleri sekmeler halinde düzenler) verilebilir.
-
Denetim Bileşenleri: Bunlar veri modeliyle doğrudan etkileşime girerek modelin değerlerini görüntüler ve değiştirir. Örnek olarak metin kutuları (metin girişini görüntüler ve kabul eder) ve açılır listeler (seçenekleri sunar ve seçimleri kaydeder) verilebilir.
Her bileşen, bir XPath ifadesi aracılığıyla veri modelindeki belirli bir konuma bağlanır. Bu ifade, bileşenin modelden verileri nasıl alıp güncelleyeceğini belirler. İç içe yerleştirilmiş bileşenler, XPath ifadesini üst kapsayıcı bileşenlerinden devralır. Örneğin, satır kapsayıcısının içinde yer alan bir metin kutusu bileşeni, satırın XPath bağlamasını devralır.
Kurallar¶
Emakin formlarındaki widget davranışı kurallarlakontrol edilebilir. Bu kurallar, widget'ların ne zaman şu duruma geleceğini tanımlar:
- Görünür: Widget'ın formda görüntülenip görüntülenmeyeceğini belirler.
- Salt okunur: Widget görünür kalırken düzenlenemez veya salt okunur olur.
- Zorunlu: Form gönderilmeden önce bir değer girilmesini zorunlu kılar.
Bu kurallar, formun veri modeline ve kullanıcı eylemlerine göre uyarlanmış duyarlı ve kullanıcı dostu bir deneyim sunarak dinamik ve bağlama duyarlı form etkileşimleri sağlar.
Form Bölümleri¶
Bazı içerik ve kapsayıcı widget'ları bir SectionName özniteliğini destekler. Bu öznitelik, formun mantıksal bir alanını adlandırır; böylece görev, aynı görünürlük veya salt okunur kuralını her widget'a eklemeden bu alanın varsayılan durumunu denetleyebilir.
Form bölümleri görev üzerinde yapılandırılır. Adlandırılmış her bölüm normal Default durumunda bırakılabilir, Enabledolarak işaretlenebilir, Disabledolarak işaretlenebilir veya Hidden bu görev için bu şekilde işaretlenebilir. Bu durumlar, bölümün başlangıç davranışını belirler:
Default: Normal form ve widget davranışını kullanır.Enabled: Form salt okunur değilse, üst öğe gizlenmemişse veya bir kural durumu değiştirmemişse bölümü etkin tutar.Disabled: Bölümü gösterir ancak salt okunur yapar.Hidden: Bölümü gizler.
Bölüm durumları varsayılan değerlerdir; kuralların yerini almaz. Belirli bir koşulun widget'ı veya bölümü denetlemesi gerektiğinde biçimlendirme kuralları görünürlük ya da salt okunur davranışını yine geçersiz kılabilir.
Form bölümleri iç içe olduğunda, alt bölüm kendi alanı için ayrı bir durum tanımlayabilir. Üst bölüm gizliyse içeriği de onunla birlikte gizli kalır; aksi takdirde alt bölümün durumu, bu alt alanı çevresindeki bölümden daha ayrıntılı biçimde tanımlamak için kullanılabilir.
Form komut dizileri, bölüm durumlarını şu değişken aracılığıyla da güncelleyebilir: $Form.sections değişkeni. Bölüm durumu yalnızca görev yapılandırmasına göre değil, form verilerinden veya komut dizisi mantığından belirlenmesi gerektiğinde bunu kullanın. Bkz. Form Bölümü Durumlarını Dinamik Olarak Değiştirme.
Veri Modeli¶
Veri modeli formun verilerini depolar ve widget'lara sağlar. XML yapısı, verilerin hiyerarşik biçimde gösterilmesine olanak tanır.
Veri modeli, süreç tanımı şemasına göre doğrulanır. Bu doğrulama yapısal bütünlüğü sağlar ancak verilerin geçerliliğini denetlemez. Veri doğrulaması, kullanıcı etkileşimleriyle tetiklenen widget'lar tarafından gerçekleştirilir.
Komut Dizisi¶
Widget etkileşimlerinin hesaplamaları, veri aramalarını veya model güncellemelerini tetiklemesi gerektiğinde form komut dizisini kullanın.
Komut dizileri veri modelini işleyebilir; hesaplamalar yapabilir, dış kaynaklardan veri alabilir ve model değerlerini güncelleyebilir.
Stil Özelleştirme¶
Emakin formları CSS ile özel stil tanımlamayıdestekleyerek geliştiricilerin form öğelerinin görünümünü belirli tasarım gereksinimlerine göre özelleştirmesine olanak tanır. Bu özellik, formların görsel sunumunu iyileştirir, kurumsal markayla tutarlılık sağlar ve kullanıcı deneyimini geliştirir.