{% extends 'help/base.html' %} {% block breadcrumb_content %}
  • {% link_for _(title), named_route='help.permissions' %}
  • {% endblock %} {% block help_content %}

    This page covers dataset editing permissions: who's allowed to edit which datasets, and how to change who can edit a particular dataset.

    Overview

    Collaborators

    Collaborators are individual users with additional permissions on a dataset. These users will also be emailed if someone clicks the "Contact dataset curator" button on the dataset overview page.

    NB: collaborators are not the same as contributors. Contributors are names of people who contributed to the dataset in some way, and are not necessarily users. As they are used for attribution, contributors are visible in the dataset overview and usually in the citation string, whereas collaborators are only visible to dataset editors.

    Collaborator permissions

    Collaborators can have one of three different levels of access: member, editor, or admin. Each builds on the previous level (admin being the highest level with the most permissions).

    Managing collaborators

    Collaborators cannot be set when creating a dataset, so you will have to finish creating it first, save, and then follow these steps to find the edit page.

    1. Log in and locate a dataset that you own or have admin permissions for
    2. From the dataset overview page, click the "Manage" button
    3. Click the "Collaborators" tab
    4. From here, you can add, remove, and manage collaborators of this dataset.

    Organisations

    Organisations are groups of users that "own" datasets. While there will still be one user who is the primary owner of the dataset, every dataset also belongs to one (and only one) organisation.

    Most datasets on the portal belong to the Natural History Museum organisation, which is the default, and all users are members. If you are not a part of any other organisations on the portal, you will not have the option to change the organisation your dataset belongs to.

    An example of an organisation is the Digitisation Team, who regularly produce new datasets that multiple team members need edit access to.

    A note on terminology

    The data portal runs on a platform called CKAN. While we have extensively modified the software for our needs, there are certain things that are deceptively difficult to change - like the name of a feature embedded throughout the code.

    Since all data on the portal has to be associated in some way with one real-world organisation (the Natural History Museum) calling this feature organisations does seem a bit confusing. Unfortunately, that's what the feature is called in the core platform, and it's referenced in too many places to make it a sensible idea to change.

    When to use an organisation

    For the majority of datasets, the default organisation is fine.

    If you have several datasets and you would like to give the same people edit access to them then your team could benefit from an organisation.

    Only system administrators can create organisations, so if you'd like to use this feature please contact us.

    Organisation permissions

    As with collaborators, users in an organisation can have one of three levels of access: member, editor, or admin. Each builds on the previous level (admin being the highest level with the most permissions).

    Adding a dataset to an organisation

    1. Log in and either: click the "Manage" button on a dataset that you have edit permissions for, OR; create a new dataset
    2. Change the value of the "Organisation" dropdown to the desired organisation (if you can't find this dropdown, you may not have access to any other organisations)
    3. Save your changes.

    Viewing your organisations

    Organisations that you are part of (at any role) are listed in your user profile. We also have a full list of organisations on the portal.

    To view your available organisations:

    1. Log in
    2. Click your name at the top of the page
    3. Click the "organisations" tab.

    Managing organisation members

    1. Log in and locate an organisation that you have admin permissions for
    2. On the organisation overview page, click the "Manage" button
    3. Click the "Members" tab
    4. From here, you can add, remove, and manage the members of this organisation.
    {% endblock %}