Ortak Özellikler

Top  Previous  Next

Doğrulama Tipi (MScript Kabul Eder)

Bu özellik SOAP çağrısı için kullanılacak olan doğrulama yöntemini belirler. Mevcut doğrulama yöntemleri

1.Temel Doğrulama
Bu doğrulama türünde sadece Kullanıcı Adı ve Şifre bilgilerini sağlamak yeterli olur.
2.WSS4J Doğrulaması. Java için Web Servis Güvenliği anlamına gelen bu doğrulama tipi seçildiğinde SOAP Zarfı mutlaka aşağıdaki gibi bir mesaj başlığı da içermelidir.

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">

<soap:Header>

<wsse:Security xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">

<wsse:UsernameToken>

<wsse:Username>${username}</wsse:Username>

<wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordDigest">${password}</wsse:Password>

<wsse:Nonce EncodingType="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0#Base64Binary">${nonce}</wsse:Nonce>

<wsu:Created xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">${created}</wsu:Created>

</wsse:UsernameToken>

<wsu:Timestamp xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">

<wsu:Created xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">${created}</wsu:Created>

<wsu:Expires xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">${expires}</wsu:Expires>

</wsu:Timestamp>

</wsse:Security>

</soap:Header>

<soap:Body/>

</soap:Envelope>

Uç Nokta URL (MScript Kabul Eder)

Bu özellik SOAP Çağrısının gönderileceği Uç Noktanın URL bilgisini tanımlar.

SOAP Aksiyon URI (MScript Kabul Eder)

Bu özellik isteği karşılayacak olan SOAP Aksiyonunun URI bilgisini tanımlar.

SOAP Zarfı (MScript Kabul Eder)

XML yapısındaki SOAP Zarfı bu özellik içinde tanımlanır. Gönderilecek olan XML yapısını içeren zarf, mesaj gövdesini gerektiğinde ise mesaj başlığını da içermelidir. MScript fonksiyonları kullanarak, SOAP Zarfı, istek parametrelerine veya havuz değişkenlerine göre dinamik olarak şekillendirilebilir.

Değişiklik İfadeleri

Bazen, SOAP Mesajlarına alınan yanıtlar içinde XSLT İşlemcileri tarafından işlenemeyen XML nitelikleri veya ad uzantıları bulunabilir. Bu tür normal olmayan durumları gidermek için veya başka amaçlarla mesaj yanıtına müdahale edilmesi gerekebilir. Bu özellik içinde tanımlanmış olan ifadeye göre mesaj yanıtı değiştirilir.

Özellik içinde bir yada daha fazla değişiklik ifadesi verilebilir. Birden fazla verildiğinde, ifadeler birbirlerinden "|::|" ayıracı ile ayrılmalıdır.

Her değişiklik ifadesi değiştirilecek-metin ve yeni-metin değeri içerir. yeni-metin değeri verilmez ise, değer "" olarak verilmiş kabul edilir. değiştirilecek-metin ve yeni-metin birbirlerinden "|:|" ayıracı ile ayrılmalıdır.

Bu özelliği tanımlarken boşluk ayıraçlar ile metinler arasında gereksiz boşluklar kullanılmamalıdır. Eğer kullanılırsa boşluk karakterleri de işlemlere dahil edilir.

Örnekler:

 xmlns="http://kps.nvi.gov.tr/WS"   

 yeni-metin değeri verilmemiş. değiştirilecek-metin SOAP yanıt metninden yok edilecek. 

 

 xmlns="http://kps.nvi.gov.tr/WS"|::|ilce-kodu|:|ilceKodu 

İki adet değişiklik ifadesi verilmiş. 1. ifade içinde yeni-metin değeri verilmemiş. O nedenle 1. ifadenin değiştirilecek-metin değeri SOAP yanıt metninden yok edilecek.
2. ifade içinde yeni-metin değeri verilmiş. SOAP yanıtı içinde yer alan tüm "ilce-kodu" metinleri "ilceKodu" olarak değiştirilecek.

 

Bekleme Süresi (MScript Kabul Eder)

Eğer Web Servisi herhangi bir nedenden dolayı yanıt vermez ise işletim askıda kalabilir. Bunu engellemek için bu özellikte milisaniye cinsinden(1saniye =1000milisaniye) bekleme süresi verilebilir.

Kullanıcı Adı, Şifre (MScript Kabul Eder)

Bu özelliklere geçerli bir kullanıcı adı ve şifresi verilmelidir.