Form Tasarım Editörü: Çift Yönlü Veri Akışı

Süreç tasarım ekranındaki Sorgu Çalıştır aracından alınan veriler, form tasarım ekranında kullanılabilir. Aynı şekilde form üzerinde üretilen/değiştirilen değerler de süreç tasarım ekranına geri aktarılabilir. Bu yapı sayesinde çift yönlü veri işleme ve senaryo bazlı dinamik akışlar oluşturulabilir.

Form'a Veri Gönderme

getFormVariable

Form'dan Veri Alma

setFormVariable

1) Genel Mimari

Süreç → Form: Süreçte üretilen değer, form üzerinde kullanılır.
Form → Süreç: Formdaki kullanıcı girdisi veya hesaplanan değer süreç adımlarında kullanılır.
Bu iki yöntem birlikte kullanılarak veri senkronizasyonu sağlanır.

Akış Özeti:

Sorgu Çalıştır sonucu alınır.
Sonuç, form değişkenine aktarılır.
Formda görüntülenir / işlenir.
Gerekirse güncel değer tekrar sürece aktarılır.

2) Form'a Veri Gönderme (getFormVariable)

2.1 Amaç

Süreç içinde elde edilen verinin form tarafında erişilebilir hale getirilmesidir.

2.2 Kullanım Senaryosu

Örnek: Stok bilgisi sorgu ile alınır ve form alanları otomatik doldurulur.

2.3 Adımlar

Süreç tasarım ekranında Web Servis Çalıştır adımı eklenir.
Servisten dönen kod bilgisi hesapla aracı içerisinde alınır.
İlgili değerler form değişkenleri ile eşleştirilir.
Form tarafında bu değişkenler ilgili bileşenlerde kullanılır.

2.4

#Süreçten gelen değişkeni form tarafında okumak için
surecData = getFormVariable("param")
stokKodu = surecData.get("stokKodu")
if stokKodu:
  # örnek: input value setleme

2.5 Dikkat Edilecek Noktalar

Değişken adları birebir aynı olmalıdır.
Süreç tasarım aracında araçlardaki sonuç değişkeni kısımlarında bulunan tüm değişkenler formda kullanılabilir.

3) Form'dan Veri Alma (setFormVariable)

3.1 Amaç

Form üzerinde oluşan değerin süreç tarafına aktarılmasıdır.

3.2 Kullanım Senaryosu

Örnek: Kullanıcı formda seçim yapar, süreç sonraki adımda bu seçime göre yönlenir.

3.3 Adımlar

Formda izlenecek alan belirlenir (örn: onayDurumu).
Alan değişiminde değer süreç değişkenine yazılır.
Süreç tasarım ekranında bu değişken, karar/koşul adımlarında kullanılır.

3.4 Örnek

# Formdaki değeri süreç tarafına aktarmak için
setFormVariable("onayDurumu", "Onaylandi")

3.5 Dikkat Edilecek Noktalar

Veri tipi uyumuna dikkat edilmelidir
Süreçte kullanılan koşul değerleri ile formdan gönderilen değerler aynı formatta olmalıdır.

4) Uçtan Uca Örnek Senaryo

Senaryo: Sipariş Doğrulama ve Onay

Adım 1: Süreçte Sorgu Çalıştır ile sipariş bilgileri alınır.
Adım 2: Bilgiler form alanlarına aktarılır (getFormVariable).
Adım 3: Kullanıcı formda kontrol edip onaylar.
Adım 4: Onay bilgisi sürece geri yazılır (setFormVariable).
Adım 5: Süreç, onay durumuna göre devam eder.

5) Hata Yönetimi ve İyi Pratikler

✅ Notlar:

Değişken adlandırmalarında standart kullanın (örn: camelCase).
Form açılışında gerekli değişkenlerin varlığını doğrulayın.
Her aktarımda loglama/izleme yapısı kullanın.
Test senaryoları hazırlayın:
- Veri geldi / gelmedi
- Kullanıcı alanı değiştirdi / değiştirmedi
- Koşul adımı beklenen yönlendirmeyi yaptı / yapmadı

6) Sık Karşılaşılan Sorunlar

Sorun	Olası Neden	Çözüm
Formda değer görünmüyor	Değişken adı yanlış	Süreç ve formdaki değişken adlarını birebir kontrol edin
Süreçte değer boş geliyor	setFormVariable tetiklenmiyor	Alan olaylarını ve tetik zamanını kontrol edin
Koşul adımı yanlış çalışıyor	Tip/format uyuşmazlığı	Gönderilen değerin tipini standartlaştırın