Skip to main content

Avatar OE 2023 Update 11

  1. Last updated
  2. Save as PDF

Product Requirements / Recommendations

Avatar CWS required
Avatar OE required
RADplus required

Recommended Update Level

Avatar OE 2022 Update 87

Product Update Form Description

The following issues are resolved:  1) When attempting to create or update an order in a system running a version of Cache prior to Cache 2011 could generate a "[METHOD DOES NOT EXIST]ValidateObject+4^OrderEntry.histclientorder.2" error.  2) Orders that use a 'Route of Administration' that is defined with a 'Preferred Description' no longer display the 'Preferred Description' in the Avatar eMAR 'Order Description' once pharmacy fill details are received and are used to display the eMAR 'Order Description'.  NOTE:  The change included in this Update will affect only those orders for which pharmacy fill details are received by Avatar from RxConnect subsequent to the installation of this Update. 3) In the Order Entry Console (Orders This Episode section), the error "Avatar Order Entry Console has encountered the following error: GetDongleId+26^GUIDongleAPI" might be presented when attempting to Validate orders. Note that this error occurs only when using myAvatar NX and only when the 'Two-Factor Authentication Method' registry setting is set to "iButton", and when the 'Two-Factor Authentication Process Points' registry setting includes "3" (Avatar OE for filing pharmacy/medication orders).

Included Updates

8

Required Updates

None

Details
NEW0 CHANGED0 FIXED3
Fixed (3)
Order Entry Console - Preferred Description for Route of Administration
An issue is resolved to ensure that when orders use a 'Route of Administration' that is defined with a 'Preferred Description', the 'Preferred Description' is still displayed in the Avatar eMAR 'Order Description' after pharmacy fill details are received. 
NOTE:  The change included in this Update will affect only those orders for which pharmacy fill details are received by Avatar from RxConnect subsequent to the installation of this Update.
Topics
• NX • RxConnect
 
Order Entry Console - Pre-Admit - Give Initial Dose Now
An issue is resolved to ensure that while in a pre-admit episode, orders placed with a One Time Only frequency that has Give Initial Dose Now selected, are not being filed with the current date and time as its Start Date and Start Time.
Topics
• NX • Order Entry Console
 
Order Entry Console - Order Validation - iButton
An issue is resolved to ensure that in the Order Entry Console (Orders This Episode section), the error "Avatar Order Entry Console has encountered the following error: GetDongleId+26^GUIDongleAPI" is no longer presented when attempting to Validate orders.
Note: This error occurs only when using myAvatar NX and only when the 'Two-Factor Authentication Method' registry setting is set to "iButton", and when the 'Two-Factor Authentication Process Points' registry setting includes "3" (Avatar OE for filing pharmacy/medication orders).
Topics
• NX • Order Entry Console
 
Acceptance Tests
AV-87246 Summary | Details
Order Entry Console - Preferred Description for Route of Administration
Note - These testing guidelines assume the user is skilled in the use of, at a minimum, the following:
  • App Dashboard
  • Dictionary Update (CWS)
  • Dynamic Form - Dictionary Update - Locked Dictionary
  • eMAR
  • eMAR - Order Details
  • Launch RxConnect
  • Orders This Episode
  • Rx Summary
  • Rx Summary.Order Details
  • Rx Summary.Pending
  • Rx Summary.Pending.Schedule
  • RxConnect
Scenario 1: eMAR NX - Validate Preferred Description for Route of Administration is Respected with Fill Details
Specific Setup:
  • The ‘(10182) Preferred Description’ extended attribute must be set to “SUB-Q” in the Order Entry Tabled Files ‘(10181) Route of Administration’ dictionary for “SUBCUTANEOUS”.
  • The registry setting 'Avatar eMAR->General->Settings->->->Use Pharmacy Fill Details For Order Description' must be set to "Y".
  • Avatar must be configured to communicate with RxConnect via Avatar HL7.
  • Please log out of the application and log back in after completing the above configuration.
  • A pharmacy type order code with a subcutaneous route of administration must exist. (Order Code A)
  • A pharmacy type order code with an oral route of administration must exist. (Order Code B)
  • A client must have an active episode. (Client A)
  • “Client A” must have a ‘Date of Birth’, ‘Sex’ and address on file in the ‘Update Client Data’ form, as well as information filed in the ‘Allergies and Hypersensitivities’ form, ‘Diagnosis’ form, and in the ‘Height’ and ‘Weight’ fields in the ‘Vitals Entry’ form.
