Load Time Troubleshooting

Introduction

This article details common error messages displayed while initialising EditLive! for XML. For each type of error message this article details how to locate the source of the error and how to solve the problem.

XML Configuration File Error Messages

These error messages will be shown by the following display in EditLive! for XML:

An error occured while parsing the XML configuration file

These error messages reflect a problem with one or more sections of the XML configuration file used to initialise EditLive! for XML. When prompted with this error message, opening the Java console will reveal more information about the specific location and cause of the problem.

Common errors include:

File Not Found Exception

This error will be shown by the following string in the Java console:

java.io.FileNotFoundException

This error refers to one of two conditions that could occur.

  1. When specifying the XML configuration file of an instance of EditLive! for XML (using the ConfigurationFile property in the instantiation API), the path specified was incorrect. For more information on specifying the path of an XML configuration file, see the ConfigurationFile property in the instatiation API.

  2. When specifying the XML configuration file of an instance of EditLive! for XML (using the ConfigurationFile property in the instantiation API), the name of the XML file specified was incorrect. For more information on specifying the name of an XML configuration file, see the ConfigurationFile property in the instatiation API.

Illegal Argument Exception

This error will be shown by the following string in the Java console:

java.lang.IllegalArguement

This error reveals that there is a syntax error in the XML configuration file. To easier identify the syntax error, load the XML configuration file into the Ephox configuration tool. This tool can be located from http://www.ephox.com/product/editliveforjava/configuration/default.asp.

Character Encoding Error Message

This error message will be shown by the following display in EditLive! for XML:

The required encoding for this document, XXXencodingMethodXXX, is unavailable
on this system.

Where XXXencodingMethodXXX represents the encoding method specified.

This error message reflects a problem with the character encoding method used for the content in EditLive! for XML. To fix this error will require locating where the character encoding was specified and specifying an acceptable character encoding method. The Internationalization article details the three methods used to specify character encoding for EditLive! for XML and it's supported character sets.

Licensing Error Messages

These messages will be displayed in a separate pop-up window from the EditLive! for XML editor. Licencing information is specified in the XML configuration file associated with an instance of EditLive! for XML. For information on how to specify the an EditLive! for XML licence, see the <ephoxlicences> Configuration Element article from the XML Configuration API and the Licensing EditLive! for XML article.

Common errors include:

Account Not Found Error

This error will be shown by the following message in a pop-up window:

Licence error 203: Account not found

This error refers to an incorrect value being place in the key attribute of a licence configuration element. Make sure the product key provided by Ephox is correctly entered into this attribute.

Licence Domain Error

This error will be shown by the following message in a pop-up window:

Attempting to use an unlicensed domain

This error refers to an incorrect value being placed in the domain attribute of a licence configuration element. Make sure the organisation's domain registered with Ephox is correctly entered into this attribute (commonly, the domain displayed by browsers in an organisation is the domain name registered with Ephox).