Contributors Guide

This guide supports version 1.2 of the Dataverse Network application.

In addition to all the tasks that Data Users can perform, Contributors can use the following options and privileges:

Become a Contributor

To contribute your data to a dataverse:

  1. Navigate to the dataverse to which you choose to contribute.
  2. Click the Become a Contributor link on the top-right corner of the dataverse homepage.
    You see the Become a Contributor page.
  3. If you do not have an account:
    1. Click Continue.
      You see the Create Account page.
    2. Enter values in the required fields, and then click Create Account.
      You see the Agree to Terms page. Note your new username in the top-right corner of the page.
      Click Cancel to return to Network homepage and not create a Contributor account.

    If you have an account and not logged in:

    1. Click Log In.
      You see the Login page.
    2. Log in.
      You see the Agree to Terms page. Note your username in the top-right corner of the page.

    If you are logged in, click Continue.
    You see the Agree to Terms page.

  4. Read the Terms of Use, then check the box for I agree and accept these terms of use.
    Note: If there are no Terms of Use applied to the Network or the dataverse, you do not need to check an accept box.
  5. Click Continue to complete your request, or click Cancel to return to the Network homepage.
    You see the Success! page, and now are logged in to the dataverse and ready to contribute.
    You also receive e-mail notification that your account was created.
  6. Navigate to the dataverse homepage, and then click My Options.
    You see your Contributor Options.
    Continue to Add New Studies to learn how to contribute your study to the dataverse.

Forgot Your Password?

If you forget your login account password, you can retrieve a new password to log in to your account.

To retrieve your password:

  1. On the Network or dataverse homepage, click Log In.
    You see the Login window.
  2. In the Dataverse Account field, click the Forgot your password? link.
    You see the Forgot Password page.
  3. In the User Name field, enter the username for your account. Then, click Submit.
    You see the message Your password has been emailed to you.
    In the e-mail account that you specified when you created your login account, you receive a message with the subject Dataverse Network: password has been changed. This e-mail contains a new password for your account.
  4. Go back to the Login page and use the new password to log in to the dataverse.

Add New Studies

There are several guidelines to creating a study:

The steps to creating a study are:

  1. Enter Cataloging Information, including an abstract of the study.
    Set Terms of Use for the study in the Cataloging fields, if you choose.
  2. Upload files associated with the study.
    Be sure to review the study file tips before you start to upload your files.
  3. Set permissions to access the study, all of the study files, or some of the study files.
  4. Delete your study if you choose, before you submit it for review.
  5. Submit your study for review, to make it available to the public.

See the following topics to find out more:

Enter Cataloging Information

A complete list of Cataloging Information fields that comprise the metadata for a study is provided in the List of Metadata.

To enter the Cataloging Information for a new study:

  1. Log in to the Network and navigate to the dataverse to which you plan to contribute.
    This dataverse is specified in your Contributor account e-mail.
  2. Click My Options, scroll to Contributor Options, and then click Add New Study.
    If prompted to accept Terms of Use, check the I Accept box and then click the Continue button.
    You see the Cataloging Information tab of the study page.
  3. Enter a title in the Title field before you do anything else.
  4. Enter data in the Cataloging Information fields.
    To list all fields, including the Terms of Use fields, click the Show Additional Fields button after you enter a title. Use the following guidelines to complete these fields:

    • A light blue background in any form field indicates that HTML, JavaScript, and style tags are permitted. You cannot use the html and body element types.
    • To use the inline help and view information about a field, roll your cursor over the field title.
    • Be sure to complete the Abstract field.
    • To set Terms of Use for your study, scroll to the bottom of the Cataloging Information tab.
      Eight fields appear under the Terms of Use label. You must complete at least one of these fields to enable Terms for this study.
  5. Click Save to keep your changes, or click Cancel to lose your changes.
  6. Continue to the next topic and upload the Study Files.

Upload Study Files

See Study File Tips for more about uploading files for a dataverse study.

To upload files associated with a new study:

  1. After you enter the Cataloging Information on the study page, you can click the Upload Files tab before you click Save to upload your files.
    If you clicked Save on the Cataloging Information tab, click the Add File(s) link in the top-right area of the page to go to the Upload Files tab.
    If prompted to accept Terms of Use, check the I Accept box and then click the Continue button.
  2. For each file that you choose to upload to your study, click the Browse button to select the file and upload one file at a time.
    There is no restriction to the number or types of files that you can upload to the IQSS DVN. There is a maximum file size of 1 gigabyte for each subsettable data file that you upload.
  3. For each file that you upload, first click the check box in front of the file's entry in the list, and then use the Category drop-down list to select the type of file that you uploaded.
    Every checked file is assigned the category that you select. Be sure to click the checked box to remove the check before you select a new value in the Category list for another file.
  4. In the Description field, enter a brief message that identifies the contents of your file.
  5. Click Save when you are finished uploading files.
    You see the Documentation, Data and Analysis tab of the study page with a list of the uploaded files. For each subsettable data set file that you upload, the number of variables and a link to the Data Citation information for that data set are displayed. If you uploaded an SPSS (.sav or .por) file, the Type for that file is changed to Tab delimited and the file extension is changed to .tab when you click Save.
  6. Continue to the next step and set file permissions for the study or its files.

