Setting Encoding Options


See the TIBCO Adapter Concepts book for an introduction to Internationalization topics such as Unicode and how adapters handle it. The encoding for TIBCO Adapter for COM is UTF16_LittleEndian.

Complete the following steps prior to running the adapter so it can handle files in different encodings.

  1. Configure TIBCO messaging encoding.
  2. The wire format encoding used for communication between adapters and TIBCO-enabled applications is determined by the encoding property set in the project. The adapter instance can be saved in a project:

    • At design time or running as a legacy project using a local repository.
    • Deployed to a TIBCO Administrator Domain.
    • If the adapter instance is saved to a project in a Administration server domain, TIBCO messaging encoding is determined by the repo.encoding property in the server's tibcoadmin.tra file. Each adapter or TIBCO-enabled application that uses the Administration server for storing and retrieving configuration data from a project uses this encoding setting when communicating. This assures that all components (including adapters and other TIBCO-enabled applications) that use the same repository also use the same encoding value to communicate. The repo.encoding property value can be ISO8859-1 (the default) or UTF-8. If English or other Latin-1 language data is transmitted between adapters, ISO8859-1 should be used. Otherwise use UTF-8.

      If an adapter instance is saved in a local project, the TIBCO messaging encoding is determined by the encoding property of the local project file. To communicate with other adapters using the same encoding, all adapters and applications must set their local project file encoding property to be identical. The encoding value is set on the root project folder, in the Save Project dialog box, TIBCO Messaging Encoding field. The default encoding is ISO8859-1.

      The encoding property set in the project file is superseded by the server's encoding property. The encoding property discussed above is the encoding used by the communication between adapters and applications, not the encoding used for the persistent storage of the project files. Project files are always saved using UTF-8.

  3. The adapter supports automation-compliant BSTR data type for string literals, which is represented internally as a UNICODE string. For example, to handle the Euro character (€) correctly, you must set the TIBCO Messaging encoding to UTF-8.

TIBCO Adapter™ for COM User’s Guide
Software Release 5.3, September 2005
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com