The Export User Generated Data Tool
This functionality is not relevant to to Primo VE.
The Export User Generated tool allows staff users who have installation-level permissions to export user-generated content (such as tags, reviews, and ratings) for an entire Primo installation (not a specific Primo institution).
Because this tool exports user data for the entire installation, it is not applicable to multitenant customers. In addition, access to the Back Office server is required to manage the export files created by this tool.
-
On the Tools Monitoring page, select Export User Generated Data in the Create a Tool drop-down list.
The Export User Generated Data page opens.
Export User Generated Data Page -
Enter the fields as described in Export User Generated Data Details. Required fields are indicated by an asterisk.
Export User Generated Data Details Field name Description Name*
This field identifies the tool job, which you can execute and monitor in the Tool Monitoring list.
Content Type*
Indicates the type of content, such as tags, review, and ratings.
Exported Files Destination*
Specify the full path of the directory on the Back Office server in which to place the exported file, which has the following format:
primo_export_user_gen_<date>-<time>.xmlStart exporting from*
Indicates the start date of the user-generated data. Only records that begin on this date are included. Enter a date or click to select a date with the calendar tool.
Email
The e-mail address to which the completion status of the export is sent.
-
Execute the tool when needed. For information on monitoring tools, see Tools Monitoring.
Primo Import-Export XML File Format
The export file is an XML file that contains the following structure per PNX record:
-
id (optional) – For exports, this should be the PNX_ID. For imports, it can be a running number.
-
One or more pairs of key_type/key_value. The key types must be defined in PNX XREF Keys mapping table.
-
One or more groups of data_groups including the following:
-
data_type – the type of data element to import. Currently, the following types are supported:
-
tags
-
reviews
-
abstract
-
fiction
-
extension – allows you to specify additional types of PNX extensions. For example, to create the extension LANG, you could specify the following:
<extension extension_type="LANG"></extension><value><![CDATA[French]]></value>
-
-
data_value – In the case of a review, this may include a rating.
-
data_userid – Optionally, a user ID may be added. This should be done only if the user ID might be valid within Primo.
-
data_username – Optionally, there can be an attribute that indicates whether to display the name (true/false) or not. This is relevant for the review and rating data types.
The following figure shows an example of an export file: