Mesaj eşlemesi

Entegrasyon hata mesajlarını kullanıcıya gösterilecek açıklamalara eşleyin; eşleme ekleyin, düzenleyin, silin ve ilgili logları görün.

Mesaj eşlemesi ekranı, entegrasyonlardan (fatura, kargo, ERP gibi) dönen teknik hata mesajlarını kullanıcının anlayacağı bir açıklamaya çevirdiğiniz yerdir. Bir entegrasyon işlemi hata verdiğinde, hata mesajı ve kaynağı bir eşlemeyle örtüşüyorsa kullanıcıya ham hata yerine eşlemedeki açıklama gösterilir. Ekranı genellikle entegrasyon hatalarını izleyen operasyon ve destek ekipleri kullanır.

Ekrana ulaşma

Menüde ComHub – Pazaryeri Entegrasyonu › Hata logları › Mesaj eşlemesi yolunu izleyin.

Eşlemeye Log mesajları ekranındaki bir log kaydının detayından da ulaşabilirsiniz: orada eşlemesi olmayan bir mesaj için eşleme ekleyebilir ya da var olan eşlemeyi düzenleyebilirsiniz. Açılan kutu bu ekrandakiyle aynıdır.

Menüde görmüyorsanız hesabınızın bu ekrana yetkisi yoktur.

Ekranın bölümleri

• Uyarı şeridi (yalnızca eşleme yazamıyorsanız): En üstte, neden eşleme ekleyip değiştiremediğinizi yazar (ayrıntı için aşağıdaki "Ne zaman pasif olur" bölümüne bakın).
• Başlık: Mesaj eşlemesi ve altında "Entegrasyon hata mesajlarının kullanıcıya gösterilecek açıklamaya eşlenmesi." açıklaması.
• Filtre alanı: Hata mesajında geçen, Eylemde geçen ve Kaynak alanları; altta Temizle ve Filtrele düğmeleri.
• Liste: Üstte Her sayfada seçimi, "Filtreleme sonucu: … kayıt" sayısı, Yeni eşleme düğmesi, yenileme simgesi ve Sütunlar menüsü; altında eşlemeler ve sayfalama.
• Not: Listenin altında eşlemenin nasıl uygulandığını özetleyen kısa bir açıklama yer alır.

Eşleme nasıl uygulanır

Her eşleme dört bilgiden oluşur: hata mesajı, kaynak, kullanıcıya gösterilecek eylem metni ve isteğe bağlı sıra numarası.

• Bir log mesajına, hata mesajı ve kaynağı birebir aynı olan eşleme uygulanır. Büyük/küçük harf ayırt edilmez; ancak metnin geri kalanı, baştaki ve sondaki boşluklar dahil, aynı olmalıdır.
• Aynı mesaj ve kaynak için birden fazla eşleme varsa sıra numarası en küçük olan uygulanır.
• Eylem metnine … yazarsanız bu yer tutucu, kullanıcıya gösterilirken asıl hata metniyle doldurulur. Örneğin eylem "Kargo firması şu hatayı döndü: …" ise kullanıcı hata metnini açıklamanın içinde görür.

Değişiklik canlı ortama hemen yansır. Kaydettiğiniz ya da sildiğiniz eşleme, o hataya düşen siparişlerde kullanıcıya gösterilen açıklamayı hemen değiştirir. Onay adımında da bu uyarı gösterilir.

Filtreleme ve arama

Alanlara yazdığınız değerler hemen uygulanmaz. Filtrele düğmesine basın ya da bir alandayken Enter'a basın. Temizle tüm filtreleri kaldırır ve listeyi yeniden getirir.

Liste

• Hata mesajı ve Eylem (kullanıcıya gösterilen) kolonlarında uzun metinler iki satırda kesilir; imleci hücrenin üzerine getirdiğinizde metnin tamamı görünür.
• Sayfa boyutu varsayılan olarak 25'tir; Her sayfada seçiminden 10, 50 ya da 100 seçebilirsiniz.
• Sütunlar menüsünden Hata mesajı dışındaki kolonları gizleyebilirsiniz; seçiminiz tarayıcınızda saklanır.
• Kolon başlıklarına tıklayarak sıralama yapılamaz.
• Bir satıra tıkladığınızda Eşlemeyi düzenle kutusu açılır. Yazma yetkiniz yoksa kutu yine açılır, ancak Devam ve Sil düğmeleri pasiftir; kaydı yalnızca inceleyebilirsiniz.

