{"id":7440,"date":"2019-05-01T23:05:50","date_gmt":"2019-05-01T23:05:50","guid":{"rendered":"https:\/\/alt2.minisoft.com\/support\/?p=7440"},"modified":"2020-07-02T13:08:28","modified_gmt":"2020-07-02T20:08:28","slug":"eformz-support-for-reading-zebra-printer-language-zpl-files","status":"publish","type":"post","link":"https:\/\/c002.minisoft.com\/support\/eformz-support-for-reading-zebra-printer-language-zpl-files\/","title":{"rendered":"eFORMz Support for Reading Zebra Printer Language (ZPL) Files"},"content":{"rendered":"\n<p>To follow along with this tutorial on importing ZPL, download the following: <a href=\"\/support\/wp-content\/uploads\/2019\/05\/ZPLInputSample.zip\">ZPL Input Sample<\/a><\/p>\n\n\n\n<p>Many different types of files can be used as input to eFORMz, including PDF, text, XML, captured print spool files such as those going to a PCL 5 printer, or label files such as ZPL files.<\/p>\n\n\n\n<p>The Zebra Printer Language (ZPL) format is a full-featured printer language for producing labels that contain text, barcodes, lines and boxes, and graphics. When using a ZPL file as input, eFORMz reads in the individual elements on the label and converts them into the eFORMz proprietary device-independent format. The contents of the label can then be combined with other elements to compose the desired output, and this output can then be sent to any output device or file type supported by eFORMz.<\/p>\n\n\n\n<p>The following simple exercise demonstrates how eFORMz can read in a ZPL file and add, remove, or change elements of the label to create the desired final label.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Simple Exercise to Work with ZPL Files<\/h2>\n\n\n\n<p>Run eFORMz Composer, then create a new project, a new page, and a new form within that page. Click the \u201cCreate New Project\u201d button to create your new project. Select the \u201cAdd Page\u201d button to add a page to your new project. Click OK on the \u201cPage Properties\u201d dialog box. Then click the \u201cAdd Form\u201d button to add a new form to your page.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"207\" height=\"155\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb1.png\" alt=\"\" class=\"wp-image-7441\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb1.png 207w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb1-150x112.png 150w\" sizes=\"(max-width: 207px) 100vw, 207px\" \/><figcaption><br><\/figcaption><\/figure>\n\n\n\n<p>On the Form Properties dialog box, select \u201c4 x 6 Label\u201d from the Page Size dropdown:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"418\" height=\"263\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb2-1.png\" alt=\"\" class=\"wp-image-7443\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb2-1.png 418w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb2-1-300x189.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb2-1-150x94.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb2-1-250x157.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb2-1-286x180.png 286w\" sizes=\"(max-width: 418px) 100vw, 418px\" \/><\/figure>\n\n\n\n<p>Save the project, by clicking the \u201cSave\u201d button. Double-click the \u201cSample\u201d directory to open it. Then type \u201cZPLInputSample\u201d in the \u201cFile Name\u201d field, and click the Save button to save the file:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"502\" height=\"358\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3.png\" alt=\"\" class=\"wp-image-7444\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3.png 502w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3-300x214.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3-150x107.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3-250x178.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3-252x180.png 252w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3-421x300.png 421w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3-210x150.png 210w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/Zeb3-400x285.png 400w\" sizes=\"(max-width: 502px) 100vw, 502px\" \/><\/figure>\n\n\n\n<p>Next, open the ZPLInputSample.zpl file. Click the \u201cOpen Data\u201d button on the Viewer window to open the ZPL file. Select \u201cFrom file\u201d and click \u201cOK\u201d on the \u201cSelect\u201d dialog box that appears. Now find the file you downloaded, select it, and click Open.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"502\" height=\"358\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4.png\" alt=\"\" class=\"wp-image-7446\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4.png 502w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4-300x214.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4-150x107.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4-250x178.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4-252x180.png 252w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4-421x300.png 421w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4-210x150.png 210w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL4-400x285.png 400w\" sizes=\"(max-width: 502px) 100vw, 502px\" \/><\/figure>\n\n\n\n<p>You can now see the label contained in the ZPL file shown in the eFORMz Viewer window. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Creating a Variable from Text on the Label<br><\/h2>\n\n\n\n<p>Now, let\u2019s create a variable from some text on the label. Right-click on the \u201cPO#: 12244484\u201d and select \u201cAdd Variable\u2026\u201d:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"414\" height=\"285\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL5.png\" alt=\"\" class=\"wp-image-7447\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL5.png 414w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL5-300x207.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL5-150x103.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL5-250x172.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL5-261x180.png 261w\" sizes=\"(max-width: 414px) 100vw, 414px\" \/><\/figure>\n\n\n\n<p>Name the variable \u201cPONumber\u201d and click OK. And in the Variables window, you can see its value, which comes directly from the ZPL label:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"242\" height=\"82\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL6.png\" alt=\"\" class=\"wp-image-7448\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL6.png 242w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL6-150x51.png 150w\" sizes=\"(max-width: 242px) 100vw, 242px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Creating a Variable from a Barcode<br><\/h2>\n\n\n\n<p>Let\u2019s create a variable to contain the value encoded by a barcode on the label. Right-click on the SSCC-18 barcode, and select \u201cAdd Variable\u2026\u201d:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"486\" height=\"243\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL7.png\" alt=\"\" class=\"wp-image-7449\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL7.png 486w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL7-300x150.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL7-150x75.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL7-250x125.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL7-360x180.png 360w\" sizes=\"(max-width: 486px) 100vw, 486px\" \/><\/figure>\n\n\n\n<p>Name the variable \u201cSSCC18BarcodeValue\u201d and click OK to add it. Note that when you create a variable from some portion of the label, that portion disappears from the output. You can display the variable data on the output by right-clicking on the variable in the Project window, selecting \u201cEdit\u2026\u201d and check the \u201cCopy original data to output\u201d checkbox:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"421\" height=\"294\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL8.png\" alt=\"\" class=\"wp-image-7450\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL8.png 421w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL8-300x210.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL8-150x105.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL8-250x175.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL8-258x180.png 258w\" sizes=\"(max-width: 421px) 100vw, 421px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Placing a Value on the Label for Output<br><\/h2>\n\n\n\n<p>Create a new variable by right-clicking on the Variables node in the Project window, and select \u201cAdd variable &gt; By position\u2026\u201d:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"410\" height=\"208\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL9.png\" alt=\"\" class=\"wp-image-7451\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL9.png 410w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL9-300x152.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL9-150x76.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL9-250x127.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL9-355x180.png 355w\" sizes=\"(max-width: 410px) 100vw, 410px\" \/><\/figure>\n\n\n\n<p>Name the variable \u201cReferenceNumber\u201d and click OK. Give the variable a value by right-clicking on the variable name in the Projects window, and select \u201cAdd Function &gt; Set value\u2026\u201d:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"538\" height=\"255\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL10.png\" alt=\"\" class=\"wp-image-7452\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL10.png 538w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL10-300x142.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL10-150x71.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL10-250x118.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL10-380x180.png 380w\" sizes=\"(max-width: 538px) 100vw, 538px\" \/><\/figure>\n\n\n\n<p>Type some numbers for the reference number, then click OK. Finally, place this text on the label by right-clicking the variable name, and select \u201cAdd Rule &gt; Place Text\u2026\u201d:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"397\" height=\"198\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL11.png\" alt=\"\" class=\"wp-image-7453\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL11.png 397w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL11-300x150.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL11-150x75.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL11-250x125.png 250w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL11-361x180.png 361w\" sizes=\"(max-width: 397px) 100vw, 397px\" \/><\/figure>\n\n\n\n<p>Give the rule a name, such as \u201cRule ReferenceNumber\u201d, and click OK. Type \u201c1500\u201d in the Horizontal Position, and \u201c1900\u201d in the Vertical Position (these values are in deci-points, with 720 deci-points to an inch), then click OK:<\/p>\n\n\n\n<figure class=\"wp-block-image\"><img decoding=\"async\" loading=\"lazy\" width=\"352\" height=\"173\" src=\"https:\/\/alt2.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL12.png\" alt=\"\" class=\"wp-image-7454\" srcset=\"https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL12.png 352w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL12-300x147.png 300w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL12-150x74.png 150w, https:\/\/c002.minisoft.com\/support\/wp-content\/uploads\/2019\/05\/ZPL12-250x123.png 250w\" sizes=\"(max-width: 352px) 100vw, 352px\" \/><\/figure>\n\n\n\n<p>Notice this text now appears in a Courier New font (the default font, which you can change), above the \u201cDC#:00875\u201d on the label.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Conclusion<br><\/h2>\n\n\n\n<p>You have now seen how eFORMz can accept a ZPL file as input, and bring in all the text, lines, barcodes, and boxes defined in the label. You can define variables from data on the label, add your own output to the label and much more. We haven\u2019t shown how you can <a href=\"\/support\/index.php\/conditionally-suppressing-data\/\">hide portions of the incoming label<\/a>, <a href=\"\/support\/index.php\/conditionally-suppressing-data\/\">move rectangular sections<\/a> to be in a different location on the output, <a href=\"\/support\/index.php\/change-the-font-on-a-form\/\">change the font of text<\/a> on the label and more.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>To follow along with this tutorial on importing ZPL, download the following: ZPL Input Sample Many different types of files can be used as input to eFORMz, including PDF, text, XML, captured print spool files such as those going to a PCL 5 printer, or label files such as ZPL files. The Zebra Printer Language [&hellip;]<\/p>\n","protected":false},"author":15,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[124],"_links":{"self":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/7440"}],"collection":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/users\/15"}],"replies":[{"embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/comments?post=7440"}],"version-history":[{"count":3,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/7440\/revisions"}],"predecessor-version":[{"id":8264,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/posts\/7440\/revisions\/8264"}],"wp:attachment":[{"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/media?parent=7440"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/categories?post=7440"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/c002.minisoft.com\/support\/wp-json\/wp\/v2\/tags?post=7440"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}