Steps
  1. Select "Client A" and access the Order Entry Console.
  2. Search for and select "Order Code A" in the 'New Order' field.
  3. Validate the 'Route' field is equal to "SUB-Q".
  4. Fill out any remaining required fields and click [Add to Scratchpad] and [Sign].
  5. Validate "SUB-Q" is displayed in the order details.
  6. Search for and select "Order Code B" in the 'New Order' field.
  7. Validate the 'Route' field is equal to "ORAL".
  8. Fill out any remaining required fields and click [Add to Scratchpad] and [Sign].
  9. Validate "ORAL" is displayed in the order details.
  10. Access the 'eMAR' widget.
  11. Validate that an order for "Order Code A" is displayed.
  12. Validate "SUB-Q" is displayed in the order details.
  13. Validate that an order for "Order Code B" is displayed.
  14. Validate "ORAL" is displayed in the order details.
  15. Process the orders for "Order Code A" and "Order Code B" via RxConnect.
  16. Access the 'eMAR' widget.
  17. Validate that an order for "Order Code A" is displayed.
  18. Validate "SUB-Q" is displayed in the order details.
  19. Validate that an order for "Order Code B" is displayed.
  20. Validate "ORAL" is displayed in the order details.
Topics
• NX • RxConnect
AV-88699 Summary | Details
Order Entry Console - Pre-Admit - Give Initial Dose Now
Note - These testing guidelines assume the user is skilled in the use of, at a minimum, the following:
  • Dictionary Update (CWS)
  • Frequency Code Setup
  • Orders This Episode
  • Registry Settings (PM)
Scenario 1: OE NX - Pre-Admit - Order Group - One Time Only Frequency - Custom Administration Time
Specific Setup:
  • The 'Avatar Order Entry->Facility Defaults->Client Profile->->->Allow New Orders For Pre-Admit Episodes' registry setting must be set to "Y".
  • The application must not have pharmacies configured in the 'External Pharmacy Setup' form.
  • The '"Avatar Order Entry->Facility Defaults->Client Profile->->->Defer Activation of Orders in a Pre-Admit Episode" must be set to "Y".
  • The ‘(524) Require Hours of Administration for Routine Orders’ extended attribute must be set to “Hours of Administration are required not for Routine Orders” in the Order Entry Tabled Files ‘(500) Order Types’ dictionary for “Pharmacy”.
  • Please log out of the application and log back in after completing the above configuration.
  • A frequency code must be configured in the 'Frequency Code Setup' form with the following attributes: (Frequency Code A)
  • 'Routine or PRN(As Needed) = "Routine"
  • 'One Time Only' = "Yes"
  • 'Times/24 Hours' = "1"
  • 'Interval Frequency' = "No"
  • 'Daily Administration' = "Daily"
  • 'Default to Give Initial Dose Now' = "Yes"
  • A frequency code must be configured in the 'Frequency Code Setup' form with the following attributes: (Frequency Code B)
  • 'Routine or PRN(As Needed) = "Routine"
  • 'One Time Only' = "Yes"
  • 'Times/24 Hours' = "1"
  • 'Interval Frequency' = "No"
  • 'Daily Administration' = "Daily"
  • 'Default to Give Initial Dose Now' = "No"
  • 'Hours of Administration' = "08:00 AM"
  • Two Pharmacy-type order codes must exist. (Order Code A) (Order Code B)
  • An order group (Order Group A) must be created with at least two pharmacy-type order codes where:
  • "Order Code A" has a default frequency of "Frequency Code A".
  • "Order Code B" has a default frequency of "Frequency Code B".
  • A client must have an active pre-admit episode. (Client A)
  • “Client A” must have a ‘Date of Birth’, ‘Sex’ and address on file in the ‘Update Client Data’ form, as well as information filed in the ‘Allergies and Hypersensitivities’ form, ‘Diagnosis’ form, and in the ‘Height’ and ‘Weight’ fields in the ‘Vitals Entry’ form.
