***** VOCABULARY schemas to include ***** ***** ROOT element ***** annotationRecordType is complex ***** Complex Types and Groups (alpha order) ***** annotationType - part of annotationRecordType annotationRecordType - is the ROOT type basicType - part of contentType contentType - part of annotationType contributorType - part of contributorsType contributorsType - part annotationType dateType - part of serviceType headerType - part of outlinesType moreInfoType - part of annotationRecordType organizationType - part of contributorType outlineType - part of outlinesType outlinesType - part of annotationType personType - part of contributorType serviceType - part of annotationType standardType - part of standardsType standardsType - part of contentType ***** 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, description 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 outlines - hierarchical or categorical classifications of content (e.g. educational standards); 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 ***** basicType ***** contentType - the content of the annotation expressed as a rating, description or URL description - the narrative of or an explanation about the annotation; simple type rating - an overall judgment of a resource; complex 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 ***** contentType ***** basic - a url that provides annotation information, a description that is the annotation or enhances other sections of annotation information or a star rating of a resource standards - a list of indentification numbers that refer to standards that support a resource ***** contributorType ***** contributorType - an individual person or individual organization 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 information can be made public; built-in type ***** contributorsType ***** contributorsType - persons or organizations making the annotation contributor - an individual person or individual organization 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 annotation metadata record; built-in type; attribute ***** headerType ***** headerType - the label for and type of classification; may also indicate location outline - a label for one level of the classification scheme text - the organizing label for a classification scheme type - the kind of classification scheme location - the place (US state, Mexican state, Canadian province or country of the world) the classification scheme applies ***** 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 ***** outlineType ***** outline - a label for one level of the classification scheme ***** outlinesType ***** header - the label for and type of classification; may also indicate location outline - a label for one level of the classification scheme ***** 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 individual person; simple type emailAlt - an alternate email of the individual 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 ***** standardType ***** standardType - an identification number that refers to a standard, not the standard itself, that support the resource being annotated authority - the organization or group that promotes or supports the classification scheme of identifiers that refer to standards (content, educational, professional, teaching, process) supporting the resource being annotated alignment - the strength of the association between the standard and the resource being annotated ***** standardsType ***** standardsType - a list of indentification numbers that refer to standards that support a resource standard - an identification number that refers to a standard, not the standard itself, that support the resource being annotated; authority and alignment information can be included ***** 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 union.locationType - list of US states, Mexican states, Canadian provinces and countries of the world; see location.xsd union.typeType - a list of kinds of classification schemes, may be formal or informal schemes 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 list of US states, Mexican states, Canadian provinces and countries of the world; see location.xsd a list of kinds of classification schemes, may be formal or informal schemes ***** SCHEMA PURPOSE ****** Defines the annotation metadata framework for the Digital Library for Earth 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. *** 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 element 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