Administrators can define label templates for label printing in the Serialized Manufacturing application. The label template must be a valid Zebra Programming Language (ZPL) label design.


After you defined the label template, you can select it for a printing order. When the printing order is released to printing, the label is printed in the format defined in the template.


List of Procedures


Creating a Label Template


Procedure


1. In the Serialized Manufacturing 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 Create.



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. In the Label size field, select the size from the drop-down.


Note: Only A5 is supported.


4. In the Type field, select a template type from the drop-down.


For each template type, Movilitas.Cloud offers an example template with all the parameters applicable to that template type. After the type is selected, the example template is loaded in the Template field.


5. In the Template field, define the ZPL label template by using the placeholders displayed on the screen.

  • 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, ZPL designer, and then you can paste it into the editor field.


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


#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. For example, when you type ${batch_number} in the template, this value will be replaced with the actual batch number when printing the label.


Only the placeholders displayed on the screen are supported.


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.

3Indicator placeholders

An indicator placeholder defines a piece of information that should only be included in the label if the relevant data is present.


For example, ${batch?:(10) } means that if the batch is existing, then this value is printed on the label preceded by (10), for example, (10) BATCH010203.


The application validates the entered information in real-time:

  • If the template is in the right format, 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.

6. 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. You can also see the number of times each placeholder is used in the template.

  • We have a typo for the ${expiration_date} placeholder.
  • We do not know if this is the only error in the template or there are further ones. After correcting the error, the application will check the template again and will display the next error found in the row.



EXAMPLE 2


The defined template is validated successfully and is ready for saving. The application displays the green message and you can also see the number of times each placeholder is used in the template.



7. 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 Manufacturing 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 "Online Help Demo Template" and are viewing its details:




Back to the list of procedures


Updating a Label Template


Procedure


1. In the Serialized Manufacturing 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 or the label design.


Since this name is used for identifying the template, use an expression that is self-explanatory.


For the label design, select the template type and then provide the template:

  • 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, ZPL designer, and then you can paste it into the editor field.


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


#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. For example, when you type ${batch_number} in the template, this value will be replaced with the actual batch number when printing the label.


Only the placeholders displayed on the screen are supported.


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.

3Indicator placeholders

An indicator placeholder defines a piece of information that should only be included in the label if the relevant data is present.


For example, ${batch?:(10) } means that if the batch is existing, then this value is printed on the label preceded by (10), for example, (10) BATCH010203.


The application validates the entered information in real-time:

  • If the template is in the right format, 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.


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 Manufacturing application, select LabelsTemplates tab. The application displays the list of label templates.


2. Find the label template you want to delete.



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



Back to the list of procedures