iwf_frm_agg

Creates the defined aggregate form of the relation and displays it on the screen.


Parameters:

[child entity [parent entity view [form]]]

Child entity
Name of the entity you directed the relation to. If you want to use the userexit in items of object dependent menus (e.g. in Select menus), you will not have to specify the child entity as parameter, because DataView reads the entity name from the active widget. If you want to use the userexit in items of object independent menus (e.g. in sub-menus at the top menu), you will have to specify the child entity as parameter.

Parent entity
Name of the entity you specified as parent entity for the relation. You can only specify entities you already related as parent entity to the child entity.

View
Name of the view to the parent entity of the relation. You can only specify views you already defined for relations of the calling parent entity. You can only specify a view together with the parent entity. If you do not specify a parent entity and a view, DataView creates a sub-menu with all relations you already created in your application at the child entity.

Form
Name of the aggregate form of the relation between child and parent entity. Only specify forms containing elements of the relation table. You can only specify a form together with the view. Because it is not possible in DataView to create default forms for relations during model definition, you first have to create the aggregate form in the mask definition list, before you can enter it here as parameters..


Usage as:

On_Select userexit in each menu/button-area or On_Event userexit in each state of the user interface.


Explanation:

If you invoke the userexit in the Select menu of a list, i.e. at the selected record, DataView will fill only the fields of the form with the current data if you defined either no userexit or the wdh_upd_lis userexit at the pre_mask-trigger of the form. Each other Pre_Mask userexit prevents that the data of the selected record are displayed. You will then have to start a new query using the standard functions refresh or query to fill the form with data. However, the relation to the selected, calling record will be lost.