# Communication Events

<div class="node-header">
  <span class="node-preview green-light">Communication Events</span>
  <div class="meta-item"><strong>Inputs:</strong> <span class="io-badge in">0</span></div>
  <div class="meta-item"><strong>Outputs:</strong> <span class="io-badge out">1</span></div>
  <div class="meta-item"><strong>Kategori:</strong> trexMes service</div>
</div>

trexMes paneli ile **operatör veya harici cihaz arasındaki iletişim olaylarına** abone olur. Barkod okuma, seri port, IO kart, OPC ve benzeri dış kaynaklı etkileşimleri yakalar.

## Property Tablosu

| Alan | Tip | Varsayılan | Açıklama |
|---|---|---|---|
| `name` | string | — | Canvas üzerinde gösterilecek ad |
| `event` | string | _(boş)_ | Abone olunacak iletişim olayı |
| `ishandled` | boolean | `false` | Node-RED bu olayı handle ediyor mu? |

## Olay Listesi

| Olay | Açıklama |
|---|---|
| `OnAssemblyPictureSignalChanged` | Montaj resim gösterim sinyalinin değişimi sırasında fırlatılır. |
| `OnBarcodeScanned` | Uygulama ana ekranı veya COM barkod okuyucu ile gerçekleştirilen barkod okutma işlemlerinde tetiklenir. |
| `OnBarcodeScanning` | Barkod okutma işlemlerinde standart barkod kurguları çalıştırılmadan önce tetiklenir. IsHandled true ise standart işlem yapılmaz. |
| `OnNotificationMessageProcessing` | Bildirim mesajı alındığında tetiklenir. IsHandled true ise sadece mesaj durumu gösterildi olarak güncellenir. |
| `OnDigitalInputValueChanged` | Dijital input sinyal değeri değiştiğinde tetiklenir. |
| `OnDigitalInputValueChanging` | Dijital input sinyal değeri değişmek üzere olduğunda tetiklenir. |
| `OnDigitalOutputValueChanged` | Dijital output sinyal değeri değiştiğinde tetiklenir. |
| `OnDigitalOutputValueChanging` | Dijital output sinyal değeri değişmek üzere olduğunda tetiklenir. |
| `OnIOCardDataCoalesced` | IO kart üzerinden alınan sinyal verisinin çözümlenmesinden hemen önce tetiklenir. |
| `OnJobOrderStockBarcodeScanned` | İş emri veya stok barkodu taratılıp ilgili işlem gerçekleştirildiğinde tetiklenir. |
| `OnJobOrderStockBarcodeScanning` | İş emri veya stok barkodu taratıldığında tetiklenir. IsHandled true ise standart işlemler es geçilir. |
| `OnLotBarcodeScanning` | Sarf lot girişi için barkod okutma işlemi gerçekleştirildiğinde tetiklenir. IsHandled true ise standart işlemler es geçilir. |
| `OnNgpCommandProcessing` | trex Lite üzerinden gelen istek işlenmeden hemen önce tetiklenir. IsHandled true ise standart kurgu işletilmez. |
| `OnPortDataChanged` | OPC haberleşmesi üzerinden gerçekleşen veri portu değer değişimi işlendiğinde tetiklenir. |
| `OnPortDataChanging` | OPC haberleşmesi üzerinden gerçekleşen veri portu değer değişimi işlenmek üzere olduğunda tetiklenir. |
| `OnPortManagerConnected` | IO kart ile port yöneticisi arasında bağlantı gerçekleştirildiğinde tetiklenir. |
| `OnPortManagerInitialized` | Sinyal port yöneticisi ayağa kalktığında tetiklenir. |
| `OnPortManagerInitializing` | Sinyal port yöneticisi ayağa kalktığı esnada tetiklenir. |
| `OnPortParametersLoaded` | Sinyal port parametre tanımları yüklendiğinde tetiklenir. |
| `OnProductionConfirmationSignalChanged` | Üretim onay sinyali ile üretim onayı gerçekleştirildiğinde tetiklenir. |
| `OnProductionConfirmationSignalInputValuesSetting` | Üretim onay süreci sonrası sinyal input değerlerinin set edilmesi sırasında tetiklenir. |
| `OnSerialPortBarcodeScanning` | Seri port üzerinden barkod okutma işlemi gerçekleştirildiğinde standart işlemler öncesi tetiklenir. |
| `OnSerieBarcodeScanning` | Serili üretim barkod işlemleri gerçekleştirilmeden hemen önce tetiklenir. |
| `OnSocketMessageInterpreted` | OPC haberleşmesi amacı ile dinlenen TCP socket üzerinden gelen mesaj çözümlendiğinde tetiklenir. |
| `OnStoppageSignalChanged` | Duruş sinyal input durumu değiştiğinde tetiklenir. |
| `OnDefectEntrySignalChanged` | Iskarta giriş sinyal input durumu değiştiğinde tetiklenir. |

