Error message when you import some XML documents by using an XMLPort in Microsoft Dynamics NAV 4.0: "A document must contain exactly one root element"

Article ID: 946445 - View products that this article applies to.
Microsoft Business Solutions-Navision 4.0 and Microsoft Navision 4.0 are now part of Microsoft Dynamics NAV 4.0. All references to Microsoft Business Solutions-Navision or to Microsoft Navision 4.0 relate to Microsoft Dynamics NAV.
This article applies to Microsoft Dynamics NAV for all countries and all language locales.
Expand all | Collapse all

On This Page

SYMPTOMS

Consider the following scenario. You import some XML documents by using an XMLPort in Microsoft Dynamics NAV 4.0. In this scenario, you receive an error message that resembles the following from Microsoft Message Queuing, also known as MSMQ:
The XML Parser return the following fatal error:
A document must contain exactly one root element.
Line number = 2 column number = 9
Note This problem occurs even if the XML documents are valid.
Back to the top | Give Feedback

CAUSE

This problem occurs because the MSMQBusAdapter.dll file did not tell XMLDOM when an XML document was finished. Therefore, the MSMQBusAdapter.dll file could pass on additional characters to Microsoft Dynamics NAV.
Back to the top | Give Feedback

RESOLUTION

A supported hotfix is now available from Microsoft. The hotfix corrects the problem that is described in this article. Apply the hotfix only to systems that are experiencing this specific problem.

To resolve this problem immediately, contact Technical Support for Microsoft Dynamics and related products to obtain the hotfix. You can log on to the Microsoft Dynamics site and create a new support request. To do this, visit the following Microsoft Web site:
https://mbs.microsoft.com/support/newstart.aspx
(https://mbs.microsoft.com/support/newstart.aspx)
You can also contact Technical Support for Microsoft Dynamics and related products by telephone at (888) 477-7877.

Note In special cases, charges that are ordinarily incurred for support calls may be canceled if a Technical Support Professional for Microsoft Dynamics and related products determines that a specific update will resolve your problem. The usual support costs will apply to any additional support questions and issues that do not qualify for the specific update in question.

How to obtain the Microsoft Dynamics NAV hotfix or update files

After you request a Microsoft Dynamics NAV hotfix or an update file from Technical Support for Microsoft Dynamics, a hyperlink will be sent to you in an e-mail.

The e-mail will contain a hyperlink and a password. You can use the hyperlink to download the Microsoft Dynamics NAV hotfix or the update files. When you click the hyperlink, the File Download – Security Warning dialog box opens. Then, you are prompted to run, to save, or to cancel the download.

If you click Run, the files start the download and the extraction process. You must specify a folder for the new files, and then provide the password.

If you click Save, you must specify a path for saving the compressed file. When you open the file that you saved, you are prompted to specify a path for the files. You must then provide the password provided in the e-mail.

If you click Cancel, the download process stops.

How to install a Microsoft Dynamics NAV hotfix or an update file

The Microsoft Dynamics NAV platform hotfixes and updates are made available as single files. To install a Microsoft Dynamics NAV hotfix or an update, you must replace the existing Microsoft Dynamics NAV installation files with the hotfix or the update files.

If you have Microsoft Dynamics NAV Application Server installed, replace the following files in the Microsoft Dynamics NAV Application Server installation.
Collapse this tableExpand this table
File nameFile versionFile sizeDateTimePlatform
Msmqbusadapter.dll4.0.3.25726197,75213-Dec-200719:00x86
To replace the files, follow these steps:
  1. Stop the Microsoft Dynamics NAV Application Server.
  2. Locate the Microsoft Dynamics NAV Application Server installation directory. The Microsoft Dynamics NAV Application Server is usually installed in the following directory:
    C:\Program Files\Microsoft Business Solutions-Navision\Application Server\
  3. Copy the files that you downloaded.
  4. Paste the files that you downloaded into the Microsoft Dynamics NAV Application Server installation directory.
  5. Click Yes to overwrite the files in the directory.
  6. Start the Microsoft Dynamics NAV Application Server.

Prerequisites

There are no prerequisites for installing this hotfix.

Restart requirement

You do not have to restart the computer after you apply this hotfix.
Back to the top | Give Feedback

STATUS

Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
Back to the top | Give Feedback

MORE INFORMATION

For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:
824684
(http://support.microsoft.com/kb/824684/LN/ )
Description of the standard terminology that is used to describe Microsoft software updates
Back to the top | Give Feedback

Properties

Article ID: 946445 - Last Review: March 19, 2012 - Revision: 3.0
APPLIES TO
  • Microsoft Dynamics NAV 4.0
Keywords: 
kbmbsmigrate kbnavision40presp4fix kbmbsdatabaseandplatforms kberrmsg kbqfe kbautohotfix KB946445
Back to the top | Give Feedback

Give Feedback

 
Back to the topBack to the top