iwf_frm_ref

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


Parameters:

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

Parent entity
Name of the entity you specified as parent entity for the relation. 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 parent 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 parent entity as parameter.

Child entity
Name of the entity you directed the relation to. You can only specify entities you already related as child entity to the parent entity.

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

Form
Name of the refine list of the relation between parent and child entity. Only specify lists containing elements of the relation table. You can only specify a list 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 refine 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.