Örnek: Custom Form Akışı

Bu örnekte panel'den gelen sipariş verisini bir Custom Form üzerinde gösterecek, alanlarına bağlayacak ve kontrol özelliklerini ayarlayacağız.

Hedef

OrderStartEvent tetiklendiğinde:

1. Panel ekranında OrderEntryForm adlı bir form açılsın.
2. Form açıldıktan sonra (Load olayında) sipariş bilgisi form alanlarına bağlansın.
3. Buton görünürlüğü Load olayında ayarlansın.
4. Her akış kendi Responser'ı ile kapansın.

Önkoşullar

• Temel Akış örneğinin çalışıyor olması
• Form için XML tasarım hazır (aşağıda örnek var)
• customFormDesigner.exe (opsiyonel, Designer kullanılacaksa)

Akış Şeması

Custom Form akışı iki bağımsız akıştan oluşur:

flowchart LR
    subgraph Kayit["Kayıt (bağımsız)"]
        A[trex Subscriber]
    end

    subgraph Akis1["Akış 1 — Form Aç"]
        B[Business Events<br/>OrderStartEvent] --> C[Custom Form<br/>OrderEntryForm]
        C --> F[Responser]
    end

    subgraph Akis2["Akış 2 — Form Yüklendi (Load)"]
        G[Form Events<br/>OrderEntryForm / _ / Load] --> D[Form Bind Controls<br/>txt* → orderNo,...]
        D --> E[Control Properties<br/>btnSave.Enabled=true]
        E --> H[Responser]
    end

    style A fill:#58d68d,color:#000
    style B fill:#ccffcc,color:#000
    style C fill:#ccffcc,color:#000
    style F fill:#ccffcc,color:#000
    style G fill:#ccffcc,color:#000
    style D fill:#ccffcc,color:#000
    style E fill:#ccffcc,color:#000
    style H fill:#ccffcc,color:#000

Neden iki akış?

Custom Form → Responser zinciri panele "formu aç" komutunu gönderir ve biter. Form panel tarafında yüklendiğinde Form Events (Load) yeni bir akış başlatır; form üzerindeki tüm değişiklikler (alanları bağlama, buton özelliği) bu ikinci akışta yapılır.

Form XML Tasarımı

Custom Form node'unun customformxml alanına yapıştıracağımız XML, trexForm.Designer tarafından üretilen WinForms formatındadır:

<Object name="CustomForm" type="trexForm.Designer.CustomForm, trexForm.Designer, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" version="1">
    <AutoValidate>EnablePreventFocusChange</AutoValidate>
    <BackColor>Control</BackColor>
    <ClientSize>600, 400</ClientSize>
    <Font>Microsoft Sans Serif, 8.25pt</Font>
    <Name>CustomForm</Name>

    <Object type="System.Windows.Forms.Label, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="lblOrderNo">
        <Text>Sipariş No:</Text>
        <Location>20, 20</Location>
        <Size>100, 20</Size>
        <TabIndex>0</TabIndex>
    </Object>
    <Object type="System.Windows.Forms.TextBox, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="txtOrderNo">
        <Location>140, 20</Location>
        <Size>200, 20</Size>
        <TabIndex>1</TabIndex>
    </Object>

    <Object type="System.Windows.Forms.Label, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="lblCustomer">
        <Text>Müşteri:</Text>
        <Location>20, 60</Location>
        <Size>100, 20</Size>
        <TabIndex>2</TabIndex>
    </Object>
    <Object type="System.Windows.Forms.TextBox, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="txtCustomer">
        <Location>140, 60</Location>
        <Size>200, 20</Size>
        <TabIndex>3</TabIndex>
    </Object>

    <Object type="System.Windows.Forms.Label, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="lblQty">
        <Text>Miktar:</Text>
        <Location>20, 100</Location>
        <Size>100, 20</Size>
        <TabIndex>4</TabIndex>
    </Object>
    <Object type="System.Windows.Forms.NumericUpDown, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="txtQty">
        <Minimum>1</Minimum>
        <Maximum>9999</Maximum>
        <Location>140, 100</Location>
        <Size>100, 20</Size>
        <TabIndex>5</TabIndex>
    </Object>

    <Object type="System.Windows.Forms.Label, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="lblWarning">
        <Text></Text>
        <ForeColor>Red</ForeColor>
        <Location>20, 140</Location>
        <Size>320, 20</Size>
        <TabIndex>6</TabIndex>
    </Object>

    <Object type="System.Windows.Forms.Button, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="btnSave">
        <Text>Kaydet</Text>
        <Location>20, 200</Location>
        <Size>120, 40</Size>
        <TabIndex>7</TabIndex>
    </Object>
    <Object type="System.Windows.Forms.Button, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" name="btnCancel">
        <Text>İptal</Text>
        <Location>160, 200</Location>
        <Size>120, 40</Size>
        <TabIndex>8</TabIndex>
    </Object>