İşlemler

Satırın en sağındaki üç nokta (Satır işlemleri) menüsünde üç seçenek bulunur: Düzenle (yazma kapalıysa Görüntüle), Bu hataya düşen loglar ve Sil.

Bütün yazma işlemleri iki adımlıdır: önce form, sonra ne yazılacağını gösteren onay kutusu. Onaylamadan hiçbir değişiklik kaydedilmez.

Yeni eşleme ekleme

Kullanıcıya ham ve anlaşılmaz bir hata gösteriliyorsa, bu hata için açıklama tanımlamak üzere kullanın.

1. Listenin üstündeki Yeni eşleme düğmesine basın. Eşleme ekle kutusu açılır; üstünde "Hata mesajı ve kaynak, log mesajıyla birebir eşleşmelidir." yazar.
2. Hata mesajı alanına entegrasyondan dönen metni birebir yazın ya da yapıştırın.
3. Eylem (kullanıcıya gösterilen) alanına kullanıcının göreceği açıklamayı yazın. Hata metnini açıklamanın içine eklemek isterseniz … yazın; kutuda Önizleme bölümü açılır ve metnin nasıl görüneceğini gösterir.
4. Kaynak alanına hatanın geldiği kaynağı yazın. Alana yazmaya başladığınızda kayıtlı kaynaklar öneri olarak listelenir.
5. Gerekiyorsa Sıra alanına bir tam sayı girin.
6. Devam düğmesine basın. Eksik ya da hatalı alan varsa altında kırmızı uyarı çıkar ve bir sonraki adıma geçilmez.
7. Eşleme kaydedilsin mi? onay kutusunda kaynak, hata mesajı, eylem ve sıra bilgilerini kontrol edin ve Kaydet'e basın.

Kayıt başarılı olursa "Eşleme eklendi" bildirimi görünür, kutu kapanır ve liste yenilenir. Onay adımında Vazgeç'e basarsanız forma geri dönersiniz; girdiğiniz bilgiler kaybolmaz.

En kolay yol, eşlemeyi Log mesajları ekranındaki log detayından eklemektir; orada hata mesajı ve kaynak kayıttan hazır gelir, yazım farkından kaynaklanan eşleşmeme riski ortadan kalkar.

Eşlemeyi düzenleme

1. Satıra tıklayın ya da satır menüsünden Düzenle'yi seçin. Eşlemeyi düzenle kutusu, eşlemenin mevcut değerleriyle açılır.
2. Alanları değiştirin ve Devam'a basın.
3. Eşleme kaydedilsin mi? onay kutusunda No dahil bilgileri kontrol edip Kaydet'e basın.

Sonuçta "Eşleme güncellendi" bildirimi görünür, kutu kapanır ve liste yenilenir. Kutuyu Vazgeç ile kapatırsanız değişiklikler kaydedilmez.

Eşlemeyi silme

Artık gerekmeyen ya da yanlış tanımlanmış bir eşlemeyi kaldırmak için kullanın.

1. Satır menüsünden Sil'i seçin ya da düzenleme kutusunun sol altındaki Sil düğmesine basın.
2. Eşleme silinsin mi? onay kutusunda No, kaynak ve hata mesajını kontrol edin.
3. Sil'e basın.

"Eşleme silindi" bildirimi görünür ve liste yenilenir. Silme geri alınamaz; eşlemeye yeniden ihtiyaç duyarsanız yeniden eklemeniz gerekir. Silme onayında Vazgeç'e basarsanız satır menüsünden geldiyseniz kutu kapanır, düzenleme kutusundan geldiyseniz forma dönersiniz.

Bu hataya düşen logları görme

Bir eşlemenin gerçekte hangi hatalarda kullanıldığını görmek için satır menüsünden Bu hataya düşen loglar'ı seçin. Log mesajları ekranı, bu hata mesajıyla birebir eşleşen ve Kaynak filtresi eşlemenin kaynağına ayarlanmış olarak açılır. Ekranın üstünde "Yalnız şu mesajla birebir eşleşen kayıtlar:" satırı ve Süzgeci kaldır düğmesi görünür; bu düğme yalnızca mesaj süzgecini kaldırır, Kaynak seçimi kalır.

Log mesajları ekranının kendi tarih kuralı geçerlidir: tarih seçmezseniz son 10 günün kayıtları aranır. Daha eski kayıtları görmek için orada tarih aralığını genişletin.

Ne zaman pasif olur

Yeni eşleme, satır menüsündeki Sil ve kutudaki Devam, Sil ve Kaydet düğmeleri şu durumlarda devre dışıdır:

• Hesabınızın eşleme yazma yetkisi yoksa: "Eşleme eklemek ya da değiştirmek için yönetici yetkisi ve eşleme yazma izni gerekiyor."
• Eşleme yazması bu ortamda kapalıysa: "Eşleme yazması bu ortamda kapalı; kayıtlar yalnız görüntülenebilir."

Bu durumda ekranın üstünde ve kutunun içinde nedeni yazan uyarı görünür; Yeni eşleme düğmesinin üzerine geldiğinizde de aynı neden gösterilir. Kayıtları yine açıp inceleyebilir, Bu hataya düşen loglar ile ilgili logları görebilirsiniz.

Eşleme kutusu alanları

Hata uyarıları Devam'a ilk bastığınızda görünür: "Zorunlu alan", "En fazla 100 karakter" ya da "Tam sayı olmalı".

Hata mesajı alanıyla ilgili iki ek uyarı çıkabilir:

• Mesaj yalnız boşluktan oluşuyorsa: "Hata mesajı yalnız boşluktan oluşuyor. Bu, boş yanıt dönen hataları eşlemek için bilerek kullanılabilir."
• Mesajın başında ya da sonunda boşluk varsa: "Hata mesajının başında ya da sonunda boşluk var; olduğu gibi kaydedilecek."

Bu uyarılar kaydı engellemez; yalnızca farkında olmanız içindir. Eşleşme boşluklara duyarlı olduğundan, istemeden eklenmiş bir boşluk eşlemenin hiç uygulanmamasına yol açabilir.

Onay kutusunda hata mesajındaki boşluklar görünür simgelerle gösterilir (· boşluk, → sekme, ↵ satır sonu), böylece tam olarak ne kaydedileceğini görürsünüz.

Sık karşılaşılan durumlar

• Eşleme ekledim ama kullanıcı hâlâ ham hatayı görüyor. Hata mesajı ve kaynak, log kaydındakiyle birebir aynı olmalıdır. Baştaki/sondaki boşlukları ve kaynak yazımını kontrol edin. Eşlemeyi log detayından eklemek bu tür farkları önler. Aynı mesaj ve kaynak için sıra numarası daha küçük başka bir eşleme varsa o uygulanır.
• Düğmeler soluk, eşleme ekleyemiyorum. Ekranın üstündeki uyarıyı okuyun. Yazma bu ortamda kapalıysa değişiklik yapılamaz; yetki eksikse yöneticinizden yetki isteyin.
• "Eşleme kaydedilemedi" bildirimi çıktı. Değişiklik yapılmadı. Kaydetmede kutu forma döner ve girdikleriniz korunur; bildirimdeki ayrıntıyı kontrol edip yeniden deneyin. Bildirim "Eşleme yazması bu ortamda kapalı…" diyorsa bu ortamda yazma kapalıdır.
• "Eşleme yok" görünüyor. Filtrelere uyan eşleme yoktur. Temizle ile filtreleri kaldırın ya da yeni eşleme ekleyin.
• Filtrelediğim mesaj bulunamıyor. Kaynak filtresi birebir eşleşme ister; farklı bir kaynak seçili olabilir. Kaynak'ı Tümü yapıp yeniden deneyin.
• Liste yerine "Bir şeyler ters gitti" yazıyor. Eşlemeler o an okunamadı. Tekrar dene düğmesine basın; sorun sürerse sistem yöneticinize bildirin.

İlgili ekranlar

• Log mesajları
• Mesaj kuralları
• API istek logları (S3)
• Loglar
• Liste ekranlarını kullanma