Export/Import CP

A CP can be exported and imported from one instance of OpenSpecimen to another. E.g. QA server to production server.

Pre-requisites before importing a protocol from one server to another:

Users used as PI/coordinators exists
Sites associated to the protocol or used as default sites in events exists
User who is doing the import has sufficient access
If new dropdown values like specimen type, collection containers etc. are created to be used in the protocol, make sure those are imported as well

Navigate to the overview page of the CP which is to be exported.
Click on 'More' → ‘Export Collection Protocol (JSON)’
This will export the protocol definition to a .json file
Go to the collection protocols list page of the other instance of OpenSpecimen where the exported CP has to be imported.
Click on 'More' option and select option 'Collection Protocol'
Upload the .json file and click on 'Import'

Clone CP

A CP can be cloned to make an exact copy on the same instance of OpenSpecimen. This will copy all the details, consents, events, requirements and settings. The administrator can change the name and create another similar protocol. This is useful if there is a similar study that is starting up and saves administrator time in setting up the protocol. Another use case of the clone feature is when you create a CP on the QA/Test server and have to move it to the production server.

Once the CP is cloned, all required the forms should be attached to the CP to required level.

Delete CP

Administrators who have the privilege to delete protocols can delete protocol from the main overview page. Click on 'Delete' to delete the collection protocol.

If participants and specimens are already registered under the protocol, the system warns and makes the user type 'DELETE ANYWAY' so that it is not deleted accidentally. This will delete the protocol with all data under it.

Close CP

Administrators who have the privilege to close protocols can close the protocol from the main overview page. Click on 'Close' to close the collection protocol.

New participants cannot be added to a closed collection protocol. A collection protocol can be closed once it is no longer used.

The activity status of closed CP is 'Closed'.

To reopen the collection protocol, go to the overview page of the closed collection protocol and click on 'Reopen'.

Starring CP

From v6.3, it is possible for users to ‘star’ a protocol which they work on regularly. This is similar to a browser bookmark, where users can mark the sites they visit frequently.

Starring a collection protocol makes it appear at the top of the list, thus saving the users' effort to search for the protocols that are accessed frequently.

This starring is login-specific. Each logged-in user can have her/his own list of starred collection protocols.

From the ‘Navigation’ menu, go to the ‘Collection Protocols’ list page.
On the left-hand side, a blank ‘star’ icon is visible.
Search for the protocols that need to be accessed more frequently than the others. Click on the star(s) present in front of such protocols. They turn golden once you click on them.
Refresh the page. These will appear at the top whenever you log in using the same login ID.
Starred CPs are ordered in the descending order of starred time. More recently starred CPs will appear above the previously starred CPs.

The starred CPs can be unstarred by clicking again on the golden ‘star’ icon.

CP Operations

Export/Import CP

Clone CP

Delete CP

Close CP

Starring CP