Vitals Configuration

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

Overview

  • (oderable vs non-orderable Orderable Items give axample of each?)

(Are all vital signs orderable? for example is a comment orderable?)

  • All Vitals are Orderable Items
  • All Orderable Items must be mapped to a resultable item
  • A Complex Orderable Item is an Orderable Item that can contain other Orderable Items
  • A Complex Orderable Item does not needed to be mapped to a resultable item because its children are already mapped to resultable iems.
  • Both the parent and child Orderable Items are contained in the same dictionary, the OID
  • A Complex Orderalbe Item containing vitals is called a Panel on the back end and a View on the front end.

High Level Process

  1. Create Resultable Items for any new vital signs
  2. Create Orderable items for the new vital signs and map to the corresponding resultable items
  3. Create Complex Orderable Items (panels) and Add Orderable Items to create views

Create Resultable Item

All Orderable Items must have a Resultable Item

  1. TWAdmin > Dictionaries > Dictionary: Resultable Item
  2. Click 'Search' at the bottom of the screen to show/hide the search bar
  3. Search for the needed item before creating a new item. (use 'Contains')
  4. If the needed item already exists in the RID no further action is needed in the RID.
  5. To create a new item click 'Add'
  6. Enter 'Code', 'Name', 'Mnemonic' and 'Display Name'
    • The Code is the database key and must be unique
    • Always make 'Code' and 'Mnemonic' the same.
    • The code and mnemonic are limited to 10 characters and no spaces between characters
    • Always use the organization mnemonic as the prefix. This will make it easy to tell which items were created for the organization. For example a new vital sign of waist circumference added by New World Health could be given the code and mnemonic 'NWH_WstCir'
    • Make 'Name' and 'Display Name' the same
  7. Configure details
  8. Click 'Save'

Create Vital Signs

  1. TWAdmin > Dictionaries > Dictionary: Orderable Item
  2. Under Non-Medication and Immunizations, expand Clinical Findings Find and highlight Vitals
    File:Jdb 23.JPG
  3. Click 'Search' at the bottom of the screen to show/hide the search bar
  4. Search for the needed item before creating a new item. (use 'Name' 'Contains')
  5. Click Add. A new row will appear within the grid
  6. Enter 'Code', 'Name', 'Mnemonic' and 'Display Name'
    • The Code is the database key and must be unique within the OID
    • If the item is orderable, make the 'Code', 'Name', 'Mnemonic' and 'Display Name' the same as the Resultable item in the RID
    • Always make 'Code' and 'Mnemonic' the same
    • The code and mnemonic are limited to 10 characters and no spaces between characters
    • Always use the organization mnemonic as the prefix. This will make it easy to tell which items were created for the organization. For example a new vital sign of waist circumference added by New World Health could be given the code and mnemonic 'NWH_WstCir'
    • Make 'Name' and 'Display Name' the same
  7. Indicate if the vital signs Orderable Item is orderable by placing a checkmark in the box (please give example of each)
    • Do not check the “Complex” Order Indicator
  8. Select appropriate setting from the Orderable Via drop down list:
    • User Only – orderable in TouchWorks only (more explaination here?)
    • Interface Only – orderable through Order Interface only (more explaination here?)
    • User or Interface - orderable in TouchWorks and/or through Orders Interface
  9. Select appropriate orderable item mode (OID Mode):
    • Draft
    • Active
    • No longer used
  10. The 'Order Type' will automatically default to Clinical Findings
  11. Click Save.
  12. IF the new item is orderable, continue with the following steps. (Are all vital signs orderable?)
  13. Click on the Results collapsible detail pane
  14. Click blue RID Selector link
  15. Search for the Resultable item to link to the orderable item (use 'Entry Name' 'Contains') If the matching Resultable Item does not exist, you may need to go to the resultable item dictionary, create a new Resultable Item, and then return here to link it)
  16. Click the binoculars to search. The results will display within the grid.
  17. Select the desired orderable item
  18. Click the down arrow
  19. Click 'OK'

