'$RCSfile: eml.xsd,v $' Copyright: 1997-2002 Regents of the University ofCalifornia, University of New Mexico, and Arizona State University Sponsors: National Centerfor Ecological Analysis and Synthesis and Partnership for Interdisciplinary Studies of CoastalOceans, University of California Santa Barbara Long-Term Ecological Research Network Office,University of New Mexico Center for Environmental Studies, Arizona State University Otherfunding: National Science Foundation (see README for details) The David and Lucile PackardFoundation For Details: http://knb.ecoinformatics.org/ '$Author: obrien $' '$Date: 2008/04/0921:31:41 $' '$Revision: 1.59 $' This program is free software; you can redistribute it and/ormodify it under the terms of the GNU General Public License as published by the Free SoftwareFoundation; either version 2 of the License, or (at your option) any later version. Thisprogram is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; withouteven the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNUGeneral Public License for more details. You should have received a copy of the GNU GeneralPublic License along with this program; if not, write to the Free Software Foundation, Inc.,59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
moduleName: emlmoduleDescription: The eml module - A metadata container The eml module is a wrapper container that allows the inclusion of any metadata content in a single EML document. The eml module is used as a container to hold structured descriptions of ecological resources. In EML, the definition of a resource comes from the The Dublin Core Metadata Initiative , which describes a general element set used to describe "networked digital resources". The top-level structure of EML has been designed to be compatible with the Dublin Core syntax. In general, dataset resources, literature resources, software resources, and protocol resources comprise the list of information that may be described in EML. EML is largely designed to describe digital resources, however, it may also be used to describe non-digital resources such as paper maps and other non-digital media. In EML, the definition of a "Data Package" is the combination of both the data and metadata for a resource. So, data packages are built by using the <eml> wrapper, which will include all of the metadata, and optionally the data (or references to them). All EML packages must begin with the <eml> tag and end with the </eml> tag. The eml module may be extended to describe other resources by means of its optional sub-field, <additionalMetadata>. This field is largely reserved for the inclusion of metadata that may be highly discipline specific and not covered in this version of EML, or it may be used to internally extend fields within the EML standard. recommendedUsage: all datasetsstandAlone: yes
tooltip: Ecological Metadatasummary: A collection of EML metadata and additional metadata linked using the inline references.description: The "eml" element allows for the inclusion of any metadata content in a single EML document. In general, dataset resources, literature resources, and software resources, or another type that extends eml-resource are described using an eml document. The eml document represents a "package" that can contain both metadata and data. It can optionally include non-EML metadata through the flexibility of the "additionalMetadata" element. Any additional metadata that is provided can provide a pointer into the EML metadata indicating what the context of the additional metadata is (i.e., what it describes). For example, a spatial raster image might be described in EML, and an FGDC CSDGM metadata document could be included in the additionalMetadata element with a pointer to the EML spatialRaster element to indicate that the FGDC metadata is providing supplemental documentation about that particular image entity. There is no validity constraint that restricts what metadata may be present in additionalMetadata.
tooltip: Package Identifersummary: A globally unique identifier for the data package described by this EML metadata document that can be used to cite it elsewhere.description: A globally unique identifier for the data package described by this EML metadata document that can be used to cite it elsewhere. This identifier can be interpreted as the formal accession number for the data package, and is therefore required. It must be globally unique within a particular data management system, which should be specified in the system attribute as a URI. Typically a DOI or other identifier that is both citable and resolvable is used for published data packages.
tooltip: Identifer Scopesummary: The scope of the identifier.description: The scope of the identifier. Scope is generally set to either "system", meaning that it is scoped according to the "system" attribute, or "document" if it is only to be in scope within this single document instance. In this particular use of scope, it is FIXED to be "system" because the packageId is required and always has the scope of the required "system".
<xs:element name="eml"><xs:annotation><xs:documentation>tooltip: Ecological Metadata summary: A collection of EML metadata and additional metadata linked using the inline references. description: The "eml" element allows for the inclusion of any metadata content in a single EML document. In general, dataset resources, literature resources, and software resources, or another type that extends eml-resource are described using an eml document. The eml document represents a "package" that can contain both metadata and data. It can optionally include non-EML metadata through the flexibility of the "additionalMetadata" element. Any additional metadata that is provided can provide a pointer into the EML metadata indicating what the context of the additional metadata is (i.e., what it describes). For example, a spatial raster image might be described in EML, and an FGDC CSDGM metadata document could be included in the additionalMetadata element with a pointer to the EML spatialRaster element to indicate that the FGDC metadata is providing supplemental documentation about that particular image entity. There is no validity constraint that restricts what metadata may be present in additionalMetadata.</xs:documentation></xs:annotation><xs:complexType><xs:sequence><xs:element name="access" type="acc:AccessType" minOccurs="0"><xs:annotation><xs:documentation>tooltip: Access summary: Access control rules for the entire resource, which can be overridden by access rules in distribution trees description: An optional access tree at this location controls access to the entire metadata document. If this access element is omitted from the document, then the package submitter should be given full access to the package but all other users should be denied all access.</xs:documentation></xs:annotation></xs:element><xs:choice><xs:element name="dataset" type="ds:DatasetType"><xs:annotation><xs:documentation>tooltip: Dataset Resource summary: A resource that describes a data set, which can include one or more data entities such as data tables. description: A resource that describes a data set, which can include one or more data entities such as data tables and spatial images (raster and vector). If included, this represents the primary resource that is described in this eml document.</xs:documentation></xs:annotation></xs:element><xs:element name="citation" type="cit:CitationType"><xs:annotation><xs:documentation>tooltip: Literature Resource summary: A resource that describes a literature citation that one might find in a bibliography. description: A resource that describes a literature citation that one might find in a bibliography. If included, this represents the primary resource that is described in this eml document.</xs:documentation></xs:annotation></xs:element><xs:element name="software" type="sw:SoftwareType"><xs:annotation><xs:documentation>tooltip: Software Resource summary: A resource that describes a software package, which can include commercial and non-commercial software as well as data processing programs. description: A resource that describes a software package, which can include commercial and non-commercial software as well as data processing programs. If included, this represents the primary resource that is described in this eml document.</xs:documentation></xs:annotation></xs:element><xs:element name="protocol" type="pro:ProtocolType"><xs:annotation><xs:documentation>tooltip: Protocol Resource summary: A resource that describes a scientific protocol, which can include one or more descriptions of methods and procedures. description: A resource that describes a scientific protocol, which can include one or more descriptions of methods and procedures. If included, this represents the primary resource that is described in this eml document.</xs:documentation></xs:annotation></xs:element></xs:choice><xs:element name="annotations" minOccurs="0" maxOccurs="1"><xs:annotation><xs:documentation>tooltip: Semantic Annotation List summary: A list of precisely-defined semantic statements about this resource. description: A list of annotations defining precise semantics for parts of this resource. The list consists of a set of annotation elements, each referring to a subject within the EML document using its references attribute, which provides a pointer to the id of the element being annotated.</xs:documentation></xs:annotation><xs:complexType><xs:sequence><xs:element name="annotation" minOccurs="1" maxOccurs="unbounded"><xs:annotation><xs:documentation>tooltip: Semantic Annotation summary: A precisely-defined semantic statement about an element in the EML document. description: An annotation represents a precisely-defined semantic statement that applies to this resource. This semantic statement is used to associate precise semantics with a particular element in the EML document. The id of the element being annotated is listed in the references attribute, and must point to a unique id within the EML document. Each annotation consists of a propertyURI and valueURI that define a property and value that apply to the resource. The subject of the statement is implicitly the element that is listed in the references attribute. The associated labels can be used to display the statement to users. Each URI is resolvable to a controlled vocabulary that provides a definition, relationships to other terms, and multiple labels for displaying the statement.</xs:documentation></xs:annotation><xs:complexType><xs:complexContent><xs:extension base="sem:SemanticAnnotation"><xs:attribute name="references" type="xs:string" use="required"/></xs:extension></xs:complexContent></xs:complexType></xs:element></xs:sequence></xs:complexType></xs:element><xs:element name="additionalMetadata" minOccurs="0" maxOccurs="unbounded"><xs:annotation><xs:documentation>tooltip: Additional Metadata summary: A flexible field for including any other relevant metadata that pertains to the resource being described. description: A flexible field for including any other relevant metadata that pertains to the resource being described. This field allows EML to be extensible in that any XML-based metadata can be included in this element, including metadata from other standards such as the FGDC CSDGM. The "describes" element of this field allows the specific part of the resource which is described by the additional metadata to be indicated formally.</xs:documentation></xs:annotation><xs:complexType><xs:sequence><xs:element name="describes" type="res:NonEmptyStringType" minOccurs="0" maxOccurs="unbounded"><xs:annotation><xs:documentation>tooltip: Describes Reference summary: A pointer to the id attribute for the sub-portion of the resource that is described by this additional metadata. description: A pointer to the id attribute for the sub-portion of the resource that is described by this additional metadata. This is a formal field in that it is an error to provide a value in the "describes" element that does not correspond to the value of one of the "id" attributes in another eml module. This is designed to allow automated processors to discover the contextual relationship between the additional metadata and the resource it describes.</xs:documentation></xs:annotation></xs:element><xs:element name="metadata"><xs:annotation><xs:documentation>tooltip: Additional metadata summary: This element contains the additional metadata that is to be included in the document. The content of this field can be any well-formed XML fragment. description: This element contains the additional metadata to be included in the document. This element should be used for extending EML to include metadata that is not already available in another part of the EML specification, or to include site- or system-specific extensions that are needed beyond the core metadata. The additional metadata contained in this field describes the element referenced in the 'describes' element preceding it. The content of this field is any well-formed XML fragment. If that content contains namespace declarations, and if the namespace declaration can be resolved to a schema definition, then the content will be validated against that schema definition. If no namespace is present, or if no schema can be resolved, validation for this fragment will be skipped (validation is "lax").</xs:documentation></xs:annotation><xs:complexType><xs:sequence><xs:any processContents="lax"><xs:annotation><xs:documentation>tooltip: Any Metadata summary: Any well-formed XML-formatted metadata may be inserted at this location in the EML document. If an element inserted here contains a reference to its namespace, and if there is an association between that namespace and an XML Schema that can be located by the processing application, then the processing application must validate the metadata element. If these conditions are not met, then validation need not occur. description: Any well-formed XML-formatted metadata may be inserted at this location in the EML document. If an element inserted here contains a reference to its namespace, and if there is an association between that namespace and an XML Schema that can be located by the processing application, then the processing application must validate the metadata element. If these conditions are not met, then validation need not occur.</xs:documentation></xs:annotation></xs:any></xs:sequence></xs:complexType></xs:element></xs:sequence><xs:attribute name="id" type="res:IDType" use="optional"/></xs:complexType></xs:element></xs:sequence><xs:attribute name="packageId" type="xs:string" use="required"><xs:annotation><xs:documentation>tooltip: Package Identifer summary: A globally unique identifier for the data package described by this EML metadata document that can be used to cite it elsewhere. description: A globally unique identifier for the data package described by this EML metadata document that can be used to cite it elsewhere. This identifier can be interpreted as the formal accession number for the data package, and is therefore required. It must be globally unique within a particular data management system, which should be specified in the system attribute as a URI. Typically a DOI or other identifier that is both citable and resolvable is used for published data packages.</xs:documentation></xs:annotation></xs:attribute><xs:attribute name="system" type="res:SystemType" use="required"/><xs:attribute name="scope" type="res:ScopeType" fixed="system"><xs:annotation><xs:documentation>tooltip: Identifer Scope summary: The scope of the identifier. description: The scope of the identifier. Scope is generally set to either "system", meaning that it is scoped according to the "system" attribute, or "document" if it is only to be in scope within this single document instance. In this particular use of scope, it is FIXED to be "system" because the packageId is required and always has the scope of the required "system".</xs:documentation></xs:annotation></xs:attribute><xs:attribute ref="xml:lang" use="optional"/></xs:complexType></xs:element>