Manage references

This page refers to Labeljoy 5, which is not the latest release!

Please upgrade to Labeljoy 6 to get the latest version of the software with all its amazing features, or go to Labeljoy 6 user guide if you already own it.

manage references

In elements of type Text and Page element you can concatenate the text with one or more references:

By clicking the Reference button, a context menu will be shown listing 18 types of references managed by Labeljoy (13 for page elements).
By selecting a reference name, it will be added to the text in the form of an active link.

Reference concatenation is only available in the Full and Basic version or when in trial mode.

The references added to the text will be shown as active links with a pink background and delimited by curly braces.
By clicking the active links, a popup window will be shown to enable you to define additional properties.

The Modify reference form enables you to modify the following properties:

  • Reference: definition of the reference selected when the item was created.
    The available references are:

    • Current page: shows the page number on which the element is.
    • Total pages: shows the total number of pages of the current job.
    • First label on page: shows the number of the first label on the page. For example, if the current layout is made up of 24 labels, page 1 will show 1, page 2 will show 25, page 3 will show 49, etc.
    • Last label on page: shows the number of the last label on page. In the case of a 24-label layout, page 1 will show 24, page 2 will show 48, page 3 will show 72 and so on.
    • Total labels: shows the total number of labels including all groups.
    • File path and title: shows the path and the name of the current file. If the job is new and hasn't yet been saved, the text will be blank.
    • File title: the file title without the path. If the job is new and hasn't yet been saved, the text will be blank.
    • Layout brand: brand of the layout in use, as entered in the Advanced tab of the layout management form.
    • layout description: description of the layout in use, as entered in the Advanced tab of the layout management form.
    • Layout model: model of the layout in use, as entered in the Advanced tab of the layout management form.
    • Current date/time: current date and time. use the Format combo box to customize the appearance.
    • PC name: Windows PC name.
    • User name: Windows user name.
    • Column: layout column on which the label is (this reference is not available for page elements).
    • Row: layout row on which the label is (this reference is not available for page elements).
    • label number: label number since the beginning of the group (this reference is not available for page elements).
    • Group name: group name as entered in the Main tab of the group properties window (this reference is not available for page elements).
    • Modulo-10 Checksum: adds a modulo-10 check sum to the number sequence immediately preceding, computed according to the EAN/UPC/GS1 Modulo-10 algorithm. For example, if added right after the sequence 123456789 it will turn it into 1234567895 where 5 (the last digit) is the proper Modulo-10 check digit. This reference works only if placed right after a numeric sequence. Non-numeric characters reset the computation. For example if used in the sequence 12345-6789{Modulo-10 Cheksum} the computation will only take into account the digits 6789, the numeric sequence immediately preceding the reference.
  • Format: format to be applied to the value read from the value (optional). For example, if the reference contains a date, you will be able to define the textual format, such as mm/dd/yyyy to show a date in the 11/28/2012 format, or by entering dddd mmmm d yyyy you will obtain the text Wednesday November 28 2012.
    You can select a predefined format from the list or enter a custom format.
    In case the reference is the Modulo-10 Checksum, the format is not taken into account.

The option Show this form when adding new items if enabled will make this window automatically popup right after a new reference is added to the text.

Note:
The concatenated text can include the same reference as many times as needed and each instance can have its own unique format, independent from all other instances of the same reference.