Steps
  1. Select "Client A" and access the Order Entry Console.
  2. Search for and select "Order Group A" in the 'New Order' field.
  3. Validate the 'Order Group' dialog is displayed.
  4. Click [Select All].
  5. Validate the 'Frequency' fields are defaulted from the 'Order Group Setup' form.
  6. Validate that the 'First Dose Date/Time' fields are hidden.
  7. Validate that the 'Stop Date/Time' fields are hidden.
  8. Validate that the 'Custom' button is visible for both "Order Code A" and "Order Code B".
  9. Click the 'Custom' button for "Order Code A".
  10. Set the 'Scheduled Administration Times;' field to "12:00 PM" and click [Save].
  11. Validate a 'Warning!' dialog appears stating "'Hours of Administration' and 'Give Initial Dose Now' cannot both be specified for an order created in "Pre-Admit mode". 'Give Initial Dose Now' will be cleared." and click [OK].
  12. Click the 'Custom' button for "Order Code B".
  13. Set the 'Scheduled Administration Times;' field to "12:00 AM" and click [Save].
  14. Click [Add to Scratchpad].
  15. Validate the 'Start Date' fields in the scratchpad for both "Order Code A" and "Order Code B" contain "01/01/2099".
  16. Select "Order Code A" from the 'Scratchpad'.
  17. Validate the 'Give Initial Dose Now - Yes' button is enabled and not pressed.
  18. Click [Custom], validate the 'Scheduled Administration Times:' field contains "12:00 PM" and click [Cancel].
  19. Click [Give Initial Dose Now - Yes].
  20. Validate a 'Warning!' dialog appears stating "'Hours of Administration' and 'Give Initial Dose Now' cannot both be specified for an order created in "Pre-Admit mode". 'Hours of Administration' will be cleared." and click [OK].
  21. Click [Custom], validate the 'Scheduled Administration Times' field contains no values and click [Cancel].
  22. Set the 'Duration' field to "1" and click [Days].
  23. Click [Update Order] and, in the 'Scratchpad', validate the 'Stop Date' field for "Order Code A" is "01/01/2099".
  24. Select "Order Code B" from the 'Scratchpad'.
  25. Click [Custom], validate the 'Scheduled Administration Times' field contains "12:00 AM" and click [Cancel].
  26. Set the 'Duration' field to "2" and click [Days].
  27. Click [Update Order] and, in the 'Scratchpad', validate the 'Stop Date' field for "Order Code B" is "01/02/2099".
  28. Click [Sign].
Scenario 2: OE NX - Pre-Admit - One Time Only with Default Give Initial Dose Now - Field Validation
Specific Setup:
  • The 'Avatar Order Entry->Facility Defaults->Client Profile->->->Allow New Orders For Pre-Admit Episodes' registry setting must be set to "Y".
  • The application must not have pharmacies configured in the 'External Pharmacy Setup' form.
  • The '"Avatar Order Entry->Facility Defaults->Client Profile->->->Defer Activation of Orders in a Pre-Admit Episode" must be set to "Y".
  • The ‘(524) Require Hours of Administration for Routine Orders’ extended attribute must be set to “Hours of Administration are required for Routine Orders” in the Order Entry Tabled Files ‘(500) Order Types’ dictionary for “Pharmacy”.
  • Please log out of the application and log back in after completing the above configuration.
  • A frequency code must be configured in the 'Frequency Code Setup' form with the following attributes: (Frequency Code A)
  • 'Routine or PRN(As Needed) = "Routine"
  • 'One Time Only' = "Yes"
  • 'Times/24 Hours' = "1"
  • 'Interval Frequency' = "No"
  • 'Daily Administration' = "Daily"
  • 'Default to Give Initial Dose Now' = "Yes"
  • A Pharmacy-type order code must exist. (Order Code A)
  • A client must have an active pre-admit episode. (Client A)
  • “Client A” must have a ‘Date of Birth’, ‘Sex’ and address on file in the ‘Update Client Data’ form, as well as information filed in the ‘Allergies and Hypersensitivities’ form, ‘Diagnosis’ form, and in the ‘Height’ and ‘Weight’ fields in the ‘Vitals Entry’ form.
