Project

General

Profile

Bug #568 ยป eml-resource-test.xsd

Peter McCartney, 09/09/2002 10:59 AM

 
1
<?xml version="1.0"?>
2
<xs:schema targetNamespace="eml://ecoinformatics.org/resource-2.0.0rc1" xmlns="eml://ecoinformatics.org/resource-2.0.0rc1" xmlns:cov="eml://ecoinformatics.org/coverage-2.0.0rc1" xmlns:rp="eml://ecoinformatics.org/party-2.0.0rc1" xmlns:txt="eml://ecoinformatics.org/text-2.0.0rc1" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:doc="eml://ecoinformatics.org/documentation-2.0.0rc1">
3
<xs:import namespace="eml://ecoinformatics.org/documentation-2.0.0rc1" schemaLocation="eml-documentation.xsd"/>
4
<xs:import namespace="eml://ecoinformatics.org/party-2.0.0rc1" schemaLocation="eml-party.xsd"/>
5
<xs:import namespace="eml://ecoinformatics.org/coverage-2.0.0rc1" schemaLocation="eml-coverage.xsd"/>
6
<xs:import namespace="eml://ecoinformatics.org/text-2.0.0rc1" schemaLocation="eml-text.xsd"/>
7
<xs:annotation>
8
<xs:documentation>
9
       '$RCSfile: eml-resource.xsd,v $'
10
       Copyright: 1997-2002 Regents of the University of California,
11
                            University of New Mexico, and
12
                            Arizona State University
13
        Sponsors: National Center for Ecological Analysis and Synthesis and
14
                  Partnership for Interdisciplinary Studies of Coastal Oceans,
15
                     University of California Santa Barbara
16
                  Long-Term Ecological Research Network Office,
17
                     University of New Mexico
18
                  Center for Environmental Studies, Arizona State University
19
   Other funding: National Science Foundation (see README for details)
20
                  The David and Lucile Packard Foundation
21
     For Details: http://knb.ecoinformatics.org/
22

    
23
        '$Author: jones $'
24
          '$Date: 2002/09/09 08:16:52 $'
25
      '$Revision: 1.60 $'
26

    
27
    This program is free software; you can redistribute it and/or modify
28
    it under the terms of the GNU General Public License as published by
29
    the Free Software Foundation; either version 2 of the License, or
30
    (at your option) any later version.
31

    
32
    This program is distributed in the hope that it will be useful,
33
    but WITHOUT ANY WARRANTY; without even the implied warranty of
34
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
35
    GNU General Public License for more details.
36

    
37
    You should have received a copy of the GNU General Public License
38
    along with this program; if not, write to the Free Software
39
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA    
40
    </xs:documentation>
41
<xs:appinfo>
42
<doc:moduleDocs>
43
<doc:moduleName>eml-resource</doc:moduleName>
44
<doc:moduleDescription>The eml-resource module contains general
45
        information that describes dataset resources, literature resources,
46
        collection resources, and software resources. It is intended to provide
47
        overview information about the resource, including title, abstract,
48
        keywords, contacts, and the links to associated metadata and data for
49
        the given resource.</doc:moduleDescription>
50
<doc:recommendedUsage>all datasets</doc:recommendedUsage>
51
<doc:standAlone>no</doc:standAlone>
52
</doc:moduleDocs>
53
</xs:appinfo>
54
</xs:annotation>
55
<xs:group name="ResourceGroup">
56
<xs:annotation>
57
<xs:appinfo>
58
<doc:tooltip>Resource Base</doc:tooltip>
59
<doc:summary>Generic information about any resource that is being
60
        described.</doc:summary>
61
<doc:description>The 'ResourceBase' complexType contains information
62
        that is inherited by each resource type that is being documented. The
63
        subelements with the resource base are common to all
64
        resources.</doc:description>
65
<doc:example>Please see the individual sub-fields for specific
66
        examples.</doc:example>
67
<doc:lineage>The 'ResourceBase' element was introduced into EML
68
        2.0.</doc:lineage>
69
</xs:appinfo>
70
</xs:annotation>
71
<xs:sequence>
72
<xs:element name="alternateIdentifier" minOccurs="0" maxOccurs="unbounded">
73
<xs:annotation>
74
<xs:appinfo>
75
<doc:tooltip>Alternate Identifier</doc:tooltip>
76
<doc:summary>A secondary identifier for this entity</doc:summary>
77
<doc:description>An additional, secondary identifier for this
78
            entity. The primary identifier belongs in the "id" attribute, but
79
            additional identifiers that are used to label this entity, possibly
80
            from different data management systems, can be listed
81
            here.</doc:description>
82
<doc:example>VCR3465</doc:example>
83
<doc:lineage>As of EML 2.0.0</doc:lineage>
84
</xs:appinfo>
85
</xs:annotation>
86
<xs:complexType>
87
<xs:simpleContent>
88
<xs:extension base="xs:string">
89
<xs:attribute name="system" type="xs:string" use="optional">
90
<xs:annotation>
91
<xs:appinfo>
92
<doc:tooltip>Identifier System</doc:tooltip>
93
<doc:summary>The system in which this id is
94
                    relevant</doc:summary>
95
<doc:description>The computing system within which this
96
                    identifier has relevance. Generally, the identifier would
97
                    be unique within the "system" and would be sufficient to
