DAT 330 Building Web Services with SQL Server and SQLXML 3.0 Alexander Vaschillo Lead Program Manager WebData XML Group Microsoft Corporation

SQLXML Talks SQLXML: XML Technology for SQL Server SQLXML: XML Technology for SQL Server  DAT200, Alexander Vaschillo, Jul 2 8:30 Building Web Services with SQL Server and SQLXML 3.0 Building Web Services with SQL Server and SQLXML 3.0  DAT330, Alexander Vaschillo, Jul 2 18:15 Inside data access with SQLXML: Architecture guide Inside data access with SQLXML: Architecture guide  DAT400, Alexander Vaschillo, Jul 3 10:00

Agenda SQLXML Overview SQLXML Overview SQL Server 2000 Web Services Overview SQL Server 2000 Web Services Overview  What can be exposed  What does SQLXML 3.0 do for you How to create a Web Service How to create a Web Service  Setting up a Web Service  Available Options Support for Visual Studio.NET Support for Visual Studio.NET Demo Demo

The Two Worlds SQLServer RowSet SQL Relational world Language Data storage Data output XML world XMLFiles XPathXQuery XML/HTML XMLView SQLXML – Bringing worlds together

Query/Update Technologies FOR XML (raw, auto, nested, explicit) FOR XML (raw, auto, nested, explicit)  SQL language extension to retrieve XML instead of rowsets XML Views – XPath, XQuery XML Views – XPath, XQuery  Work with your relational database as if it was XML file (through annotated schema) Updategrams/Diffgrams Updategrams/Diffgrams  Update through XML View Bulkload Bulkload  Shred large XML files into existing tables

Data Access Methods HTTP Access via URL HTTP Access via URL  SQL Query  XPath Query  XML Templates ADO / OLEDB ADO / OLEDB.NET access through SQLXML Managed Classes.NET access through SQLXML Managed Classes Web Services Web Services

SQLXML 3.0 Introduces Web Services for SQL Server Introduces Web Services for SQL Server Turn your SQL Server into a Web Service in 15 minutes Turn your SQL Server into a Web Service in 15 minutes Released at Visual Studio.NET Launch, February 2002 Released at Visual Studio.NET Launch, February 2002 Localized to 8 languages at launch Localized to 8 languages at launch Integral part of Microsoft’s.NET vision Integral part of Microsoft’s.NET vision

Web Services Overview Web Services expose Stored Procedures and XML Templates Web Services expose Stored Procedures and XML Templates Messaging done according to SOAP 1.1 standard Messaging done according to SOAP 1.1 standard Variety of response options Variety of response options Can run on database server or mid-tier Can run on database server or mid-tier  Wherever IIS is Simple UI for configuration Simple UI for configuration  Even DBA’s can do it!

What can be exposed? XML Templates XML Templates  XML returned from template is simply returned from the Web Service Stored Procedures Stored Procedures  Relational data converted to XML  XML Data is returned  Output Parameters also returned UDF’s- Visible like a store procedure UDF’s- Visible like a store procedure

What does SQLXML do for you? Creates Web Services Description Language (WSDL) file Creates Web Services Description Language (WSDL) file  Describes Web Service  Indicates what Methods are available  Difficult to write by hand. WE DO IT FOR YOU! Parses SOAP requests Parses SOAP requests Returns proper SOAP response Returns proper SOAP response

How is it done? Admin creates a Web Service and adds Web Methods via a simple UI Admin creates a Web Service and adds Web Methods via a simple UI  Web Methods map to Stored Procedures and Templates  WSDL file is created Client retrieves WSDL via URL Client retrieves WSDL via URL  Client now knows the methods available Client now knows the methods available  Method names  Parameters  Return Values

How is it done (continued)? Client application sends SOAP encoded request (Procedure call) Client application sends SOAP encoded request (Procedure call)  POST to SOAP vName SQLXML parses request SQLXML parses request  Method Name  Parameters XML Template or Stored Procedure is called XML Template or Stored Procedure is called  Client has no idea that this is a template or stored procedure, or even that it’s SQL Server

How is it done (continued)? Proper SOAP encoded response is constructed and returned to the client Proper SOAP encoded response is constructed and returned to the client For methods mapping to XML Templates, results are already XML For methods mapping to XML Templates, results are already XML  Results are wrapped in SOAP envelope and returned For methods mapping to stored procedures, results are processed For methods mapping to stored procedures, results are processed  Results are converted to XML according to options chosen  XML is wrapped in SOAP envelope and returned

Architecture WebServer Virtual Directory SOAP VName WSDLWSDL Method Method Method XML Templates SQL Server 2000 SQL Server 2000 SP’sSP’s Config / Mappin g File File

Creating a Web Service Use the configuration tool to create a Virtual Directory (VDir) Use the configuration tool to create a Virtual Directory (VDir) Create a Virtual Name of type “SOAP” Create a Virtual Name of type “SOAP”  Name your Web Service  Give it a domain You Have a Web Service! Now to add some methods…

