Sapnote_0000645158 New Barcode Technology

18.09.2013 Page 1 of 12

SAP Note 645158 - New bar code technology

Note Language: English Version: 17 Validity: Valid Since 12.07.2013

Summary

SymptomThis SAP Note provides information on how to use the new bar codetechnology (SAP Note 430887):Which parameters are associated with the individual bar code symbology andwhat do they mean?Which special characters may or must be taken into account when youtransfer text data to bar codes?

Other termsSmart Forms, SAPscript, SE73, bar code

Reason and PrerequisitesYou require information.

In order to use the new bar code technology, you must ensure that thesystem requirements specified in Note 430887 are fulfilled.

Important: You must implement SAP Note 1558595 to be able to use the newbar code technology with SAPscript.

SolutionNote on the procedure: The "new bar code technology" described here onlyrequires definitions in the list of system bar codes in transaction SE73.Those bar code definitions are device-independent and therefore do notrequire any changes or enhancements of device types/print controls or anymaintenance of printer bar codes, as was the case with the "old"printer-based bar code output (Note 5196).After creating a new system bar code in SE73, you can print this bar codeusing any suitable SAP device type. The following device types aresuitable:- All PCL5 device types (for example, BRHL, CAN105, HPLJ8000, LEXT622,OKI6100)- All PostScript device types (for example, POSTSCPT, POST2)- All Kyocera PRESCRIBE device types (for example, KYOFS150, KYOFS170)- All device types for Windows printing (for example, SAPWIN, SWIN, I2SWIN,JPSAPWIN, CNSAPWIN)- The Zebra device types mentioned in Note 750772, for example LZEB2- The SATP device types for SAP Device Driver mentioned in Note 1135106

If you create a new system bar code for the "new bar code technology" intransaction SE73, you must specify the following parameters:

o Bar code name (is used in the form or style)

o Short text for system bar code (documentation)

o Bar code symbology: Code39 Code128 Interleaved 2of5

18.09.2013 Page 2 of 12


PDF417 Code93

This selection determines the technical bar code type that is usedto format the bar code data (also called bar code symbology). Thesymbology also determines which characters are allowed in the barcode data.

o Bar code alignment: Normal (that is, the scan direction is "from left to right") Rotated (the scan direction is rotated by 90 degrees "from top tobottom") Inverted (the scan direction is rotated by 180 degrees "fromright to left") Bottom-up (the scan direction is rotated by 270 degrees "frombottom to top")

The other parameters are determined by the selected bar code symbology.******************** Code39 ******************

Code39 is an alphanumeric code that can represent the following charactersin the bar code data:Numbers: 1234567890Capital letters: ABCDEFGHIJKLMNOPQRSTUVWXYZSpecial characters: - . $ / + %Blank characters (space characters)

The start and stop character for the Code39 bar code is usually representedby an asterix (*) in the text view of the bar code data (also called"human-readable text" or "interpretation line").

Parameters for Code39:

o Narrow module widthValue range: 1 to 10This is the width for the narrowest module of a bar code, measuredin pixels. It controls the width of the bar code. Value 1 generatesthe "narrowest", value 10 the widest bars or spaces.

o Linear heightValue range: 1 to 9999Controls the height of the bars of the bar code, measured inpixels. A value of 600 is equal to a height of one inch.

o Mod-43 check digitValue range: X equals YES, blank character equals NoWith this indicator, you can determine whether a Modulo-43 checkdigit is to be generated.

o Bar ratioValue range: 20 to 30This value controls the ratio between wide and narrow bars. Value20 means a ratio of 2.0 :1, value 30 means a ratio of 3.0 to 1

18.09.2013 Page 3 of 12


(that is, 3:1). 1)*************** Interleaved 2of5 *************

Interleaved 2of5 is a numeric code, which can only represent the numbers 0to 9. Since the digits in a bar code are always mapped in pairs, the totalnumber of the digits displayed must always be an even number. If the numberof digits (including an optional check digit) is odd, the systemautomatically adds a leading zero to the bar code data.

Parameters for Interleaved 2of5:



