Application ID ile bir iş işlemini bulma

Application ID, entegrasyonun iş açısından tanıdığı kimliktir: sipariş numarası, belge numarası veya işlem referansı gibi. Lunex bu değeri sizin yerinize üretmez. Akış, gelen veriden aldığı değeri lunex.monitor.applicationId exchange property’sine yazar; Message Monitor bu değeri kaydeder.

Bu kimlik, proje kimliğinden ve giriş veya API erişimi için kullanılan OAuth/OIDC client ID değerinden ayrıdır. Yeni bir OAuth uygulaması kaydettirerek Message Monitor Application ID almazsınız.

Mevcut bir kimliği ekranda bulma

1. Message Monitor içinde mesajı açın.
2. Ayrıntılardaki Application ID değerini okuyun.
3. Teknik izleme kimliği gerekiyorsa Technical details → Message ID veya Run ID yanındaki kopyalama düğmesini kullanın.
4. Not recorded görünüyorsa bu çalışmada Application ID kaydedilmemiştir. Akışa aşağıdaki atamayı ekleyip yeni bir mesaj gönderin.

Eski kayda sonradan Application ID eklenmez. Kimliği bulmak için başlangıçta yalnız gönderim saati biliniyorsa tarih ve entegrasyon filtresi kullanabilirsiniz.

Akışa Application ID ekleme

Önkoşul: Düzenleme yetkiniz ve kimliğin mesajın hangi alanında geldiğini belirleyen bir sözleşmeniz olmalıdır. Sipariş numarasını header, JSON alanı veya önceki adımdaki dönüşümden alabilirsiniz. Hassas veri yerine işi tanımlamak için gereken referansı kullanın.

1. Projede Source bölümünden akış dosyasını açın.
2. Designer içinde iş kimliği elde edildikten hemen sonra bir Set Property adımı ekleyin.
3. Özellik adını lunex.monitor.applicationId yapın. Değeri bir String ifade olarak verin.
4. Kaydın tamamlandığını kontrol edin ve gerçek runtime’da bir örnek mesaj işleyin.
5. Message Monitor içinde kimlik türünü Application ID seçin, değeri Search by identifier alanına yazın ve Enter tuşuna basın.

Code görünümünde aynı atamanın sabit değerli örneği:

- setProperty:
    name: lunex.monitor.applicationId
    constant: ORD-2026-0042

Giriş sözleşmenizde OrderId adlı header varsa:

- setProperty:
    name: lunex.monitor.applicationId
    simple: "${header.OrderId}"

İkinci örneği kullanmadan önce header’ın varlığını ve geçerli bir sipariş referansı taşıdığını akışınızda doğrulayın. Lunex rastgele header’ları kendiliğinden Application ID olarak yorumlamaz.

Birden fazla kaydı ilişkilendirme

Bir iş süreci farklı projelerde çalışıyorsa ortak referansı bu projelere giriş verinizle aktarın. Her akış açıkça kendi metadata değerini atamalıdır. Örneğin:

- setProperty:
    name: lunex.monitor.correlationId
    constant: CHECKOUT-2026-0180
- setProperty:
    name: lunex.monitor.sender
    constant: web-store
- setProperty:
    name: lunex.monitor.receiver
    constant: order-service
- setProperty:
    name: lunex.monitor.applicationType
    constant: SalesOrder
- setProperty:
    name: lunex.monitor.customStatus
    constant: Validated

Correlation ID aynı değerle işaretlenmiş kayıtları aratır. Bu ortak değer tek başına bir çağrının başka bir çağrıyı gerçekten başlattığını kanıtlamaz. Related processing yalnız kaydedilmiş çalışma ilişkilerini gösterir. Custom status sizin iş durumunuzdur; Completed veya Failed gibi teknik sonucu değiştirmez.

Ne zaman kaydedilir?

Metadata çalışma başlangıcında ve sonunda alınan gözlemlere kopyalanır. Route içindeki Set Property başlangıç gözleminden sonra çalıştığı için değer çoğunlukla terminal kayıt geldiğinde görünür. Gönderim henüz bitmediyse tamamlandıktan sonra Refresh kullanın.

Atamayı hata verebilecek uzak çağrıdan önce yapın. Akış bu adıma ulaşmadan hata alırsa değeri kaydedemez. None kayıt üretmez; Error normal başarılı çalışmaları saklamaz. Kimlikli başarılı işlemleri aramak için Info, Debug veya Trace kullanın.

Bu metadata değerleri String olmalı ve her biri en fazla 256 UTF-8 byte olmalıdır. Daha uzun değer kesilerek farklı bir kimliğe dönüştürülmez; kayda alınmaz. Çok sayıda iş anahtarı için özel iş alanları kullanın.

Aramada sonuç çıkmıyorsa

Kimlik araması normal zaman ve durum filtrelerinden ayrı çalışır; yalnız son 24 saatte arama yapmaz. Bununla birlikte süresi dolmuş verileri geri getirmez.