• Makale

wsdl kullanarak

Bu özellik Microsoft SQL Server'ın ilerideki bir sürümünde kaldırılacaktır. Yeni geliştirme işlerinde bu özelliği kullanmaktan kaçının ve bu özelliği kullanmakta olan uygulamalarda değişiklik yapmayı planlayın.

Web hizmeti Açıklama Dili (wsdl) Web arabirim tanımı için http bitiş noktası üzerinde sergilenen tüm rpc işlevleri tanımlar ve ayrıca son nokta için sql toplu iş işlevini tanımlar.Bir istemci bir wsdl yanıt talep edebilirsiniz bir örnek , SQL Server ve desteklemek üzere yapılandırılmış http bitiş noktaları kullanarak sunucuya karşı rpc ve sql toplu iş istekleri oluşturmak için kullanınbir wsdl türü. wsdl yanıt uç noktada ilişkili rpc işlevlerini temel alan aslında bir dinamik olarak oluşturulan xml belgeniz ne kadar saat isteği.

Not

World Wide Web Consortium (W3C) wsdl 1.1 belirtimini wsdl hakkında arka plan bilgileri için bkz: Web sitesi en http://www.w3c.org.

wsdl teklifi desteklemek üzere yapılandırılmış http bitiş noktaları wsdl istekleri gönderme yanıtlama istemcileri kullanmak için aşağıdaki wsdl yapılandırmalardan birini belirtebilirsiniz:

  • Varsayılan wsdl

  • Özelleştirilmiş bir wsdl

Varsayılan wsdl seçeneği sağlamak üzere yapılandırıldığında SQL Server iki wsdl türleri için destek sunar: bir varsayılan veya genişletilmiş wsdl ve Basitleştirilmiş wsdl biçimi.

Son nokta üzerindeki desteklenen yöntemlerden herhangi biri bu wsdl belgeleri tanımlamak rağmen wsdl varsayılan ek özellikler bir xml Şeması'nın (xsd) bitiş noktası tarafından sunulan veya kullanılabilir değerler döndürür ve yöntemleri, veri türleri, parametreler için daha zengin bir açıklama sağlamak için kullanır.

İçin gerekli olabilir Basitleştirilmiş wsdl biçimi, kapalı-uyumluluk düzey ile birlikte eski istemcileri, yalnızca temel veri türlerini gerektirir çok temel bir xsd şeması kullanır.Belirli bir istemci için uygun wsdl içeriğini tam ne varsayılan ne de Basitleştirilmiş wsdl sağlıyorsa, wsdl gerektiği gibi özelleştirilmiş bir sürüm sağlamak için sunucuyu güncelleştirebilirsiniz.

wsdl yanıtları oluşturulan ve örnek tarafından döndürülen SQL Server Web tarafından bir http bitiş noktası için ilk bağlantı sırasında Hizmetleri istemci , bir wsdl isteği. gönderen

Nasıl wsdl sql Server tarafından desteklenmiyor

When an endpoint is defined, the WSDL argument in the CREATE ENDPOINT Transact-SQL statement is used to specify for the server whether a WSDL response is generated and returned for the endpoint to describe its Web programmable features.Bitiş noktası bir wsdl kullanarak kuruldu, = none değeri, sunucunun bir wsdl yanıt verecektir.

