Bu makaledeki modül: iFlow Docs
SAP CPI'da Deploy Sonrası: Deploy İzleyici, Paket Belgeleri, Sistem Görünümü ve Excel'de Value Mapping
Bir iFlow'un ne zaman Started olduğunu veya neden başarısız olduğunu görün, Cloud ya da Edge runtime'ını seçin, yeni tasarım denetimlerini çalıştırın, bir paketin tamamını sistem görünümüyle belgeleyin, Value Mapping'leri Excel'e aktarın ve istediğiniz aracı kapatın.
SAP Cloud Integration'da (SAP CPI) Deploy'a basmak bir bekleyişi başlatır: Monitor'e geçin, iFlow'u bulun, Started veya Error yazana kadar yenileyin, sonra hatanın ne anlama geldiğini çözün. Bir arayüz bittiğinde de biri mutlaka belgeyi, sistem görünümü resmini ve Value Mapping'i bir elektronik tabloda ister.
Kitegra artık işin bu kısmını SAP Integration Suite tasarımcısının yanında üstleniyor: test çağrılı bir deploy izleyici, Edge Integration Cell'li tenant'lar için bir runtime seçici, yeni tasarım denetimleri, sistem görünümü diyagramı ve dokümantasyon hazırlığı içeren bir paket belgesi, Excel'de bir Value Mapping sayfası ve Groovy betiklerinin sade bir dille açıklaması. Her araç tek tek kapatılabilir. Bu yazı hepsini tek tek ele alır.
Deploy izleyici: iFlow'dan ayrılmadan Started veya Error
Tasarımcıda her zamanki gibi Deploy'a basın ve SAP'nin iletişim kutusunu onaylayın. "Dağıtılıyor…" ifadesi ve geçen süreyle bir Dağıtım bildirimi belirir ve siz çalışmaya devam edersiniz. Kitegra üç saniye sonra SAP'ye durumu sorar, ardından giderek daha seyrek, en fazla 20 saniyede bir sorar. SAP yanıt verdiğinde bildirim şuna dönüşür:
- Started, dağıtılan sürümle birlikte. iFlow'un bir HTTP endpoint'i varsa Test çağrısı gönder, isteği hazır olarak HTTP Runner'ı açar; Son mesajı göster ise Mesajlar panelini yenilenmiş olarak açar.
- Hata, SAP'nin hata metniyle ve bilinen bir durumsa genellikle ne anlama geldiğiyle: başka bir dağıtılmış iFlow gönderici adresini zaten kullanıyordur, bir betik derlenmiyordur, dışsallaştırılmış bir parametrenin değeri yoktur ya da SAP iFlow'u derleyememiştir. SAP’de dağıtılmış içeriği aç sizi ayrıntılara götürür.
- On dakika sonra Hâlâ dağıtılıyor, SAP'deki dağıtılmış içeriğe bir yönlendirmeyle.
SAP'nin Deploy iletişim kutusunu iptal ederseniz hiçbir şey izlenmez. İzleyici yalnızca dağıtım durumunu okur; dağıtımı kendi tıklamanızla başlayan SAP yapar. Sonrasında bir mesajı iFlow boyunca izlemek bir mesajı adım adım izlemek yazısında, çağrının kendisi ise bir HTTPS iFlow'unu service key ile test etmek yazısında anlatılır.
Runtime seçici: Cloud veya Edge
Edge Integration Cell'li bir tenant, iFlow'ları birden fazla runtime'da çalıştırır. Yalnızca böyle bir tenant'ta Kitegra kutusu Çalışma zamanı: Cloud (veya Edge runtime'ının adını) gösterir. Runtime'ı orada seçin; Message Monitor bu iFlow'un mesajlarını o runtime'da okur ve log seviyesini orada ayarlar. Seçici ayrıca her birinde dağıtılıp dağıtılmadığını ve hangi sürümün dağıtıldığını gösterir. Tek runtime'lı tenant'lar onu hiç görmez.
iFlow Inspector'da yeni tasarım denetimleri
iFlow inceleme kontrol listesi, yeni bir Dokümantasyon kategorisiyle beş denetim kazandı:
| Denetim | Neden önemli |
|---|---|
| Adresi olmayan alıcı (hata) | iFlow dağıtılır, ancak bu alıcıya yapılan her çağrı çalışma zamanında başarısız olur. |
| Varsayılan adresli HTTPS gönderici (uyarı) | Boş, / veya /test gibi yer tutucu bir adres çağıranlara hiçbir şey söylemez ve iki iFlow bu adreste çakışabilir. |
| HTTPS gönderici bir CSRF token'ı bekliyor (bilgi) | Her çağıran önce bir X-CSRF-Token almalıdır, yoksa POST isteği 403 alır. |
| Alıcı adresi iFlow'a yazılmış (bilgi) | DEV, QA ve PROD arasında taşımak iFlow'u düzenlemek demektir; Externalize Parameters bunu tek adımda düzeltir. |
| Katılımcı varsayılan adını koruyor (bilgi, Dokümantasyon) | "Sender" ve "Receiver" izlemede de görünür, bu yüzden kimse hangi sistemin kastedildiğini anlayamaz. |
Diğer denetimler gibi bunlar da puana dahil edilir ve tek tek kapatılabilir. Görüntülemek ücretsizdir; raporu dışa aktarmak Pro'ya dahildir. Externalize Parameters ve diğer yeni Helper araçları Externalize Parameters, adım kopyalama ve Hub içe aktarma yazısında anlatılıyor.
Tüm paket için bir belge
Kitegra menüsünde Bu iFlow'u belgele'nin yanında artık Paket belgesi de var. Açık iFlow'un paketindeki her iFlow'u tek tek okur ("iFlow okunuyor (2 / 5)…") ve onu durdurup o ana kadar okunanları açabilirsiniz. Okunamayan iFlow'lar listelenir. Belge, tek bir iFlow'un teknik tasarım belgesi gibi yeni bir sekmede Word, PDF veya HTML olarak açılır ya da kendi Word şablonunuza doldurulur. Paketin sürümünü, sağlayıcısını, etiketlerini ve iFlow sayısını, ardından her iFlow'u ve iki yeni bölümü içerir:
- Sistem görünümü: solda göndericilerin, ortada paketin iFlow'larının ve sağda alıcıların yer aldığı bir diyagram. Aynı adlı katılımcılar tek bir kutu olur ve her çizgi adaptör türlerini taşır.
- Dokümantasyon hazırlığı: okuyucunun ihtiyaç duyduğu şeyler, tek tek denetlenir: paketin açıklaması ve etiketleri, her iFlow için bir açıklama, Sender ve Receiver yerine yeniden adlandırılmış katılımcılar ve dışsallaştırılmış alıcı adresleri. Kaç denetimin geçtiğini ve neyin eksik olduğunu gösterir; böylece teslim etmeden önce boşlukları doldurabilirsiniz.
Excel'de Value Mapping
iFlow Docs sayfasında, Value Mapping'ler altında bir Value Mapping ZIP'i (SAP'de paketinden indirin) veya onun value_mapping.xml dosyasını yükleyin. Kitegra değerleri listeler ve her ajans ve tanımlayıcı çifti için bir sayfa içeren bir Excel çalışma kitabı yazar: kaynak ajans, tanımlayıcı ve değer, ardından hedef ajans, tanımlayıcı ve değer. Dosya tarayıcınızda okunur; SAP'den hiçbir şey okunmaz ve hiçbir yere bir şey gönderilmez. Message Mapping sayfası eşlemeler için aynı şekilde çalışır.
Sade bir dille açıklanan betikler
Kitegra menüsündeki Betikleri açıkla, iFlow'un her Groovy betik adımını listeler. Her biri için yazarın özet yorumunu, tanımladığı fonksiyonları, neyi okuduğunu (gövde, header'lar, exchange özellikleri, ekler), neyi ayarlayıp değiştirdiğini, ana mantığını (XML veya JSON ayrıştırma ya da oluşturma, döngüler, kararlar, HTTP çağrıları, tarihler), Security Material, Value Mapping veya Partner Directory gibi kullandığı SAP API'lerini ve notları ve riskleri gösterir. Bir adımın adına tıklayarak onu diyagramda seçin. Açıklama, betiğin metninden tarayıcınızda çıkarılır; betik hiçbir yere gönderilmez.
Kullanmadığınız her aracı kapatın
Seçenekler sayfasında artık her araç için bir anahtar içeren ve araçları modüllerinin altında toplayan bir Araçlar bölümü var: Helper'daki XPath denetimi, düzenleme, Security Material, Externalize, adım kopyalama ve yapıştırma ve Hub içe aktarmasından; Mesajlar, runtime seçici, günlük görüntüleyici ve deploy izleyici, iFlow bilgisi, Inspector ve Arama, Belgeler ve Betik açıklaması üzerinden; Toolbox'taki Notlar, Kod parçaları, Karşılaştırma, Dönüştürme, Üretme ve HTTP Runner'a kadar. Kapatılan bir araç tasarımcıdan ve açılır pencereden hemen kaybolur; verileriniz kalır ve Tümünü aç her şeyi geri getirir. Bir modülün tamamını kapatmak için aynı sayfadaki Modüller'i kullanın; bkz. seçenekler sayfası.
Deploy izleyici, runtime seçici, Betik açıklaması ve tasarım denetimlerini görüntülemek ücretsizdir. Paket belgesi, sistem görünümü ve Value Mapping sayfası iFlow Docs'a aittir; Free ve Starter'da birkaç kullanım hakkı vardır. Kitegra'in lansman döneminde oturum açan herkes tüm araçları kullanabilir. Planları karşılaştırın.
Bir sonraki iFlow'unuzda deneyin
Kitegra'in SAP Integration Suite tasarımcısının çevresine neler eklediğini veya iFlow yazmak için yeni araçlarını okuyun.
Sık sorulan sorular
Kitegra iFlow'umu dağıtır mı?
Hayır. Deploy'a SAP'de siz basarsınız; deploy izleyici yalnızca dağıtım durumunu okur ve iFlow Started olduğunda veya başarısız olduğunda size haber verir.
Bir SAP CPI paketinin tamamını nasıl belgelerim?
Paketin herhangi bir iFlow'unu açın ve Kitegra menüsünden Paket belgesi'ni seçin. Her iFlow'u okur ve sistem görünümü diyagramını ve dokümantasyon hazırlığını içeren tek bir belgeyi Word, PDF veya HTML olarak açar.
Bir Value Mapping'i Excel'e aktarabilir miyim?
Evet. Value Mapping ZIP'ini SAP'de paketinden indirin ve iFlow Docs sayfasına yükleyin. Her ajans ve tanımlayıcı çifti için bir sayfa elde edersiniz; dosya tarayıcınızdan hiç çıkmaz.
Runtime seçiciyi neden görmüyorum?
Yalnızca Cloud artı Edge Integration Cell gibi birden fazla runtime'ı olan tenant'larda görünür.
Bir aracı kapatırsam verilerim silinir mi?
Hayır. Araç tasarımcıdan ve açılır pencereden kaybolur, verileri ise kalır. Seçenekler sayfasının Araçlar bölümünden yeniden açın.