o Mod-10 check digitValue range: X equals YES, blank character equals NoWith this indicator, you can determine whether a Modulo-10 checkdigit is to be generated.

o Bar ratioValue range: 20 to 30This value controls the ratio between wide and narrow bars. Value20 means a ratio of 2.0 :1, value 30 means a ratio of 3.0 to 1(that is, 3:1). 1)

******************* Code 128 *****************Code128 is an alphanumeric code that can encode three different charactersets. Each of the three character sets can represent 106 differentcharacters. Within a bar code, you can alternate between the charactersets.The three Code128 character sets are named as follows:

o Subset A) (contains, for example, digits, capital letters andcontrol characters)

o Subset B) (contains, for example, digits, uppercase and lowercaseletters)

o Subset C) (digit pairs from 00 to 99).

The following shows a table of the three character sets and the encodedcharacters:Value Code A CodeB Code C0 space space 001 ! ! 012 " " 023 # # 03

18.09.2013 Page 4 of 12


4 $ $ 045 % % 056 & & 067 ' ' 078 ( ( 089 ) ) 0910 * * 1011 + + 1112 , , 1213 - - 1314 . . 1415 / / 1516 0 0 1617 1 1 1718 2 2 1819 3 3 1920 4 4 2021 5 5 2122 6 6 2223 7 7 2324 8 8 2425 9 9 2526 : : 2627 ; ; 2728 < < 2829 = = 2930 > > 3031 ? ? 3132 @ @ 3233 A A 3334 B B 3435 C C 3536 D D 3637 E E 3738 F F 3839 G G 3940 H H 4041 I I 4142 J J 4243 K K 4344 L L 4445 M M 4546 N N 4647 O O 4748 P P 4849 Q Q 4950 R R 5051 S S 5152 T T 5253 U U 5354 V V 5455 W W 5556 X X 5657 Y Y 5758 Z Z 5859 [ [ 5960 \ \ 6061 ] ] 61

18.09.2013 Page 5 of 12


