Skip to Main Content

LibraData User Guide

UVa's Local Instance of the Dataverse Software

LibraData Account Creation & Management

As a registered UVA user, you can:

  • Add datasets to dataverses.
  • Contribute to existing datasets, if available.
  • Request access to restricted files, if available.

Create UVA User Account (required for UVA depositors)

  1. In the top right corner of each page, click on the Log In link.
  2. On the right-side, choose the UVA icon, or “University of Virginia” in the pulldown menu. UVa Login

  3. Sign in with your UVa Netbadge Credentials.


The first time you sign in to LibraData, you must accept the LibraData Deposit Terms. The University expects that you read the terms before confirming your agreement. You can see the terms here: http://www.library.virginia.edu/libra/datasets/public-dataset-license/
Terms Acceptance
 

My Data

The My Data section of your account page displays a listing of all the datasets, and files you have either created, uploaded or that you have access to edit. You are able to filter through all the datasets, and files listed using the filter box or use the facets on the left side to only view a specific Publication Status or Role.
 

Notifications: Setup & Maintenance

Notifications appear in the notifications tab on your account page and are also displayed as a number next to your account name.

You will receive a notification when:

  • You’ve created your account
  • You’ve added a dataset
  • Another Dataverse user has requested access to a restricted file in one of your datasets
  • A file in one of your datasets has finished the ingest process.

There are other notification types that you can receive, e.g., notification on granted roles, API key generation, etc. These types of notifications are less common and are not described here. Some other notifications are limited to specific roles. For example, if the installation has a curation workflow, reviewers get notified when a new dataset is submitted for review.

LibraData will email your unread notifications once a day. Notifications will only be emailed one time even if you haven’t read the notification on the Dataverse site.
 

API Token
 

Your API Token is Like a Password

In many cases, such as when depositing data, an API Token is required to interact with Dataverse Software APIs. The word “token” indicates a series of letters and numbers such as c6527048-5bdc-48b0-a1d5-ed1b62c8113b. Anyone who has your API Token can add and delete data as you so you should treat it with the same care as a password.
 

Create Your Token
  1. To create your API token, click on your name in the header on right hand side and then click on “API Token”. NOTE: API Tokens last one year and then you will need to recreate it.
  2. In this tab, you can create your API Token for the first time as well as recreate it if you need a new API Token or your API Token becomes compromised.
  3. Please see the LibraData API Terms of use before using, https://www.library.virginia.edu/libra/datasets/libra-data-api-terms-of-use/