This new psml.xsd fixes several problems with the old
psml.xsd.

- Resolves several inconsistencies with the w3c xml
schema specification, which made the old psml.xsd
impossible to use in conjunction with a validating
tool/library 

-accounts for security, security-ref, and reference
elements (which are now permissable in psml)

-specifies that "portlets" must be the root element of
a psml file (instead of e.g. "metainfo" - this is the
intent correct?

-moves comments about the meaning of specific elements
inside "annotation elements", the preffered method of
documentation for xml schema.

This new psml.xsd successfully validates psml files
produced by the JetspeedProfilerService and
CastorPsmlManager, and rejects other files which don't
follow the intended structure.

Sincerely, 
matt forsyth, seawave


__________________________________________________
Do you Yahoo!?
New DSL Internet Access from SBC & Yahoo!
http://sbc.yahoo.com
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--

 The Apache Software License, Version 1.1
 
 Copyright (c) 2000-2001 The Apache Software Foundation.  All rights
 reserved.
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions
 are met:
 
 1. Redistributions of source code must retain the above copyright  notice, this list of conditions and the following disclaimer.
 
 2. Redistributions in binary form must reproduce the above copyright  notice, this list of conditions and the following disclaimer in  the documentation and/or other materials provided with the  distribution.
 
 3. The end-user documentation included with the redistribution,  if any, must include the following acknowledgment:     "This product includes software developed by the      Apache Software Foundation (http://www.apache.org/)."  Alternately, this acknowledgment may appear in the software itself,  if and wherever such third-party acknowledgments normally appear.
 
 4. The names "Apache" and "Apache Software Foundation" and   "Apache Jetspeed" must not be used to endorse or promote products  derived from this software without prior written permission. For  written permission, please contact [EMAIL PROTECTED]
 
 5. Products derived from this software may not be called "Apache" or  "Apache Jetspeed", nor may "Apache" appear in their name, without  prior written permission of the Apache Software Foundation.
 
 THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
 WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
 DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
 ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
 USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
 OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 SUCH DAMAGE.
 ====================================================================
 
 This software consists of voluntary contributions made by many
 individuals on behalf of the Apache Software Foundation.  For more
 information on the Apache Software Foundation, please see
 <http://www.apache.org/>.

-->
<schema targetNamespace="http://www.apache.org/2000/02/CVS"; xmlns:apache="http://www.apache.org/2000/02/CVS"; xmlns="http://www.w3.org/2001/XMLSchema"; elementFormDefault="unqualified" attributeFormDefault="unqualified">
	<annotation>
		<documentation>
PSML - Jetspeed Portal Site Markup Language
Version: $Id: psml.xsd,v 1.9 2001/07/29 13:42:02 raphael Exp $
Authors:  	Kevin A. Burton &lt;[EMAIL PROTECTED]&gt;        
			Rapha�l Luta &lt;[EMAIL PROTECTED]&gt;        
			Matthew Forsyth &lt;[EMAIL PROTECTED]&gt;        
This markup allows description of customized user portal 
interface.
	</documentation>
	</annotation>
	<element name="portlets" type="apache:Portlets">
		<annotation>
			<documentation/>
		</annotation>
	</element>
	<complexType name="Control">
		<annotation>
			<documentation> This element describes the control used to manage a portlet or      a portletset          The name attribute must contain the name of the control within the     PortletControlRegistry some parameters may be added to modify the      default control behavior</documentation>
		</annotation>
		<sequence>
			<element name="parameter" type="apache:Parameter" minOccurs="0" maxOccurs="unbounded"/>
		</sequence>
		<attribute name="name" type="string" use="required"/>
		<attribute name="user" type="string" use="optional"/>
	</complexType>
	<complexType name="Controller">
		<annotation>
			<documentation> This element describes the controller used to layout a given     portlets.          The name attribute must contain the classname of the controller,     some parameters may be added to modify the default controller behavior</documentation>
		</annotation>
		<sequence>
			<element name="parameter" type="apache:Parameter" minOccurs="0" maxOccurs="unbounded"/>
		</sequence>
		<attribute name="name" type="string" use="required"/>
	</complexType>
	<complexType name="Entry">
		<annotation>
			<documentation>  The main element of content, should link to an existing     portlet definition which will provide implementation     details (such as classname and url).          May override some parameters defined in the portlet     definition and some some metainfo defined in the channel     description (if there's one). </documentation>
		</annotation>
		<sequence>
			<element name="metainfo" type="apache:Metainfo" minOccurs="0"/>
			<element name="security-ref" type="apache:Security-Ref" minOccurs="0"/>
			<element name="skin" type="apache:Skin" minOccurs="0"/>
			<element name="layout" type="apache:Layout" minOccurs="0"/>
			<element name="control" minOccurs="0"/>
			<element name="parameter" type="apache:Parameter" minOccurs="0" maxOccurs="unbounded"/>
		</sequence>
		<attribute name="id" type="string" use="optional"/>
		<attribute name="parent" type="string" use="required"/>
	</complexType>
	<complexType name="Layout">
		<annotation>
			<documentation>This element is a parameter used by the controller     to describe preferred layout structure.         This is only a hint, contoller may ignore any layout element.      2 specific properties exists:          position: the position of the portlet compared to its other               siblings. Should be defined for all portlets and               entry     size: NORMAL|MAXIMUM|MINIMUM hints about expected content           size (not yet implemented)                Other properties may be added through the &lt;parameter> elements     their semantics are defined by the controllers in use</documentation>
		</annotation>
		<sequence>
			<element name="property" minOccurs="0" maxOccurs="unbounded"/>
		</sequence>
		<attribute name="position" type="string" use="optional"/>
		<attribute name="size" type="string" use="optional"/>
	</complexType>
	<complexType name="Metainfo">
		<annotation>
			<documentation>Encapsulation for meta-data info, should probably be moved     to Dublin Core by using namespaces</documentation>
		</annotation>
		<all>
			<element name="title" type="string" minOccurs="0"/>
			<element name="description" type="string" minOccurs="0"/>
			<element name="image" type="string" minOccurs="0"/>
		</all>
	</complexType>
	<complexType name="Parameter">
		<annotation>
			<documentation>A parameter definition (used in layout and skin) </documentation>
		</annotation>
		<sequence>
			<element name="security-ref" type="apache:Security-Ref" minOccurs="0"/>
		</sequence>
		<attribute name="name" type="string" use="required"/>
		<attribute name="value" type="string" use="optional"/>
	</complexType>
	<complexType name="Property">
		<attribute name="name" type="string" use="required"/>
		<attribute name="value" type="string" use="optional"/>
	</complexType>
	<complexType name="Portlets">
		<annotation>
			<documentation>Portlet set definition object      user: Turbine login of user owner of this portlet set       portlet-entry: portlets with reference to registry     portlets: entity for grouping portlets and assigning common properties      skin, parameter, layout: see their entries</documentation>
		</annotation>
		<sequence>
			<element name="metainfo" type="apache:Metainfo" minOccurs="0"/>
			<element name="security" type="apache:Security" minOccurs="0"/>
			<element name="security-ref" type="apache:Security-Ref" minOccurs="0"/>
			<element name="skin" type="apache:Skin" minOccurs="0"/>
			<element name="layout" type="apache:Layout" minOccurs="0"/>
			<element name="control" type="apache:Control" minOccurs="0"/>
			<element name="controller" type="apache:Controller" minOccurs="0"/>
			<element name="parameter" type="apache:Parameter" minOccurs="0" maxOccurs="unbounded"/>
			<element name="entry" type="apache:Entry" minOccurs="0" maxOccurs="unbounded"/>
			<element name="portlets" type="apache:Portlets" minOccurs="0" maxOccurs="unbounded"/>
			<element name="reference" type="apache:Reference" minOccurs="0" maxOccurs="unbounded"/>
		</sequence>
		<attribute name="id" type="string" use="optional"/>
		<attribute name="name" type="string" use="optional"/>
	</complexType>
	<complexType name="Reference">
		<annotation>
			<documentation> A reference to another PSML resource which is included into this PSML resource at the specified point in the markup. The reference is specified using a PSML resource locator in the path attribute of the reference PSML element</documentation>
		</annotation>
		<sequence>
			<element name="metainfo" type="apache:Metainfo" minOccurs="0"/>
			<element name="skin" type="apache:Skin" minOccurs="0"/>
			<element name="layout" type="apache:Layout" minOccurs="0"/>
			<element name="security" type="apache:Security" minOccurs="0"/>
		</sequence>
		<attribute name="id" type="string" use="optional"/>
		<attribute name="name" type="string" use="optional"/>
		<attribute name="path" type="string" use="optional"/>
	</complexType>
	<complexType name="Security">
		<attribute name="id" type="string" use="required"/>
	</complexType>
	<complexType name="Security-Ref">
		<attribute name="parent" type="string" use="required"/>
	</complexType>
	<complexType name="Skin">
		<annotation>
			<documentation>  This element is a parameter used by the control or controller to      customize the visual appearance of the portlet, pane or portlet set.      They should never influence the structural representation of the screen      The available list of properties is defined by the current control or     controller and set by the control(ler) or control(ler) customization pane       The name references a Skin entry in the system Registry that defines the     relevant properties.          The state defines whether the portlet should be shown in NORMAL mode,     MAXIMIZED mode, MINIMIZED mode or DETACHED. Not yet implemented.</documentation>
		</annotation>
		<sequence>
			<element name="property" minOccurs="0" maxOccurs="unbounded"/>
		</sequence>
		<attribute name="state" type="string" use="optional"/>
		<attribute name="name" type="string" use="optional"/>
	</complexType>
</schema>

--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to