What are labels?
Label models are the labels that you will be printing and using to stick on whichever product, container, or box. You can render labels with the Render button and view the label that was defined in the Template tab. The rendering depends on certain settings on the Label Preferences (AL101000) form. By default, the Labelary API is used and the programming language for the label template is Zebra.
PROCESS FLOW
Navigate to Asgard Labels > Profiles > Label Models.
In the Generic Inquiry page of Label Models form that opens, click on + to add a New Record.
Expected Result: The data entry page of Label Models must open.
On the data entry page, indicate the Model ID. It is the unique identifier that defines the label model in the system. An alphanumeric string with 50 maximum characters must be used.
2. In the Summary Area of the Label Model data entry page, indicate the Description.
The values indicated in the Description field is the identifier of the label when the user prints from the screen selected.
3. In the Summary Area of the Label Model data entry page, identify the Model Type: Label/Group/Snippet.
Label: The label itself. Label Model Type is the label that is defined in a printer control language in the template tab.
Group: A group of label models. The group model type allows you to group different single labels together and have them all in one place.
Snippet: Reusable piece or section of a label. Snippets can be reused in other labels.
4. In the Summary Area of the Label Model data entry page, select the Screen where the label is mapped to
Expected Result: The Graph Type field will be auto-populated based on the selected Screen ID.
5. To complete the summary information, identify the following:
Based On View: The view is the process that tells the system where from the selected screen the label is going to pull data from.
Format ID: The unique identifier of the format used on the label model. Formats include dimensions of width and height and print density.
Margin: The space separating text or other elements from the edge of the label; commonly adjusted throughout the label setup.
Position Type: Choose between Dots or %
6. In the Setup Tab of the Label Model data entry page, set the Rules for the label.
Enable When: The rule that indicates when the label model should be displayed in the toolbar or action menu of the respective form that the label is mapped to. If the label model is visible, you can click on the button to print the label. If not, you will not be able to click the button to print the label.
Print When: The rule that indicates when the label model should be printed.
Tooltip: A brief description of the use case of the label.
Nb. of Copies Expr.: The expression that dictates how many labels should be printed when the print request is made.
Language: The programming language that is used in the label template. It is automatically set based on the language preferences set in the Label Preferences (AL101000) form.
Category: The category that the label model will take. Allows to set the purpose of the label model.
If the Not checkbox is selected, the contrary of the rule applied will be in effect.
7. In the Template Tab of the Label Model data entry page, write the template to be used in creating the label
In the right side of the screen, view/hide the rendered label.
8. In the Expressions Tab of the Label Model data entry page, click on LOAD EXPRESSIONS in the Table toolbar. This automatically converts all the Scriban brace expressions from the Template tab into assignable variables that can be mapped to corresponding values from an Acumatica Screen.
After the brace expressions are converted into a Code, and loaded in the Expressions tab, indicate the values for the following columns if applicable.
Pos. X: The x-position of the current row expression. It can be expressed in terms of percentage (between 0% and 100%) or dots (varies depending on the format of the model). The x-axis is the horizontal axis of the label.
Pos. Y: The y-position of the current row expression. It can be expressed in terms of percentage (between 0% and 100%) or dots (varies depending on the format of the model). The y-axis is the vertical axis of the label.
Expr. Type: The type of the following expression definition. Each type makes a different call or reference to different functions and contents. The following types are available:
o Fixed: The fixed type refers to any expression that is static. For instance, a string or sample value. These fields will always keep their same value.
o Screen: The screen type refers to dynamic fields that pull their data from the respective screen that the model is mapped to. These fields will change depending on the data found in your system.
o Function: The function type refers to the use of ZPL functions to implement the expression.
o Content: The content type refers to the mapping of Content to the expression. Typically this is used when there is a 2D barcode that contains different identifiers.
o Image: The image type refers to the use of an image on the label. By setting the image type, you are essentially calling the include function to bring in your image.
o Snippet: The snippet type refers to a call of a snippet to be placed on the label.
o Same: The same type means that the expression has the same type as the previous row (previous expression).
Printer Image: This applies when working with an image. It is a selector that allows you to choose among all of the image files attached to the solution.
Expression: The variable that is pulled from the view that's written as an expression. From the tree selector, you can select which variable you want to assign your Code variable to for printing or you can set a fixed value.
Sample Type: The type of the following sample expression definition. Each type make a different call or reference to different functions and contents. Sample type has the same options as Expression Type with the addition of Same. The same type means that the expression has the same type as the previous row (previous expression).
Sample Value: The value used in the rendering process of the label. Sample values are independent of the values used for printing.
Barcode ID: The barcode that the expression or sample value will take form in. Barcodes are configured in the Barcodes form.
Do Substitute: A check box that indicates (if selected) that a substitution is to be used.
Substitution: The substitution that is going to be applied to your expression. Substitutions refer to functions that are used as a means to manipulate the data whether that is to format, sort, calculate, etc. Substitutions are configured in the Substitutions form.
Content ID: The content for the complex (2D) barcode that is used on the label. Contents are configured in the Contents form. This appears when the Advanced Mode checkbox is selected in the Expressions table toolbar.
Enable When: The rule that indicates when the expression line should be displayed on the label. Allows you to apply rules at the line level to make your labels dynamic when printing. This appears when the Advanced Mode checkbox is selected in the Expressions table toolbar.
Not: A check box that indicates (if selected) that the contrary of the rule applied will be in effect. This appears when the Advanced Mode checkbox is selected in the Expressions table toolbar.
Font: The font of the text in the expression. This appears when the Advanced Mode checkbox is selected in the Expressions table toolbar. Forms are configured in the Fonts form.
9. Create graphics if the label requires a horizontal, or vertical line and/or a box.
10. In the Printers tab, assign printer/s to the created label.
11. After creating the label, in the Form Toolbar of the Label Model data entry page, click on Save and click on RENDER.
Expected Result: The rendered label in an image format is displayed in the right side of the screen.