98
                    retrieve the entity from the system. The system is often a
99
                    URL or URI that identifies the main entry point for the
100
                    data management system.</doc:description>
101
<doc:example>
102
                    http://knb.ecoinformatics.org/knb/</doc:example>
103
<doc:lineage>As of EML 2.0.0</doc:lineage>
104
</xs:appinfo>
105
</xs:annotation>
106
</xs:attribute>
107
</xs:extension>
108
</xs:simpleContent>
109
</xs:complexType>
110
</xs:element>
111
<xs:element name="shortName" type="xs:string" minOccurs="0">
112
<xs:annotation>
113
<xs:appinfo>
114
<doc:tooltip>Short Name</doc:tooltip>
115
<doc:summary>A short name that describes the resource, sometimes a
116
            filename.</doc:summary>
117
<doc:description>The 'shortName' field provides a concise name that
118
            describes the resource that is being documented. It is the
119
            appropriate place to store a filename associated with other storage
120
            systems.</doc:description>
121
<doc:example>vernal-data-1999</doc:example>
122
<doc:lineage>This element was derived from elements described in
123
            the ISO 19115.3 standard (iso-geo-md-2000June-draft).</doc:lineage>
124
</xs:appinfo>
125
</xs:annotation>
126
</xs:element>
127
<xs:element name="title" type="xs:string" maxOccurs="unbounded">
128
<xs:annotation>
129
<xs:appinfo>
130
<doc:tooltip>Title</doc:tooltip>
131
<doc:summary>A brief description of the resource, providing enough
132
            detail to differentiate it from other similar
133
            resources.</doc:summary>
134
<doc:description>The 'title' field provides a description of the
135
            resource that is being documented that is long enough to
136
            differentiate it from other similar resources. Multiple titles may
137
            be provided, particularly when trying to express the title in more
138
            than one language (use the "xml:lang" attribute to indicate the
139
            language if not English/en).</doc:description>
140
<doc:example>Vernal pool amphibian density data, Isla Vista,
141
            1990-1996.</doc:example>
142
<doc:lineage>This element was derived from elements described in
143
            the ISO 19115.3 standard (iso-geo-md-2000June-draft).</doc:lineage>
144
</xs:appinfo>
145
</xs:annotation>
146
</xs:element>
147
<xs:element name="creator" type="rp:ResponsibleParty" maxOccurs="unbounded">
148
<xs:annotation>
149
<xs:appinfo>
150
<doc:tooltip>Creator</doc:tooltip>
151
<doc:summary>The people or organizations who created this
152
            resource.</doc:summary>
153
<doc:description>The 'creator' element provides the full name of
154
            the person, organization, or position who created the resource. The
155
            list of creators for a resource represent the people and
156
            organizations who should be cited for the
157
            resource.</doc:description>
158
<doc:example>For a book, the creators are its
159
            authors.</doc:example>
160
<doc:lineage>This element was derived from elements described in
161
            the FGDC-STD-001.1-1999 standard (nbii-fgdc-std-001.1-1999). It has
162
            parallel semantics to the Creator element in Dublin
163
            Core.</doc:lineage>
164
</xs:appinfo>
165
</xs:annotation>
166
</xs:element>
167
<xs:element name="metadataProvider" type="rp:ResponsibleParty" minOccurs="0" maxOccurs="unbounded">
168
<xs:annotation>
169
<xs:appinfo>
170
<doc:tooltip>Metadata Provider</doc:tooltip>
171
<doc:summary>The people or organizations who created provided
172
            documentation and other metadata for this resource.</doc:summary>
173
<doc:description>The 'metadataProvider' element provides the full
174
            name of the person, organization, or position who created
175
            documentation for the resource.</doc:description>
176
<doc:example>The scientist who collected the data, sometimes a data
177
            technician, or other individual.</doc:example>
178
<doc:lineage>New in EML 2.0.0.</doc:lineage>
179
</xs:appinfo>
180
</xs:annotation>
181
</xs:element>
182
<xs:element name="associatedParty" minOccurs="0" maxOccurs="unbounded">
183
<xs:annotation>
184
<xs:appinfo>
185
<doc:tooltip>Associated Party</doc:tooltip>
186
<doc:summary>Other people or organizations who should be associated
187
            with this resource.</doc:summary>
188
<doc:description>The 'associatedParty' element provides the full
189
            name of other people, organizations, or positions who should be
190
            associated with the resource. These parties might play various
191
            roles in the creation or maintenance of the resource, and these
192
            roles should be indicated in the "role" element.</doc:description>
193
<doc:example>The technician who collected the data.</doc:example>
194
<doc:lineage>New in EML 2.0.0.</doc:lineage>
195
</xs:appinfo>
196
</xs:annotation>
197
<xs:complexType>
198
<xs:complexContent>
199
<xs:extension base="rp:ResponsibleParty">
200
<xs:sequence>
201
<xs:element name="role" type="rp:RoleType">
202
<xs:annotation>
203
<xs:appinfo>
204
<doc:tooltip>Role</doc:tooltip>
205
<doc:summary>The role the party played with respect to
206
                      the resource.</doc:summary>
207
<doc:description>Use this field to describe the role the
208
                      party played with respect to the resource. Some potential
209
                      roles include technician, reviewer, principal
