You are here:

Environment variables used for converting classic forms

This chapter describes environment variables that influence the conversion from classic (.per) forms to .fm2.

These variables must be set before the form is converted.

LYCIA_PER_CONVERT_CALENDAR

Specifies whether a widget of the DATE data type must be converted into a Calendar:

LYCIA_PER_CONVERT_CALENDAR=1

If LYCIA_PER_CONVERT_CALENDAR is not set, then it is treated as set to true.

Possible values and their meaning:

{1, 0} or {true, false} or {yes, no}

LYCIA_PER_CONVERT_CHECKBOX

Specifies what values must be converted into the options of a new CheckBox:

LYCIA_PER_CONVERT_CHECKBOX="'Yes', 'No'; 'Retry'; 'Cancel'"

Possible values and their meaning:

Variable value is a list of character strings which stand for one or more "checked", "unchecked" pairs.

"checked" and "unchecked" values must be separated by a comma (,), and pairs are separated by a semicolon (;):

LYCIA_PER_CONVERT_CHECKBOX="'checked1', 'unchecked1'; 'checked2', 'unchecked2'; 'unchecked3'; 'checked4'"

LYCIA_PER_CONVERT_COMBOBOX

Specifies what maximum number of items defined in the INCLUDE attribute can be converted into one ComboBox:

LYCIA_PER_CONVERT_COMBOBOX=50 (default)

Possible values and their meaning:

{any integer}

If LYCIA_PER_CONVERT_COMBOBOX is zero or negative, then the INCLUDE attribute will NOT be implicitly converted to a ComboBox.

LYCIA_PER_CONVERT_SPINNER

Specifies whether a widget with the INCLUDE attribute that contains a range (e.g., INCLUDE = (1 TO 10)) must be converted into a Spinner:

LYCIA_PER_CONVERT_SPINNER=1

If LYCIA_PER_CONVERT_SPINNER is not set, then it is treated as set to false.

Possible values and their meaning:

{1, 0} or {true, false} or {yes, no}

LYCIA_PER_CONVERT_TEXTAREA

Specifies whether a widget with attributes WORDWRAP, WORDWRAP COMPRESS, or WORDWRAP NONCOMPRESS must be converted into a TextArea:

LYCIA_PER_CONVERT_TEXTAREA=1

If LYCIA_PER_CONVERT_TEXTAREA is not set, then it is treated as set to true.

Possible values and their meaning:

{1, 0} or {true, false} o{yes, no}

LYCIA_PER_CONVERT_TAB_CHAR_SIZE

Specifies the number of spaces for TAB character conversion during .per to .fm2 form conversion.

LYCIA_PER_CONVERT_TAB_CHAR_SIZE=4 (default)

If LYCIA_PER_CONVERT_TAB_CHAR_SIZE is not set, then it is treated with the default value.

Possible values and their meaning:

{any integer}

LYCIA_PER_CONVERT_KEEP_COLUMN_SEQUENCE

Makes the table column sequence identical to the screen record sequence.

LYCIA_PER_CONVERT_KEEP_COLUMN_SEQUENCE=false (for qform)

Possible values and their meaning:

{false}

Usage example:

In the .per form below, the filed table sequence is different from the screen record sequence

DATABASE formonly

screen
{
[f001   |f002   ]
[f001   |f002   ]
}

attributes
f001 = formonly.f001;
f002 = formonly.f002;
instructions
screen grid scr1[2] (f002,f001)

If LYCIA_PER_CONVERT_KEEP_COLUMN_SEQUENCE is set to false, the .fm2 form will have first table column f002 and second table column f001