documents
The root element. This element is a container for the document element(s). A document is a piece of work that is or is going to be published.
date type: dateType
The date this file was created or altered according to the Gregorian calendar. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used. The attribute type="creation" is also mandatory.
time type: timeType
The time this file was created or altered according to the Gregorian calendar. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used. The attribute type="creation" is also mandatory. The time format is HH:MM.
document
An XML document conforming to this schema can contain descriptions of one or more publications or documents. In some occasions it is convenient to group publications and put them altogether into a single file, but usually publications for long-term preservation are stored into separate files ie each file contains only one document element. The children of this element are in ascending order of generality regarding to the document type, in other words "the most specific element comes first".
properties
A container for the attributes or the properties of this document.
property
The document types are specified into property elements. Each value is put into a property element. A document can have several document type attributes. Valid values are book, article, chapter, thesis, journal, report, postgraduateThesis, undergraduateThesis, doctoralThesis, licentiateThesis, comprehensiveDissertation or monographDissertation.
identifiers type: identifiersType
Comprehensive identifiers for the document. Identifiers specified here belong to all manifestations. The property internal is used to link this document to other external descriptions. The value with the property uri holds for example the URN:NBN identifier of the document.
specifics
This element contains elements that belong to a certain document type. The document type is specified as a value to the xml attribute type. Two document types have specific elements, undergraduateThesis and thesis. Note that the most specific document type should be first in order.
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: undergraduateThesis thesis |
required |
examiner
Exists only if the parent's type attribute has the value "undergraduateThesis". Contains an examiner.
properties
A container for the attributes or the properties of the examiner.
property type: xs:token
NO VALUES DEFINED.
person type: personType
An examiner as a person.
effort
Exists only if the parent's type attribute has the value "undergraduateThesis". University points measure the effort a student has to put into their work to pass exam. Another interpretation is that the effort measures the quantity of the work. The xml attribute unit="universityPoints" is required.
| Name | Type | Use | Description |
|---|---|---|---|
| unit | NMTOKEN | required |
level
Exists only if the parent's type attribute has the value "undergraduateThesis". There are different levels of undergraduate theses in Sweden. The levels supported are A,B,AB,C,D,CD and Y. Y means the work has been written for a special kind of exam so called "yrkesexamen" (swedish term). The levels work as some kind of quality markers. Theses in level A are least significant and theses in level D most significant. Y has an unique position with no further dividing up.
supervisors
Exists only if the parent's type attribute has the value "thesis". A container element for supervisors.
supervisor
A supervisor.
properties
A container for the attributes or the properties of the supervisor.
property type: xs:token
NO VALUES DEFINED.
person type: personType
A supervisor as a person.
degree
Exists only if the parent's type attribute has the value "thesis". The element contains the degree the student gets when the thesis is accepted.
identifiers type: identifiersType
Identifiers for the degree.
descriptions type: descriptionsType
Descriptions of the exam/degree title in different languages.
disputation
Exists only if the parent's type attribute has the value "thesis". Public defense is another word for disputation.
place
A geographical place.
room type: xs:token
Hall or room. For example "sal EA1", "room 12".
building type: xs:token
House or building. For example "Ångströmslaboratoriet", "Uppsala University Main Building".
address type: addressType
Visiting address. The xml attribute type="visiting" is required.
date type: dateType
Date of public defence/disputation according to the Gregorian calendar. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used. The attribute type="disputation" is also mandatory.
time type: timeType
Disputation time according to the Gregorian calendar. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used. The attribute type="disputation" is also mandatory. The time format is HH:MM.
language type: languageType
Disputation language.
opponents
A container element for opponents.
opponent
An opponent.
properties
A container for the attributes or the properties of the opponent.
property type: xs:token
NO VALUES DEFINED.
person type: personType
An opponent as a person.
languages
A container element for elements that describe what languages is used in the document.
documentLanguages
The language or languages that the main part of the document is written in.
language type: languageType
Document language.
summaryLanguages
The language or languages that included summaries are written in.
language type: languageType
Summary language.
manifestations
The document can be represented in different ways and in various formats, so called manifestations. The manifestations element is a container for manifestations.
manifestation
A manifestation. The xml attribute number gives every manifestation in the same document a unique identifier. The identifier is used to link archived files to the metadata description. The xml attribute number is optional.
| Name | Type | Use | Description |
|---|---|---|---|
| number | NMTOKEN | optional |
properties
A container element for the attributes or the properties of the manifestation. This element is required.
property
The manifestation properties are specified into property elements. Each value is put into a property element. A manifestation can have many attributes. Valid values are physicalMedium, electronicMedium, book, pdf, xml, ps, original.
serialIssues
The manifestation belong to the series specified under this element. serialIssues is a container element for serialIssue elements.
serialIssue type: serialIssueType
A serial issue is a volume in a series. A manifestation can be registered as a volume in many different series.
date type: dateType
Dates. To describe the publication date the xml attribute type="publication" is used. To describe the date when the manifestation is available for the public the xml attribute type="availableFrom" is used. In both cases the attributes are required. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used.
time type: timeType
The time of the day the manifestation is available (tillgänglig från / spikningsklockslag) according to the Gregorian calendar. To indicate this meaning the xml attribute type must have the value "availableFrom". The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used. The time format is HH:MM.
edition type: xs:token
The edition of the manifestation. For example "Second edition".
numberOfCopies type: xs:int
The number of manufactured/distributed copies of the manifestation.
publishers
A container element for publishers.
publisher type: publisherType
A publisher.
distributors
A container element for distributors.
distributor
A distributor.
properties
A container for the attributes or the properties of the distributor.
property type: xs:token
NO VALUES DEFINED.
person type: personType
A distributor as a person.
organisation type: organisationType
A distributor as an organisation.
archivers
A container element for archivers. Archivers archive digital and physical copies of documents and make them available.
archiver
An archiver.
properties
A container for the attributes or the properties of the archiver.
property type: xs:token
NO VALUES DEFINED.
person type: personType
An archiver as a person.
organisation type: organisationType
An archiver as an organisation.
identifiers type: identifiersType
Identifiers for the manifestation. Here identifiers pointing to a file format register/dictionary can be specified (not yet implemented).
extent
To describe the manifestation's pages the xml attribute type="pages" is required. To describe the size of the manifestation in bytes the xml attribute type="fileSize" is required.
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: pages fileSize |
required |
creators
A container element for the creators of the document.
creator type: creatorType
A creator.
contributors
A container element for the contributors of the document.
contributor type: contributorType
A contributor.
classificationCategories
A container element for the classification categories of the document.
classificationCategory type: classificationCategoryType
A classification category.
titles
A container element for the titles of the document.
title
A title. There are three kinds of titles: ordinary, original and alternative titles. Ordinary title does not have any xml attributes. Only one ordinary title can exist at a time. An original title must have the xml attribute type="original". Only one original title can exist. An alternative title must have the xml attribute type="alternative". There can exist many alternative titles.
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: alternative original |
optional |
maintitle
A main title. The xml attribute xml:lang is required. Only one main title can be defined. A main title can be formatted in different ways (see the children of this element).
subtitle
A subtitle. The xml attribute xml:lang is required. Many subtitles can be defined. A sub title can be formatted in different ways (see the children of this element).
listsOfReferences
Lists of references.
listOfReferences
The xml attribute type is required. There exist one type of reference list that is called "listOfPapers".
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: listOfPapers |
required |
references
A container element for the references.
reference
A reference. The xml attribute number is required. The number indicate the order number of the reference.
| Name | Type | Use | Description |
|---|---|---|---|
| number |
NMTOKEN
Enumeration: |
required |
properties
A container for the attributes or the properties of this reference.
property
The reference properties are specified into property elements. Each value is put into a property element. A reference can have several attributes. There are two groups of attributes. The first group state the reference type: manuscript, article, chapter. Notice that a manuscript is neither a chapter nor an article. The second group state the status of publishing: inProgress, accepted, submitted, inPress, published. The attribute type="status" should be used on properties of the second group.
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: status |
optional |
specifics
This element contains elements that belong to a certain reference type. The reference type is specified as a value to the xml attribute type. The reference type "article" and "chapter" have specific elements.
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: article chapter |
required |
partOf
Exists only if the parent's type attribute has the value "article" or "chapter". When the parent's type attribute equals "article" this element describes that the article is a part of a journal. Then the xml attribute type="journal" is required. When the parent's type attribute equals "chapter" this element describes that the chapter is part of a book. The xml attribute type="book" is required.
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: journal book |
required |
volumeNumber type: xs:token
Exists only if the parent's type attribute has the value "journal". The volume number of the journal in which this article is published in.
issueNumber type: xs:token
Exists only if the parent's type attribute has the value "journal". The issue number of the journal in which this article is published in.
date type: dateType
Exists only if the parent's type attribute has the value "journal" or "book". Publication year. The xml attribute type="publication" is required. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used.
extent
Exists only if the parent's type attribute has the value "journal" or "book". Pages. Required xml attribute type="pages".
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: pages |
required |
title
Exists only if the parent's type attribute has the value "journal" or "book". The title of the journal or book.
maintitle type: formattedText
A main title.
identifiers type: identifiersType
Exists only if the parent's type attribute has the value "journal" or "book". Identifiers for a journal or a book.
contributors
Exists only if the parent's type attribute has the value "book". Contributors.
contributor type: contributorType
A contributor. On a person the only elements in use are name type="original" and identifiers. On an organisation element the only elements in use are organisationNames and address type="postal" with the child element city.
publishers
Exists only if the parent's type attribute has the value "book". Publishers.
publisher type: publisherType
A publisher. On a person the only elements in use are name type="original" and identifiers. On an organisation element the only elements in use are organisationNames and address type="postal" with the child element city.
creators
The creators of the publication the reference pointing at.
creator type: creatorType
A creator. Only the person element is used and on a person the only elements in use are name type="original" and identifiers.
title
The title of the reference.
maintitle type: formattedText
A main title. Only one main title can be defined. A main title can be formatted in different ways (see the children of this element).
subtitle type: formattedText
A subtitle. Only one subtitle can be defined. A subtitle can be formatted in different ways (see the children of this element).
identifiers type: identifiersType
Identifiers for the reference. For example doi, purl, urn:nbn, url.
abstracts
Abstracts in different languages.
abstract
An abstract. The xml attribute xml:lang is required.
| Name | Type | Use | Description |
|---|---|---|---|
| xml:lang | required |
paragraph
A paragraph. The text can be formatted in different ways (see the children of this element).
note type: formattedText
This element could contain any comments about the document. The text can be formatted in different ways.
contents
Contains all other parts of the document (e.g. the fulltext). Must follow the DocBook standard.
Address. The required xml attribute "type" can take the value postal or visiting.
identifiers type: identifiersType
Container element for address identifiers. Identifiers can be used to link an address to geographical coordinates (identifier name not implemented).
street type: xs:token
The street name and the street number. For example "Storgatan 56".
postbox type: xs:token
Can only exist if the parent's type attribute has the value "postal". Postbox address. For example "Box 123".
postcode type: xs:token
Postal code or zip code. For example "123 44", "SE-321 11".
city type: cityType
Town or city. For example "Kiruna".
state type: xs:token
State. This field is used when the country is a federation of states. For example "Georgia".
country type: countryType
Country. For example "Sweden".
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: postal visiting |
required |
An affiliation to an organisation.
organisation
An organisation is a corporate body (universities, departments, associations, institutions, business firms, nonprofit enterprises etc.).
City or town.
identifiers type: identifiersType
Container element for city identifiers. Identifiers can be used to link a city to geographical coordinates (identifier name not implemented). Cities can also be linked to an authority data register with the help of identifiers (identifier name not implemented).
descriptions type: descriptionsType
The name of the city in different languages.
Describes a classification category.
properties
A contrainer for the attributes or the properties of the category.
property
The classification category type is specified into a property element. Valid values are "code","controlledKeyword" and "uncontrolledKeyword". Categories that have codes as their primary field should use the "code" value. All other categories have a keyword instead of a code as the primary field and should instead use the "controlledKeyword" or "uncontrolledKeyword" property.
identifiers type: identifiersType
Identifiers for a classification category. The property internal is used to link this category to other external descriptions.
classificationScheme type: classificationSchemeType
A classification scheme. A classification category can be part of a schema when the property "code" or "controlledKeyword" exist.
code type: codeType
The code of the classification system. To use this element property "code" must exist.
descriptions type: descriptionsType
Descriptions of the classification code in different languages. To use this element property "code" must exist.
keywords
A keyword. To use this element property "controlledKeyword" or "uncontrolledKeyword" must exist.
keyword
The keyword in any language. The xml attribute xml:lang specifies the language and is required.
| Name | Type | Use | Description |
|---|---|---|---|
| xml:lang | required |
Describes a classification scheme.
identifiers type: identifiersType
Identifiers for a classification scheme. The property "internal" is used to link this category to other external descriptions.
descriptions type: descriptionsType
Descriptions of the classification scheme in different languages.
Describes a code.
Contributor.
properties
A container for the attributes or the properties of the contributor.
property
The contributor role is specified into a property element. If a role is specified the xml attribute type="role" is required. Valid values for the roles are "editor", "illustrator", "other", "compiler" and "translator". The content of this element is not controlled by the schema.
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: role |
optional |
person type: personType
A contributor as a physical person.
organisation type: organisationType
A contributor as an organisation.
Describes a country.
identifiers type: identifiersType
Container element for country identifiers. The country code according to the standard ISO 3166-1 can be used. The property element should contain "iso3166-1" and the value element the code, for example "se" or "SE".
descriptions type: descriptionsType
The name of the country in different languages.
Describes a creator.
properties
A container for the attributes or the properties of the creator.
property
The creator role is specified into a property element. If a role is specified the xml attribute type="role" is required. A valid value for the role is "author". For references the value "contributedEqually" with no xml attribute can be used. This means all creators having the attribute have contributed with the same amount of work to the document in question. The content of this element is not controlled by the schema.
| Name | Type | Use | Description |
|---|---|---|---|
| type | NMTOKEN | optional |
person type: personType
A creator as a physical person.
organisation type: organisationType
An creator as an organisation.
Describes a date according to the Gregorian calendar. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used. The attribute type should have the value "creation", "disputation", "publication", "availableFrom or "dateOfBirth".
year type: xs:short
The year according to the Gregorian calendar. Use negative integers for BC.
month
The month according to the Gregorian calendar. Two figures must be used to represent the month. Valid values are in the range 01-12.
day
The day according to the Gregorian calendar. Two figures must be used to represent the month. Valid values are in the range 01-31.
| Name | Type | Use | Description |
|---|---|---|---|
| timezone |
token
Enumeration: |
required | The xs:token type was chosen because the xs:NMTOKEN type does not support the + character. An example of the use is timezone="UTC+1". |
| type |
NMTOKEN
Enumeration: creation disputation publication availableFrom dateOfBirth |
required |
A description of a text description.
description
A text description in any language. The language used is specified by the attribute xml:lang and is mandatory.
| Name | Type | Use | Description |
|---|---|---|---|
| xml:lang | required |
Describes formatted text.
bold type: formattedText
Contains text with a bold style.
italics type: formattedText
Contains text with an italic style.
lineThrough type: formattedText
Contains text with a line through it.
overline type: formattedText
Contains text with a line on top.
underline type: formattedText
Contains text with a line underneath.
subscript type: formattedText
Contains text that should be subscripted.
superscript type: formattedText
Contains text that should be superscripted.
Describes formatted text in a specified language. The xml attribute xml:lang is required.
| Name | Type | Use | Description |
|---|---|---|---|
| xml:lang | required |
Describes identifiers.
identifier
Describes a unique name or number, ie an identifier.
properties
A container for the attributes or the properties of the identifier, ie the name of the identifier.
property
The identifier name are specified in a property element. Valid identifiers are internal, isbn, issn, local, uri, iso639-1, iso3166-1 and pmid.
value type: xs:token
The value of the identifier.
Describes a language.
identifiers type: identifiersType
A container element for the identifiers of the language. If ISO 639-1 standard is used the property element should contain "iso639-1" and the value element should have the language code, e.g. "sv" or "SV" for Swedish.
descriptions type: descriptionsType
Descriptions of the language name in different languages.
Description of an organisation.
properties
A container element for attributes or properties of the organisation.
property
Several different attributes can be put into this kind of element. "open" means the organisation is active or in business. "closed" corresponds to the opposite. Those organisations taking care of undergraduate or postgraduate students have the property "forTheses". "faculty", "university", "department", "institution", "section" are organisation type properties that correspond to different organisational levels. If the organisation type is unknown no organisation type property is used. The "controlled" attribute is used for organisations that are controlled by a central authority (the internal identifier is used to link the controlled organisation). All other organisations have the "uncontrolled" attribute.
identifiers type: identifiersType
Container element for organisation identifiers. The property internal is used to link this organisation to a more detailed external description. Identifiers can for example link the organisation to an authority data register (identifier name not implemented yet).
organisationNames
The names of the organisation.
organisationName
An organisation can have many names in different languages. Each name should be put into a new organisationName element. The XML attribute xml:lang is required.
| Name | Type | Use | Description |
|---|---|---|---|
| xml:lang | optional |
address type: addressType
The postal or visiting address of the organisation. The xml attribute type should have the value "postal" or "visiting" and is required.
parentOrganisation type: affiliationType
The ancestor of this organisation (if any).
Describes a physical person.
properties
A container for the attributes or the properties of a person.
property
Each property value is put into a property element. The value firstNameFiling tell us that the first name should be written before the last name. The value lastNameFiling has the opposite meaning. firstNameFiling and lastNameFiling cannot be used at the same time.
identifiers type: identifiersType
Container element for person identifiers. Identifiers can be used to link the person to an authority data register (identifier name not implemented).
name
The name of the person. The type attribute which is mandatory can have the value "original", "transliterated" or "transcribed".
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: original transliterated transcribed |
required |
identifiers type: identifiersType
If the name is transliterated or transcribed the encoding schema in use should be described as an identifier.
firstName type: xs:token
First name. Notice that any middle names should be part of this field.
lastName type: xs:token
Last name.
address type: addressType
Addresses. The mandatory type attribute can take the value postal or visiting.
date
Date of birth. The mandatory type attributet should have the value "dateOfBirth". The mandatory timezone attribute should have a value "UTC*" where * should be the time difference. For example Sweden is in the timezone "UTC+1".
personalTitles
Working titles or academical titles.
personalTitle type: xs:token
Each element contains a working or academical title of the person.
emailAddresses
E-mail addresses to the person.
emailAddress type: xs:token
E-mail address.
affiliations
The person is connected to the organisations specified here.
affiliation type: affiliationType
A connection to an organisation.
Publisher.
properties
A container for the attributes or the properties of the publisher.
property type: xs:token
NO VALUES DEFINED.
person type: personType
A publisher as a person.
organisation type: organisationType
A publisher as an organisation.
The reason for this type is that the property element which uses this type will have both controlled contents and a controlled type-attribute. Allowed values: manuscript, article, chapter, inProgress, accepted, submitted, inPress, published. Note that a manuscript is neither a chapter nor an article.
Describes a serial volume/number.
volumeNumber type: xs:token
The serial number (if any) of the serial publication.
serialPublication type: serialPublicationType
The content of this element describes a serial publication.
A series.
properties
A container element for the attributes or the properties of the serial publication.
property
The serial publication properties are specified into property elements. Each value is put into a property element. A serial publication can have many attributes. Valid values are "open" or "closed". "open" means the series is still in use. Series that does not allow new publications to be registered with them have the "closed" property set.
identifiers type: identifiersType
Identifiers for the serial publication. The property issn is used for the ISSN identifier. The property internal is used to link this serial publication to a more detailed external description.
titles
The title of the serial publication.
title
A title of the series. There are two kinds of titles: ordinary and alternative titles. Ordinary title does not have any xml attributes. An alternative title must have the xml attribute type="alternative".
| Name | Type | Use | Description |
|---|---|---|---|
| type |
NMTOKEN
Enumeration: alternative |
optional |
maintitle
A main title. The xml attribute xml:lang is required. Only one main title can be defined. A main title can be formatted in different ways (see the children of this element).
subtitle
A subtitle. The xml attribute xml:lang is required. Many subtitles can be defined. A sub title can be formatted in different ways (see the children of this element).
contributors
A container element for contributors.
contributor type: contributorType
A contributor. The content after the "/" character in the serial publication's title. The property element can take the value "editor" or "other".
partOf
The serial publication is part of the series specified here.
serialPublication type: serialPublicationType
A serial publication.
Describes a time according to the Gregorian calendar. The attribute timezone="UTC*" where * should be the time difference (if any) to the UTC is required. In Sweden timezone="UTC+1" is used. The attribute type should have the value "creation", "disputation", "availableFrom". The time format is HH:MM.
| Name | Type | Use | Description |
|---|---|---|---|
| timezone |
token
Enumeration: |
required | |
| type |
NMTOKEN
Enumeration: disputation creation availableFrom |
required |