Create Vital Signs Panels(Views)

  1. TWAdmin > Dictionaries > Dictionary: Orderable Item
  2. Under Non-Medication and Immunizations, expand Clinical Findings Find and highlight Vitals
  3. Click 'Search' at the bottom of the screen to show/hide the search bar
  4. Search for the needed Panel before creating a new Panel. (use 'Name' 'Contains')
  5. Click Add. A new row will appear within the grid
  6. Enter 'Code', 'Name', 'Mnemonic' and 'Display Name'
    • The Code is the database key and must be unique within the OID
    • If the Panel is orderable, make the 'Code', 'Name', 'Mnemonic' and 'Display Name' the same as the Resultable item in the RID
    • Always make 'Code' and 'Mnemonic' the same
    • The code and mnemonic are limited to 10 characters and no spaces between characters
    • Always use the organization mnemonic as the prefix. This will make it easy to tell which Panels were created for the organization. For example if New World Health wants to create a Panel for Adult Male but still retain the Allscripts Adult Male Panel the code and mnemonic 'NWH_AdultM' could be used.
    • Make 'Name' and 'Display Name' the same
  1. Indicate that the vital signs Panel is orderable by placing a checkmark in the box (All vital signs panels are orderable?)
  2. Check the “Complex” Order Indicator
  3. Select appropriate setting from the Orderable Via drop down list:
    • User Only – orderable in TouchWorks only (more explaination here?)
    • Interface Only – orderable through Order Interface only (more explaination here?)
    • User or Interface - orderable in TouchWorks and/or through Orders Interface
  4. Select appropriate orderable item mode (OID Mode):
    • Draft
    • Active
    • No longer used
  5. The 'Order Type' will automatically default to Clinical Findings
  6. Click Save.
  7. Once saved, a new detail pane will appear known as Child Orders (you may need to scroll down in the bottom/detail pane), where an administrator can define the orderable items to be included in the vitals panel.
    Jdb 25.JPG
  8. Click OID Selector link. The Link Child Orders Item(s)… dialog box will display.
    Jdb 26.JPG
  9. Find an orderable item via entry name, code, or mnemonic.
  10. Click the binoculars to search. The results will display within the grid.
  11. Select the desired orderable item
  12. Click the down arrow
  13. Repeat steps add additional orderable items
  14. Once complete, click OK
    Jdb 27.JPG

Vital Signs Picklist

  • A picklist is a subset of entries that an administrator could create to make vitals selection more efficient
  • Organizations can create Vital Sign picklists that can be assigned to TouchWorks users
  • The Vitals Picklist would control what a user would have access to within TouchWorks Version 11
  • A Vitals picklist could include the custom vitals panels that are important for a given specialty or practice

Creating a Vital Signs Picklist

  1. Within TW Admin – TW Setup – Dictionaries – Orderable Item
  2. Click Picklist. The Orderable Item Picklist dialog box will display.
  3. Click Add Picklist
  4. Enter a Picklist Name
  5. Click OK
    Jdb 28.JPG
  6. Select the New Vitals Picklist in the left pane
  7. Click Add Entry. The Add Entries dialog box will display.
  8. Find the desired vital signs orderable item via name, code, or mnemonic
  9. Click the binoculars to search. The results will display within the Item Available pane on the left.
  10. Select the desired orderable item
  11. Click Add. The orderable item will be added to the Items Selected pane on the right.
  12. Repeat steps 8-11 to add additional entries.
  13. Once complete, click OK.
    File:Jdb 29.JPG
    Note: To add your newly created Orderable Item to global selection options (located next to heart on Clinical Toolbar), please also add your item to TW Vitals
    File:Jdb 30.JPG

Setting System Preferences

  • Customers can associate a Vitals Picklist by setting a Results preference at the enterprise, organization, or user level
  • In addition, they can set default vital signs views based on the age and gender of a patient

Special Cases:

  • Located in Preferences (TW Admin) >> Results there are 4 default vitals that can be set given a patient's criteria. Please adjust as needed, using the EXACT TEXT match of your Vitals Picklist.
    File:Jdb 31.JPG
  • Also located in Preferences (TW Admin) >> Results there is a Preference labeled Vitals Picklist this is the master control for the picklist locate next to the heart icon on the Clinical Toolbar.
    File:Jdb 32.JPG

Adding Custom Vitals Components

  1. Create new Resultable Item in TW Admin >> Dictionaries
  2. Create new Vitals Orderable Item in TW Admin >> Dictionaries (as described above). Specify this Vital as Orderable, but not Complex and Save.
    File:Jdb 33.JPG
  3. Upon Save, your new Orderable Item will be highlighted and you will be given the opportunity to add your Resultable Item (created in step 1) below by clicking on the RID Selector link and using the Search utility to find your Resultable, and move it to the bottom (using the arrows) and hit OK.
    File:Jdb 34.JPG
  4. Select Phys Admin Workplace and select Flowsheets >> Vitals.
    File:Jdb 35.JPG
  5. Click Add Item, and using the Search utility find the name of the New Vitals Orderable Item and using the arrows move the your Vital to the Selectable Orderable Items column (on the right) and click OK.
    File:Jdb 37.JPG

Making the Date and Time editable

With certain workflows you may find it necessary to quickly jot down the vitals and return later to TouchWorks to enter that information. In order to change the date and or time to match when the vitals were taken, make the following changes to the desired vitals panel.

  1. Log into the TWAdmin workspace
  2. On the vertical toolbar, click Dictionaries
  3. Select Orderable Item from the Dictionary drop down list
  4. Under Non-Medication and Immunizations, expand Clinical Findings
  5. Find and highlight Vitals
  6. Select the desired Vitals panel to edit and on the details screen scroll down to Performing

Performing.jpg

By setting the Overdue Interval (I set mine to "10" following the example of a vitals panel provided by Allscripts) this allows the user to enter the correct date/time for when the vitals were taken.

Result details.jpg