Preparing payload using GetLPSArtifacts

The Conversion Service relies on the ZIP file prepared with the tool GetLPSArtifacts. The tool is designed to run on the customer’s system where LPS is installed. The tool will collect the LPS-related data and LWL label templates found in the default location "c:\Program Files (x86)\Loftware Labeling\LABELS".

Caution

The GetLPSArtifacts tool will collect label templates from a default location. They will not be included when you store label templates in some alternative location (e.g., network drive).

The ZIP file generate by GetLPSArtifacts contains many artifacts, but the Conversion Service only uses files from the following folders:

  • Labels. This is a mandatory folder. LWL files are used from here.

  • Images. This is an optional folder. The images are only used during the generation of label previews.

  • Jobs\Printed. This is an optional folder. The command files are used from here (such as PAS or XML files) for the following purpose:

    • To generate a list of label templates ordered by the frequency of their printing. The most-used label template is on top. This can give you a sense of urgency - which label templates must be refined first.

    • To generate label previews with real data from the past print requests.

  • Layouts. This is a mandatory folder, only when your label templates use page formatting. The layout definition files determine how the templates fit on pages (A4, Letter).

Preparing to convert a selection of labels, images or layouts

If you have a selection label templates, images or layouts to migrate, you can collect these  without using the GetLPSArtifacts script. You can choose to follow these steps for just labels, or images or layouts or any combination of the 3 types of artifacts.

Perform the following steps to gather label templates, images or layouts for conversion, omitting all other types of LPS artifacts.

  1. Create a staging folder named Labels for the label templates that you want to convert. The folder must be named “Labels”.

    • If you also have a set of images to convert, create a staging folder named Images for the images you want to convert. The folder must be named “Images”.

    • If you also have a set of layouts to convert, create a staging folder named Layouts for the layouts you want to convert. The folder must be named “Layouts".

  2. On your LPS server, navigate to the folder where label templates (*.lwl files), or images or layouts are stored. This location is typically in a folder such as the following "c:\Program Files (x86)\Loftware Labeling\LABELS".

  3. Copy the label templates (*.lwl files), and/or images, and layouts that you want to convert into the Labels folder, and/or Images folder and/or Layouts folder that you created.

  4. Using a utility of your choice that produces a *.zip file, zip the Labels, Images and/or Layouts folders. Ensure that the folder structure within the zip file is maintained so that the top-level folders in the zip file are the Labels, Images and/or Layouts folders.