DataMatrix and GS1 DataMatrix Script Methods

The following script methods are specific to this barcode symbology. Additionally, you can use the Common Script Methods for Barcodes.

Tip: If using these script methods in a business rule, select the Rhino script engine.

Tip: Script methods with names beginning with get or is retrieve the current value for a property. Script methods with names beginning with set configure a value for the property.

Methods	Description	Values
getCellWidth() setCellWidth(int)	The X-dimension or height and width of one cell (module) in the barcode. The range of values available depends on the Document DPI of the label template. For example, a label template with a Document DPI of 203 has Line X-Dim values in increments of 4.9 mil (1000 mil / 203 dpi).	Thousandths of an inch (mil)
getSymbolSize() setSymbolSize(String)	The number of rows and columns in the symbol. For more information, see the "Symbol Size" section following this table. Note: This value limits Max Chars.	Auto Square Form: 10x10 to 144x144 Rectangular Form: 8x18 to 16x48
getErrorCorrection() setErrorCorrection(String)	The level of error checking and correction employed in the symbol. Note: The current DataMatrix standard requires the use of ECC 200.	ECC 200
getFormatID() setFormatID(int)	Defines the type of data that can be encoded in the symbol. Note: The Format ID is not used when Error Correction is set to ECC 200.	1: Numeric digits 0 through 9 and the space character 2: Upper case alpha A-Z and the space character 3: Upper case alphanumeric A-Z, 0-9, and the space character 4: A-Z, 0-9, space, minus, period, comma, and forward slash (/) 5: 7 bit ASCII—all ASCII characters between ASCII 0 through ASCII 127 6: 8-bit ASCII—all ASCII characters between ASCII 0 through ASCII 255

Methods

Description

Values

getCellWidth()

setCellWidth(int)

The X-dimension or height and width of one cell (module) in the barcode. The range of values available depends on the Document DPI of the label template. For example, a label template with a Document DPI of 203 has Line X-Dim values in increments of 4.9 mil (1000 mil / 203 dpi).

Thousandths of an inch (mil)

getSymbolSize()

setSymbolSize(String)

The number of rows and columns in the symbol. For more information, see the "Symbol Size" section following this table.

Note: This value limits Max Chars.

Auto

Square Form: 10x10 to 144x144

Rectangular Form: 8x18 to 16x48

getErrorCorrection()

setErrorCorrection(String)

The level of error checking and correction employed in the symbol.

Note: The current DataMatrix standard requires the use of ECC 200.

ECC 200

getFormatID()

setFormatID(int)

Defines the type of data that can be encoded in the symbol.

Note: The Format ID is not used when Error Correction is set to ECC 200.

1: Numeric digits 0 through 9 and the space character

2: Upper case alpha A-Z and the space character

3: Upper case alphanumeric A-Z, 0-9, and the space character

4: A-Z, 0-9, space, minus, period, comma, and forward slash (/)

5: 7 bit ASCII—all ASCII characters between ASCII 0 through ASCII 127

6: 8-bit ASCII—all ASCII characters between ASCII 0 through ASCII 255

Additional Methods

The following methods do not have corresponding controls for barcode objects in the Loftware Enterprise SP user interface.

Methods	Description	Values
getRows() setRows(int)	The number of rows in the symbol. For more information, see the "Symbol Size" section following this table.
getColumns() setColumns(int)	The number of columns in the symbol. For more information, see the "Symbol Size" section following this table.
getCellHeight() setCellHeight(int)	The height of the barcode cell (module). The range of values available varies with the Document DPI of the label template.

Methods

Description

Values

getRows()

setRows(int)

The number of rows in the symbol. For more information, see the "Symbol Size" section following this table.

getColumns()

setColumns(int)

The number of columns in the symbol. For more information, see the "Symbol Size" section following this table.

getCellHeight()

setCellHeight(int)

The height of the barcode cell (module). The range of values available varies with the Document DPI of the label template.

Symbol Size

The Symbol Size is the number of rows and columns in the symbol. The Symbol Size and whether the data represented by the symbol is numeric, alphanumeric, or binary, limits the maximum number of characters that can be represented by the symbol. You can configure the value of Max Chars to further limit the number of characters allowed.

When you select a Symbol Size other than Auto, the value of Max Chars is changed to the maximum number of numeric characters that can be represented by the symbol. The value of Max Chars displayed is not dynamically updated to correspond to the type of data to which the data ref points, and you cannot explicitly define the data type in Loftware Enterprise SP. If the data can be alphanumeric or binary, you should reduce the value of Max Chars to the limit shown in the following table to ensure that data incorporated into the symbol is not unexpectedly truncated.

Note: If you select Auto for the Symbol Size, the value of Max Chars is not changed automatically. However, with Auto selected, you can configure Max Chars to any value up to 3116, which is the number of numeric characters that can be represented when using a Symbol Size of 144x144.

Square Form

Symbol Size	Maximum Characters Possible
Symbol Size	Numeric	Alphanumeric	Binary
10x10	6	3	1
12x12	10	6	3
14x14	16	10	6
16x16	24	16	10
18x18	36	25	16
20x20	44	31	20
22x22	60	43	28
24x24	72	52	34
26x26	88	64	42
32x32	124	91	60
36x36	172	127	84
40x40	228	169	112
44x44	288	214	142
48x48	348	259	172
52x52	408	304	202
64x64	560	418	278
72x72	736	550	366
80x80	912	682	454
88x88	1152	862	574
96x96	1392	1042	694
104x104	1632	1222	814
120x120	2100	1573	1048
132x132	2608	1954	1302
144x144	3116	2335	1556

Rectangular Form

Symbol Size	Maximum Characters Possible
Symbol Size	Numeric	Alphanumeric	Binary
8x18	10	6	3
8x32	20	13	8
12x26	32	22	14
12x36	44	31	20
16x36	64	46	30
16x48	98	72	47