62 ^ ^ 6263 _ _ 6364 NUL ` 6465 SOH a 6566 STX b 6667 ETX c 6768 EOT d 6869 ENQ e 6970 ACK f 7071 BEL g 7172 BS h 7273 HT i 7374 LF j 7475 VT k 7576 FF l 7677 CR m 7778 SO n 7879 SI o 7980 DLE p 8081 DC1 q 8182 DC2 r 8283 DC3 s 8384 DC4 t 8485 NAK u 8586 SYN v 8687 ETB w 8788 CAN x 8889 EM y 8990 SUB z 9091 ESC { 9192 FS | 9293 GS } 9394 RS ~ 9495 US DEL 9596 FNC3 FNC3 9697 FNC2 FNC2 9798 SHIFT SHIFT 9899 Code C Code C 99100 Code B FNC4 Code B101 FNC4 Code A Code A102 FNC1 FNC1 FNC1103 START (Code A)104 START (Code B)105 START (Code C)




18.09.2013 Page 6 of 12


o Code128 modeValue range: N (default value), A, UIn default mode N (None), the Code128 bar code works in subset B.If you want to switch to another subset, you must trigger thechange explicitly with a control command ("invocation code") in thebar code data.In mode A (automatic), the software analyzes the transferred barcode data and recognizes automatically which subset is the mostadequate for the bar code data. Subsets are swapped automaticallyin the bar code data. A sequence of four or more digits initiatesan automatic change in subset C.In mode U (UCC case mode), you must transfer 19 digits in the barcode data. Subset C is set automatically and an FNC1 character isadded as prefix.Note: If fewer than 19 digits are transferred, the bar code isfilled with zeros to the left until it contains 19 digits.

o UCC check digitValue range: X equals YES, blank character equals NoNote: This parameter has no effect becaues Code128 always generatesa check digit, even in UCC mode. The parameter will be removed inthe future.

Invocation codes for Code128 Mode N:You can select subsets A, B and C in two ways:1) A special invocation code is added to the bar code data as prefix.2) At the beginning of the bar code data, a special start code ("start codeA", "start code B", "start code C") is used.To switch the subset within the bar code data, insert an invocation code atthe relevant position in the bar code data. The new subset is valid untilthe subset is changed again with a new invocation code.For example: In subset C, a ">7" in the bar code data initiates a change tosubset A.The following table shows the Code128 invocation and start codes for thethree subsets:Invocation Decimal Subset A Subset B Subset CCode value Character Character Character>< 62 ^ ^>0 30 > >>= 94 ~>1 95 USQ DEL>2 96 FNC3 FNC3>3 97 FNC2 FNC2>4 98 SHIFT SHIFT>5 99 CODE C CODE C>6 100 CODE B FNC4 CODE B>7 101 FNC4 CODE A CODE A>8 102 FNC1 FNC1 FNC1Start Characters:>9 103 Start Code A (Numeric Pairs give Alpha/Numerics)>: 104 Start Code B (Normal Alpha/Numeric)>; 105 Start Code C (All Numeric 00-99)

Invocation code for Code128 Mode A:You can use \& to insert the character combination into the barcode. For this, the subset is automatically switched to

18.09.2013 Page 7 of 12


A.

Code 128 - subset BSince Code128 subset B is the subset used most frequently, Code128 startsin subset B by default when in mode "N" if a start character is not definedin the bar code data. The bar code data for Code128 is transferred directlyas ASCII characters, with the exception of values over 94 (decimal) andsome special characters':^ > ~

These characters must be transferred with the invocation codes listed above(for example, ">0" to represent the greater-than sign (>) in subset B or">9" and that each subset A character tobe encoded is represented with its decimal code. Therefore, you can alsodisplay non-printable characters and special characters that are "illegal"in SAP using the bar code Code128.

Example for subset C:The bar code data>;1234567890encodes the string "1234567890" in subset C. Bear in mind that subset C isstarted with the start character ">;".Note: If you specify anything else but a digit as the first position of adigit pair in the bar code data of subset C, this "illegal" character isignored. However, if you specify a "non-digit" character in the secondposition of a digit pair, the entire digit pair is ignored.

******************* Code 93 *****************

Code93 is an alphanumeric code that can represent the following charactersdirectly in the bar code data:Numbers: 1234567890Capital letters: ABCDEFGHIJKLMNOPQRSTUVWXYZSpecial characters: - . $ / + %Blank characters (space characters)

The start and stop characters in the Code93 bar code are represented as #sign in the text view of the bar code data (also called "human-readabletext" or "interpretation line").

Representation of the full ASCII character set in Code93:By combining one of the special characters' & ( )with another character, you can represent the complete ASCII character set(that is, all characters from 0 to 127 in decimal form) with Code93 asfollows:Val. ASCII char. Character in bar code

18.09.2013 Page 8 of 12


0 NUL 'U1 SOH &A2 STX &B3 ETX &C4 EOT &D5 ENQ &E6 ACK &F7 BEL &G8 BS &H9 HT &I10 LF &J11 VT &K12 FF &L13 CR &M14 SO &N15 SI &O16 DLE &P17 DC1 &Q18 DC2 &R19 DC3 &S20 DC4 &T21 NAK &U22 SYN &V23 ETB &W24 CAN &X25 EM &Y26 SUB &Z27 ESC 'A28 FS 'B29 GS 'C30 RS 'D31 US 'E32 space33 ! (A34 " (B35 # (C36 $ $37 % %38 & (F39 ' (G40 ( (H41 ) (I42 * (J43 + +44 , (L45 - -46 . .47 / /

58 : (Z59 ; 'F60 < 'G61 = 'H62 > 'I63 ? 'J64 @ 'V

91 [ 'K

18.09.2013 Page 9 of 12


92 \ 'L93 ] 'M94 ^ 'N95 _ 'O96 ` 'W97 a )A98 b )B99 c )C100 d )D101 e )E102 f )F103 g )G104 h )H105 i )I106 j )J107 k )K108 l )L109 m )M110 n )N111 o )O112 p )P113 q )Q114 r )R115 s )S116 t )T117 u )U118 v )V119 w )W120 x )X121 y )Y122 z )Z123 { 'P124 | 'Q125 } 'R126 ~ 'S127 DEL 'T




