Skip to content
haarli edited this page Oct 30, 2023 · 7 revisions

UpVerse Installation & Usage

UpVerse is the desktop application that allows you to upload files from your local device to the Edmond repository using a graphical interface. This short manual is intended to guide you through the process of installing and uploading your first files on Windows. The whole process is also visualised in a screencast.

Screencast

final_vid_comp.mp4

Installation

The latest version of Upverse can be found in the Github repository. It contains versions of UpVerse for different operating systems. Selecting the appropriate system starts the download in your browser.

Setting the API token and repository link

Once you have finished downloading and opened Upverse, you need to enter the API ("Application Programming Interface") token for the user. The API token for your account can be found on Edmond. After logging into your Edmond account, open the Account tab in the top right corner. There you will find "API Token" where the token is created.

grafik

The generated token can now be copied to Upverse. More information about the API can be found in the Dataverse documentation.

As well as your personal token, you also need to include the repository URL. Copy the following into the field: https://edmond.mpg.de. You can then save the information and close the window. If you ever want to change the token, it's always possible to reopen the settings window under Settings in the UpVerse tab at the top left in the main window.

Uploading files

In order to upload files and data to your repository, open the main window.

grafik

Under Files or Folders you can select either individual files or entire folders from your local memory. All selected files are listed one after the other. You can then edit the metadata to your liking, such as adding a description to your data (1), changing the name of your file (2) or excluding it from the upload (3).

grafik

You can also delete all files by selecting Clear. Once you have decided which files to add to the repository, select your target dataset. This is useful if you have more than one dataset ready to publish. If you can't find the dataset you want, or you forgot to create one for the files, go to Edmond and double check your dataset, or create a new one. On the main page of Edmond, select Add Data and then New Dataset. Fill in the mandatory fields, which are

  • Title of the Dataset
  • Author
  • MPG institution to which you belong
  • Study type of your Dataset

and save the Dataset. The Dataset can then be accessed by clicking on the reload icon in the UpVerse window.

The files can now be uploaded to the repository (Upload icon). If, during the upload process, you change your mind about the files you want to upload, you can press the Cancel button at any time to prevent the files from being uploaded. All files are then immediately deleted and you are able to select and edit new files.

If files are uploaded multiple times, they are not replaced. Instead, the suffix is used to count up. It starts with "-1". Special characters in the file name such as !?%&'§$() lead to errors.

The files can then be found in your dataset in Edmond on your web browser.