210
                      investigator, and many others.</doc:description>
211
<doc:example>principalInvestigator</doc:example>
212
<doc:lineage>From ISO.</doc:lineage>
213
</xs:appinfo>
214
</xs:annotation>
215
</xs:element>
216
</xs:sequence>
217
</xs:extension>
218
</xs:complexContent>
219
</xs:complexType>
220
</xs:element>
221
<xs:element name="pubDate" type="yearDate" minOccurs="0">
222
<xs:annotation>
223
<xs:appinfo>
224
<doc:tooltip>Publication date</doc:tooltip>
225
<doc:summary>The publication date of the resource.</doc:summary>
226
<doc:description>The 'pubDate' field represents the date that the
227
            resource was published. The format should be represented as: CCYY,
228
            which represents a 4 digit year, or as CCYY-MM-DD, which denotes
229
            the full year, month, and day. Note that month and day are optional
230
            components. Formats must conform to ISO 8601.</doc:description>
231
<doc:example>1999-10-26</doc:example>
232
<doc:lineage>This element was derived from elements described in
233
            the FGDC-STD-001.1-1999 standard (nbii-fgdc-std-001.1-1999) The
234
            string should follow the date standard described in ISO
235
            8601.</doc:lineage>
236
</xs:appinfo>
237
</xs:annotation>
238
</xs:element>
239
<xs:element name="language" type="xs:string" minOccurs="0">
240
<xs:annotation>
241
<xs:appinfo>
242
<doc:tooltip>Language</doc:tooltip>
243
<doc:summary>The language in which the resource is
244
            written.</doc:summary>
245
<doc:description>The language in which the resource is written.
246
            This can be a well-known language name, or one of the ISO language
247
            codes to be more precise.</doc:description>
248
<doc:example>English</doc:example>
249
<doc:lineage>From Dublin Core Element Set.</doc:lineage>
250
</xs:appinfo>
251
</xs:annotation>
252
</xs:element>
253
<xs:element name="series" type="xs:string" minOccurs="0">
254
<xs:annotation>
255
<xs:appinfo>
256
<doc:tooltip>Series</doc:tooltip>
257
<doc:summary>The series from which the resource came.</doc:summary>
258
<doc:description>This field describes the series of resources that
259
            include the resource being described. For example, a volume of a
260
            journal may be part of a series of the journal for a particular
261
            year.</doc:description>
262
<doc:example>Volume 20</doc:example>
263
<doc:lineage>This element was derived from elements described in
264
            the FGDC-STD-001.1-1999 standard (nbii-fgdc-std-001.1-1999) and ISO
265
            19115.3 standard (iso-geo-md-2000June-draft)</doc:lineage>
266
</xs:appinfo>
267
</xs:annotation>
268
</xs:element>
269
<xs:element name="abstract" type="txt:TextType" minOccurs="0">
270
<xs:annotation>
271
<xs:appinfo>
272
<doc:tooltip>Abstract</doc:tooltip>
273
<doc:summary>A brief overview of the resource.</doc:summary>
274
<doc:description>A brief overview of the resource that is being
275
            documented. The abstract should include basic information that
276
            summarizes the resource.</doc:description>
277
<doc:lineage>This element was derived from elements described in
278
            the FGDC-STD-001.1-1999 standard
279
            (nbii-fgdc-std-001.1-1999)</doc:lineage>
280
</xs:appinfo>
281
</xs:annotation>
282
</xs:element>
283
<xs:element name="keywordSet" minOccurs="0" maxOccurs="unbounded">
284
<xs:annotation>
285
<xs:appinfo>
286
<doc:tooltip>Keyword information</doc:tooltip>
287
<doc:summary>Keyword information that describes the
288
            resource.</doc:summary>
289
<doc:description>The 'keywordSet' element is a container for the
290
            'keyword' and 'keywordThesaurus' fields. Each keywordSet field can
291
            contain one or more keywords and a name of a thesaurus for the set
292
            of keywords. Each keyword field should contain one and only one
293
            keyword (i.e., keywords should not be separated by commas or other
294
            delimiters).</doc:description>
295
<doc:example>Please see the examples for the subfields contained
296
            within this field.</doc:example>
297
<doc:lineage>This element was derived from elements described in
298
            the FGDC-STD-001.1-1999 standard
299
            (nbii-fgdc-std-001.1-1999)</doc:lineage>
300
</xs:appinfo>
301
</xs:annotation>
302
<xs:complexType>
303
<xs:sequence>
304
<xs:element name="keyword" maxOccurs="unbounded">
305
<xs:annotation>
306
<xs:appinfo>
307
<doc:tooltip>Keyword</doc:tooltip>
308
<doc:summary>A single keyword that describes the
309
                  resource.</doc:summary>
310
<doc:description>This field names a keyword or keyphrase that
311
                  concisely describes the resource or is related to the
312
                  resource. Each keyword field should contain one and only one
313
                  keyword (i.e., keywords should not be separated by commas or
314
                  other delimiters).</doc:description>
315
<doc:example>biodiversity</doc:example>
316
<doc:lineage>This field was introduced into EML 2.0 beta 1,
317
                  and was derived from EML 1.3. and the ISO 19115.3 standard
318
                  (iso-geo-md-2000June-draft).</doc:lineage>