o Check digitValue range: X equals YES, blank character equals NoWith Code93 bar codes, a pair of check digits is always used and isalways generated in the bar code. This parameter has no effect.

******************* PDF417 *******************

18.09.2013 Page 10 of 12


PDF417 is a two-dimensional bar code to represent datasets that are largeras the usual datasets in one-dimensional bar codes (for example, more than1,000 characters). The entire 7-Bit ASCII character set is generallyprocessed (binary values 1 - 127, the value 0 is not permitted).A PDF417 bar code consists of 3 to 90 consecutive rows. Every row consistsof a start/stop indicator and "code words". A code word consists of 4 barsand 4 spaces. The minimum number of code words per row is three.

Parameters for PDF417:

o Narrow module widthValue range: 1 to 10This is the width for the narrowest module of a bar code, measuredin pixels. Value 1 generates the "narrowest", value 10 the widestbars or spaces.

o Linear heightValue range: 1 to 9999This parameter currently has no effect on PDF417. The height of aPDF417 symbol is controlled by parameter "Single Row Height" andthe number of columns and rows, in conjunction with the length oftext data to be encoded.

o Single row heightValue range: 1 to 32000This value, multiplied by the narrow module width, returns theheight of the individual rows of a PDF417 symbol, measured inpixels. Caution: Do NOT use the value 1 for this parameter

o Security levelValue range: 0, 1-8This parameter controls the number of code words that are generatedfor error recognition and error correction. The default value 0,however, only permits error recognition but no automaticcorrection. If you increase the security level, the level of errorcorrection increases with it (this increases the size of the barcode).

o Number of columnsHere, you can define the number of the code word columns which youcan use to check the width of the bar code.Value range:0 (default value) : A row/column ratio of 1:2 is used.Permitted values: 1 to 30

o Number of rowsHere, you can define the number of rows which can be used to checkthe height of the bar code.Value range:0 (default value) : A row/column ratio of 1:2 is used.Permitted values: 3 to 90For example: If you leave both parameters set to the default value0, the system would convert 72 code words in a bar code symbol with

18.09.2013 Page 11 of 12


6 columns and 12 rows.

o TruncationValue range: X equals YES, blank character equals NoThis indicator determines if the right row indicator and the stoppattern are to be truncated (this saves space).

The following character combinations in the transferred bar code data havethe special function:\& - This represents the end of a line (Carriage Return + Newline)\\ - This represents a backslash (5C hexadecimal)\0xYY - This represents a single byte with the value YY (hexadecimal) For example: \0x1E is output as a single byte with the value 1E(hex) or 30 (decimal).

Comments:- If you specify values higher than zero for Number of columns and Numberof rows, the result of both values must be less than 928.- A bar code is not printed if the total of Columns and Rows is higher than928.- A bar code is not printed if the total number of code words is greaterthan Columns multiplied by Rows.- You can use Truncation if it is unlikely that the bar code will bedamaged.

Header DataRelease Status: Released for CustomerReleased on: 12.07.2013 12:12:12Master Language: GermanPriority: Correction with medium priorityCategory: CustomizingPrimary Component: BC-CCM-PRN Print and Output Management

Secondary Components:BC-SRV-SCR SAPscriptBC-SRV-SSF Smart Forms

Valid Releases

Software Component Release FromRelease

ToRelease

andSubsequent

SAP_BASIS 46 46C 46DSAP_BASIS 60 610 640

Related Notes

18.09.2013 Page 12 of 12


Number Short Text1558595 SAPscript: New bar code technology for SAPscript1557674 Overview of bar code printing from SAP1158016 Different bar code position: Zebra vs. PCL/PS/PDF1019919 Automatic charset switching for EAN128/GX128 barcode764006 SD-Argentina: Bar code creation on billing document750772 Information about the ZPL-II printer driver for Smart Forms730352 Print documents: Notes and remarks706743 Corrections for New Barcode Technology for Smart Forms639812 Bar codes in archived Smart Forms430887 PDF conversion: bar codes are not supported

Documents

Sapnote_0000645158 New Barcode Technology