Study File Tips

Keep in mind these tips when uploading study files to your dataverse:

  • You can add information for each file, including:
    • File name
    • Category (documentation or data)
    • Description
  • If you upload the wrong file, click the Delete check box to prevent the addition of that file to your study.
    To replace a file after you upload it and save the study, first delete the file and then upload a new one.
  • If you upload a STATA (.dta) or SPSS (.sav or .por) file, the file automatically becomes subsettable (that is, subset and analysis tools are available for that file in the Network). In this case, processing the file might take some time and you will not see the file listed immediately after you click Save.
  • When you upload a subsettable data file, you are prompted to provide or confirm your e-mail address for notifications. One e-mail lets you know that the file upload is in progress; a second e-mail notifies you when the file upload is complete.
  • While the upload of the files takes place, your study is not available for editing. It becomes available as soon as the upload is completed.

Set Study Permissions

You can restrict access to a study, all of its files, or some of its files. This restriction extends to the search and browse functions.

To permit or restrict access:

  1. On the study page, click the Permissions link.
  2. To set permissions for the study:
    1. Scroll to the Entire Study Permissions panel, and click the drop-down list to change the study to Restricted or Public.
    2. In the If study is set as Restricted field, enter a user or group that you choose to grant access to the study, then click Add User/Group.

    To set permissions for all files in the study at one time, scroll to the All Files Permissions panel, and click the check box to require users to log in or to request by e-mail permission to view the study.
    To set permission for individual files in the study:

    1. Scroll to the Individual File Permissions panel, and enter a user or group to grant permissions to an individual file.
    2. Use the Set file permission pull-down list and select the permission level that you choose to apply to selected files: Restricted or Public.
    3. In the list of files, click the check box for each file to which you choose to apply permissions.
      To select all files within a category, click the check box for that category.
    4. Click Update.
  3. Click Save Changes to keep your changes or Cancel to return to the Cataloging Information tab.

Note: You can edit or delete your study if you choose, but only until you submit the study for reveiw. After you submit your study for review, you cannot edit or delete it from the dataverse.

Delete Studies

You can delete a study that you contribute, but only until you submit that study for review. After you submit your study for review, you cannot delete it from the dataverse.

When you delete a study, you remove it permanently from the dataverse. This includes the global identifier assigned to the study.

To delete a study:

  1. Click the Delete link in the top-right area of the page to go to the Upload Files tab.
    You see the Deleting a Study page.
  2. Click the Delete button to remove your study from the dataverse, or click Cancel to return to the study page without removing the study.
    If your delete was successful, you see the message The study has been deleted successfully.

Submit Study for Review

When you finish setting options for your study, click Ready for Review in the top-right corner. The study page changes to show In Review.

Note: After you click the Ready for Review button, no editing options are available to you for this study. Make sure that all your options are set for this study before you click the Ready for Review button.

You receive e-mail after you click Ready for Review, notifying you that your study was submitted for review by the Curator or Dataverse Admin. When a study is in review, it is not available to the public. You receive another e-mail notifying you when your study is released for public use.

After your study is reviewed and released, it is made available to the public, and it is included in the search and browse functions. The Cataloging Information tab for your study contains the Citation Information for the complete study. The Documentation, Data and Analysis tab lists the files associated with the study. For each subsettable file in the study, a link is available to show the Data Citation for that specific data set.

View (and Edit) Your Studies

You can view the status of any study that you added to the dataverse, and you can edit any study that has a status of New.

To view and edit studies that you contributed to a dataverse:

  1. On the dataverse homepage, click My Options.
  2. Click View My Studies.
    You see the My Studies in [Your] Dataverse page, listing all studies that you uploaded to this dataverse.
  3. To edit a New study before you submit it for review, click the study title.
    You see the study page with all edit options available.
    See Add New Studies for information about editing the Cataloging Information, adding files, adding or editing permissions, deleting the study, or submitting it for review.
    Note: The Study ID field is validated for invalid characters or spaces when a user edits the study. Invalid characters include the following: ~,`, !, @, #, $, %, ^, &, and *.
  4. To view a study in review, click the study title.
    You see the Cataloging Information tab for that study.