Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    Mappings for Export Actions in Primo VE

    Return to menu

    Export actions allow users find material with Primo VE and use its metadata in other systems (such as reference management systems). When a Send To action is invoked, Primo VE maps data fields in Primo VE to data fields used in the target system. This page describes the mapping used for each type of system that is supported by Primo VE.

    Only the mappings for the Export to RIS, EasyBib, and EndNote actions are configurable.

    Export Mappings for the RIS, EasyBib, and EndNote Actions

    The RIS, EasyBib, and EndNote export actions map Primo VE fields to RIS tags. The following table describes the default mapping (including normalization) from PNX sections/fields to RIS tags. You can use the Export Mapping for the RIS, EasyBib, and EndNote Actions mapping table to customize this mapping (see steps). 

    RIS Tag RIS Description PNX
    Section 1
    PNX
    Field 1
    PNX
    Section 2
    PNX
    Field 2
    Multiple
    Occurrences?
    Normalization
    Regex

    TY

    Type of reference

    addata

    ristype

    For a list of mappings, see Primo VE Resource Type Mappings.

     

     

     

     

    T1

    Primary Title

    display

    title

     

     

     

     

    T2

    Secondary Title (journal title, if applicable)

    addata

    addtitle

     

     

     

     

    T3

    Tertiary Title

    addata

    seriestitle

     

     

     

     

    JF

    Journal/Periodical name

    addata

    jtitle

     

     

     

     

    JA

    Periodical name: standard abbreviation

    addata

    stitle

     

     

     

     

    AU

    Author (each author on its own line preceded by the tag)

    addata

    au

    display

    creator

    true

    (.*)\$\$Q.*;true

    A2

    Secondary Author

    addata

    addau

     

     

    true

     

    Y1

    Publication year

    addata

    date

    display

    creationdate

     

    \d{4};false

    VL

    Volume number

    addata

    volume

     

     

     

     

    IS

    Issue number

    addata

    issue

     

     

     

     

    SP

    Start Page

    addata

    spage

     

     

     

     

    EP

    End Page

    addata

    epage

     

     

     

     

    ID

    Reference ID

    control

    recordid

     

     

     

     

    N2

    Abstract

    addata

    abstract

     

     

    true

    SINGLE_TAG

    KW

    Keywords

    display

    subject

     

     

    true

     

    N1

    Notes

    addata

    notes

     

     

     

     

    DO

    DOI

    addata

    doi

     

     

     

     

    SN

    ISBN/ISSN

    addata

    issn, eissn, isbn, eisbn

     

     

     

     

    PB

    Publisher

    addata

    pub

     

     

     

     

    CY

    Place published

    addata

    cop

     

     

     

     

    ET

    Edition

    addata

    edition

     

     

     

     

     

    To modify a RIS field's mapping:
    1. Open the Export Mapping for the RIS, EasyBib, and EndNote Actions mapping table (Configuration Menu > Discovery > Other > Export Mapping for the RIS, EasyBib, and EndNote Actions).

    2. If you haven't already customized any mappings, select Customize to allow the table to be customized.

    3. For each RIS Tag that you want to modify, configure the following fields:

      • RIS Tag – The tag to which the value of the PNX field is mapped in the target system.

      • PNX Section 1 and PNX Section 2 – Indicates the PNX section used to map values from Primo VE to RIS format: display, control, and addata. Local fields are selectable after selecting the display section.

      • PNX Field 1 and PNX Field 2 – Indicates which fields are used to map values from Primo VE to RIS format. The allowable fields are based on the selected PNX section.

      • Multiple Occurrences? – Indicates whether multiple instances of a field are mapped to the RIS format. If this column is left blank, only one instance of a field is mapped.

      • Normalization Regex – If normalization is needed, this field contains the regular expression <regex> used to extract data from the PNX field and also indicates whether the full value of the PNX field is mapped if the regular expression returns no result <map?>. This column uses the following format:

        <regex>;<map?>
    4. Select Save. If you want to return to the default settings, select Restore.

    Primo VE Resource Type Mappings

    The following table shows how the Primo VE resource type is mapped to RIS Type for export to RIS actions (such as EndNote).

    prima_display/rtype

    addata/ristype

    books

    BOOK

    book_chapters

    CHAP

    journals

    JOUR

    articles

    JOUR

    text_resources

    BOOK

    government_documents

    BOOK

    images

    GEN

    maps

    MAP

    scores

    GEN

    videos

    VIDEO

    audios

    SOUND

    databases

    GEN

    websites

    GEN

    newspaper_articles

    JOUR

    manuscripts

    BOOK

    conference_proceedings

    If the record has display/issn or display/eissn, use:

    CONF

    Else:

    BOOK

    dissertations

    THES

    kits

    GEN

    collections

    GEN

    other

    GEN

    archival_materials

    GEN

    realia

    GEN

    Export Mappings for the RefWorks Action

    The RefWorks export action uses the same RIS mappings as shown in the previous table. With the December 2018 release, there are a few differences, which are described in the following table.

    RIS Tag RIS Description PNX Field 1 PNX Field 2 Multiple Occurrences? Normalization Regex

    AU

    Secondary Author – each author is on its own line and preceded by the tag

    addata/addau

    display/creator

    true

    (.*)\$\$Q.*;true

    A1

    First Author

    addata/au

     

    true

     

    A2

    No longer mapped (see AU tag).

           

    ET

    Edition – one or more digits only

    addata/edition

     

     

     (\d + );false

    Export Mappings for the BibTex Action

    The BibTex export action maps Primo VE fields to BibTex tags as described in the following table.

    BibTex Tag PNX Field 1 PNX Field 2 Multiple Params indication Single Section with Multiple Fields

    title

    display/title

     

     

     

    journal

    addata/jtitle

    display/title

    NOT

     

    booktitle

    addata/btitle

    display/title

    NOT

     

    series

    addata/seriestitle

     

     

     

    author

    addata/au

     

    AND

    TRUE

    organization

    addata/aucorp

     

     

     

    year

    addata/date

     

     

     

    volume

    addata/volume

     

     

     

    copyright

    display/rights

     

     

     

    number

    addata/issue

     

     

     

    pages

    addata/

    spage, epage/pages

     

    SINGLE

     

    isbn

    addata/isbn

    addata/eisbn

    SINGLE

     

    issn

    addata/issn

    addata/eissn

    SINGLE

     

    lccn

    addata/lccn

     

     

     

    abstract

    addata/abstract

     

     

     

    keywords

    display/subject

     

     

     

    language

    display/language

     

     

     

    publisher

    addata/pub

     

     

     

    address

    addata/cop

     

     

     

    edition

    display/edition

     

     

     

    url

    addata/url

     

     

     

    • Was this article helpful?