</Object>

XML'i elle yazmayın

Yukarıdaki XML trexForm.Designer aracı ile görsel olarak tasarlanıp dışa aktarılabilir. Kontrol adları (txtOrderNo, btnSave vb.) Form Bind Controls ve Control Properties nodlarında kullanılacağından büyük/küçük harfe dikkat edin.

Adım Adım Yapılandırma

Akış 1 — Form Aç

1. trex Subscriber (Bağımsız)

Temel Akış örneğindeki gibi varsayılan ayarlarla ekleyin.

2. Business Events

Alan	Değer
Name	OrderStart
Event	/OrderStartEvent
Is Handled	false

3. Custom Form

Alan	Değer
Name	OrderForm
Form Name	OrderEntryForm
Custom Form XML	(yukarıdaki XML)
Is Styled	true
Form In Main Form	false

4. Responser (Akış 1 sonu)

Varsayılan ayarlarla ekleyin. Akış 1 burada biter.

---

Akış 2 — Form Yüklenince Değişiklikler (Load)

5. Form Events

Alan	Değer
Form Name	OrderEntryForm
Control	_
Event Name	Load

control = _

_ değeri belirli bir kontrol değil formun kendisinin yüklenme olayını yakalar.

6. Form Bind Controls

Alan	Değer
Name	BindOrder
Form Name	OrderEntryForm
Form In Main Form	false
Data Type	msg
Data	payload
Props	(aşağıdaki tablo)

props listesi:

p (Property)	v (Value Field)
txtOrderNo	orderNo
txtCustomer	customer
txtQty	qty

7. Control Properties

Alan	Değer
Name	SetProperties
Form Name	OrderEntryForm
Form In Main Form	false
Props	(aşağıdaki tablo)

props listesi:

p (Control)	v (Property)	d (Value)	dt (Type)
btnSave	Enabled	true	bool
lblWarning	Visible	false	bool

8. Responser (Akış 2 sonu)

Varsayılan ayarlarla ekleyin.

Flow JSON

