Ana içeriğe atla

SOAP Metod Konfigürasyonu

Bu sekmede, seçilen API Proxy için
politikalar, protokol dönüşümü ayarları ve SOAP metod yönetimi işlemleri yapılabilir.
SOAP Metod Konfigürasyonu sekmesi

SOAP Metod İşlemleri

Her API Proxy, önüne koyulduğu Backend API’nin metodları için vekil olarak çalışan kendi metodlarına sahiptir. Eğer API Proxy, bir WSDL dosyası adresi verilerek ya da bu dosya yüklenerek oluşturulmuşsa, WSDL içerisinde tanımlı olan her metod için API Proxy üzerinde aynı isimde bir metod otomatik olarak oluşturulur. SOAP Metot ve endpoint listesinin görüntülendiği ekran Kullanıcılar aşağıdaki nedenlerle metodlara müdahale etmek isteyebilir:
  • Backend API’ye yeni metod(lar) eklenmesi
  • Backend API’den mevcut metod(lar)ın silinmesi
  • Backend API metod adlarının istemcilerden gizlenmek istenmesi
  • Backend API metodlarının tamamen ya da geçici olarak erişime kapatılmak istenmesi

SOAP Metod Seçme

Metod listesinde herhangi bir metodun adına tıklandığında ilgili metod seçilir ve arayüz buna göre güncellenir:
  1. Seçilen metod listede renk değişimi ile vurgulanır.
  2. Üst orta bölümde seçili metod bilgisi gösterilir.
  3. Alt orta bölümde metod için yapılabilecek işlemler listelenir.
  4. Sağ bölümde seçilen metodun Backend API’de karşılık geldiği metod görüntülenir.
SOAP metot ve endpoint seçme ekranı

SOAP Metod Ayarları Güncelleme

SOAP tipindeki API Proxy’lerde yalnızca metod güncelleme işlemi yapılabilir. SOAP metodlarına ait ayarlar, REST metod ayarlarından farklıdır. Aşağıda SOAP metodlarına özel ayar alanları gösterilmektedir: SOAP metod ayarları ekranı

SOAP Metod Ayarları Alanları

AlanAçıklama
SOAP ActionWSDL ayrıştırılırken elde edilen SOAPAction değeri. İstenirse manuel olarak değiştirilebilir.
İndirmeyi EtkinleştirYanıt Byte Array tipinde ise dosya olarak indirilmesini sağlar.
Compressed Response için Base64 KullanSıkıştırılmış yanıtlar için Base64 encode edilmiş text kullanımını sağlar.
Re-Parse’da YoksayRe-parse işlemlerinde bu metodun güncellenmemesini sağlar.
WSA AyarıWS-Addressing ayarlarının metod bazlı aktif edilmesini sağlar.
Must UnderstandSOAP mustUnderstand alanının ayarlanmasını sağlar.
VersiyonKullanılacak WS-Addressing versiyonunu belirtir.
Add Default ActionWSDL’den gelen varsayılan action değerini kullanır.
ActionSOAP mesajına özel action eklenmesini sağlar.
Add Default ToVarsayılan To bilgisinin eklenmesini sağlar.
ToSOAP mesajına özel To alanı eklenir.
Reply ToSOAP mesajına özel yanıt adresi eklenir.
Generate Message IDHer mesaj için otomatik Message ID üretir.
Message IDSabit bir Message ID kullanır.
FromSOAP mesajına özel From bilgisi ekler.
Fault ToSOAP hata mesajları için özel adres tanımlar.
Relates ToHata mesajları için ilişki bilgisi ekler.
Cache SettingsMetod bazlı önbellek ayarlarını aktif eder.
Cache Key TypeÖnbellek anahtarının nasıl oluşturulacağını belirler.
Variable ListÖzel önbellek anahtarı oluşturmak için kullanılır.
CapacityÖnbellekte tutulabilecek maksimum yanıt sayısı.
TTLÖnbellek geçerlilik süresi (saniye).
Cache Null ValueBoş yanıtların önbelleğe alınmasını sağlar.

SOAP Metod Silme

Bir SOAP metodunu silmek için Metodu Sil (Delete Method) bağlantısına tıklanır.
Onay işleminden sonra metod kalıcı olarak silinir.

SOAP Metod Geçici Olarak Kullanımdan Kaldırma

Bir metod silinmeden erişime kapatılabilir. Bunun için Metodu Devre Dışı Bırak (Disable Method) bağlantısı kullanılır. Bu işlem sonrası:
  1. Metod simgesi devre dışı durumunu gösterecek şekilde değişir.
  2. Metodu Etkinleştir (Enable Method) bağlantısı görünür hale gelir.
SOAP metodun devre dışı bırakılması ekranı

SOAP Metod Test Etme

  1. Endpointler Görüntülenir
    (Test Method) kullanılarak ilgili SOAP endpoint’leri görüntülenebilir ve test edilebilir.
SOAP endpoint listesinin görüntülendiği Test Method ekranı
  1. Test Method
    Test Method kullanılarak ilgili SOAP servisleri XML (SOAP Envelope) formatında manuel olarak test edilebilir.
SOAP servislerinin XML request ile manuel olarak test edildiği ekran Bir API Proxy en az bir ortama yüklenmişse, metodlar bu sekme üzerinden kolayca test edilebilir.
Metodu Test Et (Test Method) bağlantısına tıklandığında ilgili metod için Test Konsolu açılır.

Sonraki Adımlar