User Guide: Open Concept Lab (OCL) for OpenMRS

User Testing Pointers

Please follow this link to test the application.
Key pointers:
- If you do not have credentials, use the old OCL to [sign up](https://demo.openconceptlab.org/accounts/signup/), and then be sure to come back to the new OCL, again [here](https://openmrs.demo.openconceptlab.org/).
- If you are unable to login even after you had signed up, the database may have been reset and you would have to sign up again

All feedback can be shared at the user feedback discussion channel on talk(https://talk.openmrs.org/t/ocl-for-openmrs-user-feedback-discussion).

Login

To login, provide your registered username and password then click the "Log in" button. 

Note: You can use your credentials from the Traditional OCL or click the "Sign up" link to register a new account

User Home

After successful login, the application will redirect to the homepage. This page contains a list of the Dictionaries you created.

You will have the option of creating a new Dictionary by clicking the "New Dictionary" button.

Public Dictionaries

You can browse through all the public dictionaries, including those that belong to other people/organisations.

From the navigation bar, click "All Dictionaries" to view the page similar to the one below:

New Dictionary

A real-life user may be creating dictionaries for different reasons, e.g. they may be creating an implementation dictionary for a specific hospital, or a starter set that will eventually be used by multiple hospitals. The UI for these is the same. Click "New Dictionary" to get started.

Dictionary Overview

Click on any of the available Dictionaries to access its overview page. This includes:

• General details (description, owner, creation date, ... )
• Concept counts (Active concepts, Custom concepts, ... )
• A list of released versions
• Options to:
  • View the current Dictionary in the Traditional OCL
  • Release the latest version of the Dictionary
  • Edit the Dictionary
  • View all Concepts

Releasing a Dictionary Version

You can release a dictionary version, essentially creating a frozen 'checkpoint' for the contents of your dictionary. Clicking the 'release latest version' button will give the following prompt;

Name your version and provide an optional description. Note that the version name must be one you have not used before, e.g you cannot release two 'Version 1's.

Providing these details and confirming the release will add that release to the release list;

You can then use the subscription URL to import a particular dictionary version.

Caveat: Please note though, that at this point, versioned dictionary imports are not working as expected, and you will need to use a URL without a version number(this points to the latest version).

For example, in the previous example, we have two release versions. The URL for version 2 is this;

https://qa.openconceptlab.org/users/admin/collections/TR3/2/

and for version 1;

https://qa.openconceptlab.org/users/admin/collections/TR3/1/

Trying to import using this will not work at this moment, and you will need to remove the trailing version number;

https://qa.openconceptlab.org/users/admin/collections/TR3/

This URL now points to the latest released version, which in this case is 2.

Dictionary Concepts

Click "Go to Concepts" to view the page similar to the one above. This shows a tabulated list of all Concepts in the Dictionary with options for Search, Filter, Edit, Remove, and Retire

Note: You can only Edit and/or Retire Concepts that belong to you or to an organization of which you are a part.

Add Concepts To Your Collection (e.g. Add CIEL Concepts)

You can add existing Concepts using any of the two methods provided:

• Add CIEL concepts
• Bulk add concepts

Add CIEL Concepts

Use the search field and/or the filters to find your desired CIEL concept then click "Add concept" to add it to your Dictionary.

To see a preview of the CIEL Concept, click "Preview concept".

Bulk Add Concepts

To add existing concepts in bulk:

1. Use the quick search field to find the concept of your choice within the selected source (only CIEL is available in the MVP version of the application)
2. Click the concept of your choice from the search results and its identifier (ID) will automatically be copied into the "Concept IDs" field
3. If you already have the Concept IDs, simply write/paste them into the Concept IDs field
4. Click the "Add" button

Update A Concept's Version

Adding a CIEL concept adds the latest version of that concept to your collection. A later release of CIEL may update this concept with new information or mappings. If you would like to have these updates in your collection, simply remove the concept and then add it to the collection again. This will pull in the latest version of the concept once again.

Removing a concept from your collection

Clicking the remove button removes a concept from your collection.

Create a new concept

Click "Create new concept" then select the class of the Concept you wish to create. Fill in the form with appropriate values for Names, Descriptions, Mappings, e.t.c and click "Create".

Create a concept example

Other OCL for OpenMRS Wiki Resources

Overview Open Concept Lab (OCL) for OpenMRS

Road map: Open Concept Lab (OCL) for OpenMRS

MVP Testing Scenarios