Overview tab

Use this tab to view the label name and to maintain all label variants in the primary language, such as English.

General Information

Label

The name of the label used as identification code.

Allowed values:

This field is read-only.

You can only specify the label name when you create a new label. The name must start with the code of the package for which the label is defined.

After a label is created, you cannot change its name.

Description

The description of the label, which corresponds with the longest variant description in the primary language.

Allowed values:

This field is read-only.

The value of this field corresponds with the value of the description field of the primary language variant with the longest description. This field is a read-only copy of this variant description.

All Variants in (primary language)

All Variants in

The All Variants in list contains all label variants in the primary language. Only the variant descriptions are displayed.

The Variant Properties field group displays all properties of the label variant you selected in this list.

You can add and remove label variants in the All Variants in list:

• To add a label variant, click Add and specify a Context. Then, enter the Description for the new variant in the Variant Properties field group.
• To remove a label variant, select a variant and click Remove on the variant shortcut menu.

Note: The name of this field includes the primary language of the label. For example, if the primary language is English, the name of the field will read the following: All Variants in English. The primary language is determined by the Primary Language property of the application for the current software development project.

Allowed values:

A label must have at least one variant. Labels without a variant cannot be saved.

When you create a new variant, specify the Context and Description of the variant. When you specify the variant Description, you cannot enter a text longer than 70 characters or a text that ends with a blank space.

When you enter the variant Context, select a value from a drop-down list. You can choose one of the following context values:

• General use
• Form Commands
• Cascading Item on Button

For more information on the Context and Description fields of a variant, see the Variant Properties field group.

Note: When you create a new label in the Create New Label wizard, you can specify an External Use context. These External Use labels cannot possess multiple variants. Therefore, the Add button is disabled for these labels.

Variant Properties

Context

The context of the label variant selected in the All Variants in field. This indicates how the variant is used in forms, reports, menus, and so on.

Allowed values:

Note: When you add a new variant to a label, you can choose between three contexts:

• General use
• Form Commands
• Cascading Item on Button

However, the label variants not created with the label editor, such as session description labels, can show many other context values.

These other context values are used for labels that are generated automatically.

For example:

• When you create a new enumeration for an Enumerated domain, LN Studio generates a label with the Enumerates context.
• When you create a new session, table or report, LN Studio generates a label with the Session, Table or Report Description context.

Example:

When you create a session with session code tezzzrx and session description MyNewSession, LN Studio generates a label called tezzzrx001 with label description MyNewSession.

Description

The description of the label variant selected in the All Variants in field.

This is the text that appears where this label variant is used in the following:

• forms
• reports
• menus

Allowed values:

An ASCII text with a maximum length of 70 characters.

Use a % sign to indicate the line break. If the description includes a line break, the height of the label variant is automatically adjusted to a value greater than one. To include the % sign in the description, type %%.

The maximum number of lines (height) is 3.

Example:

Description	Result	Height	Length
Item Code	Item Code	1	9
Item%Code	Item	2	4
	Code
Percentage [%%]	Percentage [%]	1	14
Perc.%[%%]	Perc.	2	5
	[%]

Note: The description of a label variant automatically sets the length, height and search argument of this label variant:

• The variant Length corresponds with the number of characters in the description's longest line of text.
• The variant Height corresponds with the number of text lines in the description.
• The variant Search Argument corresponds with the first 10 characters of the description.

Length

The length of the label variant selected in the All Variants in field. This is the maximum number of characters on a text line of the variant description.

Allowed values:

This field is read-only.

The length value is generated by the label editor. The length is automatically adjusted to a changed label variant description. For examples of how the length of a label variant is derived from the description, see the Description field.

Height

The height of the label variant selected in the All Variants in field. This is the maximum number of text lines in the variant description.

Allowed values:

This field is read-only.

The height value is generated by the label editor and corresponds with the number of text lines in the variant's Description. The height is the number of % signs in the description text raised by one, with an exception for the "%%" string, which you use to include the % sign in the label text displayed to the user.

The height is automatically adjusted to a changed variant description. For examples of how the height of a label variant is derived from the description, see the Description field.

Search Argument

The search argument of the label variant selected in the All Variants in field.

Allowed values:

This field is read-only.

The search argument is generated by the label editor and corresponds with first 10 characters of the variant's Description, including the % signs. The search argument is automatically adjusted to a changed variant description.

Note: The label editor changes lowercase characters to uppercase characters.

Expired

If this check box is selected, the label variant selected in the All Variants in field has expired.

Expired label variants cannot be used in the release (VRC) of the application of the current development project or any releases derived from it.

When all label variants are expired, the label becomes expired.

Note: If only one variant exists, this check box is disabled. In that case, you can expire the label in the Activity Explorer.