About Master-Detail Forms in JClient

A master-detail relationship is an association between two or more view objects defined in a Business Components data model. You can generate JClient forms which rely on those master-detail relationships. The values in the master form determine which detail records will be displayed.

Within a Business Components data model you can define the following types of master-detail relationships:

Master form to detail form
Master form to multiple detail forms
Cascading master-detail relationships (master-detail-detail forms)

The easiest way to generate this type of JClient form is launch the JClient Form wizard and choose the Master-Detail Tables option in the wizard. When you are finish the wizard, your project will contain:

A main frame that contains the JClient bootstrap code
A master data panel that displays the master view object data
A detail data panel that displays the detail view object data
A master-detail data panel that is used to parent the individual master and detail data panels

By default, both data panels will contain their own navigation bar. The navigation bar displayed in the master data panel lets users navigate the rows of the master rowset while viewing the accompanying details in the detail panel. Whereas, users navigate the detail data panel to see individual rows bound to the current master.

You can force the JClient Forms wizard to generate a master-detail form with a single navigation bar by setting a JClient code generation preference in the Tools | Preferences dialog. Creating a JClient form with only one navigation bar looks visually cleaner, but requires the user to change focus between the data panels to navigate the desired rowset.