<!--
 -  
 -  This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
 -  project.
 -  
 -  Copyright (C) 1998-2018 OpenLink Software
 -  
 -  This project is free software; you can redistribute it and/or modify it
 -  under the terms of the GNU General Public License as published by the
 -  Free Software Foundation; only version 2 of the License, dated June 1991.
 -  
 -  This program is distributed in the hope that it will be useful, but
 -  WITHOUT ANY WARRANTY; without even the implied warranty of
 -  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 -  General Public License for more details.
 -  
 -  You should have received a copy of the GNU General Public License along
 -  with this program; if not, write to the Free Software Foundation, Inc.,
 -  51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 -  
 -  
-->
<?xml version="1.0" encoding="ISO-8859-1"?>
<refentry id="VS-D-3">
  <refmeta>
    <refentrytitle>DAV Maintenance</refentrytitle>
    <refmiscinfo>tutorial</refmiscinfo>
  </refmeta>
  <refnamediv>
    <refname>DAV Properties</refname>
    <refpurpose>SQL/XML documents in DAV</refpurpose>
  </refnamediv>

<refsect1 id="VS-D-3a">
<title>Preliminaries</title>
<itemizedlist mark="bullet">
  <listitem>The SQL query can be transformed into an XML document with xml_auto() for example.</listitem>
  <listitem>The SQL/XML documents are automatically generated resources, based on a SQL query.</listitem>
  <listitem>Two types of SQL/XML documents can be defined in the WebDAV repository:
  Persistent documents and Immediate transformation.</listitem>
</itemizedlist>
</refsect1>

<refsect1 id="VS-D-3b">
<title>Persistent Documents</title>
The persistent SQL/XML documents have the same behavior as text/xml documents:
<itemizedlist mark="bullet">
  <listitem>They have a mime type of text/xml, and have a content.</listitem>
  <listitem>The content can be refreshed with a scheduled event.</listitem>
  <listitem>The content is free-text indexed</listitem>
</itemizedlist>
</refsect1>

<refsect1 id="VS-D-3c">
<title>Immediate Transformation</title>
The SQL/XML documents with immediate transformation are formed as they are requested.
<itemizedlist mark="bullet">
  <listitem>The content is empty</listitem>
  <listitem>Hence the content is not free-text indexed</listitem>
</itemizedlist>
</refsect1>

<refsect1 id="VS-D-3d">
<title>Properties</title>
<itemizedlist mark="bullet">
  <listitem>Both resources have a property xml-sql. The value of the property is the SQL query string.</listitem>
  <listitem>If content length is zero and the xml-sql property is set, then the server will do an immediate transformation.</listitem>
  <listitem>Both resources have xml-sql-root, xml-sql-dtd, and xml-sql-schema properties (see also vs-d-2).</listitem>
</itemizedlist>
</refsect1>

<refsect1 id="VS-D-3e">
<title>SQL/XML resource example</title>
<para>The example SQL script creates a few SQL/XML resources.</para>
<para><ulink url="/DAV/vs_d_3/">Click here for resources made in /DAV/vs_d_3/</ulink></para>
</refsect1>
</refentry>
