SAP CPI'da Externalize Parameters, Adım Ayarlarını Kopyalama ve SAP Business Accelerator Hub'dan API İçe Aktarma

Bir SAP Cloud Integration (SAP CPI) iFlow'undaki en yavaş işlerin bazıları mantığın kendisi değildir. Aynı alıcı adresini üç tenant'a yazmak, on Content Modifier satırını bir iFlow'dan diğerine elle kopyalamak, geçen ay yazdığınız bir OData sorgusunu yeniden kurmak ya da yalnızca bir varlık kümesinin alanlarını öğrenmek için bir API belirtimini indirmektir.

Kitegra'in Helper'ı artık SAP Integration Suite tasarımcısının yanında bunların her biri için bir araç sunuyor: Externalize Parameters, OData sorgu şablonlarıyla adım ayarlarını kopyalama ve yapıştırma, SAP Business Accelerator Hub'dan içe aktarma, örnek payload'unuza karşı XPath denetimi ve Message Mapping ifadeleri için düzenleme. Bu yazı her birinin ne yaptığını, iFlow'unuzu ne zaman değiştirdiğini ve neyi sakladığını açıklar.

Tek adımda Externalize Parameters

Doğrudan bir alıcı kanalına yazılmış adres, iFlow DEV'den QA'ya ve PROD'a her taşındığında iFlow'un kendisini düzenlemek demektir. SAP'nin çözümü dışsallaştırılmış bir parametredir: alanda {{Receiver_OData_Address}}, değeri ise her tenant'ta Configure içinde ayarlanır. Externalize Parameters bu yazma işini sizin yerinize yapar.

Bir iFlow açın, SAP'de Edit'e basın ve Kitegra menüsünden Externalize Parameters'ı seçin. Panel, genellikle tenant'lar arasında farklılık gösteren sabit değerleri listeler:

• Adresler: URL'ler, host'lar, endpoint'ler, yollar, dizinler ve WSDL'ler. Proxy adresleri ile ProcessDirect veya JMS adresleri dışında bunlar sizin için işaretlenir.
• Diğer değerler: kuyruk ve Data Store adları, OData yolları ve sorguları, zaman aşımları, kimlik bilgisi adları ve takma adları ile portlar.
• Content Modifier ve Write Variables tablolarındaki sabitler.

Her değer, katılımcıdan ve alandan oluşturulan Receiver_OData_Address gibi önerilen bir ad alır; bu adı değiştirebilirsiniz. Zaten {{…}} veya ${…} olan değerler böyle gösterilir. Externalize'a tıklayın; işaretli alanlar açık iFlow'da parametre olur. iFlow'u SAP'de kaydedene kadar hiçbir şey kaydedilmez.

Bir çalıştırmadan sonra Geri al önceki değerleri geri getirir; Mevcut değerleri kopyala ise her parametreyi yerini aldığı değerle birlikte kopyalar: dağıtımdan sonra SAP, Configure'da her değeri sorar ve siz bunları oraya yapıştırırsınız. Geri al için iFlow başına son on çalıştırma saklanır. Bir alıcının adresi iFlow'a yazılmışsa iFlow Inspector'ın tasarım denetimleri bu araca yönlendirir.

Bir adımın ayarlarını başka bir adıma veya iFlow'a kopyalayın

Kitegra menüsünden Adım ayarlarını kopyala ve yapıştır'ı seçin, diyagramda bir adım seçin (veya panelde seçin) ve Ayarları kopyala'ya tıklayın. Kopya; adımın header'larını, exchange özelliklerini ve adaptör alanlarını içerir. Panel, bu tarayıcıdaki her tenant ve iFlow için son on kopyanızı en yenisi başta olacak şekilde saklar.

Yapıştırmak için SAP'de Edit'e basın, hedef adımı seçin ve İçine yapıştır'a tıklayın. Yazmadan önce panel değişecek alanları listeler. Her tablo için Koru, Satır ekle (yalnızca eksik olan kopyalanmış satırları ekler) veya Satırları değiştir seçeneğini seçersiniz. Bir kopya yalnızca aynı türdeki bir adıma yapıştırılır ve başka bir iFlow'a da gidebilir; bunun istisnası, geldikleri iFlow'un dosyalarını adlandıran EDMX yolu ve betik alanlarıdır. Geri al, son yapıştırmanın değiştirdiklerini geri getirir.

OData sorgu şablonları

Aynı panel OData sorgu şablonlarını da saklar. Sorgusunu kurduğunuz bir OData alıcı kanalını seçin, Sorguyu şablon olarak kaydet'e tıklayın ve bir ad verin. Bir şablon; işlemi, kaynak yolunu ve $select, $filter ve $expand gibi sorgu seçeneklerini saklar. Daha sonra, düzenleme modunda başka bir OData alıcısı seçip Uygula'ya tıklayın. Var olan bir adla kaydetmek o şablonun yerine geçer. Seçeneklerin kendisi için OData alıcısı sorgu seçenekleri yazısına bakın.

