OID OCD syncing and Mapping

From Galen Healthcare Solutions - Allscripts TouchWorks EHR Wiki
Jump to navigation Jump to search

Mapping Orderable Items to Orderable Concepts is necessary for (Careguides, Order and some of the automated features of the software). This mapping allows the delivered content such as CareGuides and Specialty Favorites to be continually updated without an additional work effort by the system administrator.

  • Orderable Concepts are the generic standard names for all orderable items within the Touchworks system.
  • Orderable Items are the names that your organization uses for orderable items.
  • A professional familiar with the individual OID items needs to do the mapping

Prerequisites for Mapping

Populate Requested Performing Location Dictionary

Contains locations to which tests can be sent or procedures can be performed. Examples of entries in this dictionary include: a laboratory that you use for certain tests or locations that patients prefer to go to for procedures that must be performed off site.


TWAdmin Dictionaries – Requested Performing Location


Performing Location

Populate Orderable Item Dictionary (OID)

Vary per Customer and by performing location / vendor


OrderResults-v11 (Net New Clients) OID-Orderable Item


Dictionaries – Orderable Item

Complete Orderable Item Synchronization

  • Eliminates duplicate orderable items across all vendors
  • Provides end users with only one choice for a given orderable
  • Required to utilize the v11 delivered clinical content
  • A professional familiar with the individual OID items needs to do syncronization
  • (For Upgrade clients, this task can be completed prior to test upgrade?)


Dictionaries – Orderable Item


Order Performing Facility Identifiers

Assign Codes to OID items

Allscripts recommends that organizations review their current setup (upgrading) or as part of their initial setup (assign) codes as appropriate to all orderable items

(How are the codes assigned?)
  • The automate feature uses the codes to map the OCD to the OID
  • Diagnostics - uses CPT-4 and LOINC codes
  • Supplies – uses HCPCS codes

Create V11 OID items for any custom HMP items

OCD/OID Mapping

  • Prerequisites above must be completed prior to mapping
  • Relationship between the Orderable Concept Dictionary (OCD) and the Orderable Item Dictionary (OID) is one-to-one (1:1)
  • A medical professional familiar with the individual OID items needs to do the manual mapping
  • When mapping OCD to OID, use Automated mapping first then use OCD Mapping Tool to manually map the remaining items.

Automated Mapping

  1. Login as TWAdmin
  2. Select Concept mapping from the Vertical Toolbar.
  3. Select the Radio button for OCD based mapping
  4. Filter by all unmapped Items
  5. Click on Ocd2.jpg in the bottom left hand corner of the screen.
  6. When prompted by the Automate Confirmation box, click Yes.
  7. A status bar will appear to show the mapping progress.
  8. You can see how much mapping is complete by checking the Dashboard tab.
  9. OCD5.jpg

Manual Mapping Tool

  • A medical professional familiar with the individual OID items needs to do the manual mapping

Using the filters, map the items in the following prioritized order

  1. Unmapped v11 CareGuide Items (when purchased)
  2. Unmapped v10 HMP Items (if applicable)
    • The Allscripts delivered HMP items will be (automatically?) mapped to OCD items during the upgrade.
    • For custom HMP entries that are associated to a patient’s record within TW v10:
    1. Create a corresponding V11 OID item for all custom HMP items (add link)
    2. Map the orderable items (OID) to an orderable concept (OCD)
    3. Navigate to the Dashboard tab and run the HMP Migration script to create Order Reminders for HMP items
  3. Unmapped Order Favorites
(what about items in OID not in OCD?)

Mapping Steps

  1. From within TWAdmin, Navigate to (Concept Mapping, OCD Mapping)
  2. Select the OCD Based Mapping radio button
  3. Select a Filter to veiw a subset of unmapped items
  4. items that appear in blue text have been successfully mapped
  5. Select an OCD Item from the left hand window to map
  6. Search for the corresponding OID item in the right hand window
  7. Click on the Map button
  8. For Items contained in the OCD that are not in your Orderable item dictionary, Select the item in the OCD window and click on the clone button to copy the item to the OID and map it.

OCD-OID Mapping Dependencies

Once mapping is complete:

  • Activate CareGuides (if purchased)
  • Apply the delivered Order Favorites by Specialty (what does "Apply" mean?)


Use SSMT to migrate mapping configurations from one TouchWorks environment to the another such as from test to production

  • Category name: OID_OCD Mapping
  • Follow the directions on this link: Click Here for SSMT Page to Migrate the OID/OCD mapping