Skip to main content
Version: 4.x

SHOW operator

The SHOW operator creates an action that opens a form in interactive view.

Syntax​

SHOW name 
[OBJECTS objName1 = expr1 [NULL], ..., objNameN = exprN [NULL]]
[formActionOptions]

When opening the list/edit form, the syntax is slightly different:

SHOW classFormType className
= expr [NULL]
[formActionOptions]

formActionOptions is the options for this action. They can be added one by one in any order:

syncType
windowType
MANAGESESSION | NOMANAGESESSION
NEWSESSION | NESTEDSESSION
CANCEL | NOCANCEL
READONLY

Description​

The SHOW operator creates an action that opens the specified form. When opening the form in the OBJECTS block, initial values can be specified for Form structure form objects.

Parameters​

  • name

    Form name. Composite ID.

  • classFormType

    Keyword. Determines which form to open:

    • LIST – list
    • EDIT – edit

  • className

    The name of the user class whose list/edit form is to be opened. Composite ID

  • objName1 ... objNameN

    Names of form objects for which initial values are specified. Simple IDs.

  • expr, expr1 ... exprN

    Expressions which values determine the initial values for form objects.

  • NULL

    Specifies that the values passed may be NULL.

Options​

  • syncType

    Determines in which flow control mode the operator will work:

    • WAIT - synchronous. Used by default.
    • NOWAIT - asynchronous.

  • windowType

    Method of the form layout:

    • DOCKED – as a tab. Used by default in asynchronous mode.
    • FLOAT - as a window. Used by default in synchronous mode.

  • MANAGESESSION | NOMANAGESESSION

    Keywords. Determine whether or not the created form is considered to be the owner of the session (if so, in interactive mode the corresponding buttons for managing the session will be shown on the form). By default, the platform tries to determine which mode to use automatically depending on the context.

  • CANCEL | NOCANCEL

    Keywords. Determine whether or not to show the "Cancel" system action (System.formCancel) on the form. By default, the platform tries to determine which mode to use automatically depending on context.

  • NEWSESSION | NESTEDSESSION

    Keywords. Determine that the form will be opened in a new (nested) session. By default, the form is opened in the current session.

  • READONLY

    Keyword. If specified, the form is opened in read-only mode.

Examples​

date = DATA DATE (Order);
FORM showForm
    OBJECTS dateFrom = DATE, dateTo = DATE PANEL
    PROPERTIES VALUE(dateFrom), VALUE(dateTo)

    OBJECTS o = Order
    FILTERS date(o) >= dateFrom, date(o) <= dateTo
;

testShow ()  {
    SHOW showForm OBJECTS dateFrom = 2010_01_01, dateTo = 2010_12_31;

    NEWSESSION {
        NEW s = Sku {
            SHOW sku OBJECTS s = s FLOAT;
        }
    }
}