Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Projects

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Reverted from v. 17

...

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

Image RemovedImage Added

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

Image RemovedImage Added

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

...

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

Image RemovedImage Added

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.

Image RemovedImage Added

Dictionary Overview

Image RemovedImage Added

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

...

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;

Image RemovedImage Added

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;

Image RemovedImage Added

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

...

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

Image RemovedImage Added

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

and for version 1;

Image RemovedImage Added

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

...

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

Dictionary Concepts

Image RemovedImage Added

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

...

  • Add CIEL concepts
  • Bulk add concepts

Image RemovedImage Added


Add CIEL Concepts

Image RemovedImage Added

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

Image RemovedImage Added

To add existing concepts in bulk:

...

Clicking the remove button removes a concept from your collection.

Image RemovedImage Added

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".

The External ID is the UUID of the concept which will appear inside the local OpenMRS concept table. When moving concepts around, the idea is that the UUID should remain the same as the original author's UUID. The OCL ID is the ID which is visible in the OCL user interface and originally corresponded to the Concept ID in the OpenMRS concept dictionary. This is a numeric identifier which is not passed back to OpenMRS. The only requirement is that it is unique within a source. It probably should be a sequence as a default.


Image RemovedImage Added

Create a concept example

Image RemovedImage Added

Other OCL for OpenMRS Wiki Resources

...