Kopyalar ve şablonlar bu tarayıcının uzantı depolamasında kalır. Kitegra hesabınızla eşitlenmez ve hiçbir yere gönderilmez.

SAP Business Accelerator Hub'dan bir API içe aktarın

Helper, bir EDMX'ten OData varlık kümelerini ve alanlarını, bir OpenAPI dosyasından da HTTP yollarını önerir. Hub içe aktarmasıyla artık bu dosyayı önce indirmeniz gerekmez. Uzantının açılır penceresinde bir iFlow'un Örnek payload ve API belirtimi sayfasını açın ve SAP Business Accelerator Hub'dan içe aktar bölümünü bulun.

1. İlk seferde Erişime izin ver'e tıklayın: tarayıcı bir kez api.sap.com erişimi ister. Siz onaylayana kadar Kitegra'in bu erişimi yoktur.
2. Bir API arayın, örneğin API_PRODUCT_SRV. Arama için oturum açmanız gerekmez.
3. İçe aktar'a tıklayın. Belirtimi indirmek için bu tarayıcıda api.sap.com'da oturum açmış olmanız gerekir; oturum açmadıysanız panel bunu söyler ve Hub'ı açar.

Ardından bir OData API'nin varlık kümeleri ve alanları, o iFlow'un kendi EDMX'i olmayan OData alıcılarında önerilir. Bir REST API'nin yolları ise, dosyayı siz yüklemişsiniz gibi HTTP alanlarında önerilir; bunu OpenAPI ve Postman yazısı anlatır. Belirtim iFlow başına, yalnızca bu tarayıcıda, en fazla 8 MB olarak saklanır ve Kaldır onu siler.

Örnek payload'unuza karşı denetlenen XPath

iFlow için kayıtlı bir örnek payload varsa Helper zaten ondan XPath yolları önerir. Artık yazdığınız XPath'i de denetler. Örnekteki hiçbir düğüm eşleşmezse alanın altında bir uyarı "Örnek yükte bu XPath ile eşleşen düğüm yok." der. Eşleşen bir düğüm varsa bir bilgi satırı bulunan değeri gösterir.

Denetim; Content Modifier header ve property'lerindeki ve Write Variables'taki XPath satırlarını, XML Router koşullarını ve XPath splitter'larını kapsar. Yalnızca kayıtlı örneğin o adıma gerçekten ulaşan içerik olduğu yerlerde çalışır: öncesinde yalnızca gövdeyi koruyan adımlar bulunan bir XML örneği ya da tek bir JSON to XML Converter'dan sonra gelen bir JSON örneği. Local Integration Process'lerde, Exception Subprocess'lerde ve ${…} veya {{…}} ile kurulan XPath'lerde sessiz kalır; böylece bir uyarı gerçek bir uyuşmazlık demektir.

Bir Message Mapping ifadesini düzenleyin

Bir düzine fonksiyon içeren bir Message Mapping ifadesi kısa sürede kesişen çizgilerden oluşan bir düğüme dönüşür. İfade tuvalinde artık SAP'nin kendi düğmelerinin yanında bir İfadeyi düzenle düğmesi bulunur. Düğümleri kaynak alanlardan hedefe doğru yerleştirir. Düzenleme modunda Save bu düzeni korur ve yanındaki geri al düğmesi eski haline getirir; görüntüleme modunda yalnızca okumanıza yardım eder ve SAP ifadeyi yeniden çizdiğinde düzen kaybolur. SAP'ye hiçbir şey kaydedilmez veya gönderilmez. iFlow diyagramının da düzenleme modunda, Geri al ile birlikte kendi Diyagramı düzenle düğmesi vardır.

iFlow'unuzda neler değişir

Externalize Parameters, yapıştırma ve şablon uygulama yalnızca düzenleme modunda, tasarımcıda açık olan iFlow'a yazar ve tasarımcı iFlow'u değişmiş olarak gösterir. Asla kaydetmez veya dağıtmaz: kaydetmeyi SAP'de siz yaparsınız ya da değişikliği bırakmak için Discard'a basarsınız. Bu araçların her biri seçenekler sayfasında, Araçlar altında tek tek kapatılabilir; kapatılan araç tasarımcıdan hemen kaybolur. Externalize, adım kopyalama ve yapıştırma ile Hub içe aktarması ücretli planlara dahildir, Free'de birkaç kullanım hakkı vardır; XPath denetimi ve düzenleme ücretsizdir. 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 Deploy'a bastıktan sonra ne yaptığını okuyun.

Sık sorulan sorular