Setting Up Character Encoding
Status
If you are... |
This task is... |
Installing a new plug-in |
Required |
Upgrading an existing plug-in |
Required |
Re-installing or repairing an existing plug-in |
N/A |
Re-configuring an existing plug-in |
N/A |
Description
This preinstallation task applies only if you are installing an iProcess Java Server Plug-in or an iProcess Server Plug-in for ActiveMatrix BusinessWorks.
You have to find out your encoding details for TIBCO iProcess Java Server Plug-in or iProcess Server Plug-in for ActiveMatrix BusinessWorks so that you can specify the right character encoding on the Server Plug-in General Configuration Dialog.
From iProcess Engine version 11.1, the iProcess Suite supports Unicode UTF-8, and it is good practice to use Unicode UTF-8 in most cases. However, if you have not configured iProcess Engine to support UTF-8 (for example, if upgrading an existing installation), TIBCO iProcess Workspace (Windows) sends data to iProcess Engine in the default encoding used by the host operating system. On International English versions of Windows this is typically Cp1252.
Ensure that you have set up the character encoding specification of TIBCO iProcess Java Server Plug-in and iProcess Server Plug-in for ActiveMatrix BusinessWorks so that they can correctly translate data formatting to and from Unicode. Note the following points:
• | It is not possible to set the encoding to more than one encoding set — support for multiple encoding sets across TIBCO iProcess clients connected to a single iProcess Engine is not permitted in this release. |
• | When passing XML data including, for example, the Euro symbol, care must be taken with respect to the encoding used within the XML document and the XML editor used. (The Euro symbol in UTF-8 is represented as “€” when viewed in a non-Unicode-compliant editor.) |
To configure iProcess Java Server Plug-in to use UTF-8 encoding, set defaultEncoding=UTF-8
in the $SWDIR
/eaijava/encoding.properties
file.
For more information about iProcess Engine’s support for Unicode UTF-8 and other globalization options, see the "Using the TIBCO iProcess Suite in a Multilingual Environment" section in TIBCO iProcess Engine Architecture Guide.