İçeriğe geç
← Bloga dön

Bu makaledeki modül: iFlow Docs

SAP CPI Message Mapping Dokümantasyonu: Tek Tıkla Excel Eşleme Tablosu

Bir SAP CPI Message Mapping'ini eşleme tablosu olarak belgeleme: önemli sütunlar, fonksiyonların ve bağlamların nasıl tanımlanacağı ve tablonun Excel'e nasıl aktarılacağı.

SAP CPI Message Mapping Dokümantasyonu: Tek Tıkla Excel Eşleme Tablosu

Eşleme belirtimi genellikle bir arayüzün ilk belgesidir ve güncelliğini ilk yitiren de odur. SAP Cloud Integration'daki (SAP CPI) Message Mapping geliştirme ve testler sırasında değişir, onu tanımlayan elektronik tablo ise olduğu gibi kalır.

Bu makale bir eşleme tablosunun ihtiyaç duyduğu sütunları, fonksiyonların, bağlamların ve value mapping'lerin okuyucunun takip edebileceği şekilde nasıl tanımlanacağını ve tablonun eşlemenin kendisinden nasıl dışa aktarılacağını anlatıyor.

Eşleme belirtimleri neden kayar

Bir eşleme belirtimi, eşleme var olmadan önce, iş alanlarını bilen biri tarafından yazılır. Sonra geliştirici bir alanın bağlam değişikliğine, bir tarihin başka bir biçime, bir kodun da bir value mapping'e ihtiyaç duyduğunu fark eder. Bu kararların her biri eşleme düzenleyicisinin grafik görünümünde yaşar ve pek azı tabloya geri döner.

Bir eşleme tablosunun ihtiyaç duyduğu sütunlar

Sütunİçine ne yazılır
Hedef alanAlanın hedef mesajdaki tam yolu
TekrarKaç kez görünebileceği, örneğin 0..1 veya 1..unbounded
Kaynak alanlarDeğerin geldiği kaynak yollar
KuralMantığın sade bir dille anlatımı
FonksiyonlarKullanılan standart fonksiyonlar, örneğin concat, if veya formatByExample
SabitlerEşlemeye yazılmış sabit değerler
UDF'lerKullanıcı tanımlı fonksiyonlar ve ne yaptıkları
Value MappingBir value mapping üzerinden çevrilen kodlar
NotlarBağlam değişiklikleri ve bir test uzmanının bilmesi gereken her şey

Fonksiyonları, bağlamları ve value mapping'leri tanımlama

  • Kuralı bir cümle olarak yazın: “FirstName ve LastName'i bir boşlukla birleştirir” ifadesini kontrol etmek, bir fonksiyon adları listesini kontrol etmekten daha kolaydır.
  • Bağlam değiştiğinde bunu belirtin. Her kalem için bir kez doldurulan bir alan, her belge için bir kez doldurulan bir alandan farklı davranır ve eşleme hatalarının çoğu orada saklanır.
  • Value mapping'ler için ajansları ve tanımlayıcıları belirtin; böylece test uzmanı hangi tabloya bakacağını bilir.
  • Kullanıcı tanımlı bir fonksiyon için nasıl yazıldığını değil, neyi ne zaman döndürdüğünü söyleyin.

Tabloyu eşlemeden dışa aktarın

  1. iFlow'u tasarımcıda açın, “Kitegra araçları” düğmesine tıklayın ve “Bu iFlow'u belgele”yi seçin.
  2. iFlow belgesi sayfasında Eşleme tablosu'nu açın. iFlow'un Message Mapping'lerini, her hedef alan için bir satır olmak üzere yukarıdaki sütunlarla listeler.
  3. Her eşleme için bir sayfa içeren bir Excel çalışma kitabı olarak indirin.
  4. Tasarımcı olmadan bunun yerine “Eşleme yükle (.mmap veya ZIP)” seçeneğini seçin. Yüklenen bir dosya planınızın iFlow'larına sayılmaz.

Tablo eşleme dosyasından oluşturulur; bu yüzden eşlemenin bugün ne yaptığını gösterir. Onu aynı iFlow'dan oluşturulan teknik tasarım belgesiyle birlikte okuyun.

Teslim etmeden önce tabloyu kontrol edin

  1. Birkaç satırı bir test mesajıyla karşılaştırın: kaynak değer, kural, hedef değer.
  2. iFlow'u TRACE ile çalıştırın ve bir mesajı adım adım trace etme makalesindeki gibi eşleme adımından önceki ve sonraki body'yi okuyun.
  3. Okuyucunun kuraldan fazlasına ihtiyaç duyduğu yerlerde Notlar sütununu doldurun: bir alanın neden sabit olduğu, bir kod listesinin hangi sisteme ait olduğu.

Kitegra nasıl yardımcı olur

Eşleme tablosu, Kitegra uzantısının iFlow Docs alanının bir parçasıdır. Tarayıcınızda oluşturulur; eşlemeler asla Kitegra'e gönderilmez.

Helper, Message Monitor, iFlow Inspector ve iFlow Docs, kullandığınız iFlow'ları her biri ayrı sayar: Kitegra hesabı olmadan modül başına 5, Free planında 50, Starter'da 100 ve Pro'da 300; Business'ta sınır yoktur. Toolbox ve çalışma alanı ekstraları ücretsizdir. Planları karşılaştırın.

Bir sonraki iFlow'unuzda deneyin

Kitegra'ın SAP Integration Suite tasarımcısının çevresine neler eklediğini okuyun veya onu Kitegra'in diğer Chrome uzantılarıyla birlikte görün.

Sık sorulan sorular

Bir SAP CPI Message Mapping'ini nasıl belgelerim?

Her hedef alan için bir satır içeren bir eşleme tablosu olarak: hedef yol, tekrar, kaynak alanlar, sözlü kural, fonksiyonlar, sabitler, UDF'ler, value mapping'ler ve notlar.

Bir Message Mapping'i Excel'e aktarabilir miyim?

Evet. iFlow belgesi sayfasında Eşleme tablosu, her eşleme için bir sayfa içeren bir Excel çalışma kitabı olarak indirilir.

Bir eşlemeyi tasarımcı olmadan belgeleyebilir miyim?

Evet. Bir .mmap dosyası veya eşlemeler içeren bir ZIP yükleyin; bir yükleme planınızın iFlow'larına sayılmaz.

Tablo kullanıcı tanımlı fonksiyonları açıklıyor mu?

Her alanın kullandığı UDF'leri listeler. Bir UDF'nin iş açısından ne yaptığını Notlar sütununa bir satırla yazmaya değer.

Eşlemelerim Kitegra'e gönderiliyor mu?

Hayır. Tablo tarayıcınızda oluşturulur ve eşlemeler asla gönderilmez.

Tasarımcıdan ayrılmadan iFlow'lar üzerinde çalışın

Kitegra'i Chrome'a veya Microsoft Edge'e ekleyin. Ücretsiz başlayın, hesap gerekmez.