Map PACS procedure codes

Purpose and Benefits

Bahmni PACS-Integration is Bahmni's Radiology System that can send Radiology Orders to digital X-Ray machines and in turn receive X-Ray images that can be viewed in Bahmni. This is the part of the first step in the process to be able to create a Radiology order and send it to the digital X-Ray machines (Modality).

Bahmni will have a set of Radiology X-Ray Concepts and the Client's machine will have a set of X-Rays. We need to map both to ensure that the ordered X-Ray is properly picked at client-side following PACS procedure code mapping detailed below 

Configuring Priority of Concept Source

To better support standardised terminology dictionaries like CIEL, where concept codes are often pre-packaged, the pacs-integration service now includes a configurable environment variable: CONCEPT_CODE_RESOLVER_SOURCE_PRIORITY. This update provides implementers with the flexibility to resolve PACS codes across multiple coding systems by defining a prioritized, comma-separated list of sources.

Add a new environment variable to the pacs-integration service named as CONCEPT_CODE_RESOLVER_SOURCE_PRIORITY. It can take comma separated values in the order of priority to resolve the concept sources from.

Example: CONCEPT_CODE_RESOLVER_SOURCE_PRIORITY= "PACS Procedure Code,CIEL,LOINC" When configured, the system first looks for SAME-AS mappings with Concept Source Pacs Procedure Code → CIEL → LOINC.

Note: The default value is PACS Procedure Code.

Steps

A common reference code has to be setup for each test in both modality and OpenMRS so that modality can understand the order that is to be created. The steps to setup the procedure code in OpenMRS are detailed below:

1. Create a new concept source in OpenMRS

To create a new concept source do the following:

1. In OpenMRS administration UI, click on "Manage Concept Sources" under Concepts section.

2. Click on "Add new Concept Source"

3. Add a new concept source with name as 'PACS Procedure Code' and hl7 code as ''LOINC"

2. Add Concept mapping for each test concept

For example, to add a concept mapping for "abdomen ap" test,

1. Search for "abdomen ap" in concept dictionary and click on Edit.

2. Scroll down to the "Mappings" and click on "Add Mappings"

3. Select "ASSOCIATED-WITH" or "SAME-AS" as Relationship

4. Select "PACS Procedure Code" as Source

5. Click on "Create New Term"

6. Enter a code (for ex: 1234, same code has to be setup in modality for 'abdomen ap') and select "PACS Procedure Code" as Source and save.

7. Now back on the 'Mappings' section in 'Edit Concept screen', search for the added reference term '1234' and save the concept.

Open