# OpenLink Virtuoso Universal Server: Documentation - include

Chapter Contents | Prev | Next
Keyword Search:
www.openlinksw.com
docs.openlinksw.com
Book Home
Contents
Preface
Overview
Installation Guide
Quick Start & Tours
Sample ODBC & JDBC Applications
Conceptual Overview
Server Administration
Data Access Interfaces
SQL Reference
SQL Procedure Language Guide
Database Event Hooks
Data Replication, Synchronization and Transformation Services
Web Application Development
XML Support
RDF Database and SPARQL
Web Services
Runtime Hosting
Internet Services
Free Text Search
TPC C Benchmark Kit
Using Virtuoso with Tuxedo
Appendix
Virtuoso Functions Guide

## include

A place where the source code of other page should be inserted.
< include url (required) active (optional) initial-active (optional) debug-srcfile (optional) debug-srcline (optional) debug-log (optional) />
Description

The VSPX compiler replaces this control with the content of another page. This will include the content from the specified url at this point of the page. The url is relative to the page. The inclusion will be done before compilation of VSPX into Virtuoso/PL, hence the include can contain either vspx or static HTML content. The only requirement is that the included file be well formed. Note also that if you are using vspx namespace in the include file, it must be declared as such. This element will not be instantiated. instead of instantiating it will be replaced with content of the specified document. The included page may or may not contain a 'page' element. If a 'page' element is found in the included file this will be skipped in the resulting page. Also names of controls in the included file MUST NOT conflict with names of controls in the top level page or other included content.

Attributes
url

URL of file to be included. If relative then the base is the page where the control resides. E.g. If '/home/pageA' includes 'subdir1/pageB' and the included page includes 'subdir2/pageC' then 'pageC' should reside in '/home/subdir1/subdir2', not in '/home/subdir2'.

active = CalculateableValue

A data bound value to enable or disable the link. The default is '1' meaning 'enable'.

initial-active = CalculateableValue

A data bound value to enable or disable the link. The default is '1' meaning 'enable'. Unlike 'active' attribute, this one is effective only when the page is displayed in the first time, not after user posts data back to the page.

debug-srcfile

URI of the source document where the tag comes from.

debug-srcline

Line number in the source document where the tag comes from.

debug-log

This defines what sort of data are saved to the debugging log.

Examples
Include a common back-link into the end of page

<?xml version="1.0"?> <!-- - - $Id: include__0.vspx,v 1.2 2006/08/16 00:04:15 source Exp $ - - This file is part of the OpenLink Software Virtuoso Open-Source (VOS) - project. - - Copyright (C) 1998-2006 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 - - If the file footer.xml is placed in the same directory where this sample page is located and contains the paragraph <P><a href="index.vspx">Back to index</a></P> then the resulting page will have additional paragraph at the end.

    <v:page name="include__0" xmlns:v="http://www.openlinksw.com/vspx/">
      <html>
        <head><title>VSPX samples | v:include</title></head>
        <body>
          <p>The link after the horizontal ruler is included from footer.xml</p>
          <hr/>
          <v:include url="footer.xml"/> <!-- this will include the file described above -->
        </body>
      </html>
    </v:page>