319
</xs:appinfo>
320
</xs:annotation>
321
<xs:complexType>
322
<xs:simpleContent>
323
<xs:extension base="xs:string">
324
<xs:attribute name="keywordType" type="KeyTypCode" use="optional">
325
<xs:annotation>
326
<xs:appinfo>
327
<doc:tooltip>Keyword type</doc:tooltip>
328
<doc:summary>The type of each keyword.</doc:summary>
329
<doc:description>This field classifies the keyword
330
                          that has been provided from a list of pre-determined
331
                          categories. The possible types are listed in the
332
                          example.</doc:description>
333
<doc:example>
334
                          "discipline","place","stratum","temporal","thematic",
335
                          or "taxonomic"</doc:example>
336
<doc:lineage>This field was introduced into EML 2.0,
337
                          and was derived from EML 1.3. and the ISO 19115.3
338
                          standard(iso-geo-md-2000June-draft).</doc:lineage>
339
</xs:appinfo>
340
</xs:annotation>
341
</xs:attribute>
342
</xs:extension>
343
</xs:simpleContent>
344
</xs:complexType>
345
</xs:element>
346
<xs:element name="keywordThesaurus" type="xs:string" minOccurs="0">
347
<xs:annotation>
348
<xs:appinfo>
349
<doc:tooltip>Keyword thesaurus</doc:tooltip>
350
<doc:summary>The name of a thesaurus from which the keyword
351
                  is derived.</doc:summary>
352
<doc:description>This field provides the name of the official
353
                  keyword thesaurus from which keyword was derived. The keyword
354
                  thesauri are usually discipline specific.</doc:description>
355
<doc:example>IRIS keyword thesaurus</doc:example>
356
<doc:lineage>This field was introduced into EML 2.0, and was
357
                  derived from EML 1.3. and the ISO 19115.3
358
                  standard(iso-geo-md-2000June-draft).</doc:lineage>
359
</xs:appinfo>
360
</xs:annotation>
361
</xs:element>
362
</xs:sequence>
363
</xs:complexType>
364
</xs:element>
365
<xs:element name="additionalInfo" type="txt:TextType" minOccurs="0" maxOccurs="unbounded">
366
<xs:annotation>
367
<xs:appinfo>
368
<doc:tooltip>Additional Information</doc:tooltip>
369
<doc:summary>Any extra information pertitent to the
370
            resource.</doc:summary>
371
<doc:description>This field provides any information that is not
372
            characterized by the other resource metadata
373
            fields.</doc:description>
374
<doc:example>Copyright 2001, Robert Warner</doc:example>
375
<doc:lineage>This element was derived from elements described in
376
            the FGDC-STD-001.1-1999 standard
377
            (nbii-fgdc-std-001.1-1999)</doc:lineage>
378
</xs:appinfo>
379
</xs:annotation>
380
</xs:element>
381
<xs:element name="intellectualRights" type="txt:TextType" minOccurs="0">
382
<xs:annotation>
383
<xs:appinfo>
384
<doc:tooltip>Intellectual Property Rights</doc:tooltip>
385
<doc:summary>Intellectual property rights regarding usage and
386
            licensing of this resource.</doc:summary>
387
<doc:description>Typically, an intellectual Rights element will
388
            contain a rights management statement for the resource, or
389
            reference a service providing such information. Rights information
390
            encompasses Intellectual Property Rights (IPR), Copyright, and
391
            various Property Rights. In the case of a data set, rights might
392
            incude requirements for use, requirements for attribution, or other
393
            requirements the owner would like to impose.</doc:description>
394
<doc:example>Copyright 2001 Regents of the University of California
395
            Santa Barbara. Free for use by all individuals provided that the
396
            owners are acknowledged in any use or publication.</doc:example>
397
<doc:lineage>Introduced in EML 2.0, derived from Dublin Core
398
            Element Set 1.1.</doc:lineage>
399
</xs:appinfo>
400
</xs:annotation>
401
</xs:element>
402
<xs:element name="distribution" type="DistributionType" minOccurs="0" maxOccurs="unbounded">
403
<xs:annotation>
404
<xs:appinfo>
405
<doc:tooltip>Distribution Information</doc:tooltip>
406
<doc:summary>Information on how the resource is distributed online
407
            and offline</doc:summary>
408
<doc:description>This element provides information on how the
409
            resource is distributed online and offline. Connections to online
410
            systems can be described as URLs and as a list of relevant
411
            connection parameters.</doc:description>
412
<doc:example/>
413
<doc:lineage>Derived from distribution elements in the FGDC
414
            standard.</doc:lineage>
415
</xs:appinfo>
416
</xs:annotation>
417
</xs:element>
418
<xs:element name="coverage" type="cov:Coverage" minOccurs="0">
419
<xs:annotation>
420
<xs:appinfo>
421
<doc:tooltip>Resource coverage</doc:tooltip>
422
<doc:summary>Extent of the coverage of the resource.</doc:summary>
423
<doc:description>This element describes the extent of the coverage
424
            of the resource in terms of its spatial extent, temporal extent,
425
            and taxonomic extent. For data sets, this is useful to specify the
426
            entire extent to which all of the data might
427
            apply.</doc:description>
428
<doc:example>See the coverage module for examples.</doc:example>
429
<doc:lineage>Derived from the temporalCoverage element that was
430
            introduced into EML 1.4.</doc:lineage>
