ColdFusion XmlParse() Error - Content Is Not Allowed In Prolog

Posted September 25, 2006 at 12:04 PM

Tags: ColdFusion

I was working on an XML database this weekend and was stuck for a bit on an error getting thrown during an XmlParse() call. The error was:

Content is not allowed in prolog.

The original code was trying to take an XML document object, convert it into a string and then parse it into a ColdFusion query object (for testing). That's where the XmlParse() method call came into play.

 Launch code in new window » Download code as text file »

  • <!---
  • Try to convert the xml object to an xml string then
  • into a query object the using XmlToQuery() UDF.
  • --->
  • <cfset qData = XmlToQuery( xmlDoc.ToString() ) />

I thought it was a white space problem prior to the XML doctype. I have run into that problem before. I tried to Trim() the content before I sent it in, but that did not help. The issue, I finally worked out, was the "ToString()" method call. I was calling it incorrectly - I always do that! You can't call the method from the XML document object. You have to call it PASSING IN the Xml document:

 Launch code in new window » Download code as text file »

  • <!---
  • Try to convert the xml object to an xml string then
  • into a query object using the XmlToQuery() UDF.
  • --->
  • <cfset qData = XmlToQuery( ToString( xmlDoc ) ) />

I finally figured this out because dumping out xmlDoc.ToString() resulted in:

#document: null

... which obviously was NOT a string representation of the XML document object.

Download Code Snippet ZIP File

Post Comment  |  Ask Ben  |  Permalink  |  Other Searches  |  Print Page




Learning ColdFusion 9 - ColdFusion 9 tutorials, samples, examples, demos

Reader Comments

Kai
Jan 2, 2007 at 2:16 AM // reply »
1 Comments

Actually - this used to work fine in CF 6, but not anymore in CF 7: http://www.bloginblack.de/archives/000749.cfm


Feb 15, 2007 at 1:37 PM // reply »
3 Comments

