Document Handle Is Mapped Incorrectly - HL7 Module - English - Foundation 22.1 - OnBase - Essential - Premier - Standard - external - Essential - Standard - Premier

HL7 Module
Platform
OnBase
Product
HL7 Module
Release
Foundation 22.1
License
Essential
Standard
Premier

For the Document Update Processor to update a document, the HL7 message must provide a $$DOCNUMBER value that matches the document handle of an existing OnBase document.

  1. Determine where the $$DOCNUMBER value is mapped in the message template.
    1. In OnBase Configuration, select Medical | HL7 | Import Process.
    2. Select the import process that generated the error.
    3. Click Settings.
    4. Under Message Type Information, click View Mappings.
    5. In the User Defined column, look for $$DOCNUMBER. Take note of the field mapped to this value.
    6. Click OK.
  2. Determine whether the failed HL7 message provided a valid document handle in the $$DOCNUMBER field.
    1. Open hl7failedmessages.txt.
    2. Find the error description. If a $$DOCNUMBER value was provided, it is specified in brackets. In following example, the failed document handle is 1940.
      HL7 Inbound processor [Update Document Processor]:The document handle [1940] in the $$DOCNUMBER mapped field did not match a document in the database.
  3. Take corrective action.

    • If the sending application is configured incorrectly, update it to place document handles in the $$DOCNUMBER field.

    • If OnBase needs to respect the sending application's configuration, configure the message template to look for the $$DOCNUMBER in the appropriate field.

    Note:

    If you reconfigure OnBase, consider whether the message template is used for other sending applications. You may need to first copy the message template and the TXA segment to accommodate the sending application's unique configuration. Once the copied message template is configured, create a new import process using the copied message template, and configure a filter in the import process's Sending Application field.