virtualInfoAreaReadMode

Information on the use of Virtual Info Areas in ReadMode.

Use the virtualInfoAreaReadMode parameter to determine whether virtual info areas are used for context menus in the result rows of queries and lists.

This setting only applies, if the context menu of the Search&List configuration is set to "Default" (respectively undefined in SearchSubList/ExpandChildren headers and ListView widgets). Otherwise the explicitly defined menu is used. For further details, see Search&List, SearchSubList, ListView Widget.

virtualInfoAreaReadMode has the following options:

  • Static: Each results row has exactly the info area (i.e. the context menu and column header) that was requested in the search/query. In this case, each row has the same context menu.

    Example: When you search for FI, the FI context menu (M_Company) is always displayed, even if the record returned matches the definition of a virtual info area.

  • Dynamic (defaul): Each results row reflects the matching (virtual or physical) info area. Therefore each row may have a different context menu (since the InfoArea default menu is displayed).

    Example: If you run a query for FI, the context menu of each FI record is the one matching the respective virtual info area.

The actual syntax for the virtualInfoAreaReadMode parameter depends on the below context:

Web Configuration parameters

To define the global behavior of lists and queries use the following Web Configuration parameters:

VirtualInfoArea.List.ReadMode

This parameter defines the default behavior for lists search results sets, SearchSubLists, ExpandChildren and ListView widgets in forms.

VirtualInfoArea.Query.ReadMode

This parameter defines the default behavior for queries (query snapshot, saved queries, queries in forms and the QueryRun action template).

Note: These parameters are not part of UPDATE_DEFAULT but need to be created as Character or Combobox if required. For further details, see Creating Web Configuration Parameters.

Search Action Template

In addition to the VirtualInfoArea.List.ReadMode Web Configuration parameter there are three possibilities to define virtualInfoAreaReadMode in a Search action:

  • Add a new parameter virtualInfoAreaReadMode to define the behavior for the result set and all sublists.
  • Define virtualInfoArea.ReadMode in listParams to define the behavior only for the result list.
  • Define virtualInfoArea.ReadMode in subListParams to define the behavior only for the sub-lists.

SearchSublist / ExpandChildren Header

In SearchSublist and ExpandChildren headers the SubListParam virtualInfoArea.ReadMode defines the behavior of the context menu per child info area.

Query Designer Action Template

There are two possibilities to define virtualInfoAreaReadMode in the Query Designer action template.

  • Use the virtualInfoAreaReadMode input argument, to define the behavior for the result set and all sub-lists.
  • Or define in virtualInfoArea.ReadMode in the listParams to define the behavior only for the result list.

QueryRun Action Template

There are two possibilities to define virtualInfoAreaReadMode in the QueryRun action template.

  • Use the virtualInfoAreaReadMode input argument to define the behavior for the result set and all sub-lists.
  • Or define in virtualInfoArea.ReadMode in the listParams to define the behavior only for the result list.

Query in Form

The QueryResultPresenter widget contains the parameter virtualInfoAreaReadMode to define the behavior of the query result list.