## `msg.payload` Yapısı

Communication Events, payload'u **düz (flat) birleştirilmiş** bir nesne olarak gönderir. Yapı şu sırayı izler:

1. **EventArgs alanları** — olaya özgü veriler, üst seviyede taşınır
2. **`IsHandled`** — akış kontrolü bayrağı
3. **`WorkStationStatusEntry`** — istasyonun anlık üretim durumu

```json
{
  "WorkStationId": 5,
  "Barcode": "STOCK-12345-SN-ABC123",
  "IsHandled": false,
  "WorkStationStatusEntry": {
    "WorkStationId": 0,
    "IsPlanLoaded": false,
    "IsStopped": false,
    "ProductionQuantity": 0.0,
    "ShiftId": 0,
    "ClientVersion": "",
    "...": "..."
  }
}
```

> Yukarıdaki örnek `OnBarcodeScanned` içindir. Her event kendi EventArgs alanlarını üst seviyede taşır.

!!! warning "IsHandled — akışı kesme"
    `IsHandled` alanı bulunan eventlarda, akış içinde bu değer `true` yapılırsa panel tarafındaki varsayılan işlem atlanır. Akışı kesmek veya veriyi değiştirmek için **Handle Setter** nodu kullanılır.

!!! info "Editörde önizleme"
    Event seçildiğinde editör içinde tam `msg.payload` yapısı **collapse edilebilir JSON ağacı** olarak görüntülenir. `IsHandled` içeren eventlar editörde amber uyarı bandı gösterir: iç objeler başlangıçta kapalı gelir, tıklanarak açılabilir.

## Örnek Kullanım

```mermaid
flowchart LR
    A[Communication Events<br/>OnBarcodeScanned] --> B{Barcode\ngeçerli mi?}
    B -- Evet --> C[İş emrine bağla]
    B -- Hayır --> D[Handle Setter<br/>IsHandled=true]
    D --> E[Custom Form\nHata mesajı]

    style A fill:#ccffcc,color:#000
    style D fill:#ccffcc,color:#000
    style E fill:#ccffcc,color:#000
```

## İpuçları

!!! tip "Barkod yönlendirme"
    `OnBarcodeScanned` ile okunan barkodun içeriğine göre farklı üretim akışlarına yönlendirme yapabilirsiniz. `IsHandled: true` ile panelin kendi barkod işlemesini devre dışı bırakabilirsiniz.

!!! tip "Sinyal izleme"
    `OnDigitalInputValueChanged` ile IO kart giriş sinyallerini izleyebilir, belirli bir sinyal değişiminde üretim duruşu başlatabilir ya da alarm tetikleyebilirsiniz.

!!! tip "OPC veri günlüğü"
    `OnPortDataChanged` ile OPC tag değişimlerini InfluxDB veya MQTT'ye iletebilirsiniz.

## Argüman Referansı

Her event için `msg.payload` içindeki **EventArgs özel alanları** listelenmektedir.  
Tüm Communication Events payload'unda ayrıca **`IsHandled`** ve **`WorkStationStatusEntry`** da bulunur.

??? info "OnBarcodeScanned · OnJobOrderStockBarcodeScanned"
    Model: `BarcodeScannedEventArgs`
    ```json
    {
      "WorkStationId": 5,
      "Barcode": "STOCK-12345-SN-ABC123"
    }
    ```

??? info "OnBarcodeScanning · OnJobOrderStockBarcodeScanning · OnSerialPortBarcodeScanning"
    Model: `BarcodeScanningEventArgs`
    ```json
    {
      "WorkStationId": 5,
      "Barcode": "STOCK-12345-SN-ABC123",
      "IsBarcodeValid": true,
      "IsBarcodeChanged": true
    }
    ```

