UCCApplicationIdentifier Function

Returns a formatted string containing a GS1 (UCC/EAN) Application Identifier.

UCCApplicationIdentifier(String, FormatType, AiSeparatorString)

Where

• String is the data string to be formatted.

• FormatType is one of the following human readable formatting types: btAiNone (no formatting), btAiParen (use parenthesis), btAiParenSpace (use parenthesis and spaces), btAiParenSpaceSplit (use parenthesis, spaces, and field split).

• AiSeparatorString, an optional attribute, specifies the separator string that is inserted between application identifiers in the string.

When using GS1 barcodes in your document, you may need to format a text object with GS1 application identifiers using Visual Basic Script. BarTender allows you to easily format these text objects using the UCCApplicationIdentifier function. This function is commonly used when you want the human readable portion of a barcode to appear above the barcode, or appear on multiple lines.

The following examples show the UCCApplicationIdentifier function in use. Note that Value = should not be included when using single-line expressions.

will return the value:

(01) 1 2345678 90123 1 (17) 021212

will return the value:

(01) 1 2345678 90123 1 (17) 021212

You can also use share names to reference existing data sources. In the following example, a barcode object has a value of 01123456789012317021212; this data source has been assigned the name MyBarCodeString.

will return the value:

(01) 1 2345678 90123 1 (17) 021212

If the barcode is in any of the GS1 DataBar family of symbologies, you must explicitly include the implied application identifier "01" with or without parentheses or a trailing space in the String parameter. For example:

Some VB string constants like vbCr have an effect only if the text object is configured to be a paragraph in BarTender.