Satellite Sessions tab

If the session is a multi-main table (MMT) controller session, use this tab to maintain the MMT satellites for the session.

The fields of this tab are only enabled for sessions that have Window Type Multi Main Table specified and Session Type Maintain.

An MMT session is a combination of multiple sessions, each having their own main table. It is used to present data with a typical parent-child structure. For example, a Sales Order and the related Sales Order Lines.

The window of an MMT session consists of two parts:

  • The multi-main table controller session is a maintain session for the main entity, such as a Sales Order. The form of this session determines the upper part of the session.
  • The lower part displays satellite sessions with child information, such as Sales Order Lines. At runtime, the satellite sessions are shown as tabs.

See Multi Main Table sessions.

All Satellite Sessions
This field contains the records of all satellite sessions linked to the current multi-main table (MMT) controller session. Only a MMT controller session can have satellite sessions.

The satellite sessions are child sessions of the MMT controller session, such as the Order Lines session is a satellite session of the Order Header session.

The satellite session records show two attributes:

  • The Session attribute (the session's name)
  • The Description attribute

To add a satellite session:

  1. Click Add.
  2. In the Session field in the grid, press CTRL+SPACE to start a dialog where you can select satellite sessions.
  3. Select the desired satellite session and click OK. The satellite session is displayed in the grid.

    You can only select sessions that have the List Window window type.

  4. Select the satellite session in the grid and define the field mapping.

To remove a satellite session record, select a record and, on the shortcut menu, select Remove.

To change the order of the satellite sessions, move them up or down the list.

Name
The name of the satellite session.
Allowed values:

Press CTRL+SPACE and select a name from the select dialog. This dialog shows the names of all available sessions.

Description
The description of the satellite session.
Allowed values:

This field is read-only. LN Studio automatically fills in the satellite session description after you specified the Name of the satellite session.

Field Mapping
This field contains the field mapping records which map the fields of the multi-main table (MMT) controller session with the corresponding fields of its child satellite sessions. The records define a mapping for the satellite session marked in the All Satellite Sessions field.

The field mapping records consist of two attributes:

  • The Field in MMT Session attribute, which specifies the name of the field in the parent MMT session
  • The Field in Satellite Session attribute, which specifies the name of the corresponding field of the satellite session

For example, the Order Number field of an Order Header session (MMT session) corresponds with Order Number field of its child Order Lines sessions (satellite session).

To add a field mapping record, click Add and select the desired field names.

To remove a field mapping record, right-click a record and select Remove.

Note: The field mapping records define a mapping between the parent MMT session and one of its satellite sessions. You can compare such a field mapping with a foreign key of a record that points to the primary key of a referenced record. Similarly, the Field in Satellite Session field of the satellite session forms a pointer to the Field in MMT Session identification field of the main MMT session.
Field in MMT Session
The name of the field of the multi-main table (MMT) controller session.

Usually, the field of the main MMT session you specify here corresponds with the identification of the involved session records (business objects).

Allowed values:

To specify this attribute, select a field name from the drop-down list. This list contains the names of all available fields of the MMT controller session.

Field in Satellite Session
The name of the field of the satellite session.

Usually, the field of the satellite session you specify here corresponds with the identification field of the main MMT session.

Allowed values:

To specify this attribute, select a field name from the drop-down list. This list contains the names of all the fields of the satellite session that is marked in All Satellite Sessions field.