FATAL ERROR EVL2203: Found excluded US-ASCII character '20' in URI
Issue
From Designer for Windows an interactive document, that uses an XMLFile DID, is created using ComposerUI for J2EE. In the file upload dialog, after clicking on Ok to submit the data file, the following error is given:
ITPLOG: FATAL ERROR EVL2203: Found excluded US-ASCII character '20' in URI C:\Program Files\Apache Software Foundation\Tomcat 9.0\instance-CCMRuntime-5.3\work\Catalina\localhost\onl_core_01\C33AD4ADAF9C799636A7AD1DE85972B1\upl7438050452307287075.dat. These characters should be escaped by %. Fatal error. Throwing error message "<itp:code>itp.Fatal</itp:code><itp:reason><![CDATA[Dec 3 10:48:17.998[0] [C33AD4ADAF9C799636A7AD1DE85972B1]: Fatal error.
Cause
This error occurs if the Composer for J2EE session is not fully initialised. This happens when the session not started with modelbegin.jsp, but with runmodel.
Another possibility is that the session cookie is blocked by the Internet Browser. The used Internet Browser must accept session cookies. Without session cookies ComposerUI for J2EE cannot function correctly.
Solution
Verify the URL
When testing from Designer for Windows, the correct URL is:
http://KCM-server:8080/onl_core_01/app/ComposerUI_App/modelbegin.jsp
An example of an incorrect URL using runmodel is (do not use this URL):
http://KCM-server:8080/onl_core_01/app/ComposerUI_App/runmodel
Session cookie is blocked
To check if the session cookie (JSESSIONID) is blocked, the developer tools of the used Internet Browser can be consulted.
- Test the document from Designer for Windows.
- The ComposerUI for J2EE session is opened in the used internet browser.
- Copy the URL to notepad.
- Change runmodel in the copied URL to modelbegin.jsp. E.g.
http://kcm-server:8080/onl_core_01/app/ComposerUI_App/runmodel?model=rep:localhost:2587:%5CDID%5CExampleXML:1.6:100001&label=ExampleXML"
to
http://kcm-server:8080/onl_core_01/app/ComposerUI_App/modelbegin.jsp?model=rep:localhost:2587:%5CDID%5CExampleXML:1.6:100001&label=ExampleXML
- Open Google Chrome.
- Open the developer tools (shortcut is F12) and change to the tab Network (in the developer tools).
- Paste the URL from step 4 (with modelbegin.jsp) and visit the URL.
- In the developer tools, click on the "modelbegin.jsp?....", this will result in an additional pane being displayed. Check in the Response Headers if the Set-Cookie works. If the cookie is blocked, Chrome will display an exclamation mark.
- If the cookie is blocked, contact your system administrator. Chrome is possibly configured by IT not to accept session cookies.
This is an example of a working situation. If the cookie was blocked, the exclamation mark would be shown behind the "Set-Cookie:....;HttpOnly" line.
A workaround for Google Chrome is to use the IP address instead of the hostname. E.g. if the IP address of the KCM server is 192.168.5.12:
http://192.168.5.12:8080/onl_core_01/app/ComposerUI_App/modelbegin.jsp
Level of Complexity
Moderate
Applies to
Product | Version | Build | Environment | Hardware |
---|---|---|---|---|
Kofax Communications Manager | 5.3 (should apply to all versions) | n/a | A different Internet Browser than Internet Explorer is used. | n/a |