Schema documentation for ISNI_atompub_request.xsd
Showing:
Annotations
Attributes
Diagrams
Facets
Instances
Model
Properties
Used by
Table of Contents
No namespace
Main Schema
ISNI_atompub_request.xsd
Elements
Request
Request/isNot
Request/isNot/relationName
Request/isNot/relationName/ISNI
Request/isNot/relationName/PPN
Request/isRelated
Request/isRelated/endDateOfRelationship
Request/isRelated/relationName
Request/isRelated/relationName/ISNI
Request/isRelated/relationName/PPN
Request/isRelated/relationQualification
Request/isRelated/relationType
Request/isRelated/startDateOfRelationship
Request/merge
Request/merge/mergeInstruction
Request/merge/mergeToISNI
Request/merge/mergeToPPN
Request/requestID
Request/requestID/dateTimeOfRequest
Request/requestID/requestorTransactionId
identityInformation
identityInformation/countriesAssociated
identityInformation/countriesAssociated/city
identityInformation/countriesAssociated/countryCode
identityInformation/countriesAssociated/regionOrState
identityInformation/externalInformation
identityInformation/externalInformation/URI
identityInformation/externalInformation/information
identityInformation/externalInformation/source
identityInformation/identity
identityInformation/languageOfIdentity
identityInformation/note
identityInformation/otherIdentifierOfIdentity
identityInformation/otherIdentifierOfIdentity/identifier
identityInformation/otherIdentifierOfIdentity/type
identityInformation/requestorIdentifierOfIdentity
identityInformation/requestorIdentifierOfIdentity/deprecatedLocalIdentifier
identityInformation/requestorIdentifierOfIdentity/identifier
identityInformation/requestorIdentifierOfIdentity/referenceURI
identityInformation/requestorIdentifierOfIdentity/specialStatus
identityInformation/uniqueStatusRequested
organisation
organisation/location
organisation/location/city
organisation/location/countryCode
organisation/location/locode
organisation/location/regionOrState
organisation/organisationNameVariant
organisation/organisationNameVariant/mainName
organisation/organisationNameVariant/subdivisionName
organisation/organisationType
organisation/usageDateFrom
organisation/usageDateTo
organisationName
organisationName/mainName
organisationName/subdivisionName
personOrFiction
personOrFiction/birthDate
personOrFiction/contributedTo
personOrFiction/contributedTo/identifier
personOrFiction/contributedTo/identifier/identifierType
personOrFiction/contributedTo/identifier/identifierValue
personOrFiction/contributedTo/isrc
personOrFiction/contributedTo/iswc
personOrFiction/contributedTo/titleOfCollectiveWorkOrWorkPerformed
personOrFiction/dateConfidential
personOrFiction/dateType
personOrFiction/deathDate
personOrFiction/instrumentAndVoice
personOrFiction/nationality
personOrFiction/personalNameVariant
personOrFiction/personalNameVariant/forename
personOrFiction/personalNameVariant/languageOfName
personOrFiction/personalNameVariant/marcDate
personOrFiction/personalNameVariant/nameTitle
personOrFiction/personalNameVariant/nameUse
personOrFiction/personalNameVariant/numeration
personOrFiction/personalNameVariant/script
personOrFiction/personalNameVariant/surname
personalName
personalName/forename
personalName/languageOfName
personalName/marcDate
personalName/nameTitle
personalName/nameUse
personalName/numeration
personalName/script
personalName/surname
resource
resource/creationClass
resource/creationRole
resource/fieldOfCreation
resource/fieldOfCreation/fieldOfCreationValue
resource/fieldOfCreation/fieldType
resource/titleOfWork
resource/titleOfWork/identifier
resource/titleOfWork/identifier/identifierType
resource/titleOfWork/identifier/identifierValue
resource/titleOfWork/imprint
resource/titleOfWork/imprint/date
resource/titleOfWork/imprint/publisher
resource/titleOfWork/isrc
resource/titleOfWork/iswc
resource/titleOfWork/title
Attributes
Request/isNot/@identityType
Request/isRelated/@identityType
Main Schema
ISNI_atompub_request.xsd
Elements
Request
Request/isNot
Request/isNot/relationName
Request/isNot/relationName/ISNI
Request/isNot/relationName/PPN
Request/isRelated
Request/isRelated/endDateOfRelationship
Request/isRelated/relationName
Request/isRelated/relationName/ISNI
Request/isRelated/relationName/PPN
Request/isRelated/relationQualification
Request/isRelated/relationType
Request/isRelated/startDateOfRelationship
Request/merge
Request/merge/mergeInstruction
Request/merge/mergeToISNI
Request/merge/mergeToPPN
Request/requestID
Request/requestID/dateTimeOfRequest
Request/requestID/requestorTransactionId
identityInformation
identityInformation/countriesAssociated
identityInformation/countriesAssociated/city
identityInformation/countriesAssociated/countryCode
identityInformation/countriesAssociated/regionOrState
identityInformation/externalInformation
identityInformation/externalInformation/URI
identityInformation/externalInformation/information
identityInformation/externalInformation/source
identityInformation/identity
identityInformation/languageOfIdentity
identityInformation/note
identityInformation/otherIdentifierOfIdentity
identityInformation/otherIdentifierOfIdentity/identifier
identityInformation/otherIdentifierOfIdentity/type
identityInformation/requestorIdentifierOfIdentity
identityInformation/requestorIdentifierOfIdentity/deprecatedLocalIdentifier
identityInformation/requestorIdentifierOfIdentity/identifier
identityInformation/requestorIdentifierOfIdentity/referenceURI
identityInformation/requestorIdentifierOfIdentity/specialStatus
identityInformation/uniqueStatusRequested
organisation
organisation/location
organisation/location/city
organisation/location/countryCode
organisation/location/locode
organisation/location/regionOrState
organisation/organisationNameVariant
organisation/organisationNameVariant/mainName
organisation/organisationNameVariant/subdivisionName
organisation/organisationType
organisation/usageDateFrom
organisation/usageDateTo
organisationName
organisationName/mainName
organisationName/subdivisionName
personOrFiction
personOrFiction/birthDate
personOrFiction/contributedTo
personOrFiction/contributedTo/identifier
personOrFiction/contributedTo/identifier/identifierType
personOrFiction/contributedTo/identifier/identifierValue
personOrFiction/contributedTo/isrc
personOrFiction/contributedTo/iswc
personOrFiction/contributedTo/titleOfCollectiveWorkOrWorkPerformed
personOrFiction/dateConfidential
personOrFiction/dateType
personOrFiction/deathDate
personOrFiction/instrumentAndVoice
personOrFiction/nationality
personOrFiction/personalNameVariant
personOrFiction/personalNameVariant/forename
personOrFiction/personalNameVariant/languageOfName
personOrFiction/personalNameVariant/marcDate
personOrFiction/personalNameVariant/nameTitle
personOrFiction/personalNameVariant/nameUse
personOrFiction/personalNameVariant/numeration
personOrFiction/personalNameVariant/script
personOrFiction/personalNameVariant/surname
personalName
personalName/forename
personalName/languageOfName
personalName/marcDate
personalName/nameTitle
personalName/nameUse
personalName/numeration
personalName/script
personalName/surname
resource
resource/creationClass
resource/creationRole
resource/fieldOfCreation
resource/fieldOfCreation/fieldOfCreationValue
resource/fieldOfCreation/fieldType
resource/titleOfWork
resource/titleOfWork/identifier
resource/titleOfWork/identifier/identifierType
resource/titleOfWork/identifier/identifierValue
resource/titleOfWork/imprint
resource/titleOfWork/imprint/date
resource/titleOfWork/imprint/publisher
resource/titleOfWork/isrc
resource/titleOfWork/iswc
resource/titleOfWork/title
Attributes
Request/isNot/@identityType
Request/isRelated/@identityType
ISNI_atompub_request.xsd
Main Schema
ISNI_atompub_request.xsd
Elements
Request
Request/isNot
Request/isNot/relationName
Request/isNot/relationName/ISNI
Request/isNot/relationName/PPN
Request/isRelated
Request/isRelated/endDateOfRelationship
Request/isRelated/relationName
Request/isRelated/relationName/ISNI
Request/isRelated/relationName/PPN
Request/isRelated/relationQualification
Request/isRelated/relationType
Request/isRelated/startDateOfRelationship
Request/merge
Request/merge/mergeInstruction
Request/merge/mergeToISNI
Request/merge/mergeToPPN
Request/requestID
Request/requestID/dateTimeOfRequest
Request/requestID/requestorTransactionId
identityInformation
identityInformation/countriesAssociated
identityInformation/countriesAssociated/city
identityInformation/countriesAssociated/countryCode
identityInformation/countriesAssociated/regionOrState
identityInformation/externalInformation
identityInformation/externalInformation/URI
identityInformation/externalInformation/information
identityInformation/externalInformation/source
identityInformation/identity
identityInformation/languageOfIdentity
identityInformation/note
identityInformation/otherIdentifierOfIdentity
identityInformation/otherIdentifierOfIdentity/identifier
identityInformation/otherIdentifierOfIdentity/type
identityInformation/requestorIdentifierOfIdentity
identityInformation/requestorIdentifierOfIdentity/deprecatedLocalIdentifier
identityInformation/requestorIdentifierOfIdentity/identifier
identityInformation/requestorIdentifierOfIdentity/referenceURI
identityInformation/requestorIdentifierOfIdentity/specialStatus
identityInformation/uniqueStatusRequested
organisation
organisation/location
organisation/location/city
organisation/location/countryCode
organisation/location/locode
organisation/location/regionOrState
organisation/organisationNameVariant
organisation/organisationNameVariant/mainName
organisation/organisationNameVariant/subdivisionName
organisation/organisationType
organisation/usageDateFrom
organisation/usageDateTo
organisationName
organisationName/mainName
organisationName/subdivisionName
personOrFiction
personOrFiction/birthDate
personOrFiction/contributedTo
personOrFiction/contributedTo/identifier
personOrFiction/contributedTo/identifier/identifierType
personOrFiction/contributedTo/identifier/identifierValue
personOrFiction/contributedTo/isrc
personOrFiction/contributedTo/iswc
personOrFiction/contributedTo/titleOfCollectiveWorkOrWorkPerformed
personOrFiction/dateConfidential
personOrFiction/dateType
personOrFiction/deathDate
personOrFiction/instrumentAndVoice
personOrFiction/nationality
personOrFiction/personalNameVariant
personOrFiction/personalNameVariant/forename
personOrFiction/personalNameVariant/languageOfName
personOrFiction/personalNameVariant/marcDate
personOrFiction/personalNameVariant/nameTitle
personOrFiction/personalNameVariant/nameUse
personOrFiction/personalNameVariant/numeration
personOrFiction/personalNameVariant/script
personOrFiction/personalNameVariant/surname
personalName
personalName/forename
personalName/languageOfName
personalName/marcDate
personalName/nameTitle
personalName/nameUse
personalName/numeration
personalName/script
personalName/surname
resource
resource/creationClass
resource/creationRole
resource/fieldOfCreation
resource/fieldOfCreation/fieldOfCreationValue
resource/fieldOfCreation/fieldType
resource/titleOfWork
resource/titleOfWork/identifier
resource/titleOfWork/identifier/identifierType
resource/titleOfWork/identifier/identifierValue
resource/titleOfWork/imprint
resource/titleOfWork/imprint/date
resource/titleOfWork/imprint/publisher
resource/titleOfWork/isrc
resource/titleOfWork/iswc
resource/titleOfWork/title
Attributes
Request/isNot/@identityType
Request/isRelated/@identityType
Main schema
ISNI_atompub_request.xsd
Namespace
No namespace
Annotations
Schema for submitting requests for an ISNI for a personal name and for an organisation.
Related Documents:
* ISNI AtomPub guidelines
For ISNI Request and ISNI Response samples. For details about inserting, editing,
enriching, replacing and merging your data in ISNI throuhg ISNI Requests.
* ISNI Data element values
For a brief description of the field and (ISO) codes used in ISNI records.
* ISNI Database fields consolidated
Detailed description of the fields used in ISNI and referred to in the Annotations
below.
* ISNI_atompub_request.xsd
* ISNI response.xsd
* ISNI Response schema.doc
Schema for submitting requests for a personal name and for an organisation.
Related Documents:
ISNI AtomPub guidelines
For ISNI Request and ISNI Response samples. For details about inserting,
editing, enriching, replacing and merging your data in ISNI throuhg ISNI Requests.
ISNI Data element values
For a brief description of the field and (ISO) codes used in ISNI records.
ISNI Database fields consolidated
Detailled description of the fields used in ISNI and referred to in the
Annotations
below.
ISNI_atompub_request
ISNI response.xsd
ISNI Response schema.doc
Figure 1: ISNI Request schema top level
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
Request
NR structure
Top level element
requestID
NR Structure
dateTimeOfRequest
NR
End element. Include in the format YYYY-MM-DD HH:MM:SS
requestorTransactionID
NR
String assigned by you. You can choose whatever value you like. Even if another contributor
is accidentally using the same value, there will be no problem.
identityInformation
NR Structure
See next figure
isNot
Repeatable structure
See following figure
isRelated
Repeatable structure
See following figure
/>
merge
Not Repeatable
See following figure
Properties
attribute form default
unqualified
element form default
qualified
[ top ]
Element
Request
Namespace
No namespace
Annotations
Incoming request for ISNI. Version 2.4 2016-09-27
Diagram
Properties
content
complex
Model
requestID{0,1}
identityInformation
isNot*
isRelated*
merge{0,1}
Children
identityInformation
isNot
isRelated
merge
requestID
Instance
""
{0,unbounded}
""
{0,unbounded}
[ top ]
Element
Request
/ requestID
Namespace
No namespace
Diagram
Properties
content
complex
minOccurs
Model
dateTimeOfRequest
requestorTransactionId
Children
dateTimeOfRequest
requestorTransactionId
Instance
[ top ]
Element
Request
requestID
/ dateTimeOfRequest
Namespace
No namespace
Diagram
Type
xs:dateTime
Properties
content
simple
[ top ]
Element
Request
requestID
/ requestorTransactionId
Namespace
No namespace
Diagram
[ top ]
Element
identityInformation
Namespace
No namespace
Annotations
Figure 2: Request - identityInformation
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
identityInformation
NR structure
Top level element
requestorIdentifierOfIdentity
NR Structure
see following figure
/>
otherIdentifierOfIdentity
Repeatable structure
see following figure
identity
NR structure
see following figure
languageOfIdentity
languages spoken by person or main languages of an organisation. ISO 639-2 http://id.loc.gov/vocabulary/iso639-2
E.g. eng, fre, spa
countriesAssociated
Repeatable Structure
See following figure
externalInformation
Repeatable structure
See following figure
note
Free text additional information about the identity
/>
uniqueStatusRequested
NR
Only Y allowed
Diagram
Properties
content
complex
Used by
Element
Request
Model
requestorIdentifierOfIdentity
otherIdentifierOfIdentity*
identity
languageOfIdentity*
countriesAssociated*
externalInformation*
note*
uniqueStatusRequested{0,1}
Children
countriesAssociated
externalInformation
identity
languageOfIdentity
note
otherIdentifierOfIdentity
requestorIdentifierOfIdentity
uniqueStatusRequested
Instance
[ top ]
Element
identityInformation
/ requestorIdentifierOfIdentity
Namespace
No namespace
Annotations
001; 003Z
Figure 3: Request - identityInformation - requestorIdentifierOfIdentity
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
requestorIdentifierOfIdentity
NR structure
referenceURI
NR
IGNORED. May be a resolvable URL or namespace
/>
identifier
NR
Your identifier for this identity
depricatedLocalIdentifier
NR
You are able to indicate your deprecated identifier in case of a merge. If you choose
not to use this field multiple local identifiers may be held on the ISNI record with
equal weight.
specialStatus
NR
Contents are defined locally and there is no validation, e.g. BnF uses for "legal
deposit"
Diagram
Properties
content
complex
Model
referenceURI{0,1}
identifier
deprecatedLocalIdentifier*
specialStatus{0,1}
Children
deprecatedLocalIdentifier
identifier
referenceURI
specialStatus
Instance
[ top ]
Element
identityInformation
requestorIdentifierOfIdentity
/ referenceURI
Namespace
No namespace
Annotations
May be a resolvable URL or an unresolvable
namespace 001; 003Z $u
Diagram
Properties
minOccurs
[ top ]
Element
identityInformation
requestorIdentifierOfIdentity
/ identifier
Namespace
No namespace
Annotations
001 $a; 003Z$0
Diagram
[ top ]
Element
identityInformation
requestorIdentifierOfIdentity
/ deprecatedLocalIdentifier
Namespace
No namespace
Annotations
003Z $d
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
identityInformation
requestorIdentifierOfIdentity
/ specialStatus
Namespace
No namespace
Annotations
003Z $s
Diagram
Properties
minOccurs
[ top ]
Element
identityInformation
/ otherIdentifierOfIdentity
Namespace
No namespace
Annotations
035; 006Z
Figure 4: Request - identityInformation - otherIdentifierOfIdentity
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
otherIdentifierOfIdentity
Repeatable structure
Include other identifiers of the identity, e.g. IPI, VIAF cluster id, IPD, KRI
/>
identifier
NR
e.g. KRI 0186711 for name Yeonggyu Pi.
type
NR
Name of the identifier, e.g. IPD, KRI, IPI, ORCID. Use PPN or ISNI when replacing
metadata and requesting merges.
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
identifier
type
Children
identifier
type
Instance
[ top ]
Element
identityInformation
otherIdentifierOfIdentity
/ identifier
Namespace
No namespace
Annotations
035; 006Z $0
Diagram
[ top ]
Element
identityInformation
otherIdentifierOfIdentity
/ type
Namespace
No namespace
Annotations
035; 006Z $l; e.g. PPN, ISNI, ORCID,
IPI
Diagram
[ top ]
Element
identityInformation
/ identity
Namespace
No namespace
Annotations
Figure 5: Request - identityInformation - identity
An assignment request must contain either a structure for
personOrFiction or for organisation.
Figure 5: Request - identityInformation - identity
An assignment request must contain either a structure for personOrFiction or for organisation.
Diagram
Properties
content
complex
Model
personOrFiction
organisation
Children
organisation
personOrFiction
Instance
[ top ]
Element
personOrFiction
Namespace
No namespace
Annotations
Figure 6: Request - identityInformation - identity - personOrFiction
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
personOrFiction
Choice
NR structure
personalName
NR Structure
see next figure
/>
birthDate
NR
See Data elemant values document for valid formats YYY-MM-DD preferred
(Note birthDate and deathDate are not displayed publically if entered here)
deathDate
NR
See Data elemant values document for valid formats YYY-MM-DD preferred
dateType
NR
Indicates if one of the dates is approximate, either "circa" meaning within a few
(how many -is it 5?) years or "flourished"meaning was active in these years
dateConfidential
NR
Indicates if the date(s) are only visible for the owner and system administrator
nationality
Repeatable structure
ISO 3166-1 2 character codes: http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
/>
resource
Repeatable structure
See following figure. One or more creative works in which the identity played a role
contributedTo
Repeatable structure
See following figure. One or more creative works to which the identity contributed
or performed, e.g. journal title, musical work
personalNameVariant
Repeatable structure
See personal name figure. variant names used by the identity
instrumentAndVoice
Repeatable
instrument played or voice. See Data element values for a list of valid codes
Diagram
Properties
content
complex
Used by
Element
identityInformation/identity
Model
personalName
birthDate{0,1}
deathDate{0,1}
dateType{0,1}
dateConfidential{0,1}
nationality*
resource*
contributedTo*
instrumentAndVoice*
personalNameVariant*
Children
birthDate
contributedTo
dateConfidential
dateType
deathDate
instrumentAndVoice
nationality
personalName
personalNameVariant
resource
Instance
[ top ]
Element
personalName
Namespace
No namespace
Annotations
Figure 7: Request - identityInformation - identity - personOrFiction - personalName
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
personalName
NR structure
nameUse
NR
Valid values: public, public and private, private, fictional character,
unknown
surname (or name)
NR
If the name has two or more parts, include them here in the form
commonly used, e.g. Van Meergeren. If you wish to include more forms,
use the personalNameVariant structur
forename
NR
include all forenames or initials
numeration
NR
e.g. III, 3rd
nameTitle
NR
Includes titles such as “Sir” and “Hon.” And also qualifications such as
“(actor)”, “(spirit)”
marcDate
NR
700 $d; 028 $h, e.g. 16??-1695, 1988?-, -2003, etc. Use the same conventions "?" "C."and
"fl" as MARC.
(Note these dates will appear in the public interfaces)
languageOfName
NR
ISO 639-2 2 character code http://id.loc.gov/vocabulary/iso639-2
script
NR
ISO 15924 4 letter code www.unicode.org/iso15924/iso15924-codes.html
Diagram
Properties
content
complex
Used by
Elements
Request/isNot/relationName
Request/isRelated/relationName
personOrFiction
Model
nameUse{0,1}
surname
forename{0,1}
numeration{0,1}
nameTitle{0,1}
marcDate{0,1}
languageOfName{0,1}
script{0,1}
Children
forename
languageOfName
marcDate
nameTitle
nameUse
numeration
script
surname
Instance
[ top ]
Element
personalName
/ nameUse
Namespace
No namespace
Annotations
public, private, fictional etc. 700 $3; 028
$3
Diagram
Type
restriction of
xs:string
Properties
content
simple
minOccurs
Facets
enumeration
unknown
enumeration
fictional character
enumeration
private
enumeration
public and private
enumeration
public
[ top ]
Element
personalName
/ surname
Namespace
No namespace
Annotations
700 $a; 028 $a
Diagram
[ top ]
Element
personalName
/ forename
Namespace
No namespace
Annotations
700 $a after comma; 028 $d
Diagram
Properties
content
simple
minOccurs
[ top ]
Element
personalName
/ numeration
Namespace
No namespace
Annotations
700 $b; 028 $l, e.g. III, 3rd
Diagram
Properties
minOccurs
[ top ]
Element
personalName
/ nameTitle
Namespace
No namespace
Annotations
700 $c; 028 $f, e.g. Sir, Hon., Jnr, actor, spirit
etc.
Diagram
Properties
minOccurs
[ top ]
Element
personalName
/ marcDate
Namespace
No namespace
Annotations
700 $d; 028 $h, e.g. 16??-1695, 1988?-, -2003,
etc.
Diagram
Properties
minOccurs
[ top ]
Element
personalName
/ languageOfName
Namespace
No namespace
Annotations
ISO 639-2 3 characters); 700/710 $B; 028/029
$B
Diagram
Properties
minOccurs
[ top ]
Element
personalName
/ script
Namespace
No namespace
Annotations
ISO 15924 4 letter code; 700/710 $7; 028/029
$U
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
/ birthDate
Namespace
No namespace
Annotations
970 $a; 032A $a date relating to the party behind the
identity
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
/ deathDate
Namespace
No namespace
Annotations
970 $b; 032A $b date relating to the party behind the
identity
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
/ dateType
Namespace
No namespace
Annotations
970 $c; 032A $c, type of birth and death date, e.q. circa,
lived etc.
Diagram
Type
restriction of
xs:string
Properties
content
simple
minOccurs
Facets
enumeration
lived
enumeration
circa
enumeration
flourished
[ top ]
Element
personOrFiction
/ dateConfidential
Namespace
No namespace
Annotations
970 $e; 032A $e. lifeyears tag is Confidential. Required contents: Y.
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
/ nationality
Namespace
No namespace
Annotations
370 $a; 019A MARC country codes
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
resource
Namespace
No namespace
Annotations
Figure 8: Request - identityInformation - identity - personOrFiction - resource
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
resource
Repeatable structure
For multipe classes, roles and titles, repeat the structure
/>
creationClass
NR
See Data Elements Values document for valid codes
/>
creationRole
NR
See Data Elements Values document for valid codes
fieldOfCreation
Repeatable structure
Code or keyword indicating subjects of the identity's creations
fieldType
NR
Values: Dewey or keyword or key phrase
fieldOfCreationValue
NR
e.g. 150 (Dewey code for psychology), soil erosion (key phrase)
titleOfWork
NR structure
It is preferable to supply 3 or even more to maximize matching
/>
title
NR
Please include initial articles at the front of titles, e.g. "The wind in the willows"
"Les miserables"
Do not include series or serial titles as they have the potential to cause false matching.
Instead use the structure contributedTo
isrc
International Standard Recording Code, connected to the title
iswc
International Standard Work Code, connected to the title
imprint
NR structure
publisher
NR
Character string
date
Date of publication, preferred formats YYYY, YYYY-MM, YYYY-MM-DD
identifier
Repeatable structure
Resource identifier
/>
identifierValue
NR
e.g. a 13 or 10 character ISBN or your local resource identifier
identifierType
NR
e.g. ISBN, ISTC, ISMN, DOI or your local resource identifier
Diagram
Properties
content
complex
Used by
Elements
organisation
personOrFiction
Model
creationClass
creationRole
fieldOfCreation*
titleOfWork
Children
creationClass
creationRole
fieldOfCreation
titleOfWork
Instance
[ top ]
Element
resource
/ creationClass
Namespace
No namespace
Annotations
944 $a; 045R $a ISNI defined list
Diagram
[ top ]
Element
resource
/ creationRole
Namespace
No namespace
Annotations
941 $a; 032C $a ISNI defined list either 3 or 2 character
codes
Diagram
[ top ]
Element
resource
/ fieldOfCreation
Namespace
No namespace
Annotations
dewey 083 $a; 045K $a or keyword or key phrase 962 $a;
044K $a
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
fieldType{0,1}
fieldOfCreationValue
Children
fieldOfCreationValue
fieldType
Instance
[ top ]
Element
resource
fieldOfCreation
/ fieldType
Namespace
No namespace
Annotations
dewey or keyword or key
phrase
Diagram
Properties
minOccurs
[ top ]
Element
resource
fieldOfCreation
/ fieldOfCreationValue
Namespace
No namespace
Diagram
[ top ]
Element
resource
/ titleOfWork
Namespace
No namespace
Annotations
Work includes title with isrc and iswc, imprint, identifier
Diagram
Properties
content
complex
Model
title
isrc*
iswc*
imprint{0,1}
identifier*
Children
identifier
imprint
isrc
iswc
title
Instance
[ top ]
Element
resource
titleOfWork
/ title
Namespace
No namespace
Annotations
910 $a; 021A $a. Actual title of work , do not include journal,
newspaper titles
Diagram
[ top ]
Element
resource
titleOfWork
/ isrc
Namespace
No namespace
Annotations
ISRC 910 $r; 021A $r
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
resource
titleOfWork
/ iswc
Namespace
No namespace
Annotations
ISWC 910 $w; 021A $w
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
resource
titleOfWork
/ imprint
Namespace
No namespace
Annotations
includes imprints, release details,
publication details, performance details
Diagram
Properties
content
complex
minOccurs
Model
publisher
date*
Children
date
publisher
Instance
[ top ]
Element
resource
titleOfWork
imprint
/ publisher
Namespace
No namespace
Annotations
921 $a; 033A $n
Diagram
[ top ]
Element
resource
titleOfWork
imprint
/ date
Namespace
No namespace
Annotations
943 $a; 032B$a input as YYYY,
stored as decade
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
resource
titleOfWork
/ identifier
Namespace
No namespace
Annotations
ISBN 004A, ISSN 005A, ISAN, ISTC ISMN,
DOI, OCN 904; 007S
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
identifierValue
identifierType
Children
identifierType
identifierValue
Instance
[ top ]
Element
resource
titleOfWork
identifier
/ identifierValue
Namespace
No namespace
Annotations
904 $a; 007S $0
Diagram
[ top ]
Element
resource
titleOfWork
identifier
/ identifierType
Namespace
No namespace
Annotations
ISTC, ISBN, ISAN, ISMN, DOI,
OCN 904 $l; 007S $l
Diagram
[ top ]
Element
personOrFiction
/ contributedTo
Namespace
No namespace
Annotations
name of journal, collective work or performances, including the ISRC and ISWC, into
which the identity contibutes 912 $a 021B $a
Figure 9: Request -identityInformation - identity - personOrFiction - contributedTo
contributedTo is used for journal titles, titles of collective works that
to which an identity has contributed. It is also used for musical or theatrical
performances associated with an identity. For details on the elements, see
above "title".
Figure 9: Request - identityInformation - identity - personOrFiction - contributedTo
contributedTo is used for journal titles, titles of collective works, including the
ISRC and ISWC, that to which an identity has contributed. It is also used for musical
or theatricalperformances associated with an identity. For details on the elements,
see above "title".
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
titleOfCollectiveWorkOrWorkPerformed
isrc*
iswc*
identifier*
Children
identifier
isrc
iswc
titleOfCollectiveWorkOrWorkPerformed
Instance
[ top ]
Element
personOrFiction
contributedTo
/ titleOfCollectiveWorkOrWorkPerformed
Namespace
No namespace
Annotations
title 912 $a; 021B $a
Diagram
[ top ]
Element
personOrFiction
contributedTo
/ isrc
Namespace
No namespace
Annotations
ISRC 912 $r; 021B $r
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
personOrFiction
contributedTo
/ iswc
Namespace
No namespace
Annotations
ISWC 912 $w; 021B $w
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
personOrFiction
contributedTo
/ identifier
Namespace
No namespace
Annotations
ISBN 004A, ISSN 005A, ISAN, ISTC, ISMN,
DOI, OCN 904; 007S
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
identifierType
identifierValue
Children
identifierType
identifierValue
Instance
[ top ]
Element
personOrFiction
contributedTo
identifier
/ identifierType
Namespace
No namespace
Annotations
ISTC, ISBN, ISAN, ISMN, DOI,
OCN 904 $l; 007S $l, ISSN 005A
Diagram
[ top ]
Element
personOrFiction
contributedTo
identifier
/ identifierValue
Namespace
No namespace
Annotations
904 $a; 007S $0
Diagram
[ top ]
Element
personOrFiction
/ instrumentAndVoice
Namespace
No namespace
Annotations
035A defined list
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
personOrFiction
/ personalNameVariant
Namespace
No namespace
Annotations
400 028@
Figure 10: Request - identityInformation - identity - personOrFiction - personalNameVariant
Include other names of the person such as maiden names, where all names
are associated with the creative output of the person. Do not include
names of separate creating identities of the same person such as
pseudonyms. Names of separate identities should be included in the
isRelated structure.
For details on the data element see above under "personalName".
Figure 10: Request - identityInformation - identity - personOrFiction - personalNameVariant
Include other names of the person such as maiden names, where all names are associated
with the creative output of the person. Do not include names of separate creating
identities of the same person such as pseudonyms. Names of separate identities should
be included in the isRelated structure.
For details on the data element see above under "personalName".
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
nameUse
surname
forename{0,1}
numeration{0,1}
nameTitle{0,1}
marcDate{0,1}
languageOfName{0,1}
script{0,1}
Children
forename
languageOfName
marcDate
nameTitle
nameUse
numeration
script
surname
Instance
[ top ]
Element
personOrFiction
personalNameVariant
/ nameUse
Namespace
No namespace
Annotations
public, private, fictional etc. 400 $3; 028@
$3
Diagram
Type
restriction of
xs:string
Properties
content
simple
Facets
enumeration
unknown
enumeration
fictional character
enumeration
private
enumeration
public and private
enumeration
public
[ top ]
Element
personOrFiction
personalNameVariant
/ surname
Namespace
No namespace
Annotations
400 $a; 028@ $a
Diagram
[ top ]
Element
personOrFiction
personalNameVariant
/ forename
Namespace
No namespace
Annotations
400 $a after comma; 028@ $d
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
personalNameVariant
/ numeration
Namespace
No namespace
Annotations
400 $b; 028@ $l, e.g. III,
3rd
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
personalNameVariant
/ nameTitle
Namespace
No namespace
Annotations
400 $c; 028@ $f, e.g. Sir, Hon., Jnr, (actor),
(spirit), et.c
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
personalNameVariant
/ marcDate
Namespace
No namespace
Annotations
700 $d; 028 $h, e.g. 16??-1695, 1988?-, -2003,
etc.
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
personalNameVariant
/ languageOfName
Namespace
No namespace
Annotations
ISO 639-2 3 characters); 400 $B; 028@
$B
Diagram
Properties
minOccurs
[ top ]
Element
personOrFiction
personalNameVariant
/ script
Namespace
No namespace
Annotations
ISO 15924 4 letter code; 400 $7; 028@
$U
Diagram
Properties
minOccurs
[ top ]
Element
organisation
Namespace
No namespace
Annotations
Figure 11: Request - identityInformation - identity - organisation
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
organisation
Choice
NR structure
organisationType
NR
See ISNI Data element values.doc for valid values, e.g. University or College, Publisher,
Musical group or band
/>
organisationName
NR Structure
See next figure
usageDateFrom
NR
See Data element values document for valid formats YYYY-MM-DD preferred
usageDateTo
NR
See Data element values document for valid formats YYYY-MM-DD preferred
location
NR structure
countryCode
NR
For a multi-national, include the country code of the main office
/>
locode
NR
Use the UN/LOCODE table: http://www.unece.org/cefact/locode/service/location.html
regionOrState
NR
city
NR
resource
Repeatable structure
See following figure
organisationNameVariant
Repeatable structure
See following figure
/>
Diagram
Properties
content
complex
Used by
Element
identityInformation/identity
Model
organisationType{0,1}
organisationName
usageDateFrom{0,1}
usageDateTo{0,1}
location{0,1}
resource*
organisationNameVariant*
Children
location
organisationName
organisationNameVariant
organisationType
resource
usageDateFrom
usageDateTo
Instance
[ top ]
Element
organisation
/ organisationType
Namespace
No namespace
Annotations
NISO I2 list of values
Diagram
Properties
minOccurs
[ top ]
Element
organisationName
Namespace
No namespace
Annotations
Figure 12: Request - identityInformation - identity - organisation - organisationName(&variant)
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
organisationName
NR nstructure
mainName
NR
Main name of organisation in its most commonly used form
/>
subdivisionName
Name or names of departmens and sections
Diagram
Properties
content
complex
Used by
Elements
Request/isNot/relationName
Request/isRelated/relationName
organisation
Model
mainName
subdivisionName*
Children
mainName
subdivisionName
Instance
[ top ]
Element
organisationName
/ mainName
Namespace
No namespace
Annotations
710 $a 029C $a
Diagram
[ top ]
Element
organisationName
/ subdivisionName
Namespace
No namespace
Annotations
710 $b; 029C $b
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
organisation
/ usageDateFrom
Namespace
No namespace
Annotations
970 $a 032A $a
Diagram
Properties
minOccurs
[ top ]
Element
organisation
/ usageDateTo
Namespace
No namespace
Annotations
970 $b 032A $b
Diagram
Properties
minOccurs
[ top ]
Element
organisation
/ location
Namespace
No namespace
Diagram
Properties
content
complex
minOccurs
Model
countryCode
locode{0,1}
regionOrState{0,1}
city{0,1}
Children
city
countryCode
locode
regionOrState
Instance
[ top ]
Element
organisation
location
/ countryCode
Namespace
No namespace
Annotations
370 $a; 019A $a
Diagram
[ top ]
Element
organisation
location
/ locode
Namespace
No namespace
Annotations
370 $t; 019A $t
Diagram
Properties
minOccurs
[ top ]
Element
organisation
location
/ regionOrState
Namespace
No namespace
Annotations
370 $y; 019A $y
Diagram
Properties
minOccurs
[ top ]
Element
organisation
location
/ city
Namespace
No namespace
Annotations
370 $z; 019A $z
Diagram
Properties
minOccurs
[ top ]
Element
organisation
/ organisationNameVariant
Namespace
No namespace
Annotations
410 029@
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
mainName
subdivisionName*
Children
mainName
subdivisionName
Instance
[ top ]
Element
organisation
organisationNameVariant
/ mainName
Namespace
No namespace
Annotations
029@ $a
Diagram
[ top ]
Element
organisation
organisationNameVariant
/ subdivisionName
Namespace
No namespace
Annotations
029@ $b
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
identityInformation
/ languageOfIdentity
Namespace
No namespace
Annotations
377 $a; 010@ $a ISO 639-2
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
identityInformation
/ countriesAssociated
Namespace
No namespace
Annotations
922; 019@ MARC code list for countries
Figure 13: Request - identityInformation - countriesAssociated
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
countriesAssociated
Repeatable structure
countryCode
NR
Use ISO 3166-1 2 character codes: http://en.wikipedia.org/wiki/ISO_3166-2_alpha-2,
e.g. FR, DE, IT
/>
regionOrState
NR
Use ISO 3166-2 http://en.wikipedia.org/wiki/ISO_3166-2, e.g. US-IL = Illinois
city
NR
Use UN/LOCODE whenever available; Otherwise free-text, e.g. AU HBA = Hobart https://unece.org/trade/cefact/unlocode-code-list-country-and-territory
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
countryCode
regionOrState{0,1}
city{0,1}
Children
city
countryCode
regionOrState
Instance
[ top ]
Element
identityInformation
countriesAssociated
/ countryCode
Namespace
No namespace
Annotations
922 $a; 019@ $a
Diagram
[ top ]
Element
identityInformation
countriesAssociated
/ regionOrState
Namespace
No namespace
Annotations
922 $y; 019@ $y
Diagram
Properties
minOccurs
[ top ]
Element
identityInformation
countriesAssociated
/ city
Namespace
No namespace
Annotations
922 $z; 019@ $z
Diagram
Properties
minOccurs
[ top ]
Element
identityInformation
/ externalInformation
Namespace
No namespace
Annotations
671 / 047P
Figure 14: Request - identityInformation - externalInformation
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
externalInformation
Repeatable structure
source
NR
source citation
/>
information
NR
Nature of information found on the web page, e.g. organisation home page, Wikipedia
page, identity's home page, IMDB page
URI
NR
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
source{0,1}
information
URI
Children
URI
information
source
Instance
[ top ]
Element
identityInformation
externalInformation
/ source
Namespace
No namespace
Annotations
671 $a / 047P $a
Diagram
Properties
minOccurs
[ top ]
Element
identityInformation
externalInformation
/ information
Namespace
No namespace
Annotations
671 $b / 047P $b
Diagram
[ top ]
Element
identityInformation
externalInformation
/ URI
Namespace
No namespace
Annotations
671 $u / 047P $u
Diagram
[ top ]
Element
identityInformation
/ note
Namespace
No namespace
Annotations
668 $a / 047Q $a
Diagram
Properties
minOccurs
maxOccurs
unbounded
[ top ]
Element
identityInformation
/ uniqueStatusRequested
Namespace
No namespace
Annotations
007 $0 / 002X $0
Diagram
Properties
minOccurs
maxOccurs
[ top ]
Element
Request
/ isNot
Namespace
No namespace
Annotations
950/951 defined by attribute; 028Z/029Z
Figure 15: Request - isNot
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
isNot
Repeatable structure
identityType
NR
Values personOrFiction OR organisation
relationName
NR structure
The next elements are part of this structure
ISNI
Choice
NR
choice between ISNI and PPN
For ISNI enter the 16 digit string without prefix or spaces. The ISNI is converted
to a PPN
PPN
Choice
NR
choice between ISNI and PPN
Enter the ISNI database identifier PPN = 9 character string. Include leading zeroes
personalName
Choice
NR structure Optional
choice between personalName and organisationName
See the personalName structure above
organisationName
Choice
NR structure Optional
choice between personalName and organisationName
See the organisationName structure above
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
relationName
Children
relationName
Instance
""
Attributes
QName
Type
Use
identityType
restriction of
xs:string
required
[ top ]
Element
Request
isNot
/ relationName
Namespace
No namespace
Diagram
Properties
content
complex
Model
ISNI{0,1}
PPN{0,1}
) , (
personalName{0,1}
organisationName{0,1}
Children
ISNI
PPN
organisationName
personalName
Instance
[ top ]
Element
Request
isNot
relationName
/ ISNI
Namespace
No namespace
Annotations
converted to PPN. becomes
$9
Diagram
Properties
minOccurs
[ top ]
Element
Request
isNot
relationName
/ PPN
Namespace
No namespace
Annotations
becomes $9
Diagram
Properties
minOccurs
[ top ]
Element
Request
/ isRelated
Namespace
No namespace
Annotations
950/951 defined by attribute; 028Z/029Z
Figure 16: Request - isRelated
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
isRelated
Repeatable structure
identityType
NR
Values personOrFiction OR organisation
relationType
NR
Consult ISNI data element values.doc for a list of valid values depended of identityType,
e.g. co-author, pseud, supersedes, isAffiliatedWith
relationName
NR structure
The next elements are part of the relationName structure
ISNI
Choice
NR
choice between ISNI and PPN
For ISNI enter the 16 digit string without prefix or spaces. The ISNI is converted
to a PPN
PPN
Choice
NR
choice between ISNI and PPN
Enter the ISNI database identifier PPN = 9 character string. Include leading zeroes
personalName
Choice
NR structure mandatory
choice between personalName and organisationName
See the personalName structure above
organisationName
Choice
NR structure mandatory
choice between personalName and organisationName
See the organisationName structure above
relationQualification
NR
This and next elements are part of the isRelated structure
Clarifies relationship type, e.g. for an institution affiliation, this field could
include the position held by an individual or the faculty
startDateOfRelationship
NR
See Data element values document for valid formats YYYY-MM-DD preferred
endDateOfRelationship
NR
See Data element values document for valid formats YYYY-MM-DD preferred
Diagram
Properties
content
complex
minOccurs
maxOccurs
unbounded
Model
relationType
relationName
relationQualification{0,1}
startDateOfRelationship{0,1}
endDateOfRelationship{0,1}
Children
endDateOfRelationship
relationName
relationQualification
relationType
startDateOfRelationship
Instance
""
Attributes
QName
Type
Use
identityType
restriction of
xs:string
required
[ top ]
Element
Request
isRelated
/ relationType
Namespace
No namespace
Annotations
ISNI refined list... 950/951 $t; 028Z/029Z
$t. First 10 facets are 028Z $t
Diagram
Type
restriction of
xs:string
Properties
content
simple
Facets
enumeration
co-author
Used for person related to person
enumeration
co-performer
enumeration
pseud
enumeration
real name
enumeration
colleague / collaborator
enumeration
other identity, same person
enumeration
see also from
enumeration
contact
enumeration
undefined or unknown
enumeration
no relation
enumeration
isMemberOf
Used for institution related to institution
enumeration
hasMember
enumeration
isUnitOf
enumeration
hasUnit
enumeration
isSupersededBy
enumeration
supersedes
enumeration
isAffiliatedWith
enumeration
isRelatedTo
enumeration
see also from
enumeration
formerName
enumeration
laterName
enumeration
undefined or unknown
enumeration
no relation
enumeration
hasMember
Used for institution related to person
enumeration
hasEmployee
enumeration
isRelatedTo
enumeration
see also from
enumeration
contact
enumeration
undefined or unknown
enumeration
no relation
enumeration
isMemberOf
Used for person related to institution
enumeration
isAffiliatedWith
enumeration
isRelatedTo
enumeration
see also from
enumeration
undefined or unknown
enumeration
no relation
[ top ]
Element
Request
isRelated
/ relationName
Namespace
No namespace
Diagram
Properties
content
complex
Model
ISNI{0,1}
PPN{0,1}
) , (
personalName
organisationName
Children
ISNI
PPN
organisationName
personalName
Instance
[ top ]
Element
Request
isRelated
relationName
/ ISNI
Namespace
No namespace
Annotations
becomes $9 (compute PPN from
ISNI) type determined by
attribute
Diagram
Properties
minOccurs
[ top ]
Element
Request
isRelated
relationName
/ PPN
Namespace
No namespace
Annotations
becomes $9
Diagram
Properties
minOccurs
[ top ]
Element
Request
isRelated
/ relationQualification
Namespace
No namespace
Annotations
affiliation role, other 950/951 $j; 028Z/029Z
$j
Diagram
Properties
minOccurs
[ top ]
Element
Request
isRelated
/ startDateOfRelationship
Namespace
No namespace
Annotations
can be approximate, derived from publication
date 950/951 $w; 028Z/029Z $w
Diagram
Properties
minOccurs
[ top ]
Element
Request
isRelated
/ endDateOfRelationship
Namespace
No namespace
Annotations
950/951 $x; 028Z/029Z $x
Diagram
Properties
minOccurs
[ top ]
Element
Request
/ merge
Namespace
No namespace
Annotations
038L $a is generated of the sourcecode and the type of
request, e.g. BNF#ORG, BNF#PERSON
Figure 17: Request - merge
Element
Mandatory / Optional
Repeatable / Not repeatable
Notes
merge
NR structure
subfield a is generated of the sourcecode and type request, e.g. BNF#ORG, BNF#PERSON
Note: Not supported for offline batch import
/>
mergeInstruction
NR
M - request to merge
P - used rarely - when manual review needed
N - used rarely - when the target database record contains a possible match field
that is false.
mergeToPPN
Choice M
NR
Choice between mergeToPPN and mergeToISNI
mergeToISNI
Choice M
NR
Choice between mergeToPPN and mergeToISNI
ISNI is converted to PPN
Diagram
Properties
content
complex
minOccurs
Model
mergeInstruction
, (
mergeToPPN
mergeToISNI
Children
mergeInstruction
mergeToISNI
mergeToPPN
Instance
[ top ]
Element
Request
merge
/ mergeInstruction
Namespace
No namespace
Annotations
77A / 038L $b, values M or P or
Diagram
Type
restriction of
xs:string
Properties
content
simple
Facets
enumeration
enumeration
enumeration
[ top ]
Element
Request
merge
/ mergeToPPN
Namespace
No namespace
Annotations
77A / 038L $9
Diagram
[ top ]
Element
Request
merge
/ mergeToISNI
Namespace
No namespace
Annotations
038L $9 (compute PPN from
ISNI)
Diagram
[ top ]
Attribute
Request
isNot
/ @identityType
Namespace
No namespace
Type
restriction of
xs:string
Properties
use
required
Facets
enumeration
personOrFiction
enumeration
organisation
Used by
Element
Request/isNot
[ top ]
Attribute
Request
isRelated
/ @identityType
Namespace
No namespace
Type
restriction of
xs:string
Properties
use
required
Facets
enumeration
personOrFiction
enumeration
organisation
Used by
Element
Request/isRelated
[ top ]
XML Schema documentation generated by
ygen
/>
XML Editor.