You are here: Administrator's Guide > Other Common Tasks > Configuring International Character Encoding

Configuring International Character Encoding

By default, FME Server tries to detect how your web service handles international character encodings. Beginning with FME Server 2013, you can manually configure the services and the Web User Interface for international character encoding. To do this, you must configure each service and web application separately.

To configure international character encoding for a particular service or for the Web User Interface:

Open the web application's deployment descriptor web.xml file. This file is installed at <webAppDir>/WEB-INF/web.xml.
Find the <filter> element with <filter-name>i18nFilter and <filter-class>COM.safe.web.servlet.CharsetEncodingFilter.
Add/modify the <init-param> directives to configure international character encodings for this web application according to the table below:

Parameter Name	Type	Description
charset	string	Sets the character set to use. UTF-8 is recommended.
detect-encodings	boolean	“true” to automatically detect encodings. “false” to disable.
auto-encoded	list	A list of comma-separated keywords that specify what should be encoded by the specified character set (see charset). Available keywords: querystring – Encode query strings in the URI. path – Encode the path component of the URI. body – Encode the request body for each request.

Parameter Name

Type

Description

charset

string

Sets the character set to use. UTF-8 is recommended.

detect-encodings

boolean

“true” to automatically detect encodings. “false” to disable.

auto-encoded

list

A list of comma-separated keywords that specify what should be encoded by the specified character set (see charset). Available keywords:

querystring – Encode query strings in the URI.
path – Encode the path component of the URI.
body – Encode the request body for each request.

For further instructions, see the J2EE Servlet Specification v2.5.