Hızlı Başlangıç¶
Bu rehber, ilk trexMes akışınızı 5 dakika içinde ayağa kaldırmanız için yazılmıştır.
Hedef¶
Bir trexMes panelinden gelen Business Event'i yakalayıp Node-RED debug penceresinde gösteren bir akış oluşturacağız.
Akış Şeması¶
trex Subscriber bağımsız durur; olay akışı doğrudan Business Events'ten başlar.
flowchart LR
subgraph Kayit["Kayıt (bağımsız)"]
A[trex Subscriber]
end
subgraph Akis["Olay Akışı"]
B[Business Events<br/>OrderStart] --> D[debug]
end
style A fill:#58d68d,color:#000
style B fill:#ccffcc,color:#000
style D fill:#87ceeb,color:#000
Adım 1 — Yeni Bir Flow Oluşturun¶
- Node-RED arayüzünde + ile yeni bir tab açın (örn. "MyFirstTrexFlow").
Adım 2 — trex Subscriber Ekleyin¶
Paletten trexMes service kategorisi altındaki trex Subscriber node'unu canvas'a sürükleyin.
| Özellik | Değer |
|---|---|
| Name | (boş bırakabilirsiniz) |
| Method | get (otomatik) |
| Event | /GetSubscribed (varsayılan) |
Bu node ne yapar?
trex Subscriber, projenizdeki tüm event node'larının isimlerini trexMes paneline kayıt eder. Panel bu listeye bakarak hangi olayları Node-RED'e göndereceğini bilir.
Adım 3 — Business Events Ekleyin¶
Paletten Business Events node'unu canvas'a sürükleyin ve çift tıklayarak yapılandırın:
| Özellik | Değer | Açıklama |
|---|---|---|
| Name | OrderStart (opsiyonel) |
Akış üzerinde göstermek için |
| Method | get (varsayılan) |
HTTP method |
| Event | /OrderStartEvent |
Panel tarafında tanımlanan olay adı |
| Is Handled | false |
Bu olayı bizim akışımız mı işleyecek? |
Event ismi nereden geliyor?
Event alanına yazdığınız değer, trexMes Edge tarafında tanımlı olay isimleriyle birebir eşleşmelidir (büyük/küçük harf duyarlı). Panel yapılandırmasından doğru ismi öğrenin.
Adım 4 — debug Node'u Ekleyin¶
Standart Node-RED debug node'unu sürükleyip Business Events çıkışına bağlayın. debug özelliklerinde:
- Output:
complete msg object
Adım 5 — Deploy¶
Sağ üstteki kırmızı Deploy butonuna tıklayın. Bağlantı başarılı kurulduysa:
trex Subscribernode'unun altında kısa bir süre yeşil "Triggered" durumu görünür.- Sağ panelde debug çıktısı, panelden olay tetiklendiğinde belirir.
Beklenen Çıktı¶
Panel tarafında OrderStartEvent tetiklendiğinde Node-RED debug panelinde şuna benzer bir mesaj görmelisiniz:
{
"_msgid": "abc123",
"payload": {
"orderNo": "ORD-2026-0001",
"operatorId": "OP-007",
"machineId": "M-12"
},
"req": { /* HTTP request bilgisi */ },
"res": { /* HTTP response wrapper */ }
}
Sonraki Adım: Veriyi Form'a Yansıtmak¶
İlerleyen örneklerde bu yapıyı genişleterek:
- Gelen olay verisiyle bir Custom Form açacağız.
- Form alanlarını Form Bind Controls ile dolduracağız.
- Form üzerindeki butonları Button Configurator ile yapılandıracağız.
- Akış sonunda Responser ile cevap döndüreceğiz.
Custom Form Akışı örneğine geç →
Yaygın Hatalar¶
Olay tetiklenmiyor
trex Subscribernode'unun durumu kontrol edin (Triggered çıkıyor mu?)- trexMes Edge'de Node-RED Connector eklentisi etkin mi?
Eventalanındaki isim trexMes'teki ile tam olarak eşleşiyor mu?- Bu projede birden fazla
trex Subscribermi var? (Olmamalı!)
Aynı olayı birden fazla akış işliyor
Aynı Event ismine sahip birden fazla Business Events node'u kullanırsanız hepsi tetiklenir. Bu davranış bilinçli olmalıdır.
Custom Form çıktısı yok
Custom Form kullanıyorsanız Designer çıktısı C:\temp\<formname>_form_design.xml konumunda olmalıdır. Kurulum sayfasındaki Custom Form Designer bölümüne bakın.