Steps
  1. Select "Client A" and access the Order Entry Console.
  2. Search for and select "Order Code A" in the 'New Order' field.
  3. Set the 'Dose' field to "1" and select "Capsule" from the 'Dose Unit' field.
  4. Validate the "Start Date/Time' fields are hidden.
  5. Validate the 'Stop Date/Time' fields are hidden.
  6. Validate the 'First Dose Date/Time' fields are hidden.
  7. Validate that 'Give Initial Dose Now' [Yes] is disabled.
  8. Validate the 'Custom' button is not hidden.
  9. Search for and select "Frequency Code A" from the 'Freq:' field.
  10. Validate that 'Give Initial Dose Now' [Yes] is pressed.
  11. Validate that 'Give Initial Dose Now' [Yes] is enabled.
  12. Validate that 'Skip 1st Dose' [Yes] is disabled.
  13. Validate that [Custom] is not hidden.
  14. Click [Custom].
  15. Set the 1st 'Scheduled Administration Times' field to "1200" and click [Save].
  16. Validate a warning message is displayed stating: "Hours of Administration' and 'Give Initial Dose Now' cannot both be specified for an order created in "Pre-Admit mode". 'Give Initial Dose Now' will be cleared."
  17. Click [OK] and validate that 'Give Initial Dose Now' [Yes] is not pressed.
  18. Click 'Give Initial Dose Now' [Yes].
  19. Validate a warning message is displayed stating: 'Hours of Administration' and 'Give Initial Dose Now' cannot both be specified for an order created in "Pre-Admit mode". 'Hours of Administration' will be cleared."
  20. Click [OK].
  21. Click [Custom], validate there are no values listed under 'Scheduled Administration Times' and click [Cancel].
  22. Set the 'Duration' field to "1" and click [Days].
  23. Click [Add to Scratchpad].
  24. Validate the 'Start Date' field contains "01/01/2099".
  25. Validate the 'Stop Date' field contains "01/01/2099".
  26. Select "Order Code A" from the scratchpad.
  27. Validate that 'Give Initial Dose Now' [Yes] is pressed.
  28. Validate that 'Give Initial Dose Now' [Yes] is enabled.
  29. Click [Cancel] and then [Sign].
Topics
• NX • Order Entry Console
AV-89612 Summary | Details
Order Entry Console - Order Validation - iButton
Scenario 1: OE NX - Orders This Episode - New Order (by Nurse who requires validation), Validation by Prescriber
Specific Setup:
  • The 'RADplus->General->->->->Default Value for Console View Episodes' registry setting must be set to "1". NOTE: This is a Netsmart Staff only registry setting. Please contact your Netsmart representative to have this setting configured.
  • Please log out of the application and log back in after completing the above configuration.
  • Two users must exist in the application: One whose actions require validation (User A) and One whose actions do not require Validation (User B).
  • A client must have an active episode whose program or unit are configured in the 'External Pharmacy Setup' form. (Client A)
  • “Client A” must have a ‘Date of Birth’, ‘Sex’ and address on file in the ‘Update Client Data’ form, as well as information filed in the ‘Allergies and Hypersensitivities’ form, ‘Diagnosis’ form, and in the ‘Height’ and ‘Weight’ fields in the ‘Vitals Entry’ form.
  • "User A" must be logged into the application.