431
</xs:appinfo>
432
</xs:annotation>
433
</xs:element>
434
</xs:sequence>
435
</xs:group>
436
<xs:simpleType name="KeyTypCode">
437
<xs:annotation>
438
<xs:appinfo>
439
<doc:tooltip>Keyword type codes</doc:tooltip>
440
<doc:summary>The list of keyword categories</doc:summary>
441
<doc:description>This field provides a restricted list of categories
442
        that a keyword may fall under.</doc:description>
443
<doc:example>place</doc:example>
444
<doc:lineage/>
445
</xs:appinfo>
446
</xs:annotation>
447
<xs:restriction base="xs:string">
448
<xs:enumeration value="place"/>
449
<xs:enumeration value="stratum"/>
450
<xs:enumeration value="temporal"/>
451
<xs:enumeration value="theme"/>
452
<xs:enumeration value="taxonomic"/>
453
</xs:restriction>
454
</xs:simpleType>
455
<xs:simpleType name="yearDate">
456
<xs:annotation>
457
<xs:appinfo>
458
<doc:tooltip>Year or Date</doc:tooltip>
459
<doc:summary>A type allowing a year or date value</doc:summary>
460
<doc:description>This type is the union of the built-in types for year
461
        and date.</doc:description>
462
<doc:example>1999, or 2001-03-15</doc:example>
463
<doc:lineage>New in EML 2.0.0.</doc:lineage>
464
</xs:appinfo>
465
</xs:annotation>
466
<xs:union memberTypes="xs:gYear xs:date"/>
467
</xs:simpleType>
468
<xs:simpleType name="ScopeType">
469
<xs:restriction base="xs:string">
470
<xs:enumeration value="system"/>
471
<xs:enumeration value="document"/>
472
</xs:restriction>
473
</xs:simpleType>
474
<xs:simpleType name="FunctionType">
475
<xs:restriction base="xs:string">
476
<xs:enumeration value="download"/>
477
<xs:enumeration value="information"/>
478
</xs:restriction>
479
</xs:simpleType>
480
<xs:complexType name="DistributionType">
481
<xs:choice>
482
<xs:element name="online">
483
<xs:annotation>
484
<xs:appinfo>
485
<doc:tooltip>Online Distribution Information</doc:tooltip>
486
<doc:summary>Distribution information for accessing the 
487
              resource online.</doc:summary>
488
<doc:description>Distribution information for accessing the
489
              resource online, represented either as a URL or as a series of
490
              named parameters that are needed in order to
491
              connect. The URL field is provided for the simple cases where a
492
              file is available for download directly from a web server or 
493
              other similar server and a complex connection protocol is not
494
              needed.  The connection field provides an alternative where a
495
              complex protocol needs to be named and described, along with 
496
              the necessary parameters needed for the connection.
497
              </doc:description>
498
</xs:appinfo>
499
</xs:annotation>
500
<xs:complexType>
501
<xs:sequence>
502
<xs:element name="url">
503
<xs:annotation>
504
<xs:appinfo>
505
<doc:tooltip>Download site URL</doc:tooltip>
506
<doc:summary>A URL (Uniform Resource Locator) from which
507
                      this resource can be downloaded or information can be 
508
                      obtained about downloading it.</doc:summary>
509
<doc:description>A URL (Uniform Resource Locator) from
510
                      which this resource can be downloaded or additional
511
                      information can be obtained. If accessing the URL would
512
                      directly return the data stream, then the "function"
513
                      attribute should be set to "download".  If the URL
514
                      provides further information about downloading the
515
                      object but does not directly return the data stream, then
516
                      the "function" attribute should be set to "information".
517
                      If the "function" attribute is omitted, then "download"
518
                      is implied for the URL function.
519
                      In more complex cases where a non-standard connection 
520
                      must be established that complies with application 
521
                      specific procedures beyond what can be described in the 
522
                      simple URL, then the "connection" element should
523
                      be used instead of the URL element.</doc:description>
524
<doc:example>
525
                      http://data.org/getdata?id=98332</doc:example>
526
<doc:lineage>ISO CD 19115.3, Geographic information -
527
                      Metadata</doc:lineage>
528
</xs:appinfo>
529
</xs:annotation>
530
<xs:complexType>
531
<xs:simpleContent>
532
<xs:extension base="xs:anyURI">
533
<xs:attribute name="function" type="FunctionType" use="optional" default="download"/>
534
</xs:extension>
535
</xs:simpleContent>
536
</xs:complexType>
537
</xs:element>
538
<xs:element name="connection">
539
<xs:complexType>
540
<xs:sequence>
541
<xs:element name="connectionDefinition" type="ConnectionDefinitionType">
542
<xs:annotation>
543
<xs:appinfo>
544
<doc:tooltip>Connection Definition</doc:tooltip>
545
<doc:summary>Definition of the connection protocol 
546
                              to be used for this connection.</doc:summary>
547
<doc:description>Definition of the connection
548
                              protocol to be used for this connection.  The 
549
                              definition has a "scheme" which identifies the
550
                              protocol by name, and a detailed description of
551
                              the scheme and its required parameters.
552
                              </doc:description>
