Editing a Dataset

A dataset can be edited by navigating to the dataset and selecting the ‘Edit’ button in the actions ribbon. Editing or updating a dataset requires Data Steward permissions (or via a custom role with appropriate permissions). Currently the data owner (i.e. the creator) of the dataset can only edit their own dataset. To edit a dataset while within the dataset page, click ‘Edit’ in the action ribbon menu. Alternatively, if any of the catalogue or dictionary information is hovered on, a box will surround the field allowing the user to edit directly (opening up edit mode) or copy the information. Edit mode will allow both the catalogue and dictionary information to become editable. Note that changing the visibility of a dataset does not require edit mode to be selected. For more information about dataset-level visibility and how to change it, see the ‘Dataset Visibility’ article.

Catalogue Editing

In edit mode, all supported metadata fields will become editable, including the name of the dataset. Content within these fields can be added or updated and saved by selecting the ‘Save’ button in the actions ribbon. Supported metadata fields are:

  • Author: author/creator of the dataset
  • Contact email: email address of author or data steward. A valid email address must be provided.
  • Publisher: name or URL of the dataset publisher
  • License: license name or URL of the dataset.
  • Version: version of the dataset
  • DOI: identifier of the dataset. A valid URL must be provided.
  • Rights: rights to the dataset, such as terms and conditions. A valid URL must be provided. For DAR-enabled customers, a user will be asked to agree to these rights as submission time of the request.
  • Created On and ** Last Updated** data is automatically generated by the service.

Dictionary Editing

Adding a Dictionary

To add an initial dictionary, select either '+' icon in the dictionary section. You will be asked to enter a mandatory name and optional description for your dictionary. The former must must adhere to the following rules:

  • lower case
  • alphanumeric and underscores
  • must start with a letter
  • the dictionary name must be unique within a dataset

Adding Field Information

You can then add your dictionary information in the supported fields:

  • Field name: the name of the field. The field name must adhere to the following rules:
    • lower case
    • alphanumeric and underscores
    • must start with a letter
    • fields must be unique in a dictionary
  • Field Label: the human readable name of the field.
  • Type: the type of the field, selected from a controlled vocabulary of types. The following types are supported:
    • text
    • integer
    • decimal
    • boolean
    • date
    • datetime (displayed as Time without timezone)
  • Description: a description of the field.

Additional fields can be added to the dictionary by selecting the ‘+' icon below the list of fields and fields can be removed by selecting the '-' icon adjacent to the field.

Editing a Dictionary Name

An existing dictionary’s name can be edited by selecting the pencil edit icon above the dictionary table. A dialog appears to edit the name. The dictionary name conform to the rules mentioned above.

Removing a Dictionary

An existing dictionary can be removed by selecting the ‘bin’ icon above the dictionary table. The dictionary will delete without confirmation.

Controlled Vocabulary Editing

Controlled vocabularies can be added to datasets and edited via user interface and API. Controlled vocabularies a dictionary-wide where a single lookups (i.e. controlled vocabulary entries) can be associated to multiple fields within a dictionary.

A controlled vocabulary can be added to a dictionary by selecting the ‘list’ icon above the dictionary which brings up a dialog where first a name must be provided.

The controlled vocabulary can then be added to the dictionary by giving each lookup a ‘Name’ and ‘Description’. Rows by can added or removed by the ‘+' and '-’ icons respectively.

The controlled vocabulary then can be assigned to any of the fields within the dictionary via the ‘Type’ dropdown.

Attachment Upload and Download

Attachments can be uploaded to the dataset via the attachment table located below ‘keywords’ in the catalogue section.

Files can either by dragged and dropped into the upload panel or browsed locally and selected for upload. Files can be uploaded individually or added as a group of files. Folder upload is not currently supported.

Progress of upload will be shown when files are being uploaded. Upon a successful upload, the file will appear in the attachment panel with the size of the file and a menu to delete or download the attachment. The attachment can also be downloaded by clicking on the attachment’s filename.

Attachment Deletion

Attachments can be deleted by selecting ‘Delete’ via the ellipsis adjacent to the attachment. The attachment name must be entered to confirm the deletion.

Updated on December 3, 2020

Was this article helpful?

Related Articles

Not the solution you were looking for?
Click the link below to submit a support ticket