Kitegra 2.0: SAP CPI için Otomatik Tamamlama, Mesaj Trace, iFlow Inspector ve Dokümantasyon

SAP Integration Suite tasarımcısında bir iFlow oluşturmak, tasarımcıdan sık sık ayrılmak demektir: bir mesajın ne yaptığını görmek için izleyiciye, eşleme belirtimi için bir elektronik tabloya, uç noktayı çağırmak için başka bir araca, hangi adlandırma kuralının geçerli olduğunu sormak için bir iş arkadaşına. Kitegra, bu işi düzenlediğiniz diyagramın yanına getiren bir Chrome ve Edge uzantısıdır.

Sürüm 2.0 ile uzantı tek bir modülden beş alana büyüyor. Bu makale her alanın ne yaptığını, uzantının tenant'ınızda neyi ne zaman değiştirdiğini, neyi sakladığını ve neyi eşitlediğini ve her planın kaç iFlow'u kapsadığını açıklıyor. Uzantı, Kitegra Chrome uzantılarından biridir.

iFlow tasarımcısının çevresinde beş alan

Bir iFlow açın; diyagram araç çubuğunda, görüntüleme ve düzenleme modunda bir Kitegra kutusu bulunur. Mesajlar, Günlükler ve iFlow bilgisi bu kutuda kendi düğmelerine sahiptir; diğer tüm araçlar son düğmenin arkasındaki menüdedir ve Alt+Shift+P bu menüyü klavyeden açar. Her araç, sayfada taşıyabileceğiniz bir panel açar. Araçlar beş alana aittir:

• Helper (Integration Flow Helper): tasarımcının kendi alanlarındaki öneriler ve kontrollerle iFlow'ları daha hızlı yazın.
• Message Monitor: açık iFlow'un mesajları, trace kayıtları ve logları, tasarımcının içinde.
• iFlow Inspector: dağıtılan iFlow'un ayrıntıları, adlandırma ve tasarım kontrolleri ve arama.
• iFlow Docs: bir iFlow'dan veya Message Mapping'den oluşturulan belgeler.
• Toolbox (arayüzde “Araç kutusu”): payload karşılaştırmak, dönüştürmek ve oluşturmak için ücretsiz araçlar, ayrıca kod parçacıkları, notlar ve HTTP istekleri.

Her alan, seçenekler sayfasında Modüller altından kapatılabilir. Bunların çevresinde birkaç çalışma alanı ekstrası tenant'ı kullanmayı kolaylaştırır: bir ortam çubuğu, sekme markalaması, izleme bağlantıları ve klavye kısayolları.

Helper: iFlow'ları daha hızlı yazın

