Mappings for Export Actions in Primo VE

Last updated
Save as PDF
Share
1. Share
2. Tweet
3. Share

Export actions enable users to 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 Primo VE supports.

Only the mappings for the Export to RIS, EasyBib, and EndNote actions are configurable.
For information regarding CSL mapping for the Citation export function, see CSL Field Mapping.

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
AU	Author (each author on its own line preceded by the tag)	addata	au	display	creator	true	(.)\$\$Q.;true
CY	Place published	addata	cop
DO	DOI	addata	doi
EP	End Page	addata	epage
ET	Edition	addata	edition
ID	Reference ID	control	recordid
IS	Issue number	addata	issue
JA	Periodical name: standard abbreviation	addata	stitle
JF	Journal/Periodical name	addata	jtitle
KW	Keywords	display	subject			true
N1	Notes	addata	notes
N2	Abstract	addata	abstract			true	SINGLE_TAG
PB	Publisher	addata	pub
SN	ISBN/ISSN	addata	issn, eissn, isbn, eisbn
SP	Start Page	addata	spage
T1	Primary Title	display	title
T2	Secondary Title (journal title, if applicable)	addata	addtitle
T3	Tertiary Title	addata	seriestitle
TY	Type of reference	addata	ristype For a list of mappings, see Primo VE Resource Type Mappings.
VL	Volume number	addata	volume
Y1	Publication year	addata	date	display	creationdate		\d{4};false

To modify a RIS field's mapping:

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).
If you haven't already customized any mappings, select Customize to enable the table to be customized.
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?>
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
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