HL7 Outbound messages
Note - These testing guidelines assume the user is skilled in the use of, at a minimum, the following:
- Admission
- Delete Last Movement
- HL7 Connection Monitor
- Registry Settings (PM)
- Dictionary Update (CWS)
- Order Code Setup
- Orders This Episode
Scenario 1: Admitting a client into a pre-admit program, upgrading to an inpatient program and delete last movement
Specific Setup:
- A generic ADT Outbound connection must exist. (ADT-TEST)
- An ADT-RXCONNECT Outbound connection must exist.
- An ADT Outbound connection must exist with a 'Connection Profile' of MATRIXCARE. This can be done via an Avatar HL7 Customization Pack that can be requested via your Netsmart Representative. (ADT-MATRIXCARE)
- The ‘Avatar PM->Client Management->Movement Options->->->Allow Admission To File/Edit Pre-Admits’ registry setting must be set to "Y".
- The 'Avatar PM->System Maintenance->Client Maintenance->->->Revert To Pre-Admit When Deleting Admission Movement’ registry setting must be set to "Y".
- Please log out of the application and log back in after completing the above configuration.
Steps
- Access the 'Admission' form.
- Enter a 'Last Name', 'First Name', select a 'Sex', enter a 'Social Security #' and a 'Date of Birth' and click [Search] and [New Client].
- Validate an 'Auto Assign ID Number' message is displayed and click [Yes].
- Set the 'Preadmit/Admission Date' of "01/01/2024", a 'Preadmit/Admit Time' of "09:00 AM", populate the 'Demographics' information, and populate all remaining required fields and click [Submit].
- Access the 'HL7 Connection Monitor' form.
- Select the "ADT-RXCONNECT" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A05' event that contains a 'PID-3'segment which is the PATID with leading zero's and a 'PV1-44' segment of "202401010900".
- Select the "ADT-TEST" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A05' event that contains 'PID-3' segment which is the PATID with leading zero's and a 'PV1-44' segment of "202401010900".
- Validate there is no new message for "ADT-MATRIXCARE".
- Close the form.
- Access the 'Admission' form for the client selected.
- Select the existing row in the pre-display and click [Edit].
- Change the 'Preadmit/Admission Date' to "02/10/2024", a 'Preadmit/Admit Time' to "01:00 PM".
- Change the 'Program' field to an Inpatient program.
- Populate all required fields.
- Click the 'Inpatient/Partial/Day Treatment' section and populate all required fields and click [Submit].
- Access the 'HL7 Connection Monitor' form.
- Select the "ADT-RXCONNECT" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A08' event that contains a 'PID-3' segment which is the PATID with leading zero's and a 'PV1-44' segment of "202402101300".
- Select the "ADT-TEST" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A08' event that contains a 'PID-3' segment which is the PATID with leading zero's and a 'PV1-44' segment of "202402101300".
- Select the "ADT-MATRIXCARE" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A01' event with an 'MSH-4' segment of "98", a 'PID-3' segment of the PATID with no leading zeros, and a 'PV1-44' segment that contains "202402101300".
- Close the form.
- Access the 'Delete Last Movement' form.
- Validate a message is displayed stating "Deletion of any movement will remove the client from any bed they may be in. If a client needs to be in a bed, it needs to be entered via Unit/Room/Bed Assignment." and click [OK].
- Select "Episode #1" in the 'Episode Number' field.
- Validate the 'Client Information' field contains the information for the admission program and click [Submit].
- Validate a message is displayed stating " You are about to delete an Admission movement for episode 1. Deleting this movement will revert the episode to the Pre-Admit status. Do you want to continue?" and click [Yes].
- Access the 'HL7 Connection Monitor' form.
- Select the "ADT-RXCONNECT" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A08' event that contains a 'PID-3' segment which is the PATID with leading zero's and a 'PV1-44' segment of "202401010900".
- Select the "ADT-TEST" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A08' event that contains a 'PID-3' segment which is the PATID with leading zero's and a 'PV1-44' segment of "202401010900".
- Select the "ADT-MATRIXCARE" Outbound connection in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'A11' event with a 'PID-3' segment of the PATID with no leading zeros, and a 'PV1-44' segment that contains "202402101300".
- Close the form.
Scenario 2: Dietary-Oral Orders with validation in HL7 Connection Monitor
Specific Setup:
- The following values must exist in the Order Entry Client Information '(20982) Diet Restrictions' dictionary with the following configuration:
- Liquid Only
- '(20998) Diet Consistency Type' set to "Liquid Consistency"
- High Protein
- '(20998) Diet Consistency Type' not defined.
- The following values must exist in the Order Entry Client Profile '(20977) Meal Periods' dictionary:
- Breakfast
- Lunch
- Dinner
- The Order Entry Client Information '(20974) Diet Supplements' dictionary must contain at least one value.
- Please log out of the application and log back in after completing the above configuration.
- A generic Orders Outbound connection must exist. (ORDERS-TEST)
- An Orders Outbound connection must exist with a 'Connection Profile' of MATRIXCARE. This can be done via an Avatar HL7 Customization Pack that can be requested via your Netsmart Representative. (ORDERS-MATRIXCARE)
- A dietary-oral type order code must exist. (Order Code A)
- A client must have an active Inpatient episode. (Client A)
Steps
- Select "Client A" and access the Order Entry Console.
- Search for and select "Order Code A" in the 'New Order' field.
- Click [Additional Order Details].
- Validate the 'Additional Order Details - Diet Orders - Oral' dialog is displayed.
- Select "High Protein" and "Liquid Only" in the 'Diet Restrictions' field.
- Click [New Row].
- Select any value in the 'Diet Supplement' field and click [Select].
- Set the 'Portion Size' field to any value and click [OK].
- Select all values in the 'Days of the Week' field and click [OK].
- Select "Breakfast", "Lunch", and "Dinner" in the 'Meal Periods' field and click [OK].
- Select any value in the 'Routine or PRN' field and click [Select] and [Save].
- Select any value in the 'Frequency' field.
- Set the 'Duration' field to any value and click [Days].
- Click [Add to Scratchpad] and [Sign].
- Validate the 'Order grid' contains an order for "Order Code A".
- Access the 'HL7 Connection Monitor' form.
- Select "ORDERS-TEST" in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'ORM-001' event that includes the following:
- A 'PID-3' segment, which contains the PATID, with leading zeros.
- 2 'ODS' segments with a "D" in the 'ODS-2' segment, one for "Liquid Only" and one for "High Protein".
- 3 'ODS' segments with an "S" in the 'ODS-2' segment which includes the Meal periods selected and the dietary supplements.
- Select "ORDERS-MATRIXCARE" in the 'Select Row' field.
- Validate the 'Last Message Processed' field contains an 'ORM-001' event that includes the following:
- A 'PID-3' segment, which is the PATID, with no leading zeros.
- An ODS segments with "D" in the 'ODS-2' segment for the order code.
- An ODS segment with "LC" in the 'ODS-2' segment for "Liquid Consistency" selected in the 'Diet Consistency Type' extended attribute off of 'Diet Restrictions', and no supplements are displayed.
|
Topics
• HL7
• HL7 Connection Monitor
|