[
  { "id": "f2", "type": "tab", "label": "CustomFormOrnegi" },

  { "id": "sub1", "type": "trex Subscriber", "z": "f2",
    "method": "get", "event": "/GetSubscribed",
    "x": 200, "y": 80, "wires": [[]] },

  { "id": "ev1", "type": "Business Events", "z": "f2",
    "name": "OrderStart", "event": "/OrderStartEvent", "ishandled": false,
    "x": 180, "y": 200, "wires": [["form1"]] },

  { "id": "form1", "type": "Custom Form", "z": "f2",
    "name": "OrderForm", "formname": "OrderEntryForm",
    "customformxml": "...", "isstyled": true, "formainform": false,
    "x": 380, "y": 200, "wires": [["resp1"]] },

  { "id": "resp1", "type": "Responser", "z": "f2",
    "x": 560, "y": 200, "wires": [] },

  { "id": "fevt1", "type": "Form Events", "z": "f2",
    "formname": "OrderEntryForm", "control": "_", "eventname": "Load",
    "formainform": false, "eventtime": "After",
    "x": 180, "y": 340, "wires": [["bind1"]] },

  { "id": "bind1", "type": "Form Bind Controls", "z": "f2",
    "name": "BindOrder", "formname": "OrderEntryForm", "formainform": false,
    "props": [
      { "p": "txtOrderNo",  "v": "orderNo" },
      { "p": "txtCustomer", "v": "customer" },
      { "p": "txtQty",      "v": "qty" }
    ],
    "data": "payload", "dataType": "msg",
    "x": 400, "y": 340, "wires": [["props1"]] },

  { "id": "props1", "type": "Control Properties", "z": "f2",
    "name": "SetProperties", "formname": "OrderEntryForm", "formainform": false,
    "props": [
      { "p": "btnSave",    "v": "Enabled", "d": "true",  "dt": "bool" },
      { "p": "lblWarning", "v": "Visible", "d": "false", "dt": "bool" }
    ],
    "x": 620, "y": 340, "wires": [["resp2"]] },

  { "id": "resp2", "type": "Responser", "z": "f2",
    "x": 820, "y": 340, "wires": [] }
]

Beklenen Davranış

Panel'de OrderStartEvent tetiklendiğinde:

1. Akış 1 çalışır: OrderEntryForm panelde açılır, Responser ile ilk akış biter.
2. Panel formu yükler → Load olayı tetiklenir → Akış 2 başlar.
3. Form içindeki textbox'lar gelen sipariş verisiyle doldurulur:
   • txtOrderNo: ORD-2026-0042
   • txtCustomer: ACME Ltd.
   • txtQty: 50
4. btnSave butonu aktiftir, lblWarning etiketi gizlidir.
5. Akış 2 kendi Responser'ı ile biter.

msg.payload İncelemesi

Responser'a ulaştığında msg.payload array'i şuna benzer:

[
  {
    "operationtype": "CustomDialog",
    "receiveddata": { "orderNo": "ORD-001", "customer": "ACME", "qty": 50 },
    "name": "OrderEntryForm",
    "continueevent": "Continue",
    "customformxml": "<form ...>...</form>",
    "isstyled": true
  },
  {
    "operationtype": "BindControl",
    "receiveddata": { ... },
    "name": "OrderEntryForm",
    "bindcontrols": [
      { "Name": "txtOrderNo",  "FieldName": "orderNo" },
      { "Name": "txtCustomer", "FieldName": "customer" },
      { "Name": "txtQty",      "FieldName": "qty" }
    ],
    "value": { "orderNo": "ORD-001", "customer": "ACME", "qty": 50 }
  },
  {
    "operationtype": "ControlProperties",
    "receiveddata": { ... },
    "name": "OrderEntryForm",
    "value": [
      { "ControlName": "btnSave",    "PropertyName": "Enabled", "Value": true  },
      { "ControlName": "lblWarning", "PropertyName": "Visible", "Value": false }
    ]
  }
]

Responser bu array'i tek HTTP cevabında panele gönderir, panel sırayla her operasyonu uygular.

Yaygın Sorunlar

Form açılıyor ama alanlar boş

• Form Bind Controls'taki data ve dataType doğru mu?
• props listesindeki p değerleri XML'deki kontrol isimleriyle birebir mi eşleşiyor? (büyük/küçük harf!)

Form hiç açılmıyor

• customformxml geçerli XML mı? (Açıkta kalmış tag, eksik attribute)
• formname doğru?

btnSave hala disabled

Control Properties'te dt "bool", d ise düz "true" string olmalı.

Sonraki Adım

Buton Konfigürasyonu örneğinde butonları yapılandırıp tıklamaları yakalayacağız.