***** SCHEMA PURPOSE ****** Defines the annotation metadata framework for the Digital Library for Earrth System Education (DLESE) Allows comments, teaching tips, opinions, reviews on use or context, educational standards Includes information on the status of the annotation, the type of annotation, format of the annotation, the annotating service and access to the annotation contents either directly or through a URL Includes the name of the individual annotator or annotating organization but it may be anonymous Allows for resources to be rated; see the rating controlled vocabulary in ratings.xsd Contains pathway information for deciding when annotated items are part of the DLESE Reviewed Collection (DRC) ***** SCHEMA EXPLANATION ***** This is the MAIN schema for the DLESE annotation metadata framework This MAIN schema may call other CATEGORY schemas to create the metadata framework structure. CATEGORY schemas may call other CATEGORY schemas or VOCABULARY schemas in building the metadata structure. ***** NAMESPACES ***** The chameleon approach to namespace conventions is used in the CATEGORY and VOCABULARY schemas. Only this MAIN schema has a target namespace, http://www.dlese.org/annotation The CATEGORY and VOCABULARY schemas do not have target namespaces (allows for plug-n-play components and vocabularies). ***** ROOT ELEMENT ***** The root element of this schema is annotationRecord. ***** SCHEMA DEVELOPMENT ***** The Venetian Blind approach is used for this MAIN schema and all other CATEGORY and VOCABULARY schemas. Elements within all schemas are used for fields (quantities) of the annotation metadata framework. When elements have controlled vocabularies that are hierarchal, the vocabularies appear in the element as a colon separated text string. Attributes are used when additional information is required for the content of an element or if two pieces of information are required. ***** HISTORY ***** 2006-11-13: In the content element, changed xsd:choice min occurs=1, max occurs=3 to xsd:all *** DEFINING COMPLEX and SIMPLE TYPES ***** Since the metadata framework uses Venetian Blind schema development, most metadata fields are defined as complex or simple types. This improves re-use for other frameworks developed at the DLESE Program Center (DPC) or within the DLESE community. As such, each schema has a complex and simple type section. Built-in simple types are defined when an elment is defined. Derived simple types are used when a metadata field appears more than once in a CATEGORY schema or if restrictions are needed on element content. *** LICENSE INFORMATION ***** Copyright 2002-2006 DLESE Program Center University Corporation for Atmospheric Research (UCAR) P.O. Box 3000, Boulder, CO 80307, United States of America email: support@dlese.org. This schema is free software; you can redistribute them and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. These schemas are distributed in the hope that they 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 project; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA ***** Other CATEGORY schemas to include ***** ***** VOCABULARY schemas to include ***** ***** ROOT element ***** annotationRecordType is complex ***** Complex Types and Groups (alpha order) ***** annotationType - part of annotationRecordType annotationRecordType - is the ROOT type contentType - part of annotationType contributorType - part of contributorsType contributorsType - part annotationType dateType - part of serviceType moreInfoType - part of annotationRecordType organizationType - part of contributorType personType - part of contributorType serviceType - part of annotationType ***** annotationType ***** annotationType - information (contents, contributor, type, etc.) about the annotation title - the title of the annotation if one exists; simple type type - the type of annotation; complex type; see type.xsd format - the format of the annotation; simple type, see format.xsd date - the date of the annotation; simple type status - indicates a status associated with the annotation information; simple type; see status.xsd content - the content of the annotation expressed as a rating, decription or URL; complex type context - a URL within (not the primary resource URL) the annotated resource to which the annotation applies; complex type contributors - persons or organizations making the annotation; complex type ***** annotationRecordType ***** annotationRecordType - the type for the root element of annotationRecord service - information about the annotation service and the metadata record; complex type itemID - the catalog record identification number of the item being annotated; simple type annotation - information (contents, contributor, type, etc.) about the annotation; complex type ***** contentType ***** contentType - the content of the annotation expressed as a rating, decription or URL description - the narrative of or an explanation about the annotation; simple type rating - an overall judgment of a resource; complext type; see rating.xsd url - a link that provides access to or more information about the annotation; simple type stringTextType - a regular expression requiring content to be present (text or child elements); simple type ***** contributorType ***** contributorType - an individual person or individual ogranization making the annotation date - the calendar date the contributor made the annotation; attribute; simple type; (may only be known to the year) organization - the organization making the annotation; complex type person - the individual making the annotation; complex type role - the role of the annotator in making the annotation; simple type; attribute; see roleAnnotation.xsd share - an indication of whether the contributor inforamtion can be made public; built-in type ***** contributorsType ***** contributorsType - persons or organizations making the annotation contributor - an individual person or individual ogranization making the annotation; complex type ***** dateType ***** dateType - calendar date for the creation or modification of the metadata record created - the creation date of the annotation metadata record; built-in type; attribute modified - the modification date of the annoation metadata record; built-in type; attribute ***** moreInfoType ***** moreInfoType - allows any additional XML elements (not plain text) to be in the metadata record ***** organizationType ***** organizationType - information about the organization making the annotation instName - the name of the institution; simple type instDept - the department name within the institution; simple type instPosition - a professional position within the institution; simple type url - the url of the institution; simple type email - an email address for the institution; simple type ***** personType ***** personType - information about an individual person nameTitle - the form of address of the individual person; simple type; see nameTitle.xsd nameFirst - the first name of the individual person; simple type nameMiddle - the middle name of the individual person; simple type nameLast - the last name or family name of the individual person; simple type instName - the institutional affiliation of the individual person; simple type instDept - the department of the institution the individual person is associated with; simple type instPosition - the professional position of the individual person in their affiliated institution; simple type email - the email of the inidividual person; simple type emailAlt - an alternate email of the inidividual person; simple type ***** serviceType ***** serviceType - information about the annotation service name - the name of the annotation service; simple type recordID - the catalog record number of the metadata record; simple type date - information pertaining to date the annotation record was created or modified; complex type pathway - the name of the group approving resources for the DLESE Reviewed Collection (DRC); should only be used in consultation with the DLESE Program Center; simple type; see pathway.xsd ***** Simple Types (alpha order) ***** stringTextType - a pattern used to exclude null content from strings union.dateType - calendar dates of the form YYYY, YYYY-MM, YYYY-MM-DD stringTextType - a regular expression that enforce the presence of content (text or elements) Pattern \s*.[\S\s]* ensures that a null tag is not valid string content Pattern \s*.[\S\s]* allows leading blank characters and leading carriage returns Pattern .[\S\s]* ensures that a null tag is not valid string content Pattern .[\S\s]* does not allow leading blank characters or carriage returns Pattern .*\S+[\s\S]* ensures that a null tag is not valid string content Pattern .*\S+[\s\S]* allows leading blank characters but not leading carriage returns Note: that xsd:string allows content to be null even if the element is required Note: that xsd:string with nillable equal false allows content to be null even if the element is required union.dateType - calendar dates of the form YYYY, YYYY-MM, YYYY-MM-DD