gelistirici:diaform:form_veri_islemleri

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:

  1. Sorgu Çalıştır sonucu alınır.
  2. Sonuç, form değişkenine aktarılır.
  3. Formda görüntülenir / işlenir.
  4. 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

  1. Süreç tasarım ekranında Web Servis Çalıştır adımı eklenir.
  2. Servisten dönen kod bilgisi hesapla aracı içerisinde alınır.
  3. İlgili değerler form değişkenleri ile eşleştirilir.
  4. 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

  1. Formda izlenecek alan belirlenir (örn: onayDurumu).
  2. Alan değişiminde değer süreç değişkenine yazılır.
  3. 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

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

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