Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 3 Using the TIBCO iProcess Suite in a Multilingual Environment : Configuring the iProcess Suite Using UTF-8

Configuring the iProcess Suite Using UTF-8
When implementing an iProcess Suite installation in an multi-national environment using UTF-8 encoding, you need to consider the flow of data between the individual products that make up the iProcess Suite. Some products need particular settings configured in order to communicate with the UTF-8 character set.
Identify which parts of the iProcess Suite you are using and the physical locations of those products. The components that require consideration are:
TIBCO iProcess Engine
The following configuration needs to be done on the TIBCO iProcess Engine:
swadm set_attribute 0 ALL 0 IAPJMS_LANGUAGE UTF-8
Oracle  If iProcess Engine is used with a database supporting UTF-8, set the variable NLS_LANG to AL32UTF8.
DB2  If iProcess Engine is used with a database supporting UTF-8, set the variable DB2CODEPAGE to 1208.
Non-XML files (such as XFR or Abox files) are converted from the value specified in the environment variable SW_FILE_ENCODING or, if that is blank, from the encoding specified by the system locale. In most cases the encoding will conform to that specified by the system locale, so this environment variable can be safely left blank. However, in a situation where multiple iProcess Engine installations exist on the same machine and serve users with different language requirements, you may want override the locale setting using the environment variable. For example, depending on your platform, you can set SW_FILE_ENCODING to UTF-8 as follows:
C:\> set SW_FILE_ENCODING=UTF-8
$ export SW_FILE_ENCODING=UTF-8
$ setenv SW_FILE_ENCODING UTF-8
$ SW_FILE_ENCODING=UTF-8;export SW_FILE_ENCODING
iProcess Clients
Any iProcess Clients, both iProcess Workspace (Windows) and iProcess Workspace (Browser), send to and receive from iProcess Engine data encoded in UTF-8. Any necessary conversions are carried out by the client.
TIBCO iProcess Workspace (Windows)
Using iProcess Workspace (Windows), no configuration is necessary. Conversions take place automatically, as follows:
TIBCO iProcess Workspace (Windows) determines the native encoding to use from the system locale to which it is set.
TIBCO iProcess Workspace (Browser)
If you are using iProcess Workspace (Browser), you must:
On a UNIX system, set the TISOUnicodeConverterName environment variable to UTF-8.
On a Windows system, set the TISOUnicodeConverterName registry entry (HKEY_LOCAL_MACHINE\SOFTWARE\Staffware plc\Staffware SSO Client\) to UTF-8.
TIBCO iProcess Workspace (Browser) uses the TISOUnicodeConverterName value to determine what encoding to use for communications with iProcess Engine.
The LDAPCONF Utility
If you use the LDAPCONF Utility and the system default encoding is not UTF-8, ensure that option [10] Enable Attribute Value Translation from UTF-8 option is deselected. If selected, this enables the conversion between the UTF-8 format used by LDAP and the system locale of the iProcess Engine. If iProcess Engine is using UTF-8, this conversion is redundant.
See "Setting up the Connection" in the LDAPCONF Utility User’s Guide for details of this menu option.
TIBCO Business Studio
If you use TIBCO Business Studio, data sent from TIBCO Business Studio to iProcess Engine is converted to the encoding specified in the process attribute DEPLOY_XSL_OUT_ENCODING. Therefore you must:
Set the iProcess Engine process attribute DEPLOY_XSL_OUT_ENCODING to UTF-8 by using the SWDIR\util\swadm utility as follows:
swadm set_attribute 0 ALL 0 DEPLOY_XSL_OUT_ENCODING
   UTF-8
(The default is ISO-8859-1.)
iProcess Plug-ins
All iProcess Plug-ins send data to and receive it from the iProcess Engine in UTF-8 encoding. Any necessary conversion is carried out by the Plug-in.
iProcess BusinessWorks Plug-in
The defaultEncoding attribute in the SWDIR/eaijava/encoding.properties file must be set to the encoding used by the iProcess Engine. Therefore:
Set the defaultEncoding attribute in the SWDIR/eaijava/encoding.properties file to UTF-8.
iProcess Web Services plug-in
The WSDocumentHandler.Encoding attribute in the wsconfig.properties file must be set to the encoding used by the iProcess Engine. Therefore:
Set the attribute WSDocumentHandler.Encoding in the WebServiceHome/jetty-6.1.1/staffware/wsconfig.properties file to UTF-8.
iProcess Email Plug-in
The Charset attribute in the eai_mail.cfg file must be set to the encoding used by the iProcess Engine. The iProcess Email plug-in embeds this attribute in the encoded-words streams for the MIME header fields subject, to address, cc address, from address and others. Therefore:
Set the attribute Charset in the SWDIR/lib/eai_mail.cfg file to UTF-8 for the Windows platform.
Set the attribute Charset in the SWDIR/libs/eai_mail.cfg file to UTF-8 for UNIX platform

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved