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 dataverse collections.
  • Contribute to existing datasets, if permissions granted.
  • 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.

To see a list of notifications, and to select email notifications to turn off open the "Notification settings" grey box. Uncheck the notifications you no longer want to receive or see.
 

API Token

API stands for “Application Programming Interface” and the Dataverse Software APIs allow you to take advantage of integrations with other software that may have been set up by admins of your Dataverse installation.

Additionally, if you are willing to write a little code (or find someone to write it for you), APIs provide a way to automate parts of your workflow. See the Getting Started with APIs section of the API Guide for details.

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/ 

Additional Information

The Dataverse Software APIs are documented in the API Guide but the following sections may be of particular interest: