Documento WSDL semplice
Questa caratteristica verrà rimossa a partire da una delle prossime versioni di Microsoft SQL Server. Evitare di utilizzare questa caratteristica in un nuovo progetto di sviluppo e prevedere interventi di modifica nelle applicazioni in cui è attualmente implementata.
Il documento WSDL semplice è una versione ridotta del documento WSDL che sostituisce i tipi di dati XSD primitivi per i tipi di sistema di SQL Server, descritti in modo più dettagliato in Documento WSDL predefinito. Anche se elimina una parte della ricchezza dei tipi di dati SQL Server, i quali sono pienamente supportati nel documento WSDL predefinito, il documento WSDL semplice consente di snellire il processo di implementazione di documenti WSDL utilizzabili per client e generatori di classi proxy che non possono eseguire il mapping o gestire tutti i facet del documento WSDL predefinito e il relativo sistema di tipi.
Differenze tra documento WSDL semplice e documento WSDL predefinito
Il formato del documento WSDL semplice è stato progettato e affiancato al formato del documento WSDL predefinito per venire incontro alla necessità di offrire compatibilità con le versioni precedenti e il supporto dei client SOAP che non supportano il formato del documento WSDL predefinito.
Tra questi vi sono semplici client di servizi Web come quelli basati su SOAP Toolkit. Questi client non sono in grado di interpretare il documento WSDL predefinito dato che questo è generato da un'istanza di SQL Server. Questa limitazione è dovuta al fatto che SOAP Toolkit e altri client di servizi Web più semplici non supportano la ricchezza di alcuni tipi di sistema introdotti in SQL Server 2005. Per tener pertanto conto di questa limitazione propria dei client più semplici e meno recenti, nel formato del documento WSDL semplice viene eseguito il mapping di tutti gli elementi dei tipi di SQL Server in tipi XSD nativi.
È ad esempio noto che il client SOAP Toolkit ha problemi nella comprensione di sqltypes:money a causa della sua granularità di definizioni di totalDigits e fractionDigits e di altri elementi aggiuntivi utilizzati per ottenere i tipi XSD originali. SOAP Toolkit è tuttavia in grado di gestire correttamente il mapping diretto di tipi XSD, ad esempio int.
Tipi derivati (documento WSDL predefinito)
<xsd:simpleType name="money">
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="19">
</xsd:totalDigits>
<xsd:fractionDigits value="4">
</xsd:fractionDigits>
<xsd:maxInclusive value="922337203685477.5807">
</xsd:maxInclusive>
<xsd:minInclusive value="-922337203685477.5808">
</xsd:minInclusive>
</xsd:restriction>
</xsd:simpleType>
Mapping diretto (documento WSDL semplice)
<xsd:simpleType name="int">
<xsd:restriction base="xsd:int">
</xsd:restriction>
</xsd:simpleType>
Altro esempio è costituito da una risposta RPC. Il documento WSDL predefinito imposta un tipo di risposta su SqlResultStream, definito in maniera aggiuntiva nella sua sezione "Types". Al contrario, il tipo di risposta viene impostato su un <xsd:complexType> generico che specifica <xsd:any>, il quale tiene conto di qualsiasi contenuto. Con una tale modifica al documento WSDL è possibile eludere l'impossibilità ad analizzare i tipi di risposta SQL Server derivati da parte di un client di servizi Web semplice.
Nota
Le richieste WSDL non possono far parte di una sessione SOAP. Per ulteriori informazioni sulle sessioni SOAP, vedere Utilizzo delle sessioni SOAP.
Mapping dei tipi XSD per il documento WSDL semplice in SQL Server
Per ulteriori informazioni sulle modalità di esecuzione del mapping dei tipi di dati di sistema di SQL Server in tipi di schema XML (XSD) per i documenti WSDL semplici, vedere Mapping dei tipi di dati in servizi Web XML nativi.
Vedere anche