Steps
  1. Select "Client A”.
  2. Validate the 'Header Episode' field contains "All Episodes".
  3. Select the most current episode from the 'Header Episode' field.
  4. Access the Order Entry Console and click 'Orders This Episode' tab.
  5. Make note of the number next to the "V" icon.
  6. Search for and select "Ritalin 5 MG Tablet Oral (Schedule II)" from the ‘New Order’ field.
  7. Populate all required fields and click [Add to Scratchpad].
  8. Search for and select the staff member associated with "User B" in the ‘Ordering Practitioner' field.
  9. Click [Sign].
  10. Validate the ‘Interactions' dialog is displayed.
  11. Override all interactions and click [Save Override and Exit].
  12. Validate the 'Final Review' dialog is displayed.
  13. Select "None" in 'Output' and click [Sign].
  14. Validate the ‘Order grid’ contains an order for "Ritalin” with an 'Order Status' of "Requires Validation".
  15. Log out of the application and log back in as "User B".
  16. Select "Client A”.
  17. Validate the 'Header Episode' field contains "All Episodes".
  18. Select the most recent active episode from the 'Header Episode' field.
  19. Access the Order Entry Console and click 'Orders This Episode' tab.
  20. Validate the number next to the "V" icon has increased by 1.
  21. Select the “Ritalin” order in the ‘Order grid’ and click [Validate].
  22. Validate the 'Final Review' dialog is displayed.
  23. Select "None" in 'Output' and click [Sign].
  24. Validate the 'Order grid' contains an order for "Ritalin" with a 'Status' of "Active".
  25. Validate the number next to the "V" icon has decreased by 1.
Scenario 2: OE NX - iButton - Orders This Episode
Specific Setup:
  • The 'RADplus->System Security->User Definition->->->Two-Factor Authentication Method' registry setting must be set to "iButton".
  • Please log out of the application and log back in after completing the above configuration.
  • The logged in user must both require validation and must be allowed to validate orders.
  • A client must have an inpatient episode whose program or unit are configured in the ‘External Pharmacy Setup’ form. (Client A)
  • “Client A” must have a ‘Date of Birth’, ‘Sex’ and address on file in the ‘Update Client Data’ form, as well as information filed in the ‘Allergies and Hypersensitivities’ form, ‘Diagnosis’ form, and in the ‘Height’ and ‘Weight’ fields in the ‘Vitals Entry’ form.
Steps
  1. Select "Client A", access the Order Entry Console, and plug in the iButton.
  2. Search for and select "TYLENOL (ACETAMINOPHEN) 325 MG CAPSULE, LIQUID FILLED ORAL" from the 'New Order' field.
  3. Populate all required fields and click [Add to Scratchpad], [Final Review], and [Sign].
  4. Select the "Tylenol" order created from the 'Order grid' and click [Validate].
  5. Validate the "Tylenol" order has been validated.
  6. Search for and select "PREDNISONE 1 MG TABLET ORAL" from the 'New Order' field.
  7. Populate all required fields and click [Add to Scratchpad], [Final Review] and [Sign].
  8. Unplug the iButton.
  9. Select the "Prednisone" order in the 'Order grid' and click [Validate]
  10. Validate a message is displayed stating "Two-Factor Authentication failed. This can happen if the logged-in user is not assigned a Two-Factor Authentication token or if the correct Two-Factor Authentication token is not present. Filing is canceled. Please insert your assigned Two-Factor Authentication token and try again." and click [OK].
Topics
• NX • Order Entry Console

 

  1. Back to top
  • Was this article helpful?

Recommended articles

  1. Page type
    Reference
  2. Tags
    1. content:release
    2. llm-no-index
    3. NX
    4. Order Entry Console
    5. role:sysadmin
    6. RxConnect
    7. search:ready