Ein einfaches Schema zur Lieferung von Daten zu Zeitschriftenartikeln an die VZG
Validate against: http://json-schema.org/draft-07/schema#
Schema ID: https://uri.gbv.de/schema/article/01/schema#
Type: object
Description
Dieses JSON-Schema (https://json-schema.org/) beschreibt ein JSON-Format zur Lieferung von bibliographischen Metadaten zu Zeitschriftenartikeln an die Verbundzentrale des GBV (VZG). HTML-Dokumentation: http://findex.gbv.de/articleformatdoc/schemas/article_schema.html
Schema Definitions
This schema defines the following subschemas for reuse:
Zeitschrift:
journalType:
objectDescription
Quellenangabe
Required Properties
titleyear
Properties
The following properties are defined for this object:
Titel:
titleType:
stringDescription
Titel der Zeitschrift
Minimum length:
1IDs der Zeitschrift:
journal_idsType:
arrayDescription
Identifier der Zeitschrift, z.B. E-ISSN, P-ISSN, ZDB-ID, publisher -ID usw.
Items
Each item in this array must adhere to the following schema:
journal_idsType:
objectRequired Properties
typeid
Properties
The following properties are defined for this object:
ID:
idType:
stringDescription
Wert der ID
Minimum length:
1Typ:
typeType:
stringDescription
Typ der ID, z.B. CODEN, eissn, pissn, zdbid, springerid usw. Falls unkbekannt: unknown
Minimum length:
1Examples
The following are example values for this schema:
-
"coden" -
"eissn" -
"pissn" -
"zdbid"
-
Erscheinungsjahr:
yearType:
stringDescription
Erscheinungsjahr als vierstellige Zahl
Regular expression to match:
^[0-9]{4}$Monat:
monthType:
stringDescription
Monat des Erscheinens als zweistellige Zahl
Regular expression to match:
^[0-9]{2}$Tag:
dayType:
stringDescription
Tag des Erscheinens als zweistellige Zahl
Regular expression to match:
^[0-9]{2}$Band:
volumeType:
stringMinimum length:
1Ausgabe:
issueType:
stringMinimum length:
1Verlag:
publisherType:
objectDescription
Angaben zum Verlag, falls bekannt mit einem Identifier des Verlages (z.B. GND)
Properties
The following properties are defined for this object:
Name des Verlages:
nameType:
stringMinimum length:
1publisher_idsType:
arrayItems
Each item in this array must adhere to the following schema:
publisher_idsType:
objectRequired Properties
typeid
Properties
The following properties are defined for this object:
ID:
idType:
stringDescription
Wert der ID
Minimum length:
1Typ:
typeType:
stringDescription
Typ der ID, z.B. gnd. Falls unkbekannt: unknown
Minimum length:
1Examples
The following are example values for this schema:
-
"gnd"
-
Erscheinungsort:
placeType:
stringMinimum length:
1Anfangsseite:
start_pageType:
stringMinimum length:
1Endseite:
end_pageType:
stringMinimum length:
1
Required Properties
primary_idtitlelang_codejournal
Properties
The following properties are defined for this object:
primary_idType:
objectRequired Properties
idtype
Properties
The following properties are defined for this object:
Primäre ID:
idType:
stringDescription
primäre ID des Datensatzes in der Datenquelle
Minimum length:
1Typ:
typeType:
stringDescription
Typ der ID. Der Typ der ID sollte so gewählt werden, dass nachvollziehbar ist, woher die Datensätze stammen. Die Katalogiserungsrichtlinie schlägt in den 20XX- und 21XX-Feldern Kürzel für einige Datenlieferanten vor, die auch hier genutzt werden sollten: http://swbtools.bsz-bw.de/cgi-bin/help.pl?cmd=index®elwerk=RDA&verbund=GBV#titel . Falls unkbekannt: unknown
Minimum length:
1Examples
The following are example values for this schema:
-
"oai_id" -
"https://kxp.k10plus.de/DB=2.1/" -
"oclc"
-
weitere IDs:
other_idsType:
arrayDescription
Weitere Identifier für den Artikel aus dem Quelldatensatz mit Angabe des Typs der ID, z.B. doi, urn, oai_id usw. (hier keine Identifier zu Zeitschriften, Personen usw.) Vergleiche http://swbtools.bsz-bw.de/cgi-bin/help.pl?cmd=kat&val=2113®elwerk=RDA&verbund=GBV
Items
Each item in this array must adhere to the following schema:
other_idsType:
objectRequired Properties
idtype
Properties
The following properties are defined for this object:
ID:
idType:
stringDescription
Wert der ID
Minimum length:
1Typ:
typeType:
stringDescription
Typ der ID. Falls unkbekannt: unknown
Minimum length:
1Examples
The following are example values for this schema:
-
"doi" -
"oclc" -
"urn" -
"oai_id"
-
Titel:
titleType:
stringDescription
Der Haupttitel des Artikels
Minimum length:
1Titel:
subTitleType:
stringDescription
Eventuelle Ergänzung zum Haupttitel
Minimum length:
1Weitere Titel:
otherTitlesType:
arrayDescription
Weitere Titelformen
Items
Each item in this array must adhere to the following schema:
otherTitlesType:
stringMinimum length:
1Personen:
personsType:
arrayDescription
alle am Artikel beteiligten Personen in der Reihenfolge der Nennung im Artikel
Items
Each item in this array must adhere to the following schema:
personsType:
objectRequired Properties
fullname
Properties
The following properties are defined for this object:
Voller Name:
fullnameType:
stringDescription
persönlicher Name, dieser wird auch verwendet, wenn eine Aufteilung in Nachname, Vorname nicht möglich ist. Verfassende Organisationen (Körperschaften) können bei Aufsätzen auch als „persönlicher Name“ angegeben werden
Minimum length:
1Vorname:
firstnameType:
stringDescription
Vorname
Minimum length:
1Nachname:
lastnameType:
stringDescription
Nachname
Minimum length:
1role:
roleType:
stringDescription
Rolle der Person in Bezug auf den Artikel als relator code nach https://opus.k10plus.de/frontdoor/deliver/index/docId/421/file/Liste_Beziehungskennzeichnungen_3010_3110.pdf
Minimum length:
1Examples
The following are example values for this schema:
-
"aut" -
"edt" -
"ill"
-
Zugehörigkeit:
affiliationType:
objectDescription
Zugehörigkeit einer Person zu einer Einrichtung (z.B. Universität, Firma, Forschungseinrichtung usw.)
Properties
The following properties are defined for this object:
Name der Einrichtung:
nameType:
stringDescription
Name der Einrichtung
Minimum length:
1Identifier der Einrichtung:
affiliation_idsType:
arrayDescription
Identifier, die die Einrichtung identifizieren
Items
Each item in this array must adhere to the following schema:
affiliation_idsType:
objectRequired Properties
idtype
Properties
The following properties are defined for this object:
ID:
idType:
stringDescription
Wert der ID
Minimum length:
1type:
typeType:
stringDescription
Typ der ID (z.B. gnd, viaf, ???). Falls unkbekannt: unknown
Minimum length:
1Examples
The following are example values for this schema:
-
"gnd" -
"viaf"
-
IDs der Person:
person_idsType:
arrayDescription
Identifier, die die Person identifizieren (z.B. GND, ORCID, …)
Items
Each item in this array must adhere to the following schema:
person_idsType:
objectRequired Properties
idtype
Properties
The following properties are defined for this object:
ID:
idType:
stringDescription
Wert der ID
Minimum length:
1Typ:
typeType:
stringDescription
Typ der ID (z.B. gnd, orcid, viaf, …). Falls unkbekannt: unknown
Minimum length:
1Examples
The following are example values for this schema:
-
"orcid" -
"gnd"
-
journalReferenced Schema
This item must validate against the following schema:
Weitere Veröffentlichungen:
relatedWorksType:
arrayDescription
Hier können im gleichen Format zu ‘journal’ weitere Verknüpfungen untergebracht werden.
Items
Each item in this array must adhere to the following schema:
relatedWorksReferenced Schema
This item must validate against the following schema:
Sprache(n):
lang_codeType:
arrayDescription
Sprachcode(s) aus ISO 639-2. Zur Verwendung siehe http://swbtools.bsz-bw.de/cgi-bin/help.pl?cmd=kat&val=1500®elwerk=RDA&verbund=GBV
Items
Each item in this array must adhere to the following schema:
lang_codeType:
stringRegular expression to match:
^[a-z]{3}$URLs zum Artikel:
urlsType:
arrayDescription
URLs zum Artikel mit Angabe zum ‘Bezugswerk’ in ‘scope’ sowie zu Benutzungsbedingungen in ‘access_info’
Items
Each item in this array must adhere to the following schema:
urlsType:
objectRequired Properties
urlscopeaccess_info
Properties
The following properties are defined for this object:
URL:
urlType:
stringMinimum length:
1Bezugswerk:
scopeType:
stringDescription
Hier sollen insbesondere URLs zum Volltext des Artikels, aber auch alle anderen Arten von ‘Linkzielen’ nach Typ codiert werden mit ONIX-Codes gemäß Katalogisierungsrichtlinie für PICA3-Feld 4085 $3: http://swbtools.bsz-bw.de/cgi-bin/help.pl?cmd=kat&val=4085®elwerk=RDA&verbund=GBV#$3
Regular expression to match:
^$|^[0-9][0-9]$Codierte Zugangsbedingungen:
access_infoType:
stringDescription
Hier werden Zugangsbedingungen (z.B. Open Access) codiert gemäß Katalogisierungsrichtlinie für PICA3 4085 $4: http://swbtools.bsz-bw.de/cgi-bin/help.pl?cmd=kat&val=4085®elwerk=RDA&verbund=GBV#$4
Abstracts, Zusammenfassungen usw.:
abstractsType:
arrayDescription
Text mit Angabe der Sprache als Sprachcode aus ISO 639-2
Items
Each item in this array must adhere to the following schema:
abstractsType:
objectRequired Properties
text
Properties
The following properties are defined for this object:
Text des Abstracts:
textType:
stringMinimum length:
1Sprachcode:
lang_codeType:
stringDescription
Sprachcode aus ISO 639-2. Zur Verwendung siehe http://swbtools.bsz-bw.de/cgi-bin/help.pl?cmd=kat&val=1500®elwerk=RDA&verbund=GBV
Regular expression to match:
^[a-z]{3}$
Sacherschließung:
subject_termsType:
arrayDescription
Mit Angabe des Sacherschließungssystems und der Sprache als Sprachcode aus ISO 639-2
Items
Each item in this array must adhere to the following schema:
subject_termsType:
objectRequired Properties
schemeterms
Properties
The following properties are defined for this object:
Sacherschließungsterme:
termsType:
arrayDescription
Sacherschließungsterme als Array. Entweder jeder Term als eigenes String-Feld; oder als Objekt bestehend aus einer Bezeichnung und einer ID oder Notation (z.B. GND-ID)
Items
Each item in this array must adhere to the following schema:
termsType:
string,objectMinimum number of properties:
1Properties
The following properties are defined for this object:
Term/Bezeichnung:
termType:
stringMinimum length:
1Identifikator/Notation innerhalb des Sacherschließungssystems:
idType:
stringMinimum length:
1
Minimum length:
1Sacherschließungssystem:
schemeType:
stringDescription
Bezeichnung des Sacherschließungssystems
Minimum length:
1Sprachcode:
lang_codeType:
stringDescription
Sprachcode aus ISO 639-2. Zur Verwendung siehe http://swbtools.bsz-bw.de/cgi-bin/help.pl?cmd=kat&val=1500®elwerk=RDA&verbund=GBV
Regular expression to match:
^[a-z]{3}$
Copyrightvermerk:
copyrightType:
stringMinimum length:
1Herstellungsdatum:
dateOfProductionType:
stringDescription
Herstellungsdatum (z.B. Datum der Digitalisierung). Das Datum kann als vierstelliges Jahr (YYYY), Jahr und Monat (YYYY-MM) oder Jahr, Monat und Tag (YYYY-MM-DD) angegeben werden. s.a. PICA 1108 $p: https://swbtools.bsz-bw.de/cgi-bin/k10plushelp.pl?cmd=kat&val=1108&katalog=Standard
Regular expression to match:
^[0-9]{4}(-[0-9]{2}){0,2}$Sonst noch was?:
additional_dataType:
objectDescription
In den key ‘additional_data’ kann ein JSON-Objekt mit weiteren Daten geschrieben werden. Dieses Objekt muss mit einem JSON-Schema spezifiziert sein und es sollte ein Mapping des Objekts auf Picaplus-Felder mitgeliefert werden.