AdminCenter12.1

Page tree

Page Description

The Outbound Queue page contains all patient orders and records that have been created by ordering or demographics input routines, as well as all patient reports the system delivers. Use this page as a diagnostic tool to monitor and manage these outbound messages. Functions include viewing or editing HL7 message details and interface settings, as well as rerunning messages or reprinting labels.

You may configure how many days the system will hold messages in the outbound queue in the System Defaults administration page. See the System Defaults 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 Outbound 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

When displaying messages, the system deletes from the list the cancelled orders older than the system default time limit setting for holding entries in the outbound queue. If an order fails, is not cancelled, and is older than the system default time limit setting, then the system still holds the message in the queue, even though it is older than the system default time limit setting. See the System Defaults topic.

  1. The Outbound Queue page contains a list of up to 10 outbound messages. If the list is longer than one page, use the Page links, located below the list of messages, to navigate through the list.
  2. Each message contains the order/record status, first created date/time, recipient name, number of attempts made to send the order/record, and the date/time of the last delivery attempt.
  3. Select a message type from the Message Type drop-down list to view messages of the selected type.
    • Device Engine Command: Used to view commands sent to the Orchard Device Engine. When this type is selected, the Device Engine and Instrument search-as-you-type fields appear. Specify the device engine and instrument in these fields.
    • Device Engine Labels: Used to view labels sent to the Orchard Device Engine. When this type is selected, the Device Engine and Instrument Interface search-as-you-type fields appear. Specify the device engine and instrument interface in these fields.
    • Device Engine Order: Used to view orders sent to the Orchard Device Engine. When this type is selected, the Device Engine and Instrument Interface search-as-you-type fields appear. Specify the device engine and instrument interface in these fields.
    • Device Engine Printable Document: Used to view print jobs sent to the Orchard Device Engine. The ODE delivers these print jobs to a print queue that it has access to.
    • Device Engine Transferable File: Used to view files sent to the Orchard Device Engine. The ODE delivers these files to a directory that it has access to.
    • Direct Dial: Used to view outbound direct dial PDFs that are sent from the software to a remote printer.
    • Direct Printing: Used to view outbound directly printed lab reports printed to a network printer located on the same domain and network as the server.
    • Email
    • Fax
    • HL7
    • Harvest Workstation Label Printing: Used to view labels that were printed to a Harvest workstation.
    • Label Printing: Used to view labels that were printed to network label printers.
    • RAPS: Used to view anything sent outbound via RAPS.
  4. Select a host from the Interface drop-down list to view messages sent to that particular host. The system defaults to the All option. This option displays the messages for all hosts.
  5. 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.
  6. Select a Display messages option to further narrow the displayed message list, if desired.
    • All: Select this option to view all messages. 
    • In progress: Select this option to view pending messages.
    • Cancelled: Select this option to view messages that have been cancelled.
    • Failed: Select this option to view messages that were received but could not be successfully stored.
    • Sent: Select this option to view messages that were sent to a host system.
    • Successfully sent: Select this option to view messages that were successfully sent to a host system. The system selects this option by default.
    • No [Fax Number, Email Address, Printer]: This option is only available when you select Email, Fax, RAPS, or Direct Printing as the Message Type. Select this option to view all messages that do not have their recipient address filled in for the type of message being viewed (i.e., no fax number, no email address, or no printer).
  7. If you select Device Engine Command for the Message Type (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.
    • Instrument Interface Update
    • Instrument Command
    • Instrument Interface Restart
    • Result to Send with an Order Command
  8. If you selected Fax for the Message Type (see above) and the system default-level setting to use the Zetafax integrated API functionality is enabled, you may select one or more Server Status checkboxes to further narrow the displayed message list, if desired: Sent, Failed, Adding, Held, Holding, Waiting, Queued, Connecting, Sending, Processing, Aborting, Unknown, and Not Sent With API. 
  9. 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.
  10. Select either First Created or Last Attempt from the drop-down list in order to specify what the date range is filtering on.
  11. 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.
  12. Select Now next to the time and date fields to update the Start or End dates to the current date and time, if desired.
  13. 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.
  14. 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 outbound messages. You may specify text for the Content (Patient Name), Sample ID, Location, MRN, Recipient (location or staff member), Tech ID, or Order ID. This allows you to search for messages related to specific patients, sample IDs, locations, or recipients. Each time you refresh the page (e.g., change a drop-down list, select Refresh, select Resend, select Redirect, etc.), the system applies this text filter. When Label Printing or Harvest Workstation Label Printing is selected from the Message Type drop-down, the Sample ID and MRN fields become unavailable. 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.
  15. Select the Automatically Refresh every ___ seconds checkbox to have the system automatically refresh the Outbound 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.
  16. Select Refresh to update the list in the Details section of the page, if it did not automatically update.
  17. Once you have narrowed the list to the desired messages, you may view or edit the HL7 message details. See "Managing Outbound Messages" below.

Managing Outbound Messages

  1. Once you have refreshed your list, the system updates the list in the Details section. 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. If you select HL7, then 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. The Details column contains a link to access the message for message types. Select the link of the desired message to view or edit HL7 message details, view email messages, or view faxed reports, requisitions, or collection lists in the Outbound Message Detail page. See the Outbound 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.
    • For Device Engine Labels messages, the system displays the Order ID information in the Details column.
    • For email messages, the system displays the email address of the recipient in the Details column.
    • For forwarded messages, the system displays the message ID.
    • If you are viewing the details for a faxed message, the system displays the message in PDF format, and you will not be able to edit the message.
  4. View the status of the message in the Status column.
    • In Progress: The message is in the queue, ready to be delivered.
    • Complete: The message was delivered and stored successfully.
    • Failed: The message was sent but was not received successfully.
    • Cancelled: The message has been cancelled. If a message had a different status prior to being cancelled (e.g., Failed), then it will appear on the list when you select Failed or Cancelled as the status.
  5. The Message Types option displays which type of HL7 message was parsed in the format: Message Type (Message Trigger Event Abbreviation). Note that 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(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
    • MFN(MAD): User/location add
    • MFN(MUP): User/location update
    • MFN(MDC): User/location discontinue
    • ORM: Order messages
    • ORM(CA): Order cancellation
    • ORM(CAS): 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(RR): Order request received
    • 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)
    • ZSH: Automation line messages
  6. View the following message details in the columns listed below.
    • Content (Patient Name): The name of the patient to whom the message applies, or Notification for email messages, or the patient name and the host forwarding the message for forwarded messages.
    • Status: The status of the message.
    • Created: The date and time the system created the message.
    • Recipient: The recipient location or staff member the message is sent to.
    • Attempts: The number of attempts the system made to send the message.
    • Last Attempt: (In Progress, Failed, Cancelled, and All statuses only) The date and time the system last tried to send the message.
    • Delivered: (Successfully Sent status only) The date and time the message was sent.
  7. If you are viewing faxes and the system default-level setting to use the Zetafax integrated API functionality is enabled, the following columns are also available:
    • Server Status: The fax's status in Zetafax.
    • Server Received: The time Zetafax received the fax.
  8. If you are viewing faxes and the system default-level setting to use the Zetafax integrated API functionality is enabled, use Hold and Release to fax and release faxes that have been held.
  9. To resend one or more messages, select the checkbox in the Select column for each message you wish to send, and then select Re-send. Select the Select column label to select or deselect all of the messages on the current page.
  10. If you are viewing direct dial, email, fax, direct printing, Harvest Workstation Label Printing, Labeling Printing, and RAPS, you can redirect the selected entries via the Redirect Entries pop-up, if desired. Select the checkbox in the Select column for each message you wish to redirect, and then select Redirect to display the pop-up. Select the delivery method from the Delivery Method drop-down and select either Email, Fax, Direct Printing, or RAPS from the drop-down. If Email or Fax is selected, select inside the Recipient Address field to select a recipient. If Direct Printing is selected, select inside the Printer field to select a specific printer. If RAPS is selected, select inside the RAPS Printer field to select a RAPS printer. If Label Printing is selected, use the drop-down list to select a specific label printer. Selected entries are redirected to the following label printer field. Select Redirect on the pop-up to redirect the selection, or select Cancel to cancel without redirecting the selection. See the RAPS Printer Search topic. To redirect all displayed messages, select Redirect without making any selections. Select the Select column label to select or deselect all of the messages on the current page.

The system checks approximately every five minutes for print jobs to deliver. However, if you redirect a print job and it does not go through successfully, the system will wait approximately 15 minutes before attempting to redirect the print job again.

Cancelling Outbound Messages

  1. By default, the outbound queue continues trying to send messages to an interface if the interface is active and the messages have not successfully been sent. By cancelling the message, the outbound queue no longer recognizes the message as one that needs to be sent.
  2. Select the Select checkbox next to each message you wish to cancel on the current page of messages, and then select Cancel.
  3. The system updates the Status of the message to "cancelled," and the outbound queue will stop trying to transmit the message.
  4. If necessary, you may remove the "cancelled" status and resend the message. See "Resending Cancelled Outbound Messages" below.

Resending Cancelled Outbound Messages

  1. The outbound queue no longer recognizes cancelled messages as messages that need to be sent.
  2. To remove the "cancelled" status, select the Select checkbox next to each message you wish to send, and then select Resend.
  3. The system updates the Status of the message to "in progress," and the outbound queue will begin trying to transmit the message. The system handles sending the message as it does new outbound messages. See "Managing Outbound Messages" above.