??? info "OnSerieBarcodeScanning"
    Model: `SerieBarcodeScanningEventArgs`
    ```json
    {
      "WorkStationId": 0,
      "Barcode": "",
      "IsBarcodeValid": false,
      "BarcodeValidationMessage": ""
    }
    ```

??? info "OnLotBarcodeScanning"
    Model: `LotBarcodeScanningEventArgs`
    ```json
    {
      "WorkStationId": 0,
      "LotNo": "",
      "StockId": 0,
      "JobOrderId": 0,
      "ItemNo": 0,
      "IsLotNoChanged": false
    }
    ```

??? info "OnNotificationMessageProcessing"
    Model: `NotificationMessageProcessingEventArgs`
    ```json
    {
      "WorkStationId": 0,
      "NotificationMessageId": 0,
      "Message": "",
      "TransactionType": 0,
      "TransactionId": 0,
      "TransactionQuantity": 0.0,
      "TransactionQuantityUnitType": 0
    }
    ```

??? info "OnAssemblyPictureSignalChanged · OnPortDataChanged · OnPortDataChanging · OnProductionConfirmationSignalChanged · OnStoppageSignalChanged"
    Model: `PortDataChangeEventArgs`
    ```json
    {
      "WorkstationId": 0,
      "Value": null,
      "Port": {
        "PortNo": 0,
        "PlcType": 0,
        "OpcIpAddress": "",
        "OpcPlcName": "",
        "OpcChannelName": "",
        "OpcTagDefinitionId": 0,
        "OpcTagDefinitionName": "",
        "DigitalInputType": 0,
        "IsHighSpeedCounter": false,
        "IsMultiCycle": false
      }
    }
    ```

??? info "OnDigitalInputValueChanged · OnDigitalInputValueChanging"
    Model: `DIChangeEventArgs` — Veri paketi tanımlanmamıştır.

??? info "OnDigitalOutputValueChanged · OnDigitalOutputValueChanging"
    Model: `DOChangeEventArgs` — Veri paketi tanımlanmamıştır.

??? info "OnIOCardDataCoalesced"
    Model: `IOCardDataCoalescedEventArgs`
    ```json
    {
      "Summary": {
        "PortName": "",
        "Data": ""
      }
    }
    ```

??? info "OnNgpCommandProcessing"
    Model: `NgpCommandProcessingEventArgs`
    ```json
    {
      "WorkStationId": 0,
      "IsProcessSuccessed": false,
      "ResponseMessage": "",
      "NgpCommand": {
        "WorkStationId": 0,
        "CommandId": 0,
        "CommandType": 0,
        "Command": "",
        "IsProcessed": false,
        "InsertUserId": 0,
        "InsertDate": null
      }
    }
    ```

??? info "OnPortManagerConnected"
    Model: `PortManagerConnectedEventArgs` — Veri paketi tanımlanmamıştır.

??? info "OnPortManagerInitialized"
    Model: `PortManagerInitializedEventArgs` — Veri paketi tanımlanmamıştır.

??? info "OnPortManagerInitializing"
    Model: `PortManagerInitializingEventArgs` — Veri paketi tanımlanmamıştır.

??? info "OnPortParametersLoaded"
    Model: `PortParametersLoadedEventArgs` — Veri paketi tanımlanmamıştır.

??? info "OnProductionConfirmationSignalInputValuesSetting"
    Model: `ProductionConfirmationSignalInputValuesSettingEventArgs`
    ```json
    {
      "WorkStationId": 0
    }
    ```

??? info "OnSocketMessageInterpreted"
    Model: `SocketMessageInterpretedEventArgs`
    ```json
    {
      "Summary": {
        "TagId": 0,
        "Time": 0,
        "Value": ""
      }
    }
    ```

??? info "OnDefectEntrySignalChanged"
    Model: `DefectEntrySignalChangedEventArgs`
    ```json
    {
      "WorkStationId": 0,
      "PortProcessType": 0
    }
    ```

## İlgili

- [Olay Nodları Genel Bakış](event-subscribers.md)
- [Handle Setter](handle-setter.md)
- [Responser](responser.md)