How to edit Zebra Labels in Microsoft Dynamics Retail Management System Store Operations


INTRODUCTION


This article describes how to edit Zebra Labels in Microsoft Dynamics Retail Management System (RMS) Store Operations.

More Information


Microsoft Dynamics RMS Store Operations includes a label that works with the Zebra Barcode printer. You can use this label to experiment with the formatting options that are available when you use the Zebra Programming Language (ZPL).The following information will help you change the label format to suit your specific needs.This information includes descriptions of the Zebra commands and of the variables that Microsoft provides so that you can insert information into the labels.


Note This article provides a basic understanding of the Zebra Programming Language that is used to create labels that can be used with Zebra label printers. For more information about the Zebra Programming Language (ZPL) and its programming guides, advanced Zebra programming language features, user manuals, technical support, and other resources, visit the following Web site:

Store Operations .lbl file format

The code at the top of a Zebra label file resembles the following code example.
'<Label Title>

[INITIALIZE]

[LABEL]

Barcode printer commands

[END]
Notes
  • In the code, replace the <Label Title> placeholder with the description that you want to appear in the label list in Store Operations Manager.
  • For the label to appear in the list, the label must be saved as
    FileName.lbl in the Labels folder.

    Note By default, the Labels folder is the "C:\Program Files\Microsoft Retail Management System\Store Operations\LABELS" folder.

The opening bracket label command

The first Zebra command that you must type after the [LABEL] heading is the opening bracket. This indicates the beginning of a new label. The format for this command is as follows:
^XA
Typically, this command is followed by the change-alphanumeric-default-fontcommand. This command sets the size of the font. The format is as follows:
^CFFont,Height,Width
Notes
  • In this command, you must replace the Font placeholder with one of the default font values that are listed in the following table:
    ValueFont dimensions
    A9x5
    B11x17
    C or D18x10
    E28x15
    F26x13
    G60x40
    H21x13
    This value specifies the default font for all alphanumeric fields.
  • You must replace the Height placeholder with the individual character height in dots. Acceptable values are 0 through 32000.

    This value specifies the default height for all alphanumeric fields.
  • You must replace the Width placeholder with the individual character width in dots. Acceptable values are 0 through 32000.

    This value specifies the default width for all alphanumeric fields.
  • The default alphanumeric font is A. If you do not change the alphanumeric default font and if you do not use any alphanumeric field command (^Af) or enter an invalid font value, any data that you specify prints in font A. If you define only the height or the width, the magnification is forced to be proportional to the parameter that is defined. If you do not define either value, the last ^CF values that are provided or the default ^CF values for the height and the width are used.

The set label home command

The next command is the set label homecommand. This command defines the top leftmost label position. The format is as follows:
^LHX,Y
Notes
  • You must replace the X placeholder with a value for the number of dots along the x-axis (horizontal). Acceptable values are 0 through 32000.
  • You must replace the Y placeholder with a value for the number of dots along the y-axis (vertical). Acceptable values are 0 through 32000.

The set label length command

Now, set the label length. The format is as follows:
^LLY
Note You must replace the Y placeholder with a value for the number of dots along the y-axis (vertical). Acceptable values are 1 or larger.


Use the following formulas to determine the length of the label:
  • For 6 dot/mm printheads:Length in inches X 152.4
  • For 8 dot/mm printheads:Length in inches X 203.2
  • For 12 dot/mm printheads:Length in inches X 304.8

The field orientation label command

Then, enter the contents of the label. The first command is the field orientationcommand. This command specifies where the text is located on the label. The format is as follows:
^FOX,Y
Notes
  • You must replace the X placeholder with a value for the number of dots along the x-axis (horizontal). Acceptable values are 0 through 32000.
  • You must replace the Y placeholder with a value for the number of dots along the y-axis (vertical). Acceptable values are 0 through 32000.
This command is followed by the field datacommand.

The field datalabel command

The field datacommand specifies the actual text to print. The format is as follows:
^FDData
Note You must replace the Data placeholder with the actual text that you want to print on the label. This data can be either text or one of the label variables that are listed in the "Label variables" section.

The barcode label command

