Paper forms barcode properties in the Value tab

When you select a paper forms barcode object on the form design, the Value tab of the Object palette presents options specific to formatting paper forms barcodes.

Compress Data Before Encoding

Indicates whether the data is compressed before it is encoded by the paper forms barcode object. The default setting is to not compress the data.

The data compression uses the Flate method. When this option is selected, compression is performed inside Acrobat or Adobe Reader when the barcode is drawn.

Compressed data requires less storage space in the barcode, allowing more form data to be stored in the barcode.

Note: Typically, you will want data compressed unless the data will be decoded with a handheld scanner or your own decode solution that does not include decompression software. For more information about compressing data, see the Acrobat Help.

Automatic Scripting

Specifies whether the barcode data is obtained automatically or through custom scripting.

Format

Specifies the format of the barcode data that is automatically scripted. When an option is selected, the associated script appears in the Script Editor. If required, you can edit the predefined scripts. Select from the following formats:

XML: The value of the barcode is obtained through a script that encodes the data in XML format.
Delimited: The value of the barcode is obtained through a script that encodes the data in a delimited format (a flat ASCII representation of field values separated by the specified delimiter character).

Include Field Names

Separates the field names using the specified delimiter and encodes them. Field names are listed first, followed by the field values. This option is available when the Delimited option is selected in the Format list.

Include Label

Encodes the label (shown in Field tab) as the first delimited field in the barcode contents. This option is available when the Delimited option is selected in the Format list.

Use Legacy Format

Uses a legacy encoding format to produce XML barcode content. The legacy encoding format is used in paper forms barcode XML scripts in Designer 7.0 to 8.0. This option is selected automatically when you open a form that uses the legacy encoding format in Designer. By default, Designer uses a new encoding format.

The paper forms barcode object supports two XML encoding formats produced by two XFA JavaScript functions, xfa.datasets.saveXML() and xfa.record.saveXML(). The legacy encoding format uses the function xfa.datasets.saveXML() and the new encoding format uses the function xfa.record.saveXML()to produce XML encoded data. The legacy encoding format produces longer XML data output than the new encoding format. The new encoding format produces more compact XML data output that provides more barcode space and is better suited for XML encoding scripts.

Delimiter

Specifies the delimiter character that is used to separate field names, field values, and barcode labels in the encoded data. This option is available when the Delimited option is selected in the Format list.

Note: It is recommended that you do not select the Carriage Return option as a delimiter, because the carriage return character is already used in the paper forms barcode values as a delimiter to separate the header and value rows. See To specify a delimiter.

Character Encoding

Specifies the character set used for barcode content. Select one of these options.

UTF-8: Characters are encoded using Unicode code points as defined by Unicode-3.2, and UTF-8 serialization as defined by ISO/IEC 10646. There is no byte order mark. This option is selected by default.
UTF-16: Characters are encoded using Unicode code points as defined by Unicode-3.2, and UTF-16 serialization as defined by ISO/IEC 10646 and ISO-10646. There is no byte order mark.
UCS-2: Characters are encoded using Unicode code points as defined by Unicode 3.2, and UCS-2 serialization as defined by ISO/IEC 10646. There is no byte order mark.
ISO-8859-1: Characters are encoded using ISO-8859-1, also known as Latin-1.
ISO-8859-2: Characters are encoded using ISO-8859-2.
ISO-8859-7: Characters are encoded using ISO-8859-7.
Shift_JIS: Characters are encoded using JIS X 0208, also known as Shift_JIS.
KSC_5601: Characters are encoded using the Code for Information Interchange (Hangul and Hanja).
GB-2312: Characters are encoded using Simplified Chinese.
Big Five: Characters are encoded using Traditional Chinese (Big-Five). Note that there is no official standard for Big-Five and several variants are in use.
Font Specific: Characters are encoded in a font-specific way. Each character is represented by one 8-bit byte.
None: No special encoding is specified. Characters are encoded using the ambient encoding for the operating system.
Note: Keep in mind that some scanning devices do not support certain character sets. Also, Acrobat and Adobe Reader 7.0. and earlier do not support character encoding.

Apply To

Specifies what the selected format applies to. Select from the following list:

Entire Form Data: Encodes the data from all form fields in the selected format
Collection Data: Encodes the data from all fields specified in the selected collection.

Collection

Specifies the collection to use to encode the data. Select from the following list:

Collection name: The name of the collection that you created.
New/Manage Collection: Creates, deletes, duplicates, renames, and modifies collections in the Collection list.
Note: If you add a List Box object with the Allow Multiple Selection option selected on the Field tab to a paper forms barcode collection, you must also select the Enforce Strict Scoping Rules in JavaScript option on the Defaults tab in the Form Properties dialog. Otherwise, any values that a form filler selects in the List Box object may not encode properly in the paper forms barcode.

Modify

Displays the selected fields for the current collection. You can also edit the fields in the collection and rename the collection in this window.