Labels

1. Studio download and installation

JasperSoft is the software used to create its own labels. 

1. Please take the final version 6.17.0: https://community.jaspersoft.com/community-download
2. Download and install the version. For the jaspersoft installation process, see "JasperSoft Installation".

2. Create a label

2.1 Search for XML for testing

Go get an XML to have the attributes that will be on your label. 

Here's how to do this: 

1. Go to " Administration";
2. Go to "Manage Printables";
3. Then open the "Label Management";
4. Open the "Folder Labels" tab;
5. Select "Get a test XML file";
6. Search for a document or documents in the "Selection of document(s)" and press "Add";
7. Tap on "Save";
8. An XML file will be downloaded to your computer. You can watch the content of your XML with software like "Notepad++" or simply with a browser.

2.2 Create your label project on JasperSoft studio

1. Open the JasperSoft studio;
2. Make Files -> New -> JasperReport;
3. In the template choices, take Blank Letter. Click "Next";
4. Choose the name of your jrxml file and the location of the project in your workspace. Click "Next";
5. Create a new adapter;
6. In the window of the creation of the adapter, take XML document and click " next ";
7. Give a name, choose where the file created in XML in the previous chapter is located and choose the " Xpath expression" option;
8. Click " Finish ";
9. Scroll down the tree and choose metadata (double click). Click " Next ".
   (Or finish if you want all the elements of the XML to be accessible and you don't need the order of the documents to generate the printable).
   Click " Next ".
10. Choose the elements and the element for the order of the documents. Click " Finish ".

2.3 The form of the project on the label

2.3.1 DYMO Printer Label

I take example on a label 1 1/4'' x 2 1/4'' (32 mm x 57 mm)

1. Click in a corner of the project;
2. In the properties window, go to " Edit pag e format";
3. I put the units in " mm ". So 57 mm width, 32 mm height. The margins should be about 5 mm or less (not zero though);
4. Press " Ok ";
5. Get rid of all tapes except "detail 1".

2.3.2 Label of an Avery sheet

I take example on an Avery 5162 labels 1-1/3" x 4", 14 per page (34 mm x 102 mm)

1. Click in a corner of the project;
2. In the properties window, go to " Edit Page Size ";
3. I put the units in " mm ". The width and height remain in standard blank letter size. The margins should be about 5 mm or less (not zero though);
4. Set the display order to " horizontal ";
5. Set Columns to " 2 ";
6. Tap " Ok ";
7. Clear all stripes except " Detail 1 " and " Page Header ";
8. " Detail 1 " should be about 34 mm high and " Header " should be about 20 mm. (Click on the tape, the properties are displayed at the bottom right. Appearance will have the height of the strip.)

2.3.3 Label elements

1. First, frame the display area of your metadata fields. Use the frame element of the palette;
2. Framing it will limit the display borders of the elements in the label. You need to put a display expression too. In " frame property ", put the following line: "$F{id}!=null";
3. You put the items that should appear on the document label. You can change the character, place them as you want, etc.;
4. Don't forget to save (Ctrl+S) and save your project;
5. In the Design window, there is a tab called "Preview". In the preview toolbar, there is a record icon;
   Press the arrow next to it to be able to save as optional PDF, Excel, Words, etc.;

2.3.4 Jasper File

1. Go to Project -> Build All;
2. A Jasper file will be created in your working folder of the labels chosen at the beginning of the project (where the .jrxml project file is located);
3. Go to your Constellio. Return to the label management page of a printable document and click " Add Label ";
4. Fill in the fields and add the Jasper file;
5. Press " Save ".

You can print document labels now. 

3. Printing a label

1. Consult a document, file or container;
2. Click on the actions on the record, then select " Print Label ";
3. This page will appear. Choose the starting position of your label, the number of copies, and then the label format of your choice;
4. Click on " Generate ". This will generate a PDF page where you can print your label page on the printer of your choice.