.. _publication: Publication =========== :Description: A text based scholarly publication or publishing channel that contains results of research. CRISs typically record metadata about scholarly publications from the scope of the CRIS (institutional CRIS for the institution, funder CRIS for the funding it distributed, etc.) in the context of the research projects, infrastructure, funding, organization units and authors/contributors. This entity typically represents the granularity level of a single published item for which attribution information is attached (usually in the form of a list of authors and contributors). This entity is also used to represent publishing channels and sources: journals and book series (incl. continuing conference proceedings series). (Taken from https://doi.org/10.1016/j.procs.2014.06.008) :Examples: `openaire_cerif_xml_example_publications.xml `_ :Representation: XML element ``Publication``; the rest of this section documents children of this element :CERIF: the ResultPublication entity (``_) Internal Identifier ^^^^^^^^^^^^^^^^^^^ :Use: mandatory (1) in top level entity. When embedded in other entities the Internal Identifier must be included only for managed information (i.e. entities that have a concrete record in the local CRIS system). See :ref:`Metadata representation in CERIF XML` :Representation: XML attribute ``id`` :CERIF: the ResultPublicationIdentifier attribute (``_) Type ^^^^ :Description: The type of the publication :Use: mandatory (1) :Representation: XML element ``Type`` from namespace ``_ :CERIF: the ResultPublication_Classification (``_) :Vocabulary: Publication types extracted from the COAR Resource Types concept scheme (https://vocabularies.coar-repositories.org/resource_types/). The term *text* and its descendants (except *patent*) are relevant. Some terms are marked as deprecated and may be removed in future guideline releases. **Examples (COAR Types):** text (````_) A resource consisting primarily of words for reading. Examples: books, letters, dissertations, poems, newspapers, articles, mailing list archives. [Source: http://purl.org/dc/dcmitype/Text] annotation (````_) A legally explanatory comment on a decision handed down by a court or tribunal. [Source: DRIVER info:eu-repo definition] bibliography (````_) A list of the books and articles used when writing a book or article. [Source: Cambridge Dictionary] blog post (````_) A piece of writing or content published on a blog. [Source: Lexico] book (````_) A non-serial publication complete in one or several volumes. [Source: Adapted from http://purl.org/eprint/type/Book] book part (````_) A defined chapter or section of a book, usually with a separate title or number. [Source: http://purl.org/spar/fabio/BookChapter] conference output (````_) Digital resources contributed to a conference (presentations, reports, lectures, abstracts, demos). [COAR definition] conference paper not in proceedings (````_) A research paper not published in proceedings. [Source: Adapted from http://purl.org/spar/fabio/ConferencePaper] conference poster not in proceedings (````_) A poster not published in proceedings, often presenting hypotheses or early results. [Source: Adapted from http://purl.org/spar/fabio/ConferencePoster] conference presentation (````_) A set of slides communicating research results at a conference. [Source: http://purl.org/spar/fabio/Presentation] conference proceedings (````_) The official record of a conference meeting. [Source: IEEE] conference paper (````_) A research paper published within a conference proceeding. [Source: http://purl.org/spar/fabio/ConferencePaper] conference poster (````_) A display poster published within a conference proceeding. [Source: http://purl.org/spar/fabio/ConferencePoster] lecture (````_) Transcription of an oral presentation or talk. [Source: Wikipedia] letter (````_) A brief description of important new research, also known as “communication”. [Source: CERIF] magazine (````_) A popular interest periodical or trade publication. [Source: Adapted from The Balance / ODLIS] manuscript (````_) A work of any kind written entirely by hand. [Source: ODLIS] musical notation (````_) Symbols used to write music or express mathematical concepts. [Source: ODLIS] newspaper (````_) A non-peer-reviewed periodical published daily or weekly. [Source: http://purl.org/spar/fabio/Newspaper] newspaper article (````_) A news item appearing in a general-interest newspaper. [Source: reference.md] other periodical (````_) A periodical not included in the top concept “Text”. [COAR definition] journal (````_) A serial publication devoted to original research. [Source: ODLIS] editorial (````_) An essay expressing the opinion of the editor(s). [Source: ODLIS] journal article (````_) A research article published in a journal. [Source: http://purl.org/spar/fabio/JournalArticle] corrigendum (````_) A correction to a previously published document. [Source: FaBiO] data paper (````_) A peer-reviewed article describing a dataset. [Source: Wikipedia] research article (````_) A primary source reporting original research. [Source: Apus Library] review article (````_) A secondary source summarizing other research. [Source: Apus Library] software paper (````_) An article describing a software tool. [Source: F1000Research] letter to the editor (````_) A letter commenting on previously published work. [Source: FaBiO] preprint (````_) A manuscript without peer review. [Source: ASAPbio] report (````_) A published record of research findings or technical results. [Source: ODLIS] clinical study (````_) Reports results of biomedical or health-related studies. [Source: PubMed] data management plan (````_) A statement describing how data will be managed. [Source: CASRAI] internal report (````_) Findings collected for internal use only. memorandum (````_) A formal note distributed internally. [Source: ODLIS] other type of report (````_) Other workplace or technical reports. policy report (````_) Presents facts/evidence on a specific issue. project deliverable (````_) A document containing a project report. [Source: FaBiO] research protocol (````_) A detailed plan of a research study. [Source: WHO] research report (````_) A publication reporting on research findings. [Source: Wikipedia] technical report (````_) A document describing scientific or technical research. [Source: Cornell] research proposal (````_) A proposal for a research project. [Source: Wikipedia] review (````_) A review of others’ published work. book review (````_) A critical analysis of a book. [Source: FaBiO] commentary (````_) An in-depth analysis drawing attention to a work. [Source: Enago] peer review (````_) Evaluation of academic or professional work by peers. technical documentation (````_) Documentation describing technical products. [Source: Wikipedia] thesis (````_) A formal research output submitted for an academic degree. [Source: FaBiO] bachelor thesis (````_) A thesis for a bachelor’s degree. doctoral thesis (````_) A thesis for a doctoral degree. master thesis (````_) A thesis for a master’s degree. transcription (````_) A written record of words spoken. [Source: ODLIS] working paper (````_) A working or discussion paper circulated among peers. [Source: UKOLN] Language ^^^^^^^^ :Description: The language of the publication. Please use the IETF language tags as described in the IETF BCP 47 document. :Use: optional (0..1) :Representation: XML element ``Language`` :CERIF: the ResultPublication_Classification linking entity (``_) with the ``_ semantics Title ^^^^^ :Description: The title of the publication :Use: optional, possibly multiple (0..*) :Representation: XML element ``Title`` as a multilingual string :CERIF: the ResultPublication.Title attribute (``_) Subtitle ^^^^^^^^ :Description: The subtitle of the publication :Use: optional, possibly multiple (0..*) :Representation: XML element ``Subtitle`` as a multilingual string :CERIF: the ResultPublication.Subtitle attribute (``_) NameAbbreviation ^^^^^^^^^^^^^^^^ :Description: The abbreviation of the title of the publication. E.g. the acronym of a journal. :Use: optional, possibly multiple (0..*) :Representation: XML element ``NameAbbreviation`` as a multilingual string :CERIF: the ResultPublication.NameAbbreviation attribute (``_) PublishedIn ^^^^^^^^^^^ :Description: The source (another Publication) where this publication appeared. E.g. a journal article lists here the journal where it appeared. To be used for a publishing channel. :Use: optional (0..1) :Representation: XML element ``PublishedIn`` with embedded XML element ``Publication`` :CERIF: the ResultPublication_ResultPublication linking entity (``_) with the ``_ semantics (direction :1) PartOf ^^^^^^ :Description: The Publication of which this publication is a part. E.g. a book chapter lists here the book that contains it. To be used for a containing publication. :Use: optional (0..1) :Representation: XML element ``PartOf`` with embedded XML element ``Publication`` :CERIF: the ResultPublication_ResultPublication linking entity (``_) with the ``_ semantics (direction :1) PublicationDate ^^^^^^^^^^^^^^^ :Description: The date the publication appeared :Use: optional (0..1) :Representation: XML element ``PublicationDate`` :CERIF: the ResultPublication.ResultPublicationDate attribute (``_) :Format: any of: * year (``YYYY``) with optional time zone indication * year and month (``YYYY-MM``) with optional time zone indication * full date (``YYYY-MM-DD``) with optional time zone indication * date and time (``YYYY-MM-DD'T'hh:mm:ss(.SSS)``) with optional time zone indication Number ^^^^^^ :Description: The number of the publication (e.g. Article Number) :Use: optional (0..1) :Representation: XML element ``Number`` :CERIF: the ResultPublication.Number attribute (``_) Volume ^^^^^^ :Description: The volume of the publishing channel where this publication appeared :Use: optional (0..1) :Representation: XML element ``Volume`` :CERIF: the ResultPublication.Volume attribute (``_) Issue ^^^^^ :Description: The issue of the publishing channel where this publication appeared :Use: optional (0..1) :Representation: XML element ``Issue`` :CERIF: the ResultPublication.Issue attribute (``_) Edition ^^^^^^^ :Description: The edition of the publication :Use: optional (0..1) :Representation: XML element ``Edition`` :CERIF: the ResultPublication.Edition attribute (``_) StartPage ^^^^^^^^^ :Description: The page where this publication starts, in case the publishing channel or containing publication has numbered pages :Use: optional (0..1) :Representation: XML element ``StartPage`` :CERIF: the ResultPublication.StartPage attribute (``_) EndPage ^^^^^^^ :Description: The page where this publication ends, in case the publishing channel or containing publication has numbered pages :Use: optional (0..1) :Representation: XML element ``EndPage`` :CERIF: the ResultPublication.EndPage attribute (``_) DOI ^^^ :Description: The Digital Object Identifier :Use: optional (0..1) :Representation: XML element ``DOI`` :CERIF: the FederatedIdentifier entity (``_) :Format: regular expression ``10\.\d{4,}(\.\d+)*/[^\s]+`` (as per ``_) Handle ^^^^^^ :Use: optional (0..1) :Representation: XML element ``Handle`` :CERIF: the FederatedIdentifier entity (``_) PMCID ^^^^^ :Use: optional (0..1) :Representation: XML element ``PMCID`` :CERIF: the FederatedIdentifier entity (``_) ISI-Number ^^^^^^^^^^ :Use: optional (0..1) :Representation: XML element ``ISI-Number`` :CERIF: the FederatedIdentifier entity (``_) SCP-Number ^^^^^^^^^^ :Use: optional (0..1) :Representation: XML element ``SCP-Number`` :CERIF: the FederatedIdentifier entity (``_) ISSN ^^^^ :Description: The International Standard Serial Number :Use: optional, possibly multiple (0..*) :Representation: XML element ``ISSN`` :CERIF: the FederatedIdentifier entity (``_) :Format: regular expression ``\d{4}-?\d{3}[\dX]`` and length between 8 and 9 characters (as per ``_) medium ------ :Use: optional :Representation: XML attribute ``medium`` :Vocabulary: ISSN Media List * **Print** (``_): Print (paper) * **Online** (``_): Online (online publication) * **Digital carrier** (``_): Digital carrier (CD-ROM, USB keys) * **Other** (``_): Other (Loose-leaf publications, braille, etc.) ISBN ^^^^ :Description: The International Standard Book Number :Use: optional, possibly multiple (0..*) :Representation: XML element ``ISBN`` :CERIF: the FederatedIdentifier entity (``_) :Format: any of: * regular expression ``978-\d+-\d+-\d+-\d`` and length of exactly 17 characters (ISBN-13, human readable form) * regular expression ``978 \d+ \d+ \d+ \d`` and length of exactly 17 characters (ISBN-13, human readable form) * regular expression ``979-[1-9]\d*-\d+-\d+-\d`` and length of exactly 17 characters (ISBN-13, human readable form) * regular expression ``979 [1-9]\d* \d+ \d+ \d`` and length of exactly 17 characters (ISBN-13, human readable form) * regular expression ``978\d{10}`` and length of exactly 13 characters (ISBN-13, concise form) * regular expression ``979[1-9]\d{9}`` and length of exactly 13 characters (ISBN-13, concise form) * regular expression ``\d+-\d+-\d+-[\dX]`` and length of exactly 13 characters (ISBN-10, human readable form) * regular expression ``\d+ \d+ \d+ [\dX]`` and length of exactly 13 characters (ISBN-10, human readable form) * regular expression ``\d{9}[\dX]`` and length of exactly 10 characters (ISBN-10, concise form) medium ------ :Use: optional :Representation: XML attribute ``medium`` :Vocabulary: ISSN Media List * **Print** (``_): Print (paper) * **Online** (``_): Online (online publication) * **Digital carrier** (``_): Digital carrier (CD-ROM, USB keys) * **Other** (``_): Other (Loose-leaf publications, braille, etc.) URL ^^^ :Use: optional (0..1) :Representation: XML element ``URL`` :CERIF: the FederatedIdentifier entity (``_) URN ^^^ :Use: optional (0..1) :Representation: XML element ``URN`` :CERIF: the FederatedIdentifier entity (``_) ZDB-ID ^^^^^^ :Use: optional (0..1) :Representation: XML element ``ZDB-ID`` :CERIF: the FederatedIdentifier entity (``_) :Format: regular expression ``\d{1,7}-[Xx\d]`` (as per ``_) Authors ^^^^^^^ :Description: The authors of this publication :Use: optional (0..1) :Representation: XML element ``Authors`` with ordered embedded XML elements ``Author`` that can contain an embedded person with affiliations or organisation unit Author ------ :Use: optional, possibly multiple (0..*) :Representation: XML element ``Author`` with embedded XML element ``Person`` optionally followed by one or several ``Affiliation`` elements, or ``OrgUnit``. A ``DisplayName`` may be specified, too. :CERIF: the Person_ResultPublication linking entity (``_) with the ``_ semantics; the OrganisationUnit_ResultPublication linking entity (``_) with the ``_ semantics Editors ^^^^^^^ :Description: The editors of this publication :Use: optional (0..1) :Representation: XML element ``Editors`` with ordered embedded XML elements ``Editor`` that can contain an embedded person with affiliations or organisation unit Editor ------ :Use: optional, possibly multiple (0..*) :Representation: XML element ``Editor`` with embedded XML element ``Person`` optionally followed by one or several ``Affiliation`` elements, or ``OrgUnit``. A ``DisplayName`` may be specified, too. :CERIF: the Person_ResultPublication linking entity (``_) with the ``_ semantics; the OrganisationUnit_ResultPublication linking entity (``_) with the ``_ semantics Publishers ^^^^^^^^^^ :Description: The publishers of this publication :Use: optional (0..1) :Representation: XML element ``Publishers`` with ordered embedded XML elements ``Publisher`` that can contain an embedded organisation unit or person Publisher --------- :Use: optional, possibly multiple (0..*) :Representation: XML element ``Publisher`` with embedded XML element ``OrgUnit`` or ``Person``. A ``DisplayName`` may be specified, too. :CERIF: the OrganisationUnit_ResultPublication linking entity (``_) with the ``_ semantics; the Person_ResultPublication linking entity (``_) with the ``_ semantics License ^^^^^^^ :Description: The license of the publication. We recommend using URIs from the SPDX License List (https://spdx.org/licenses/), which includes the Creative Commons licenses. :Use: optional, possibly multiple (0..*) :Representation: XML element ``License`` containing the classification identifier and having a ``scheme`` attribute to specify the classification scheme identifier :CERIF: the ResultPublication_Classification (``_) Subject ^^^^^^^ :Description: The subject of the publication from a classification :Use: optional, possibly multiple (0..*) :Representation: XML element ``Subject`` containing the classification identifier and having a ``scheme`` attribute to specify the classification scheme identifier :CERIF: the ResultPublication_Classification (``_) Keyword ^^^^^^^ :Description: A single keyword or key expression. Please repeat to serialize separate keywords or key expressions. :Use: optional, possibly multiple (0..*) :Representation: XML element ``Keyword`` as a multilingual string :CERIF: the ResultPublication.Keywords attribute (``_) Abstract ^^^^^^^^ :Use: optional, possibly multiple (0..*) :Representation: XML element ``Abstract`` as a multilingual string :CERIF: the ResultPublication.Abstract attribute (``_) Status ^^^^^^ :Use: optional, possibly multiple (0..*) :Representation: XML element ``Status`` containing the classification identifier and having a ``scheme`` attribute to specify the classification scheme identifier :CERIF: the ResultPublication_Classification (``_) OriginatesFrom ^^^^^^^^^^^^^^ :Use: optional, possibly multiple (0..*) :Representation: XML element ``OriginatesFrom`` with embedded XML element ``Project`` or ``Funding`` :CERIF: the Project_ResultPublication linking entity (``_) with the ``_ semantics; the ResultPublication_Funding linking entity (``_) with the ``_ semantics PresentedAt ^^^^^^^^^^^ :Description: The event where this publication was presented. [#]_ :Use: optional, possibly multiple (0..*) :Representation: XML element ``PresentedAt`` with embedded XML element ``Event`` :CERIF: the ResultPublication_Event linking entity (``_) with the ``_ semantics .. [#] Note: Video recordings of conference presentations are stored as alternative representations of the primary object: the conference paper. It would be unneccessarily complex to represent them as separate, linked Products. OutputFrom ^^^^^^^^^^ :Description: This publication contains the proceedings from the linked event :Use: optional, possibly multiple (0..*) :Representation: XML element ``OutputFrom`` with embedded XML element ``Event`` :CERIF: the ResultPublication_Event linking entity (``_) with the ``_ semantics Coverage ^^^^^^^^ :Description: The event that is covered by this publication (e.g. a report about the event) :Use: optional, possibly multiple (0..*) :Representation: XML element ``Coverage`` with embedded XML element ``Event`` :CERIF: the ResultPublication_Event linking entity (``_) with the ``_ semantics References ^^^^^^^^^^ :Description: Result outputs that are referenced by this publication :Use: optional, possibly multiple (0..*) :Representation: XML element ``References`` with embedded XML element ``Publication`` or ``Patent`` or ``Product`` :CERIF: the ResultPublication_ResultPublication linking entity (``_) with the ``_ semantics (direction :1); the ResultPublication_ResultProduct linking entity (``_) with the ``_ semantics (direction :1); the ResultPublication_ResultPatent linking entity (``_) with the ``_ semantics (direction :1) ns4:Access ^^^^^^^^^^ :Description: The open access type of the publication :Use: optional (0..1) :Representation: XML element ``Access`` from namespace ``_ :CERIF: the ResultPublication_Classification (``_) :Vocabulary: * **open access** (``_): Open access refers to a resource that is immediately and permanently online, and free for all on the Web, without financial and technical barriers.The resource is either stored in the repository or referenced to an external journal or trustworthy archive. * **embargoed access** (``_): Embargoed access refers to a resource that is metadata only access until released for open access on a certain date. Embargoes can be required by publishers and funders policies, or set by the author (e.g such as in the case of theses and dissertations). * **restricted access** (``_): Restricted access refers to a resource that is available in a system but with some type of restriction for full open access. This type of access can occur in a number of different situations. Some examples are described below: The user must log-in to the system in order to access the resource The user must send an email to the author or system administrator to access the resource Access to the resource is restricted to a specific community (e.g. limited to a university community) * **metadata only access** (``_): Metadata only access refers to a resource in which access is limited to metadata only. The resource itself is described by the metadata, but neither is directly available through the system or platform nor can be referenced to an open access copy in an external journal or trustworthy archive. FileLocations ^^^^^^^^^^^^^ :Description: The files that this Publication has as contents. :Use: optional (0..1) :Representation: XML element ``FileLocations`` with embedded XML element ``Medium`` :CERIF: the ResultPublication_Medium linking entity (``_) with the ``_ semantics