Varsayılan wsdl oluşturma gibi Eğer belirtilmediğinden, wsdl = bitiş noktası oluşturulduğunda varsayılan belirtildi, sunucu tarafından döndürülen wsdl biçimi url bağlı olarak değişir dize http bitiş noktasına bağlanmak için istemci tarafından kullanılır.İstemciler WSDL'yi istemek için aşağıdaki url biçimlerinden birini kullanabilirsiniz:

  • Varsayılan wsdl

    Bu tam sürüm kullandığınızda, döndürülen genişletilmiş wsdl yanıt, http://server/endpoint_path? wsdl url bitiş noktasına bağlanma.Bu biçimi türetilmiş xsd türleri için daha karmaşık bir sql türleri eşleme destek sağlamak için kullanır.Daha fazla bilgi için bkz: Varsayılan wsdl.

  • Basit wsdl

    Bu kısa basitleştirilmiş bir sürüm tüm eşlemeleri wsdl varsayılan, SQL Server Sistem veri türleri için doğal xsd türleri.Bu biçimi kullandığınızda verilir http://server/endpoint_path? wsdlsimple URL bitiş noktasına bağlanma.Daha fazla bilgi için bkz: Basit wsdl.

  • Özel wsdl

    Zaman wsdl ya da sürüm, örnek , SQL Server döndürür, varsayılan ya da basitleştirilmiş bir istemciler için kabul edilemez, belirtebileceğiniz bir özel wsdl teklifi.Bu seçenek, tasarlamak ve uygulamak ek kod gerektirir.Bu şekilde, bir saklı yordam oluşturmak ve özelleştirilmiş wsdl içeriği dolayısıyla özel wsdl belirttiğiniz istemcilere yazın bir http tabanlı sorgu dönmek için kullanılır.Daha fazla bilgi için bkz: Özel wsdl desteği sağlama.

wsdl içeriğini

Web Hizmetleri Açıklama Dili (wsdl) örnek bir kök içeren bir xml belgesidir <tanımları> wsdl ad alanýný belirtir öğesi (https://schemas.xmlsoap.org/wsdl) tanımlar ve bir küme ağ uç noktalarının veya bağlantı noktaları topluluğu olarak Web Hizmetleri.Tipik bir wsdl belgesinde aşağıdaki üst düzey yapıya sahip olacaktır:

<wsdl:definitions>
  <wsdl:types>...</wsdl:types>
  <wsdl:message>...<wsdl:message/>
  <wsdl:portType>...</wsdl:portType>
  <wsdl:binding>...</wsdl:binding>
  <wsdl:service>...<wsdl:service>
<wsdl:definitions>

Bu Basitleştirilmiş wsdl biçimi görünümünü gösterir gibi çeşitli öğeler wsdl belgesi içindeki ana bölümleri göstermek için kullanılır.Her birinin rolünü kısaca Aşağıda, açıklanan tablo.

Element

Açıklama

wsdl:types

xml şema (xsd) veya benzer başka bir sistem veri türleri kullanılarak yapılan veri türü tanımlarının kapsayıcı öğe.

wsdl:message

İletilen ileti verisi tanımı.İletiyi birden çok bölümlerini oluşur ve her parçası farklı bir türü olabilir,

wsdl:portType

Soyut bir veya daha fazla bitiş noktaları tarafından desteklenen işlemleri küme.

wsdl:binding

Somut protokol ve veri biçim belirtimi için belirli bir bağlantı noktası türü.

wsdl:service

İlgili son noktalar koleksiyonu.

Sistem saklı yordamlar desteklemek için kullanılan wsdl

Aşağıdaki sistem saklı yordamları de yerel xml Web Hizmetleri ile birlikte gelen SQL Server ve basit wsdl uygulamaları ve varsayılan olan desteklemek için çağrılan bir isteğin yanıtı için wsdl:

  • sp_http_generate_wsdl_defaultcomplexorsimple

  • sp_http_generate_wsdl_defaultsimpleorcomplex

  • sp_http_generate_wsdl_complex

  • sp_http_generate_wsdl_simple

Bu saklı yordamları yürütmek için üyelik gerektirir ortak rolü.Dahili olarak, her biri Bu saklı yordamları katalogları Web yöntemi olarak bitiş noktaları aracılığıyla kullanıma sunulan ek saklı yordamlar hakkında bilgi almak için sorgular.Kullanıcılar, yalnızca bu Web yöntem saklı yordamların izinlerini gerektirir.Daha fazla bilgi için bkz: Web için programlama SQL risklere.