http://docs.openlinksw.com/virtuoso/quicktours.html Quick Start & Tours OpenLink Virtuoso Universal Server: Documentation virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com 2009-11-16T14:26:59Z OpenLink Software Documentation Team http://docs.openlinksw.com/virtuoso/../images/misc/logo.jpg http://docs.openlinksw.com/virtuoso/newadminui.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Where to Start 2009-11-16T14:26:59Z Where to Start http://docs.openlinksw.com/virtuoso/qsclientcon.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Client Connections 2009-11-16T14:26:59Z Client Connections Virtuoso supports a number of data access API's such as ODBC and JDBC. They both provide high performance native connectivity to the Virtuoso database system. http://docs.openlinksw.com/virtuoso/qsvdbsrv.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Virtual Database Server 2009-11-16T14:26:59Z Virtual Database Server Virtuoso's Virtual Database Engine enables you to produce Dynamic Web Content from any major database management system. This enables dynamic, real-time HTML and XML generation from any number of different database engines concurrently. The Visual Server Administration Interface of Virtuoso allows you to effortlessly remotely choose and configure remote data sources to be linked into Virtuoso. Once a table is linked into Virtuoso then it is usable like any native table leaving you free to perform join queries without ever worrying about the underlying data source. The Virtual Database (VDB) Engine section of the Conceptual Overview chapter explains the concepts in more details. Visit the Visual Server Administration Interface section to see how to link tables into Virtuoso, or follow the small example below to get you started: http://docs.openlinksw.com/virtuoso/qswebserver.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Web Server 2009-11-16T14:26:59Z Web Server http://docs.openlinksw.com/virtuoso/qswebdav.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com WebDAV 2009-11-16T14:26:59Z WebDAV WebDAV support enables Virtuoso to act as the Web Content Store for all of your eBusiness data, this includes Text, Graphics and Multimedia files. WebDAV support also enables Virtuoso to play the familiar roles of a FILE & WEB SERVER, hosting entire Web sites within a single database file, or across multiple database files. Virtuoso's WebDAV provides file system like access to its non SQL data repository. Files contained in the DAV repository are stored in a database table. Free text indexing and replication mechanisms may be applied to the DAV repository as well as the regular database. Standards based WebDAV methods are used to access resources stored in the repository based on Virtuoso's full-featured SQL-92 database engine with performance that matches or exceeds that of current major players in the DB market. Typical WebDAV clients that can access the repository for content management include Network Places on Windows through Explorer, Nautilus on Gnome (Linux and Solaris), and the Mac OS X desktop. Many web development tools also support WebDAV directly. See the WebDAV Administration section, to setup the WebDAV in the Visual Server Administration Interface. http://docs.openlinksw.com/virtuoso/qswebservices.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Web Services 2009-11-16T14:26:59Z Web Services SOAP is a lightweight, extensible, XML-based protocol for information exchange in a decentralized, distributed environment. Primarily, SOAP defines a framework for message structure and a message processing model. SOAP also defines a set of encoding rules for serializing data and a convention for making remote procedure calls. The SOAP extensibility model provides the foundation for a wide range of composable modules and protocols running over a variety of underlying protocols such as HTTP. By Supporting the Simple Object Access Protocol (SOAP), Virtuoso enables you to integrate business processes within and across organization boundaries. Virtuoso's SOAP Support implementation enables you to execute Virtuoso Stored Procedures over HTTP. This is a significant component in any B2B development and implementation effort. Development is very rapid and is directly incorporated within the database environment required for keeping B2B processes running accurately. http://docs.openlinksw.com/virtuoso/qstexpwsmodules.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Exposing Persistent Stored Modules as Web Services 2009-11-16T14:26:59Z Exposing Persistent Stored Modules as Web Services Virtuoso SQL stored procedures and functions can be exposed as SOAP services very simply from Virtuoso, whether they are native Virtuoso or on remote data sources. This powerful ability means that any database servers already existing within an organization can easily become a component in an eBusiness solution using Virtuoso. All you need is a few simple steps that typically take mere minutes to complete: XML Query Templates provide a direct way to store SQL in an XML file on the Virtuoso server that when executed, i.e. fetched from a web browser, actually returns the results of the query. The C Interface chapter describes how users can define custom built-in functions, from C or other programming languages, that can be used from within Virtuoso PL. This also means that VSE's can also be published as a Web Service! http://docs.openlinksw.com/virtuoso/qsvsmx.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com VSMX - Virtuoso Service Module for XML 2009-11-16T14:26:59Z VSMX - Virtuoso Service Module for XML Every WSDL file generated by Virtuoso is automatically accompanied by a SOAP Operations Test page known as a VSMX file, which has the extension .vsmx. You find this file in the same place as the WSDL file. For a SOAP enabled virtual directory you have the facility to find the WSDL file: likewise you also get a VSMX file: You simply point your web browser to this file for the test page. The demo database contains samples that can be found as: http://docs.openlinksw.com/virtuoso/qssqltoxml.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com SQL to XML 2009-11-16T14:26:59Z SQL to XML Virtuoso enables you to develop eBusiness solutions that use XML as both a Data Source and Data Interchange format. Your XML Data documents can take the form of Pure XML Documents, or documents that are transformed from SQL-XML on the fly. By supporting the XPATH query language for XML Data, you are able to use an industry standard query language to query entire XML Documents or portions of XML Documents stored within Virtuoso. Virtuoso's inclusion of an XSLT transformation engine then allow you to transform XML data for other needs. These XML documents are openly accessible to user agents such as Web Browsers via HTTP and/or WebDAV. These XML documents are described as being dynamic because they have varying degrees of sensitivity to changes that occur in the underlying database tables from which the XML data originates. Virtuoso allows you to create two types of XML documents from homogeneous or heterogeneous SQL Data on the fly: SQL-XML documents may be Valid or Well Formed XML documents, this includes support for both DTDs and XML Schemas which my be external entity references or inlined within the XML Documents prologue in the case of DTDs. Virtuoso supports an extended SQL syntax that is identical to that implemented by Microsoft SQL Server for the purpose of creating SQL-XML documents. These SQL extensions take the form of a new "FOR XML" clause that includes three main options which control the structure of the resulting XML document tree. These options are RAW, AUTO and EXPLICIT. http://docs.openlinksw.com/virtuoso/qsnntp.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com NNTP 2009-11-16T14:26:59Z NNTP Virtuoso supports the Network News Transfer Protocol used by Internet newsgroup forums. NNTP servers manage the global network of collected newsgroup postings and represent a vast repository of targeted information archives. As an NNTP aggregator, Virtuoso enables integration of multiple news forums around the world. All news content in Virtuoso is dynamically indexed to provide keyword searches, enabling rapid transformation of disparate text data into information. Virtuoso also acts as an NNTP server, enabling creation of new Internet and Intranet News Forums to leverage the global knowledge base into eBusiness Intelligence. http://docs.openlinksw.com/virtuoso/vspquickstart.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Dynamic Web Pages 2009-11-16T14:26:59Z Dynamic Web Pages Virtuoso provides an extensible array or dynamic methods for creating data driven web pages. Through runtime hosting Virtuoso can directly host, store and drive: Virtuoso Server Pages (VSP) is Virtuoso's specification for creating dynamic database driven Web pages, these files have the extension ".vsp" and are identical in functionality to: ASP, PHP, and JSP pages. A fundamental difference between VSP pages and others (PHP, ASP. and JSP pages) is the fact that VSPs are specialized forms of Virtuoso Stored procedures which implies that data is in-process rather than out-of-process, you do not have to complete a client-server connection in order to actually bind to the data being used in a VSP page. The obvious benefit being significant performance improvements over ASP, PHP, and JSP pages (which all bind to data out-of-process). Since VSP is essentially Virtuoso PL in a web page you can do anything that PL can from or part of a web page either directly or from interaction with the user. A massive advantage of using VSP is that you do not have to worry about making connections to the database or the overhead of RPC's because the HTTP server is built into Virtuoso. When you write a VSP page the connection is assumed since you are already in Virtuoso! VSP is server script and is therefore executed in the server as it is encountered on the page. For this reason client (JavaScript) and server script cannot directly interact but can supplement each other. You can call JavaScript inside a VSP loop, for example, to manipulate something that already exists on the page but you cannot pass variables by reference from VSP directly to JavaScript or vice versa. Page flow control is managed using FORMs. The state of the page is defined in form fields such as INPUT boxes and TEXTAREA boxes and then passed on to the next form or page using POST. http://docs.openlinksw.com/virtuoso/qsvspexamples.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com VSP Examples 2009-11-16T14:26:59Z VSP Examples http://docs.openlinksw.com/virtuoso/qshostingplugs.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Third-Party Runtime Typing, Hosting & User Defined Types 2009-11-16T14:26:59Z Third-Party Runtime Typing, Hosting & User Defined Types All barriers are broken. If Virtuoso does not readily provide the data type that you require, then make your own. If you want a database trigger to test data against existing externally developed logic, then do that too. Virtuoso has been designed with open-design in mind giving ultimate flexibility. These are the systems current available (linked to the appropriate section of this documentation): http://docs.openlinksw.com/virtuoso/troutips.html virtuoso.docs@openlinksw.com virtuoso.docs@openlinksw.com Troubleshooting Tips 2009-11-16T14:26:59Z Troubleshooting Tips