I am also having a problem with getting a [#document: null] when attempting to 'save' the xml document to disk -
When i cfdump the xml object it looks fine - (cfmx 7).
But after I do a xmldoc.ToString() on it - the text it saves is the [#document: null].

How can I convert the created XML doc to a String (I had to do some 'funky' things prior to saving this xml doc, like merging it etc - so maybe that would be the cause, but either way, it renders fine in cfdump but I can't get it back to it's String representation.

ideas?


Feb 15, 2007 at 1:40 PM // reply »
3 Comments

Ah - ok - I dind't realize toString() could be used like that -
so I did this toString(myxmldoc) and all is good now -

Thanks!


Feb 15, 2007 at 1:43 PM // reply »
6,516 Comments

Kevin,

Instead of doing XML.ToString()... rock ToString( XML ). Give that a try.


May 13, 2007 at 9:18 PM // reply »
2 Comments

I realize that this is a posting from a *long* time ago (I added myself to the "use it or lose it" e-mail), but I have run across this error before also. It turned out to be a problem within a webservice that I was writing, but had nothing to do with the "tostring" or with any whitespace before the XML...it just was throwing an error within the code itself, and, because the error was being thrown, was appearing to CF as if there was whitespace before the XML. I guess it makes sense, but it would have been nice if the actual error was thrown also :)


May 14, 2007 at 7:12 AM // reply »
6,516 Comments

That's good to know. I don't have much experience with Web Services, so it's good for me to know where possible errors are coming from. But I agree, some of the errors that ColdFusion throws are not exactly the most illuminating.


Feb 15, 2008 at 8:45 AM // reply »
5 Comments

Im not using toString, but am getting the same error, occasionally. Thats right occasionally! My webservice works 99% of the time, then I get these odd errors. At first I contributed it to the feed coming back in error, but then my isXML check would have caught that. So as of now, Im stumped.


Feb 15, 2008 at 9:58 AM // reply »
4 Comments

In my experiences working with XML, i find that every once in a while, no matter if we cdata nodes or not - some data we get from xml can have high ascii characters in them - which may bomb out at the parse level. The xml may parse just fine in Internet Explorer or Firefox, but when that same xml is given to cf to xmlparse, it will throw an error. Removing of the often hidden character or character that appears in notepad as a 'box' character often fixes the problem -


Feb 15, 2008 at 10:31 AM // reply »
6,516 Comments

Kevin has a good point. In addition to that, make sure that you are using XmlFormat() even for the content that is inside of CDATA[]. You might have to unescape somethings afterwards, though. However, it might help you to narrow down where the problem is.

If its a high-ascii value, I was just blogging on the topic of stripping out ascii values:

http://www.bennadel.com/index.cfm?dax=blog:1155.view


Aug 14, 2008 at 10:40 AM // reply »
9 Comments

This error can also be caused by the BOM (byte order mark) character in the XML feed. I blogged about it last time I encountered this problem: http://www.stillnetstudios.com/2007/07/09/coldfusion-xml-prolog-error


Sep 25, 2008 at 12:57 PM // reply »
3 Comments

trim(), extra #, blah blah blah... didn't work but the below works for me:

in CF Admin >> setting >> enable white space management


Sep 25, 2008 at 1:11 PM // reply »
3 Comments

take that back....not working my eyes cheated me, only partial better coz at least the xml showing properly now, but still getting that error.


Sep 25, 2008 at 2:55 PM // reply »
3 Comments

okay, fixed... if you are developing and can get hold of the xml try creating an empty file with notepad called test.txt. Copy and paste the xml into this .txt and change it into .xml.

You will notice there is an extra 1 byte of code that you can't see that is causing this error.


Apr 2, 2009 at 4:16 PM // reply »
25 Comments

I want to also add, that you can get this if you are doing a cfhttp request to a URL that you expect to return XML, but returns something like a 'Connection Failure' or some other invalid data.

I just ran into this - and depending on your environment, can be quite tricky to debug as it may be a network configuration thing and not a code issue at all.


Apr 3, 2009 at 8:15 AM // reply »
6,516 Comments

@Kevin,

Good point, thanks.


Post Comment  |  Ask Ben

Recent Blog Comments
Nov 22, 2009 at 4:03 AM
jQuery Live() Method And Event Bubbling
C_fieri ... read »
Nov 22, 2009 at 1:56 AM
Learning ColdFusion 9: Using CFQuery In CFScript Can Enable SQL Injection Attacks
Why adobe would give you script equivalent of cfquery is beyond me. I love cfquery tag because it helps me wriite clean sql, and get away from the horrible jdbc queries If I wanted to write javali ... read »
Nov 22, 2009 at 1:45 AM
Streaming Text Using ColdFusion's CFContent Tag And The Variable Attribute
The reason you would want to do this is to stream. Ack json/xml files to ria clients I used thus technique before because putting json in response stream causes debugging info to come thru As well a ... read »
Nov 21, 2009 at 6:47 PM
Hal Helms - Real World Object Oriented Development, Sarasota - Day Five
@charlie griefer, Thank you.. ... read »
Nov 21, 2009 at 5:15 PM
Using ColdFusion Structures To Remove Duplicate List Values
@Jose Galdamez, Oh heh yeah I didn't paste the whole code. I should have defined the vars -- my bad. It's fixed thou. Thanks. ... read »
Nov 21, 2009 at 4:49 PM
Styling The ColdFusion 8 WriteToBrowser CFImage Output
Great work yet again Ben! Whilst I didn't use this whole code, I copied some of your regex code for a similar problem with the lack of an alt attribute and unescaped ampersands in CFIMAGE for Railo 3 ... read »
Nov 21, 2009 at 1:13 PM
My First ColdFusion Builder Extension - Encrypting And Decrypting CFM / CFC Files
@Ben, Because I am pedantic, I just want to make sure that everyone knows there is absolutely no encryption going on. There is only encoding and obfuscation. The cfencode tool only obfuscates your C ... read »
Nov 21, 2009 at 12:28 PM
Using ColdFusion Structures To Remove Duplicate List Values
@Jody I can't seem to get your code sample to work. If you are still having problems, try this code out and see if it gets you what you wanted. <!--- Comma delimited list with various duplicates ... read »