XML Template Methods Browse for an XML Template Browse for an XML Template  All templates available on the SQLXML tier Choose Web Method name Choose Web Method name Results always returned in “XML Objects” mode Results always returned in “XML Objects” mode

Stored Procedure Methods Select Stored Procedure from list Select Stored Procedure from list  Generated from login used for the VDir Choose Web Method name Choose Web Method name Select Output Formatting Select Output Formatting  RAW or NESTED Select Response Type Select Response Type  XML Objects  Dataset Objects  Single Dataset

Web Service Creation demo demo

Response Types All Responses are XML / SOAP All Responses are XML / SOAP  Response Type dictates what Visual Studio.NET De-Serializes the XML into  Other clients (Microsoft SOAP Toolkit) will just see XML Methods mapping to XML Templates have a fixed return type Methods mapping to XML Templates have a fixed return type  XML Objects

XML Objects Responses Visual Studio.NET recognizes an “array of objects” Visual Studio.NET recognizes an “array of objects” Each item in the array is de-serialized into an object Each item in the array is de-serialized into an object  XMLElement - Data  SQLMessage – Error Information Templates MUST use this response type Templates MUST use this response type

Dataset Objects Responses Visual Studio.NET recognizes an “array of dataset objects” Visual Studio.NET recognizes an “array of dataset objects” Each item in the array is de-serialized into an object Each item in the array is de-serialized into an object  Dataset - Data  SQLMessage – Error Information Only for Stored Procedures Only for Stored Procedures

SQLMessage Conveys Error information Conveys Error information Object Contains the following: Object Contains the following: Created directly from SQL Server Error Messages Created directly from SQL Server Error Messages  Class  Line Number  Message  Number  Procedure  Server  Source  State

Single Dataset Responses Visual Studio.NET recognizes a Dataset Visual Studio.NET recognizes a Dataset Retrieve results of a Stored Procedure and load into a Dataset in 1 line of code! Retrieve results of a Stored Procedure and load into a Dataset in 1 line of code! Dim Service As New MyHost.MyWebService() Dim ds As New System.Data.DataSet() Dim retval As Integer ds = Service.GetCustomerInfo(“ANTON”, retval)

Single Dataset Response Limitations No Error Information No Error Information  Either a dataset comes back or it doesn’t, no other messages Single Result Sets Only Single Result Sets Only  Use Dataset Objects mode for multiple result sets

Visual Studio.NET Integration SQLXML 3.0 Web Services designed for Visual Studio.NET SQLXML 3.0 Web Services designed for Visual Studio.NET In a Visual Studio.NET Project, “Add Web Reference” to your Web Service In a Visual Studio.NET Project, “Add Web Reference” to your Web Service  Proxy classes generated for your methods  Forget that you are not accessing local information  Visual Studio.NET takes care of the SOAP messaging and XML serialization Intellisence recognizes SPs and Templates and their parameters Intellisence recognizes SPs and Templates and their parameters

Visual Studio.NET Web Service Client demo demo

Visual Studio.NET Gotchas Value-Typed Parameters Value-Typed Parameters  No NULL values  No Missing/Empty Parameters Value-Typed Return Values Value-Typed Return Values  No NULL Values Data Munging in Dataset Only Mode Data Munging in Dataset Only Mode Special Characters in Table Names Special Characters in Table Names

Call to Action Web Services Toolkit Web Services Toolkit  Download from  Turn your SQL Server into a Web Service Today! Turn your SQL Server into a Web Service Today! Let us know what your think Let us know what your think

Additional Resources Web page Web page  Download SQLXML releases at: Download SQLXML releases at:  Contact us Contact us  PSS  news:microsoft.public.sqlserver.xml  us Documentation Documentation  SQL Server 2000 Documentation (Books Online)  Web Release documentation  Books

Books About SQLXML “Professional XML Databases” Various; Wrox Press; December, 2000 “Professional XML Databases” Various; Wrox Press; December, 2000 “Scripting XML and WML for Microsoft SQL Server 2000”, Tobias Martinsson; John Wiley & Sons; January, 2001 “Scripting XML and WML for Microsoft SQL Server 2000”, Tobias Martinsson; John Wiley & Sons; January, 2001 “Programming Microsoft SQL Server 2000 with XML” Graeme Malcolm; Microsoft Press; June, 2001 “Programming Microsoft SQL Server 2000 with XML” Graeme Malcolm; Microsoft Press; June, 2001 “Professional SQL Server 2000 XML” Various; Wrox Press; June, 2001 “Professional SQL Server 2000 XML” Various; Wrox Press; June, 2001 “XML and SQL Server 2000” John Griffin; New Riders Pub; July, 2001 “XML and SQL Server 2000” John Griffin; New Riders Pub; July, 2001 “Working With Microsoft SQL Server and XML” Sams Pub; January, 2002 “Working With Microsoft SQL Server and XML” Sams Pub; January, 2002

Resources from Microsoft Press For more information please visit the TechEd Bookshop. SQL & XML

Don’t forget to complete the on-line Session Feedback form on the Attendee Web site