553
</xs:appinfo>
554
</xs:annotation>
555
</xs:element>
556
<xs:element name="parameter" minOccurs="0" maxOccurs="unbounded">
557
<xs:annotation>
558
<xs:appinfo>
559
<doc:tooltip>Parameter</doc:tooltip>
560
<doc:summary>A parameter to be used to make this 
561
                              connection.</doc:summary>
562
<doc:description>A parameter to be used to make
563
                              this connection. This value overrides any
564
                              default value that may have been provided in the
565
                              connection definition.
566
                              </doc:description>
567
</xs:appinfo>
568
</xs:annotation>
569
<xs:complexType>
570
<xs:sequence>
571
<xs:element name="name" type="xs:string">
572
<xs:annotation>
573
<xs:appinfo>
574
<doc:tooltip>Parameter Name</doc:tooltip>
575
<doc:summary>Name of the parameter to be 
576
                                    used to make this connection.</doc:summary>
577
<doc:description>The name of the parameter 
578
                                    to be used to make this connection.
579
                                    </doc:description>
580
<doc:example>hostname</doc:example>
581
</xs:appinfo>
582
</xs:annotation>
583
</xs:element>
584
<xs:element name="value" type="xs:string">
585
<xs:annotation>
586
<xs:appinfo>
587
<doc:tooltip>Parameter Value</doc:tooltip>
588
<doc:summary>The value of the parameter to 
589
                                    be used to make this connection.
590
                                    </doc:summary>
591
<doc:description>The value of the parameter 
592
                                    to be used to make this connection. This 
593
                                    value overrides any default value that may 
594
                                    have been provided in the connection 
595
                                    definition.</doc:description>
596
<doc:example>nceas.ucsb.edu</doc:example>
597
</xs:appinfo>
598
</xs:annotation>
599
</xs:element>
600
</xs:sequence>
601
</xs:complexType>
602
</xs:element>
603
</xs:sequence>
604
<xs:attribute name="id" type="xs:string" use="optional"/>
605
<xs:attribute name="system" type="xs:string" use="optional"/>
606
<xs:attribute name="scope" type="ScopeType" use="optional" default="document"/>
607
</xs:complexType>
608
</xs:element>
609
</xs:sequence>
610
</xs:complexType>
611
</xs:element>
612
<xs:element name="offline">
613
<xs:annotation>
614
<xs:appinfo>
615
<doc:tooltip>medium of the resource</doc:tooltip>
616
<doc:summary>the medium on which this resource is distributed,
617
              either digitally or as hardcopy</doc:summary>
618
<doc:description>the medium on which this resource is distributed
619
              digitally, such as 3.5" floppy disk, or various tape media types,
620
              or 'hardcopy'</doc:description>
621
<doc:example>CD-ROM, 3.5 in. floppy disk, Zip disk</doc:example>
622
<doc:lineage>ISO CD 19115.3, Geographic information -
623
              Metadata</doc:lineage>
624
</xs:appinfo>
625
</xs:annotation>
626
<xs:complexType>
627
<xs:sequence>
628
<xs:element name="mediumName" type="xs:string" minOccurs="0">
629
<xs:annotation>
630
<xs:appinfo>
631
<doc:tooltip>Medium name</doc:tooltip>
632
<doc:summary>Name of the medium that for this resource
633
                    distribution</doc:summary>
634
<doc:description>Name of the medium on which this resource
635
                    is distributed. Can be various digital media such as tapes
636
                    and disks, or printed media which can collectively be
637
                    termed 'hardcopy'.</doc:description>
638
<doc:example>Tape, 3.5 inch Floppy Disk,
639
                    hardcopy</doc:example>
640
<doc:lineage>ISO CD 19115.3, Geographic information -
641
                    Metadata</doc:lineage>
642
</xs:appinfo>
643
</xs:annotation>
644
</xs:element>
645
<xs:element name="mediumDensity" type="xs:string" minOccurs="0">
646
<xs:annotation>
647
<xs:appinfo>
648
<doc:tooltip>density of the digital medium</doc:tooltip>
649
<doc:summary>the density of the digital medium if this is
650
                    relevant.</doc:summary>
651
<doc:description>the density of the digital medium if this
652
                    is relevant. Used mainly for floppy disks or
653
                    tape.</doc:description>
654
<doc:example>High Density (HD), Double Density
655
                    (DD)</doc:example>
656
<doc:lineage>ISO CD 19115.3, Geographic information -
657
                    Metadata</doc:lineage>
658
</xs:appinfo>
659
</xs:annotation>
660
</xs:element>
661
<xs:element name="mediumDensityUnits" type="xs:string" minOccurs="0">
662
<xs:annotation>
663
<xs:appinfo>
664
<doc:tooltip>units of a numerical density</doc:tooltip>
665
<doc:summary>a numerical density's units</doc:summary>
666
<doc:description>if a density is given numerically, the
667
                    units should be given here.</doc:description>
668
<doc:example>B/cm</doc:example>
669
<doc:lineage>ISO CD 19115.3, Geographic information -
670
                    Metadata</doc:lineage>
671
</xs:appinfo>
672
</xs:annotation>
673
</xs:element>
674
<xs:element name="mediumVolume" type="xs:string" minOccurs="0">
675
<xs:annotation>
676
<xs:appinfo>
677
<doc:tooltip>storage volume</doc:tooltip>
678
<doc:summary>total volume of the storage
679
                    medium</doc:summary>
