Administrators can define label templates to print SSCC labels in the Serialized Logistics application.


The label template must be a valid Zebra Programming Language (ZPL) label design. We recommend using a third-party designer tool, for example, ZPLDesigner, to prepare the template and paste that ZPL code into Movilitas.Cloud.


After you defined the label template, you can select it for a warehouse. When an authorized operator prints an SSCC label in the warehouse, the label is printed in the format defined in the template.


Note: To access this page, the "Administrator" role is required.


List of Procedures


Creating a Label Template


Procedure


1. In the Serialized Logistics application, select Labels --> Templates tab. The application displays the list of templates and the Create template form.


Note: When viewing the details of a template, you can open the Create template form by clicking Add new +.



2. In the Template name field, enter a unique name for the template. Since this name is used for identifying the template, use an expression that is self-explanatory.


3. (Optional) In the Layout field, define the skeleton of the label as ZPL code.

  • The layout describes the basic structure.
  • The layout is stored on the physical printer when executing the printing order.
  • The layout can contain static as well as dynamic information and the layout is applied to each printed label that uses the template.
  • If you want to define dynamic information in the layout, first elaborate on the placeholders in the Template field and then refer to these placeholders in the Layout field.
  • There is no built-in validator for the content entered in the Layout field.
  • You can write the ZPL code separately in a third-party tool, for example, ZPLDesigner, and then you can paste it into the editor field.
  • You can completely skip defining the layout here, and you can define all the information in the Template field.


To get some hints about the Layout and Template fields, see How to Use Layout and Template Fields when Defining a ZPL Template in Serialized Manufacturing?.


4. In the Template field, define the dynamic information of your label as ZPL code.

  • Your dynamic information can include only the placeholders displayed on the screen.
  • Besides dynamic information, you can define static information in the ZPL code, and you can also include layout-related information here. There is no restriction.
  • There is a built-in validator for the placeholders entered in the Template field.
  • You can manually define the template on the fly by using the placeholders.
  • You can write the template separately by using the placeholders in a third-party tool, for example, ZPLDesigner, and then you can paste it into the editor field.


The following table collects some best practices to help you define the dynamic information:


#Best PracticeDescription
1Help me(?) iconClick Help me(?) icon to view more technical information and some basic examples for label templates.
2Placeholders ${...}

The placeholder is a variable that is replaced with the actual value when printing the label. When you type ${sscc} in the template, this value will be replaced with the actual SSCC when printing the label.


Only the placeholders displayed on the screen are supported. The only placeholder supported is ${sscc}.


When you include a placeholder in the template, the application displays a number next to the placeholder to denote the number of times the placeholder is used in the template.

3Field numbers (^FN)To introduce dynamic information in the Layout field, associate the placeholders with field numbers (^FN) in the Template field and then refer to these field numbers in the Layout field.

To get some hints about the Layout and Template fields, see How to Use Layout and Template Fields when Defining a ZPL Template in Serialized Manufacturing?.


The application validates the template if the required placeholder for generating the barcode is defined and is correct:

  • If the template is correct, the application displays a message in green, Template validated successfully.
  • While validation is in progress, the application displays a message in turquoise, Validating template text.
  • If there is an error, the application displays an error message in red. The error message contains the reason for the failure. The validator exits at the first error found with the relevant error message and it waits for correction.


5. Make sure the template is validated successfully and you see the green message.


If there is an error message displayed, follow the information in the error message and resolve the issue in the editor. Correct all the errors one by one, until you resolve all the issues and see the green message.


EXAMPLE 1


The application displays an error message in red.

  • We have a typo in the ${sscc} placeholder.
  • For long ZPL templates that contain the placeholder in multiple places, there can be errors in other places. After correcting the error, the application re-checks the template and displays the next error found (if any).



EXAMPLE 2


The defined template is validated successfully and is ready for saving. The application displays the green message and the number of places the placeholder is used in the template. The placeholder is used once in the template in this example.



6. Click Create. The template is created and added to the list.


Back to the list of procedures


Searching for a Label Template


Procedure


1. In the Serialized Logistics application, select Labels --> Templates tab. The application displays the list of label templates.


2. Enter the label template name in the search field.

  • The list of the templates is filtered based on the search criteria.
  • You can reset the filter by clicking the Reset filters icon.


3. Select the label template to view its details.


In the following example, we are searching for the template "SSCC Label Example" and are viewing its details:



Back to the list of procedures


Updating a Label Template


Procedure


1. In the Serialized Logistics application, select LabelsTemplates tab. The application displays the list of label templates.


2. Find and select the label template in the list you want to update. The application displays the Update template form.


3. Modify the name of the template and the label design, as needed. For a detailed description, see Creating a Label Template.


4. Make sure the template is validated successfully and you see the green message.


If there is an error message displayed, follow the information in the error message and resolve the issue in the editor. Correct all the errors one by one, until you resolve all the issues and see the green message.


5. Click Update.


Back to the list of procedures


Deleting a Label Template


Procedure


1. In the Serialized Logistics application, select LabelsTemplates tab. The application displays the list of label templates.


2. Find the label template you want to delete.


Example:



3. Click the delete icon and confirm the deletion by clicking Yes.


Back to the list of procedures