Sharing your analysis
Overview
Teaching: 10 min
Exercises: 10 minQuestions
Who can see my analysis
How can I give access to my work to others
Objectives
Learn how to share your work with others
Share your work
CAP has two basic type of entries - drafts
and published
. What’s the difference?
Once you start your analysis in CAP, you first create a draft
. You’re its owner and the only person that can access it (unless you decide otherwise).
Drafts are meant to be used to preserve a work-in-progress analysis, that are not ready to be shared with others yet. Although, if you’re collaborating with
somebody, or need to show it to your supervisor, reviewer, you can give them read/write/admin access to your draft. You work on your draft, keep editing, adding files,
repositories, or even delete it, and start from scratch. But once your analysis is ready, we encourage you to click publish button. What does publish in CAP mean?
Publishing
is the way, to preserve your work within CAP (and CAP only!). When you click publish button, few things will happen.
- We’ll create a new entry for your analysis, with a current snapshot of everything that it contains - metadata, files, repositories - everything preserved!
- All the members of your collaboration will be able to see it
- It will get a Persistent Identifier (PID) with a version number, so can be referenced and used in other analysis
- You wont be able to delete it - although you can edit and re-publish at any time - which will make a new version of published entry
During this course we’re working on the dev instance, so we can publish our test analysis, but think twice before doing this in production server;)
Let’s try to give a read access to your CAP analysis to all the cms-members
- Go to the menu on your left and click on the share symbol (last icon)
- You can see yourself marked as on owner of this analysis, with all the access (makes sense)
- Pick
Egroup email
and type cms egroup mail
- Click
+
button - Now all the cms-members have read access to your analysis! (You can check in your dashboard if you can see some new drafts from your colleagues)
- Revoke access by pressing on
read
switch next to the egroup name
Now let’s check how to publish your analysis
- From the same
share with others
tab clickPublish
button
- Confirm and congrats - your work has been published in CAP!
- Go to the home page and check what has changed in your dashboard
- did numbers on your analysis chart changed?
- can you find your analysis in
published in collaboration
list? - can you see analysis of your colleagues?
Key Points
CAP has two types of entries - drafts and published
Draft can be shared by author with other people
Published is a versioned snapshot of your work, that becomes visible to all the members of collaboration
Once published analysis cannot be deleted - but allows changes and republish with a new version number