If you want to print a barcode instead of data, insert the barcode command beforethe field data command. This command selects which type of barcode to use and encodes the next field data command with this barcode type. The format is as follows:
^BCOrientation,Height,PrintInterpretationLineBelow,PrintInterpretationLineAbove,UCCCheckDigit,Mode
Notes
  • You must replace the Orientation placeholder with a value for one of the following orientations.
    ValueOrientation
    NNormal
    RRotated (90 degrees clockwise)
    IInverted (180 degrees)
    BBottom up (270 degrees). Read from the bottom up.
  • You must replace the Height placeholder with a value for the barcode height. Acceptable values are 1 through 32000.
  • You must replace the PrintInterpretationLineBelow placeholder with a value to specify if you want to print the Print interpretation line underneath the barcode. Acceptable values include the following.
    ValueBehavior
    YPrint the human readable characters underneath the barcode.
    NDo not print human readable character.
  • You must replace the PrintInterpretationLineAbove placeholder with a value to specify if you want to print the Print interpretation line above the barcode. Acceptable values include the following:
    ValueBehavior
    YPrint the human readable characters above the barcode.
    NDo not print human readable character.
  • You must replace the UCCCheckDigit placeholder with a value to specify if you want to print aUCC Check digit.

    Note This variable should always be set to N.
  • You must replace the Mode placeholder with a value to specify the Mode.

    Note This variable should always be set to N.

Field separatorcommand

Each field must end with a field separatorcommand. The format is as follows:
^FS

Closing bracket

After you enter all the data, you must include a closing bracket. Without this command, the barcode will notprint. The format for this command is as follows:
^XZ

Label variables


The following table lists the variables that define the information that can be printed on a label. The variables must be typed exactly as they appear here. The variables must use the exact capitalization that appears in the table.
VariableDescription
<<StoreName>>The name of your store
<<ItemLookupCode>>The item lookup code
<<Description>>The description of the item
<<ExtendedDescription>>The extended description of the item
<<SubDescription1>>Subdescription 1 of the item
<<SubDescription2>>Subdescription 2 of the item
<<SubDescription3>>Subdescription 3 of the item
<<Price>>The regular price of the item
<<SalePrice>>The sale price of the item
<<PriceA>>Price A of the item
<<PriceB>>Price B of the item
<<PriceC>>Price C of the item
<<MSRP>> The manufacturer's suggested retail price for the item
<<BinLocation>> The bin location of the item
<<Department>>The department of the item
<<Category>>The category of the item
<<SupplierName>>The name of the primary supplier
<<ReorderNumber>>The reorder number of the primary supplier
<<SerialNumber1>>The first serial number of a serialized item
<<SerialNumber2>>The second serial number of a serialized item
<<SerialNumber3>>The third serial number of a serialized item
<<LastReceived>>The date the item was last received
<<LastSold>>The date the item was last sold
<<LotName>>The lot name of a lot matrix item
<<ClassDescription>>The description of a matrix class
<<ClassLookUpCode>>The code of a matrix class
<<MatrixTitle1>>The title of the first column of the matrix information
<<MatrixTitle2>>The title of the second column of the matrix information
<<MatrixTitle3>>The title of the third column of the matrix information
<<MatrixField1>> The value that was entered for the first column of the matrix information
<<MatrixField2>> The value that was entered for the second column of the matrix information
<<MatrixField3>> The value that was entered for the third column of the matrix information

References


The following code sample shows an example of a Zebra Label.
'Zebra Label 4" X 3"
[INITIALIZE]
[LABEL]
^XA^CFB,50,25
^LH0,0
^LL609.6
^FO0,50^FD<<StoreName>>^FS
^FO0,110^FDSale Price:^FS
^FO0,170^FD<<Price>>^FS
^FO0,230^BCN,200,N,N,N,N
^FD<<ItemLookupCode>>^FS
^FO0,440^FD<<Description>>^FS
^XZ
[FINALIZE]
Microsoft provides third-party contact information to help you find technical support. This contact information may change without notice. Microsoft does not guarantee the accuracy of this third-party contact information.


The third-party products that this article discusses are manufactured by companies that are independent of Microsoft. Microsoft makes no warranty, implied or otherwise, about the performance or reliability of these products.