680
<doc:description>the total volume of the storage medium on
681
                    which this resource is shipped.</doc:description>
682
<doc:example>650 MB</doc:example>
683
<doc:lineage>ISO CD 19115.3, Geographic information -
684
                    Metadata</doc:lineage>
685
</xs:appinfo>
686
</xs:annotation>
687
</xs:element>
688
<xs:element name="mediumFormat" type="xs:string" minOccurs="0" maxOccurs="unbounded">
689
<xs:annotation>
690
<xs:appinfo>
691
<doc:tooltip>medium format</doc:tooltip>
692
<doc:summary>format of the medium on which the resource is
693
                    shipped.</doc:summary>
694
<doc:description>the file system format of the medium on
695
                    which the resource is shipped</doc:description>
696
<doc:example>NTFS, FAT32, EXT2, QIK80</doc:example>
697
<doc:lineage>ISO CD 19115.3, Geographic information -
698
                    Metadata</doc:lineage>
699
</xs:appinfo>
700
</xs:annotation>
701
</xs:element>
702
<xs:element name="mediumNote" type="xs:string" minOccurs="0">
703
<xs:annotation>
704
<xs:appinfo>
705
<doc:tooltip>note about the media</doc:tooltip>
706
<doc:summary>note about the media</doc:summary>
707
<doc:description>any additional pertinent information about
708
                    the media</doc:description>
709
<doc:example/>
710
<doc:lineage>ISO CD 19115.3, Geographic information -
711
                    Metadata</doc:lineage>
712
</xs:appinfo>
713
</xs:annotation>
714
</xs:element>
715
</xs:sequence>
716
</xs:complexType>
717
</xs:element>
718
<xs:element name="inline" type="xs:anyType"/>
719
</xs:choice>
720
<xs:attribute name="id" type="xs:string" use="optional"/>
721
<xs:attribute name="system" type="xs:string" use="optional"/>
722
<xs:attribute name="scope" type="ScopeType" use="optional" default="document"/>
723
</xs:complexType>
724
<xs:complexType name="ConnectionDefinitionType">
725
<xs:annotation>
726
<xs:appinfo>
727
<doc:tooltip>Connection Definition</doc:tooltip>
728
<doc:summary>The definition of a type of connection
729
        that will be used in another location in the EML
730
        document.</doc:summary>
731
<doc:description>The definition of a type of connection
732
        that will be used in another location in the EML
733
        document. This only provides the definition of the
734
        protocol and its parameters, but not the actual values
735
        to be used to make the connection (instead, see the
736
        connection element).  The same connection definition may be
737
        used by multiple connections (e.g., to download different files
738
        from the same database), but each connection must provide or
739
        reference a valid connection definition.</doc:description>
740
<doc:lineage>New in EML 2.0.0</doc:lineage>
741
</xs:appinfo>
742
</xs:annotation>
743
<xs:choice>
744
<xs:sequence>
745
<xs:element name="schemeName">
746
<xs:annotation>
747
<xs:appinfo>
748
<doc:tooltip>Scheme Name</doc:tooltip>
749
<doc:summary>The name of the scheme used to identify this
750
              connection.</doc:summary>
751
<doc:description>The name of the scheme used to identify this
752
              connection.  The scheme name is qualified by its system attribute.
753
              The scheme name implies a particular protocol for
754
              accessing information from the connection.  Applications must
755
              have a knowledge of the scheme or be able to deduce the protocol
756
              from the scheme description in order to effectively access data
757
              over the connection.  Many schemes will be unknown to client
758
              applications.  At some later point in time a registry for
759
              connection schemes may be established in order to promote
760
              application interoperability, and we may expand this portion of
761
              EML to adopt a more comprehensive standard such as WSDL, but for
762
              now this simpler description is provided.</doc:description>
763
<doc:example>metacat</doc:example>
764
<doc:lineage>As of EML 2.0.0</doc:lineage>
765
</xs:appinfo>
766
</xs:annotation>
767
<xs:complexType>
768
<xs:simpleContent>
769
<xs:extension base="xs:string">
770
<xs:attribute name="system" type="xs:string" use="optional">
771
<xs:annotation>
772
<xs:appinfo>
773
<doc:tooltip>Scheme System</doc:tooltip>
774
<doc:summary>The system in which this scheme name is
775
                      relevant</doc:summary>
776
<doc:description>The computing system within which this
777
                      scheme name has relevance. This attribute qualifies the
778
                      scheme name in order to decrease the likelihood of scheme
779
                      name collisions when more that one EML user defines a
780
                      scheme name with the same name but different semantics.
781
                      </doc:description>
782
<doc:example>
783
                      http://knb.ecoinformatics.org/knb/</doc:example>
784
<doc:lineage>As of EML 2.0.0</doc:lineage>
785
</xs:appinfo>
786
</xs:annotation>
787
</xs:attribute>
788
</xs:extension>
789
</xs:simpleContent>
790
</xs:complexType>
791
</xs:element>
792
<xs:element name="description" type="txt:TextType">
793
<xs:annotation>
794
<xs:appinfo>
795
<doc:tooltip>Scheme Description</doc:tooltip>
796
<doc:summary>The description of the scheme used to identify this
797
              connection.</doc:summary>
