SAP Integration Suite ile TCMB Kur Entegrasyonu

Amaç : SAP Integration Suite ürünü kullanarak TCMB’nin açık kaynak kodundan USD para biriminin güncel Türk Lirasına karşılık gelen kur bilgilerinin entegrasyonu

Integration Flow

Genel entegrasyon akışımız aşağıdaki şekilde olacaktır.

Sender : SAP ERP , Finansal Sistemler vs.. (Client)

Request – Reply : Client tarafından gelen istek için request-reply adımını tamamlayan fonksiyon.

Message Mapping : Reply adımından gelen(TCMB den gelen response) cevap için, data üzerinde istenen değişikliklerin yapılıp client ın istediği cevabı hazırlayan fonksiyon.

Receiver: Entegrasyon akışında mesajların gönderileceği hedef sistemi veya uygulamayı tanımlayan fonksiyon.

Adım 1: Client için Adapter Yapılandırması

SOAP (Simple Object Access Protocol): Web servisleri ile iletişim kurmak için kullanılan bir protokoldür.

Start Point: Entegrasyon akışında veri akışının başladığı noktadır ve genellikle dış sistemden gelen veri veya mesajları alan fonksiyondur.

Endpoint: Entegrasyon akışında veri akışının sona erdiği noktadır ve işlenmiş veri veya mesajları hedef sisteme gönderen fonksiyondur.

Adım 2: Request Reply Yapılandırması

Get Method: HTTP protokolü üzerinden veri almak için kullanılan bir yöntemdir. Bu yöntem, bir web sunucusundan veri talep eder.

Adım 3: Message Mapping Yapılandırması

İstediğimiz veriyi çağıracak özel bir mapping oluşturuyoruz.

Mapping’e başlamadan önce açık kaynak kodunu WSDL formata çeviriyoruz.

WSDL (Web Services Description Language): XML tabanlı bir dil olup, web servislerinin ne yaptığı, nerede bulunduğu ve nasıl erişildiği hakkında bilgi sağlar. WSDL belgesi, web servislerini tanımlamak için kullanılır ve bir web servisine bağlanmak için gerekli bilgileri içerir

USD para biriminin güncel Türk Lirasına denk düşen kuru çağıracak örnek mapping:

Bu mapping, "Currency" alanı "USD" olan ve güncel kuru gösterecek olan ForexBuying değeriyle eşleştiren ve belirlenen koşul sağlandığında ilgili değeri almayı ve işlemeyi mümkün kılan fonksiyonu oluşturur.

Adım 4: SOAP ile Veriyi Çağırma

Son adım olarak SOAP ile verimizi çağıracağız. Gerekli ayarlamaları yaptıktan sonra iflow’u çağırıyoruz ve istediğimiz sonucun çıktısını alıyoruz.

Alternatif Yöntem: "Filter" Kullanarak Veriyi Çağırma

Bu seçenekte yukarıda bahsettidilen adımlarlarda Message Mapping yerine Filter fonksiyonunu kullanacağız.

Filter: Entegrasyon akışında belirli koşullara uyan mesajların işlenmesini sağlayan ve uymayanları engelleyen fonksiyondur.

1-Filter Fonksiyonlarını Ekleme

Node: Node" kavramı, XML veya JSON gibi yapılandırılmış veri formatlarındaki belirli bir veri öğesini ifade eden fonksiyondur.

• İlk Filter fonksiyonuna USD para birimini çağıracak şekilde bir expression yazıyoruz ve Value Type’ı “Node” seçiyoruz.
• İkinci Filter fonksiyonuna bu alandan çağırmak istediğimiz değeri yazıyoruz.

SOAP üzerinden veriyi çağırdığımızda aşağıdaki gibi veri sorunsuz bir şekilde geliyor.

Bu yazımızda, Integration Suite üzerinde SOAP Adapter kullanarak USD para biriminin güncel Türk Lirası karşılığını nasıl çağıracağımızı öğrendik. İki farklı yöntemle (Message Mapping ve Filter) veriyi çağırma işlemlerini detaylandırdık.

SAP Integration Suite Danışmanlığı