The Printing templates tab enables the administrators to define printing templates for label printing in the Serialized Logistics for Agro mobile application.


The printing template must be a valid Zebra Programming Language (ZPL) label design that contains all the required placeholders in the right format. We recommend you to use a third-party designer tool, for example, ZPLDesigner, to prepare the template and paste that template in Movilitas.Cloud.


You can define printing templates for the following three purposes:

  • Creating and printing labels when preparing goods in the warehouse
  • Preprinting simplified SSCC labels in the warehouse
  • Reprinting SSCC labels in the warehouse

After you defined the printing templates, you can select them for your warehouse as a printing template, preprinting template, and reprinting template, respectively. When an operator of your warehouse prints a label, the label is printed in the format related to the activity (print, preprint, reprint).


List of Procedures


Creating a Printing Template


Procedure


1. In the Serialized Logistics for Agro application, select the Printing templates tab. The application displays the list of printing templates and the Create printing template form.


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


Example:



2. In the template-name field, enter the name of 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 size is supported.


4. In the Printing template field, define the ZPL printing 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, ZPLDesigner, and then you can paste it into the editor field.


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


#Best Practice
Description
1Help me(?) iconClick Help me(?) icon to view more technical information and some basic examples for printing templates.
2Placeholders ${...}The placeholder is a variable that is replaced with the actual value when printing the label. For example, when you type ${sscc} in the template, this value will be replaced with the actual SSCC number when printing the label.

Only the placeholders displayed on the screen are supported.

As a minimum, you must use the ${sscc} placeholder.

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 placeholdersAn 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.
4Preprinting templateWhen defining a preprinting template, use only the ${sscc} placeholder.
5Printing templateWhen defining a printing template, you can use all the placeholders.
6Reprinting templateWhen defining a reprinting template, you can use all the placeholders.


The application validates the template if all the required placeholders are defined and are 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. You can also see how many times each placeholder is used in the template.

  • We have a typo for one of the ${sscc} placeholders.
  • 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 (if any).


EXAMPLE 2


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




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



Back to the list of procedures


Searching for a Printing Template


Procedure


1. In the Serialized Logistics for Agro application, select the Printing templates tab. The application displays the list of printing templates.


2. Enter the printing 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 Reset filters.


3. Select the printing template to view its details.


In the following example, we are searching for the template "Online Help Template" and are viewing its details:



Back to the list of procedures


Updating a Printing Template


Procedure


1. In the Serialized Logistics for Agro application, select the Printing templates tab. The application displays the list of printing templates.


2. Find and select the printing template you want to update. The application displays the Update printing 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:

  • 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 template:


#Best PracticeDescription
1Help me(?) icon
Click Help me(?) icon to view more technical information and some basic examples for printing templates.
2Placeholders ${...}
The placeholder is a variable that is replaced with the actual value when printing the label. For example, when you type ${sscc} in the template, this value will be replaced with the actual SSCC number when printing the label.

Only the placeholders displayed on the screen are supported.

As a minimum, you must use the ${sscc} placeholder.

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.
4Preprinting template
When defining a preprinting template, use only the ${sscc} placeholder.
5Printing template
When defining a printing template, you can use all the placeholders.
6Reprinting templateWhen defining a reprinting template, you can use all the placeholders.


The application validates the template if all the required placeholders are defined and are 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 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 Printing Template


Procedure


1. In the Serialized Logistics for Agro application, select the Printing templates tab. The application displays the list of printing templates.


2. Find the printing template you want to delete.



3. Click the delete icon next to the printing template and confirm the deletion by clicking Yes.


Back to the list of procedures