DBCS support
EngageOne™ supports the following encoding schemes for reporting files and exported files.
| Encoding | Description |
|---|---|
| ASCII | American Standard Code for Information Interchange. |
| UTF-8 | Eight-bit UCS Transformation Format. |
| UTF-16 | Sixteen-bit UCS Transformation Format, byte order identified by an optional byte-order mark. |
| UnicodeBigUnmarked | Sixteen-bit Unicode Transformation Format, big-endian byte order. |
| UnicodeLittleUnmarked | Sixteen-bit Unicode Transformation Format, little-endian byte order. |
| UnicodeBig | Sixteen-bit Unicode Transformation Format, big-endian byte order, with byte-order mark. |
| UnicodeLittle (default) | Sixteen-bit Unicode Transformation Format, little-endian byte order, with byte-order mark. |
| Cp1250 | Windows-1250 is a code page used under Microsoft Windows to represent texts in Central European and Eastern European languages that use Latin script |
| Cp1252 | Windows-1252 or CP-1252 (code page 1252) is a single-byte character encoding of the Latin alphabet (with additions) that was used by default in Microsoft Windows for English and many Romance and Germanic languages ( ISO 8859-1 ) |
The default encoding scheme set on installation is
UTF-16LE. It has the default name
UnicodeLittle and is set in the
config-settings.xml file under the namespace
com.pb.engageone as default.file.encoding. The namespaces
com.pb.engageone.server.batch (reporting files) and
com.pb.openedms (exported files) automatically inherit the default.file.encoding value – see the
example below for accumulated batch.
If you require another encoding scheme you only need to change
the default.file.encoding value in the
com.pb.engageone namespace.
<namespace name="com.pb.engageone">
. . .
<setting>
<key>default.file.encoding</key>
<value>UnicodeLittle</value>
</setting>
. . .
</namespace>
<namespace name="com.pb.engageone.server.batch">
. . .
<setting>
<key>csv.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
<setting>
<key>dij.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
<setting>
<key>xml.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
<setting>
<key>fixed.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
. . .
</namespace>
<namespace name="com.pb.openedms">
. . .
<setting>
<key>resource.export.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
. . .
</namespace>
. . .
<setting>
<key>resource.export.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
. . .
</namespace>You can also tailor your requirements to an individual key, leaving the rest defaulted as in the following example where the DIJ report has an over-ride value of UTF-8.
Example for accumulated batch
<namespace name="com.pb.engageone.server.batch">
. . .
<setting>
<key>csv.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
<setting>
<key>dij.report.encoding</key>
<value>UTF-8</value> <!-- If desired/required, for example -->
</setting>
<setting>
<key>xml.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
<setting>
<key>fixed.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
. . .
</namespace>
<namespace name="com.pb.openedms">
. . .
<setting>
<key>resource.export.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
. . .
</namespace>Example for non-accumulated batch
<namespace name="com.pb.engageone.server.batch.na">
. . .
<setting>
<key>default.file.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
<setting>
<key>dij.report.encoding</key>
value>${com.pb.engageone.batch[dij.report.encoding]}</value>
</setting>
<setting>
<key>csv.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
<setting>
<key>xml.report.encoding</key>
<value>${com.pb.engageone.batch[xml.report.encoding]}</value>
</setting>
<setting>
<key>fixed.report.encoding</key>
<value>${com.pb.engageone[default.file.encoding]}</value>
</setting>
. . .
</namespace>