dds project¶
Group command for creating and managing projects within the DDS.
dds project [OPTIONS] COMMAND [ARGS]...
access¶
Manage specific users access to a project.
dds project access [OPTIONS] COMMAND [ARGS]...
fix¶
Re-grant project access to user that has lost access due to password reset.
When a password is reset, all project access is lost. To use the DDS in a meaningful way again, the access to the active projects need to be updated.
Limited to Unit Admins, Unit Personnel and Researchers set as Project Owners for the project in question.
dds project access fix [OPTIONS] [EMAIL]
Options
- -p, --project <project>¶
Project ID.
Arguments
- [EMAIL]¶
Required argument
grant¶
Grant a user access to a project.
Users can only grant project access to project they themselves have access to, and only to users with the role ‘Researcher’. To set the Researcher as a Project Owner in this specific project, use the –owner flag.
Limited to Unit Admins, Unit Personnel and Researchers set as Project Owners for the project in question.
dds project access grant [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
- -e, --email <email>¶
Required Email of the user you would like to grant access to the project.
- --owner¶
Grant access as project owner. If not specified, the user gets Researcher permissions within the project.
- --no-mail¶
Do not send e-mail notifications regarding project updates.
revoke¶
Revoke a users access to a project.
Users can only revoke project access for users with the role ‘Researcher’. To set the Researcher as a Project Owner in this specific project, use the –owner flag.
Limited to Unit Admins, Unit Personnel and Researchers set as Project Owners for the project in question.
dds project access revoke [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
- -e, --email <email>¶
Required Email of the user for whom project access is to be revoked.
create¶
Create a project within the DDS.
[Unit Admins and Unit Personnel only]
To give new or existing users access to the new project, specify their emails with –researcher or –owner. Both of these will give the user the role Researcher, but –owner will mark the user as a Project Owner for this specific project, which will give that person some additional administrative rights within the project such as adding users etc.
dds project create [OPTIONS]
Options
- -t, --title <title>¶
Required The title of the project.
- -d, --description <description>¶
Required A description of the project.
- -pi, --principal-investigator <principal_investigator>¶
Required Email of the Principal Investigator. Note: The PI will not be added as a user in the DDS. Add the same email as the –owner if the PI should have an account.
- --researcher <researcher>¶
Email of a user to be added to the project as Researcher. Use the option multiple times to specify more than one researcher [multiple]
- --owner <owner>¶
Email of user to be added to the project as Project Owner. Use the option multiple times to specify more than one project owner [multiple]
- --non-sensitive¶
Indicate whether the project contains only non-sensitive data. NB! Currently all data is encrypted independent of whether the projects is marked as sensitive or not.
info¶
Manage project information.
Display or change the information of a project.
Displaying the project information is available for all user roles. Changing the project information is limited to Unit Admins and Personnel.
dds project info [OPTIONS] COMMAND [ARGS]...
change¶
Change project information.
Not available for Researchers, unless they are marked as Project Owner for a specific project.
dds project info change [OPTIONS]
Options
- -p, --project <project>¶
Required The ID of the project.
- -t, --title <title>¶
Change the title of the project.
- -d, --description <description>¶
Change the description of the project.
- -pi, --principal-investigator <principal_investigator>¶
Change the PI of the project.
display¶
Display information about a specific project.
Usable by all user roles.
dds project info display [OPTIONS]
Options
- -p, --project <project>¶
Required The ID of the project.
ls¶
List all active projects you have access to in the DDS.
Calls the dds ls function.
dds project ls [OPTIONS]
Options
- --sort <sort>¶
Which column to sort the project list by.
- Options
id | title | pi | status | updated | size | usage | cost
- --usage¶
Show the usage for available projects, in GBHours and cost.
- Default
False
- --json¶
Output project list as json.
- Default
False
- --show-all¶
List all projects connected to your account (including inactive).
status¶
Manage project statuses.
Display or change the status of a project.
Displaying the project status is available for all user roles. Changing the project status is limited to Unit Admins and Personnel.
dds project status [OPTIONS] COMMAND [ARGS]...
archive¶
Change the project status to ‘Archived’.
Certain meta data is kept and it will still be listed in your projects. All data within the project is deleted. You cannot revert this change.
Use the –abort flag to indicate that something has gone wrong in the project.
dds project status archive [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
- --abort¶
Something has gone wrong in the project.
busy¶
[Super Admins only] Returns the number of busy projects.
Use –show to see a list of all busy projects.
dds project status busy [OPTIONS]
Options
- --show¶
Show busy projects
- Default
False
delete¶
Delete an unreleased project (change project status to ‘Deleted’).
Certain meta data is kept (nothing sensitive) and it will still be listed in your projects. All data within the project is deleted. You cannot revert this change.
dds project status delete [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
display¶
Display the status of a specific project.
Use –show-history to see all previous statuses of the project.
Usable by all user roles.
dds project status display [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
- --show-history¶
Show history of project statuses in addition to current status.
extend¶
Extend a project deadline by an specified number of days.
It consumes one of allowed times to renew data access.
dds project status extend [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
- --new-deadline <new_deadline>¶
Number of days to extend the deadline.
release¶
Change project status to ‘Available’.
Make project data available for user download. Data cannot be deleted and additional data cannot be uploaded. The count-down for when the data access expires starts.
The –deadline option can be used when changing the project status from ‘In Progress’ to ‘Available’ for the first time. In all other cases the deadline option will be ignored.
Only usable by: Unit Admins / Personnel.
dds project status release [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
- --deadline <deadline>¶
Deadline in days when releasing a project.
- --no-mail¶
Do not send e-mail notifications regarding project updates.
retract¶
Change the project status to ‘In Progress’.
‘In Progress’ is the default status when a project is created. Retracting the project changes the status from ‘Available’ to ‘In Progress’ again.
Make project data unavailable to Researchers, and allow Unit Admins / Personnel to upload additional data to the project. Data cannot be deleted. Data cannot be overwritten.
dds project status retract [OPTIONS]
Options
- -p, --project <project>¶
Required Project ID.
