AdminCenter12.1

Page tree

Page Description

The Inbound Queue administration page contains all patient records and test order results that were received from other hosts. Use this page as a diagnostic tool to monitor and manage inbound messages. These functions include viewing or editing HL7 message details and interface settings, as well as re-sending messages.

You may configure how many days the system will hold messages in the inbound queue in the System Defaults administration page. See the System Defaults topic. The system will process messages in the queue based on the setting to delay processing located on the Interface Configuration page for hosts. See the Interface Configuration topic.

The data displayed on this page depends on the column view settings for your facility. The system uses the column view settings to control what columns appear in the tables on this page and the order in which it sorts the displayed information. You may set column view rules at the location or the system default levels. The rules for the signed-in location, if available, supersede the system default column view rules.

Accessing this Page

  • Select the Administration menu button, select the Monitor button, and then select the Inbound Queue submenu link. You must have the necessary security permissions to access the Administration menu button. When you select the Administration menu button, the system opens the main Administration menu, which contains administrative menu buttons, including the Monitor menu. To return to the main menu for the system, select the Tasks menu button.

Setting the List Criteria

  1. The page contains a list of up to 10 inbound messages. The system displays the message name, status, receipt date and time, the interface the message was received from, number of attempts made, and the date and time of the last delivery attempt. If the list is longer than one page, use the Page links, located below the list of messages, to navigate through the list.
  2. Select a message type from the Message Type drop-down list to view messages of the selected type (HL7, Inbox Document, JSON Data, Linked Document, or Web Service File). If you select HL7, the system also displays the Message Types checkboxes so you may narrow the list of messages to one or more types of messages (see below).
  3. Select a host from the Interface drop-down list to view messages received from that particular host. The system defaults to the All option. This option displays the messages from all hosts.
  4. Select the Show inactive hosts option to display inactive hosts at the bottom of the Interface drop-down list. The system lists all inactive hosts with "(inactive)" added to the name of the host.
  5. Select a Display messages option to further narrow the displayed message list, if desired. This makes it easier to find and delete messages for inactive hosts, when necessary.
    • All: Select this option to view all messages. 
    • In progress: Select this option to view pending messages.
    • Successfully stored: Select this option to view messages that were successfully stored. The system selects this option by default.
    • Cancelled: Select this option to view messages that have been cancelled.
  6. If you selected HL7 for the Message Type field (see above), then the system displays the Message Types options and checkboxes so you may narrow the list of messages to one or more types of messages. By default, the system selects the Message Types option and searches for all types of messages. Clear the checkbox next to each message type you wish to exclude from the list. If you clear all message types checkboxes, the system will only display messages with a blank message type. To clear all of the message type checkboxes at once, select the Message Types option. To search all types, select the All option. If embedded document content is detected in the HL7 message, the Embedded Documents button will appear. Select the button to view or download the content of the embedded document.
  7. Select either Last Attempt or Received from the drop-down list in order to specify what the date range is filtering on.
  8. To view messages for a specific date and/or time range, enter the Start and End dates and times in the format MM/DD/YYYY, HH:MM AM/PM. By default, the Start fields contain the current day and a time range that begins at midnight, and the End fields are blank. If you do not specify an end time, the system automatically enters 11:59pm. Select a date from the calendar view by selecting the calendar icon located next to the Start and End fields.
  9. Select Now next to the time and date fields to update the Start or End dates to the current date and time, if desired.
  10. To remove the date/time range restriction, select Clear, which automatically clears the fields. If you clear one or both of the date/time range fields, the system will not apply the date/time start or end point when finding messages.
  11. Enter one or more characters in one or more of the search fields to have the system only display messages that contain the specified text in inbound messages. You may specify text for Patient Name, Sample ID, Location, or Patient MRN. This allows you to search for messages related to specific patients, sample IDs, locations, or patient MRNs. Each time you refresh the page (e.g., change a drop-down list, select Refresh, select Resend, etc.), the system applies this text filter. Next to the Patient Name field, you can further filter the search by selecting Starts with to search using the first letters of the patient name or Contains to search using any part of the patient name.
  12. Select the Automatically Refresh every ___ seconds checkbox to have the system automatically refresh the Inbound Queue. Enter a value into the available field to specify the number of seconds in which the queue should refresh. The default value is five seconds.
  13. Select Refresh, or press the Enter key, to update the list on the page, if it did not automatically update.
  14. Once you have narrowed the list to the desired messages, you may view or edit the HL7 message details. See "Managing Inbound Messages" below.

Managing Inbound Messages

  1. Once you have refreshed your list, the system updates the list. See "Setting the List Criteria" above.
  2. When you open this page, the system displays an arrow next to the first message in the list. After you have viewed or edited the message (see below), the system displays the arrow next to the message you just opened.

  3. The Details column contains the message title and forwarding information, if available. Select the link in the Details column to view or edit HL7 message details in the Message Details page. See the Message Details topic. After you have viewed the details for the message, select Save or Cancel to return to the page of messages you were viewing.

    Note

    Titles for forwarded messages contain a message stating that they were forwarded and not parsed.

  4. View the status of the message in the Status column.
    • In Progress: The message is in the queue, ready to be processed.
    • Complete: The message was received and stored successfully.
  5. The Message Types option displays which type of HL7 message was parsed in the format: Message Type (Message Trigger Event Abbreviation). The system displays the text "Forwarded" instead of the trigger type for forwarded messages. Select All to include all message types. The message types and their descriptions are listed below. 
    • ACK: Message acknowledgements (exchanged but usually not shown in queues)
    • ADT: Demographic messages
    • ADT(CR): Demographic creation
    • ADT(MA): Patient encounter move (changes patient encounter information)
    • ADT(ME): Patient merge
    • ADT(NF): Patient not found (reply to a host)
    • ADT(PA): Patient arrival
    • ADT(QRY): Patient query
    • ADT(TR): Patient transfer
    • ADT(UP): Demographic update
    • DFT: Billing messages
    • MFN: Master file notification — updates to users or locations
    • ORM: Order messages
    • ORM(CA): Order cancellation
    • ORM(CSA): Order accessioning status change
    • ORM(CSC): Other order status change
    • ORM(NA): Order number assignment — usually for sending an identifying number back to a host for an order choice added by ORM(SN)
    • ORM(OR): Order release
    • ORM(SN): Send number request — usually used to add order choices to an existing order
    • ORM(XO): Change order — changes in patient address, provider, collection date, etc.
    • ORU: Result messages
    • QRY: Query messages (non-demographic)
    • SSU: Specimen status update
    • ZSH: Automation line messages
  6. View the following message details in the columns listed below.
    • Received: The date and time the message was received.
    • Interface: The host that sent the message.
    • Attempts: The number of attempts made to receive the message.
    • Last Attempt: (In Progress or Failed statuses only) The date and time the host system last tried to send the message to the system.
  7. To rerun one or more messages, select the checkbox in the Select column for each message you wish to send, and then select Rerun. Select the Select column label to select or deselect all of the messages on the current page.
  8. To delete one or more messages, select the checkbox in the Select column for each message you wish to delete, and then select Delete. To delete all displayed messages, select Delete without making any selections. Select the Select column label to select or deselect all of the messages on the current page.