Tasarımcıdaki bir alana ${ veya $ yazın; iFlow'un o noktasına uyan adların listesi açılır. Helper'ın geri kalanı iFlow'unuzun aynı modeli üzerine kuruludur:

• Öneriler: iFlow'unuzun ayarladığı header'lar ve exchange property'ler, SAP ve Camel standart header'ları, {{…}} parametreleri, değişkenler, Data Store'lar ve kimlik bilgisi alanlarında Security Material ile Keystore adları.
• İfade kontrolü: kapatılmamış ifadeler, fazla boşluklar, geçerli adımdan önce hiçbir şeyin ayarlamadığı header'lar ve EDMX'te bulunmayan OData adları.
• Kaynaklar: örnek bir payload'dan XPath yolları, bir OpenAPI, Swagger veya Postman dosyasından URL'ler ve body'ler ve ProcessDirect ile JMS üzerinden aktarılan header'lar.
• Diyagramı düzenle: düzenleme modunda diyagramı tek tıkla toparlar; Save sonucu korur, yanındaki geri al düğmesi eski haline döndürür.

Önceki altı makale bunları daha ayrıntılı ele alıyor; işe SAP CPI'da Camel Simple ifadeleri makalesiyle başlayın.

Message Monitor: ne olduğunu görün

• Mesajlar: açık iFlow'un son mesajları, diyagramın yanındaki bir panelde durum, zaman ve süreyle birlikte; SAP'nin hatası “Genellikle anlamı:” altında açıklanır.
• Trace: tek bir anahtar iFlow'un log seviyesini TRACE yapar ve siz çalışırken açık tutar.
• Diyagramda: trace edilen bir mesajın geçtiği adımlar diyagramda renklendirilir; bir adıma tıklamak, o adımdan önceki body'yi, header'ları ve exchange property'leri gösterir.
• Mesaj logları: Message ID veya Correlation ID ile arama yapan bir log görüntüleyici, ilgili mesajların zaman çizelgesi ve diyagramda adım süreleri.

Bir mesajı adım adım trace etmek akışın tamamını gösterir.

iFlow Inspector ve iFlow Docs: inceleyin ve belgeleyin

• Adlandırma: ekibinizin üzerinde anlaştığı kurallar her adımda kontrol edilir; önerilen bir ad ve Yeniden adlandır düğmesiyle.
• Tasarım kontrolleri: hata yönetimi, düz metin sırlar, güvenli olmayan protokoller, betik riskleri ve daha fazlası; 0 ile 100 arasında bir puan, bir temel çizgi ve HTML, PDF veya Excel bir raporla. iFlow inceleme kontrol listesi bunları sıralar.
• iFlow bilgisi: dağıtım, uç noktalar, Data Store kayıtları, değişkenler ve düzenleme kilidi; gerektiğinde Undeploy, Unlock ve Sil ile.
• iFlow'da veya tüm paketinde arama.
• iFlow'dan oluşturulan, diyagramını ve her sürecin anlatımını içeren Word, PDF veya HTML bir tasarım belgesi ya da kendi Word şablonunuza doldurulmuş hali. Teknik tasarım belgesi oluşturma makalesine bakın.
• Message Mapping'ler için Excel'de bir eşleme tablosu ve açıklanmış betikler.

Toolbox ve çalışma alanı

• Mesaj karşılaştırma, bir biçim dönüştürücü, hata senaryoları da üretebilen bir test mesajı oluşturucu, Groovy kod parçacıkları ve bir kopya kâğıdı, ayrıca iFlow başına, tenant başına veya her yerde geçerli notlar.
• iFlow uç noktalarınız için, bir Process Integration Runtime service key'inden OAuth kullanan bir HTTP Runner.
• Tenant başına bir ortam çubuğu (PROD, TEST, DEV) ve sekme markalaması, izleme bağlantıları, klavye kısayolları ve özellik panelinin boyutu.

Arayüz, açık ve koyu modda 15 dilde kullanılabilir.

Adım adım nasıl başlanır

1. Kitegra'ı Chrome'a veya Microsoft Edge'e ekleyin.
2. Tenant'ınızda SAP Integration Suite tasarımcısında bir iFlow açın (bir *.hana.ondemand.com adresi).
3. Content Modifier değeri gibi bir alana tıklayın ve ${ veya $ yazın; listeden bir ad seçin.
4. Diyagram araç çubuğundaki Kitegra kutusunda Mesajlar, Günlükler veya iFlow bilgisi düğmesine tıklayın ya da Denetçi ve diğer araçlar için kutunun menüsünü açın.
5. Tenant'larınız, paketleriniz ve iFlow'larınız ile Toolbox sayfalarını içeren Araçlar görünümü için uzantının açılır penceresini açın.

Hesap olmadan her modülü 5 iFlow'da kullanabilirsiniz. Daha fazlasında kullanmak için uzantıda Kitegra ile oturum aç seçeneğini seçin.

Bir sonraki iFlow'unuzda deneyin

Kitegra'ı Kitegra'in diğer Chrome uzantılarıyla birlikte görün ve her planın neleri içerdiğini karşılaştırın.

Tenant'ınızda neyi, ne zaman değiştirir

Uzantı açık iFlow'u, mesajlarını ve loglarını kendi SAP oturumunuzla okur. Bir iFlow'un içeriğini asla kaydetmez, dağıtmaz veya düzenlemez: Yeniden adlandır ve kod parçacıkları yalnızca tasarımcının alanlarına yazar, kaydeden sizsiniz. Tenant'ınızı yalnızca adı belli dört işlemden birine tıkladığınızda değiştirir:

Seçenekler sayfasındaki tek bir anahtar, “Tenant'ı değiştiren işlemlere izin ver”, dördünü birden kapatır: düğmeleri kaybolur ve uzantı bu işlemleri reddeder. HTTP Runner yalnızca sizin yazıp gönderdiğiniz istekleri gönderir.

Neyi saklar, neyi eşitler

• Mesaj içeriği (body'ler, header'lar, özellikler, ekler ve loglar) sayfada gösterilir; asla saklanmaz veya bir yere gönderilmez.
• Kitegra hesabı olmadan hiçbir şey tarayıcınızdan çıkmaz.
• Oturum açtığınızda Kitegra, planınızın iFlow'larını saymak için açtığınız her iFlow'un adını ve kimliğini, paketini, tasarımcı bağlantısını, kullanılan modülleri, tarihleri ve SAP hesabınızın tek yönlü bir hash'ini saklar.
• Oturum açtığınızda yazdıklarınız sizi her bilgisayara takip eder: ayarlar ve kısayollar, notlar, adlandırma kuralları, tasarım kontrolü ayarları ve temel çizgileri, tenant markalaması, kod parçacıkları ve her kimlik doğrulama değeri ile gizli değişkeni çıkarılmış HTTP Runner koleksiyonları. Seçenekler sayfasındaki Kitegra kontrol paneli anahtarı açıkken (varsayılan olarak açıktır), paketlerinizin ve iFlow'larınızın adları ve kimlikleri de gönderilir; bir ekip planında ekip sahibi bunları ve notlarınızı görebilir.
• Asla gönderilmeyenler: mesaj içeriği, betikler, eşlemeler, örnek payload'lar, API belirtimleri, kimlik bilgileri ve sırlar. Seçenekler › Eşitleme altında “Eşitlenen verileri sil”, eşitlenenleri Kitegra'ten kaldırır.

Her plan kaç iFlow'u kapsar

Sınır, modül başına ve süresiz olarak farklı iFlow'ları sayar: daha önce kullandığınız bir iFlow'u yeniden açmak tekrar sayılmaz; bir modülün kullandığı bir iFlow ise başka bir modül tarafından ancak o modülü de üzerinde kullandığınızda sayılır.

Helper, Message Monitor, iFlow Inspector ve iFlow Docs iFlow sayar; Toolbox ve çalışma alanı ekstraları hiçbirini saymaz. Planınızın sınırını aşan bir iFlow, tasarımcıda ve açılır pencerede bir asma kilitle gösterilir. Kitegra'in lansman döneminde, oturum açan herkes Free planında bile tüm araçları kullanabilir. Kitegra ile oturum açtığınızda, hesap olmadan kullandığınız iFlow'lar hesabınıza taşınır. Planları karşılaştırın.

Sık sorulan sorular