798
<doc:description>The description of the scheme used to identify 
799
              this connection. The scheme name implies a particular protocol for
800
              accessing information from the connection.  Applications must
801
              have a knowledge of the scheme or be able to deduce the protocol
802
              from the scheme description in order to effectively access data
803
              over the connection.</doc:description>
804
<doc:example>The metacat application protocol.  Applications
805
              must first log into metacat by sending an HTTP POST request 
806
              in http-url-encoded format with the parameters action, username,
807
              and password.  Action must be set to "login".
808
              If authentication is successful, the metacat
809
              server will respond with a session cookie.  All future requests
810
              should include the session cookie in the HTTP header.  To
811
              retrieve an object, the client then would send an HTTP POST
812
              in http-url-encoded format, with an action parameter set to
813
              "get" and the docid paramter set to the identifier for the 
814
              desired object.  The response will either be an XML document
815
              or a multipart-form-encoded response containing data.
816
              </doc:example>
817
<doc:lineage>As of EML 2.0.0</doc:lineage>
818
</xs:appinfo>
819
</xs:annotation>
820
</xs:element>
821
<xs:element name="parameterDefinition" maxOccurs="unbounded">
822
<xs:annotation>
823
<xs:appinfo>
824
<doc:tooltip>Parameter Definition</doc:tooltip>
825
<doc:summary>The definition of a parameter that is needed to
826
              properly use this connection scheme.</doc:summary>
827
<doc:description>The definition of a parameter that is needed to
828
              properly use this connection scheme.  Each parameter has a name
829
              and a definition that are used by applications to assess the type
830
              of information needed for the request.  Parameters may also set
831
              default values that are used if a connection does not provide a
832
              value for a parameter.</doc:description>
833
<doc:lineage>As of EML 2.0.0</doc:lineage>
834
</xs:appinfo>
835
</xs:annotation>
836
<xs:complexType>
837
<xs:sequence>
838
<xs:element name="name" type="xs:string">
839
<xs:annotation>
840
<xs:appinfo>
841
<doc:tooltip>Parameter Name</doc:tooltip>
842
<doc:summary>The Name of a parameter that is needed to
843
                    properly use this connection scheme.</doc:summary>
844
<doc:description>The name of a parameter that is needed to
845
                    properly use this connection scheme.</doc:description>
846
<doc:example>hostname</doc:example>
847
<doc:lineage>As of EML 2.0.0</doc:lineage>
848
</xs:appinfo>
849
</xs:annotation>
850
</xs:element>
851
<xs:element name="definition" type="xs:string">
852
<xs:annotation>
853
<xs:appinfo>
854
<doc:tooltip>Parameter Definition</doc:tooltip>
855
<doc:summary>The definition of a parameter that is needed 
856
                    to properly use this connection scheme.</doc:summary>
857
<doc:description>The definition of a parameter that is 
858
                    needed to properly use this connection scheme.  The
859
                    definition is used by applications to assess the type
860
                    of information needed for the request.</doc:description>
861
<doc:example>The fully qualified name of the internet host
862
                    that is providing the metacat service, as would be returned
863
                    by a Domain Name System (DNS) query.</doc:example>
864
<doc:lineage>As of EML 2.0.0</doc:lineage>
865
</xs:appinfo>
866
</xs:annotation>
867
</xs:element>
868
<xs:element name="defaultValue" type="xs:string" minOccurs="0">
869
<xs:annotation>
870
<xs:appinfo>
871
<doc:tooltip>Default Parameter Value</doc:tooltip>
872
<doc:summary>The default value for a parameter that is 
873
                    needed to properly use this connection scheme.</doc:summary>
874
<doc:description>The default value for a parameter that is 
875
                    needed to properly use this connection scheme.  If a default
876
                    value is set, then it should be used for connections that
877
                    do not override the default with a connection-specific
878
                    value. This allows a definition to be established that
879
                    declares common information that might be shared by several
880
                    connections as default values.  Parameter values provided
881
                    in the connection always override any default values 
882
                    provided in the conneciton definition.</doc:description>
883
<doc:example>metacat.nceas.ucsb.edu</doc:example>
884
<doc:lineage>As of EML 2.0.0</doc:lineage>
885
</xs:appinfo>
886
</xs:annotation>
887
</xs:element>
888
</xs:sequence>
889
</xs:complexType>
890
</xs:element>
891
</xs:sequence>
892
<xs:element name="references" type="xs:string">
893
<xs:annotation>
894
<xs:appinfo>
895
<doc:tooltip>References</doc:tooltip>
896
<doc:summary>A reference to a connection definition that is
897
            provided elsewhere in EML.</doc:summary>
898
<doc:description>A reference to a connection definition that is
899
            provided elsewhere in EML. This is useful to provide a single,
900
            shared connection definition for a scheme that is used by 
901
            multiple connections.</doc:description>
902
<doc:lineage>As of EML 2.0.0</doc:lineage>
903
</xs:appinfo>
904
</xs:annotation>
905
</xs:element>
906
</xs:choice>
907
<xs:attribute name="id" type="xs:string" use="optional"/>
908
<xs:attribute name="system" type="xs:string" use="optional"/>
909
<xs:attribute name="scope" type="ScopeType" use="optional" default="document"/>
910
</xs:complexType>
911
</xs:schema>
    (1-1/1)