Mesaj kuralları
Entegrasyon yanıt mesajlarını desenle mesaj koduna ve yeniden deneme tipine bağlayan kuralları, metotları ve mesaj kodlarını yönetin.

Mesaj kuralları ekranı, ürün gönderimi yapan entegrasyonlardan dönen yanıt mesajlarının nasıl sınıflandırılacağını tanımladığınız yerdir. Her kural bir entegrasyon ve metot için, yanıt mesajıyla eşleşen bir desen (düzenli ifade), bu mesajın karşılık geldiği mesaj kodu ve yeniden deneme tipini bir araya getirir. Böylece benzer hatalar tek bir kodla toplanır ve her birinde ne yapılacağı belirlenir. Ekranı entegrasyon hatalarını yöneten katalog ve operasyon ekipleri kullanır.
Ekrana ulaşma
Menüde ComHub – Pazaryeri Entegrasyonu › Hata logları › Mesaj kuralları yolunu izleyin. Ekranın başlığı Entegrasyon mesaj kuralları olarak görünür.
Menüde görmüyorsanız hesabınızın bu ekrana yetkisi yoktur. Ekranı görüp Yeni kural düğmesini göremiyorsanız hesabınızın kural yazma yetkisi yoktur; bu durumda ekran salt okunur açılır.
Ekranın bölümleri
- Başlık: Entegrasyon mesaj kuralları, altında "Entegrasyon metodu, mesaj kodu ve yeniden deneme tipi eşleşmeleri." açıklaması ve sağda Yeni kural düğmesi (yalnızca yazma yetkisiyle).
- Filtre alanı: Ara kutusu ve Entegrasyon seçimi; altta Temizle, Detaylı filtrele ve Filtrele düğmeleri.
- Liste araç çubuğu: Her sayfada seçimi, "Filtreleme sonucu: … kural" sayısı ve sağda simge düğmeler: Entegrasyon metotları, Mesaj kodları ve (yalnızca yazma yetkisiyle) Eşleşmeyenleri doldur; ardından yenileme simgesi ve Sütunlar menüsü. Simgelerin üzerine geldiğinizde ne işe yaradıkları yazar.
- Liste: Kurallar ve sayfalama.
Filtreleme ve arama
| Alan | Ne işe yarar | İpucu |
|---|---|---|
| Ara | Entegrasyon, metot, mesaj kodu, desen, mesaj, kaynak ve eylem alanlarının herhangi birinde yazdığınız metin geçen kuralları listeler. Büyük/küçük harf ayırt edilmez. | Bir hata metninin parçasını yazarak ilgili kuralı bulabilirsiniz. |
| Entegrasyon | Yalnızca seçtiğiniz entegrasyonun kurallarını listeler. Varsayılan Tümü'dür. | Her zaman görünür. |
| Metot | Seçtiğiniz entegrasyon metoduna ait kuralları listeler. | Detaylı filtrele menüsünden eklenir. Seçenekler tüm entegrasyonların metotlarıdır; Entegrasyon seçimine göre daralmaz. |
| Mesaj kodu | Seçtiğiniz mesaj koduna bağlı kuralları listeler. | Detaylı filtrele menüsünden eklenir. |
| Yeniden deneme tipi | Seçtiğiniz yeniden deneme tipine sahip kuralları listeler. | Detaylı filtrele menüsünden eklenir. |
- Seçim listelerindeki değerler birebir eşleşmeyle süzer.
- Detaylı filtrele menüsünde işaretlediğiniz filtreler tarayıcınızda hatırlanır; ekrana döndüğünüzde yine açık gelir. Bir filtrenin işaretini kaldırırsanız değeri de silinir.
- Değerler hemen uygulanmaz; Filtrele düğmesine ya da bir alandayken Enter'a basın. Temizle tüm filtreleri ve aramayı kaldırır.
Liste
| Kolon | Anlamı |
|---|---|
| Entegrasyon | Kuralın geçerli olduğu entegrasyon; altında küçük yazıyla entegrasyon metodu görünür. Bu kolon gizlenemez. |
| Mesaj kodu | Desenle eşleşen mesajın atandığı kod; altında küçük yazıyla mesajın kaynağı görünür. |
| Desen | Yanıt mesajıyla karşılaştırılan düzenli ifade. |
| Mesaj | Kurala bağlı mesaj metni. |
| Yeniden deneme | Kuralın yeniden deneme tipi, mavi etiketle. |
| Süre (dk) | Yeniden deneme süresi, dakika olarak. |
| Eylem | Kurala bağlı eylem bilgisi. |
| Bekleyen istek tipi | Metoda bağlı bekleyen istek tipi. Varsayılan olarak gizlidir. |
| Sıra | Kuralın sıra numarası. Varsayılan olarak gizlidir. |
| Oluşturulma | Kuralın oluşturulduğu tarih ve saat. Varsayılan olarak gizlidir. |
| Güncellendi | Kuralın son değiştirildiği tarih ve saat. Varsayılan olarak gizlidir. |
- Gizli kolonları Sütunlar menüsünden açabilirsiniz; seçiminiz tarayıcınızda saklanır.
- Kolon kenarlarını sürükleyerek genişliklerini değiştirebilirsiniz; uzun desen ve mesajları okumak için kullanışlıdır.
- Kolon başlıklarına tıklayarak sıralama yapılamaz.
- Değeri olmayan hücrelerde "—" görünür.
- Sayfa boyutu varsayılan olarak 25'tir; Her sayfada seçiminden 50 ya da 100 seçebilirsiniz.
- Satıra tıklamak bir şey açmaz. Yazma yetkiniz varsa satırın sağındaki üç nokta (Satır işlemleri) menüsünde Kuralı düzenle ve Kuralı sil seçenekleri bulunur; yetkiniz yoksa bu menü görünmez.
İşlemler
Kural ekleme, düzenleme, silme, eşleşmeyenleri doldurma ve metot/kod ekleme, düzenleme, silme işlemleri yazma yetkisi gerektirir. Yetkiniz yoksa bu düğmeler görünmez; Entegrasyon metotları ve Mesaj kodları panellerini yine açıp inceleyebilirsiniz.
Yeni kural ekleme
Yeni bir hata mesajı türünü sınıflandırmak istediğinizde kullanın.
- Başlığın sağındaki Yeni kural düğmesine basın. Yeni kural kutusu açılır.
- Entegrasyon listesinden entegrasyonu seçin.
- Entegrasyon metodu listesinden metodu seçin. Bu liste entegrasyon seçilmeden kapalıdır ve seçtiğiniz entegrasyonun metotlarını gösterir.
- Mesaj kodu alanına kodu yazın ya da önerilerden seçin.
- Yeniden deneme tipi'ni kontrol edin; listedeki ilk tip seçili gelir, gerekiyorsa değiştirin.
- Desen (regex) alanına yanıt mesajıyla eşleşecek düzenli ifadeyi yazın.
- Gerekiyorsa Yeniden deneme süresi (dakika) ve Sıra numarası alanlarını doldurun.
- Kaydet'e basın. Zorunlu alanlar dolmadan düğme pasiftir.
Kayıt başarılı olursa "Kural kaydedildi" bildirimi görünür, kutu kapanır ve liste yenilenir. Kayıt yapılamazsa "Bir şeyler ters gitti" bildirimi ayrıntısıyla birlikte çıkar ve kutu açık kalır; girdikleriniz kaybolmaz.
Kuralı düzenleme
- Satırın sağındaki üç nokta menüsünden Kuralı düzenle'yi seçin.
- Kuralı düzenle kutusu, kuralın mevcut değerleriyle açılır.
- Değişikliklerinizi yapıp Kaydet'e basın.
Kutuyu Vazgeç ile kapatırsanız değişiklikler kaydedilmez. Kutuyu her açtığınızda değerler kuraldan yeniden yüklenir.
Kuralı silme
- Satırın sağındaki üç nokta menüsünden Kuralı sil'i seçin.
- Bu kural silinsin mi? kutusu "Silinen kural geri alınamaz; aynı desen için yeniden kural yazmanız gerekir." uyarısıyla açılır ve kuralın desenini gösterir. Doğru kural olduğunu kontrol edin.
- Sil'e basın.
"Kural silindi" bildirimi görünür ve liste yenilenir. Silme başarısız olursa "Bir şeyler ters gitti" bildirimi çıkar ve kutu açık kalır.
Eşleşmeyenleri doldur
Henüz hiçbir kuralla eşleşmemiş entegrasyon mesajları için taslak kurallar oluşturmak üzere kullanın.
- Liste araç çubuğundaki Eşleşmeyenleri doldur simgesine basın.
- Eşleşmeyen mesajlar için taslak kurallar oluşturulsun mu? kutusu açılır. Açıklamada belirtildiği gibi, eşleşmemiş entegrasyon mesajları taranıp eksik kurallar eklenir; işlem birkaç dakika sürebilir.
- Eşleşmeyenleri doldur düğmesine basın. İşlem sürerken düğmede "Kaydediliyor…" yazar.
Tamamlandığında "Eşleşmeyen mesajlar dolduruldu" bildirimi görünür, kutu kapanır ve liste yenilenir. Eklenen kuralları inceleyip gerekiyorsa düzenleyin. İşlem başarısız olursa "Bir şeyler ters gitti" bildirimi çıkar ve kutu açık kalır.
Entegrasyon metotlarını yönetme
Kural kutusundaki Entegrasyon metodu listesi buradaki kayıtlardan gelir.
- Liste araç çubuğundaki Entegrasyon metotları simgesine basın ya da kural kutusundaki Metotları yönet düğmesini kullanın. Sağdan Entegrasyon metotları paneli açılır.
- Paneldeki Entegrasyon seçimiyle ve Ara kutusuyla (metot, bekleyen istek tipi ya da entegrasyonda arar) listeyi daraltın. Kural kutusundan açtıysanız Entegrasyon seçimi kutuda seçili entegrasyonla gelir.
- Yeni metot için Metot ekle'ye basın. Panelde bir entegrasyon seçiliyse form o entegrasyonla açılır. Formda Entegrasyon, Entegrasyon metodu ve Bekleyen istek tipi alanlarını doldurup Kaydet'e basın. Üçü de zorunludur; boş alanın altında "Zorunlu alan" yazar.
- Bir satırı değiştirmek için kalem simgesine, silmek için çöp kutusu simgesine basın. Düzenlemede Entegrasyon değiştirilemez.
Panel listesinde Entegrasyon, Entegrasyon metodu ve Bekleyen istek tipi kolonları vardır.
Mesaj kodlarını yönetme
Kural kutusundaki Mesaj kodu önerileri buradaki kayıtlardan gelir.
- Liste araç çubuğundaki Mesaj kodları simgesine basın ya da kural kutusundaki Mesaj kodlarını yönet düğmesini kullanın. Sağdan Mesaj kodları paneli açılır.
- Ara kutusuyla kod, açıklama, kaynak ya da eylemde arama yapın.
- Yeni kod için Kod ekle'ye basın. Mesaj kodu ve Açıklama zorunludur; Kaynak ve Eylem isteğe bağlıdır. Kaydet'e basın.
- Bir satırı değiştirmek için kalem simgesine, silmek için çöp kutusu simgesine basın.
Panel listesinde Mesaj kodu, Açıklama, Kaynak ve Eylem kolonları vardır.
Her iki panelde de ortak davranış şöyledir:
- Kayıt başarılı olursa "Kaydedildi" bildirimi görünür ve form kapanır; hata olursa açıklaması formun üstünde gösterilir ve form açık kalır. Formu Vazgeç ile kapatabilirsiniz.
- Silmeden önce Kayıt silinsin mi? kutusu "Bu kaydı kullanan kurallar etkilenebilir." uyarısıyla silinecek kaydı gösterir; onaylayınca "Silindi" bildirimi görünür. Silme başarısız olursa kutu kapanır ve "Bir şeyler ters gitti" bildirimi çıkar.
- Aramaya uyan kayıt yoksa "Kayıt yok" yazar.
- Panellerdeki değişiklikler kural listesini ve kural kutusundaki seçenekleri de yeniler.
Kural kutusu alanları
| Alan | Zorunlu | Açıklama / kural |
|---|---|---|
| Entegrasyon | Evet | Listede ürün gönderimi yapan entegrasyonlar yer alır. Entegrasyonu değiştirdiğinizde seçili metot temizlenir. |
| Entegrasyon metodu | Evet | Entegrasyon seçilene kadar kapalıdır ve altında "Önce entegrasyonu seçin" yazar. Seçili entegrasyonun metotlarını listeler; o entegrasyon için hiç metot kaydı yoksa tüm metotlar listelenir. |
| Mesaj kodu | Evet | En fazla 256 karakter. Önerilerden seçebilir ya da kodu kendiniz yazabilirsiniz. Listede olmayan bir kod yazarsanız alanın altında "Bu kod mesaj kodu listesinde yok; kural yine kaydedilir." notu çıkar. |
| Yeniden deneme tipi | Her zaman seçili | Seçim yapmazsanız listedeki ilk tip seçili gelir ve kural o tiple kaydedilir; kaydetmeden önce doğru tipin seçili olduğunu kontrol edin. |
| Desen (regex) | Evet | Entegrasyon yanıtındaki mesajla eşleşen düzenli ifade. Baştaki/sondaki boşluklar kaydederken kırpılır. |
| Yeniden deneme süresi (dakika) | Hayır | Tam sayı girin; tam sayı olmayan değer gönderilmez. |
| Sıra numarası | Hayır | Tam sayı girin; tam sayı olmayan değer gönderilmez. |
- Zorunlu alanlar boşken altında "Bu alan zorunlu" yazar ve Kaydet düğmesi pasif kalır. Bu not kutu açılır açılmaz görünür; alanı doldurduğunuzda kaybolur.
- Kutudaki Metotları yönet ve Mesaj kodlarını yönet düğmeleri ilgili paneli açar; panelde yaptığınız ekleme, kutudaki listelere de yansır.
- Listede görünen Mesaj ve Eylem kolonları bu kutuda düzenlenmez.
Sık karşılaşılan durumlar
- "Yeni kural" düğmesini göremiyorum. Hesabınızda kural yazma yetkisi yoktur; ekran salt okunur açılır. Yöneticinizden yetki isteyin.
- Entegrasyon metodu listesi kapalı. Önce Entegrasyon'u seçin; metot listesi seçtiğiniz entegrasyona göre açılır.
- Aradığım entegrasyon listede yok. Kural kutusunda yalnızca ürün gönderimi yapan entegrasyonlar gösterilir.
- Kullanmak istediğim mesaj kodu önerilerde yok. Kodu yine de yazabilirsiniz; kural kaydedilir. Kodun listede görünmesini istiyorsanız Mesaj kodlarını yönet ile ekleyin.
- Liste boş geliyor. "Kayıt bulunamadı" görünüyorsa filtrelere uyan kural yoktur. Temizle ile filtreleri kaldırıp yeniden deneyin.
- "Raporlama servisi tanımlı değil" yazıyor. Ekranın bağlı olduğu servis bu kurulumda tanımlanmamıştır; liste yerine yalnızca bu uyarı görünür. Bu bir arıza değildir; yöneticinize başvurun.