Skip to content

MasterDetail

Apostolis Bekiaris edited this page Aug 12, 2019 · 44 revisions

GitHub issues GitHub close issues

About

The MasterDetail module can help you create platform agnostic master detail XAF views using only the Model Editor.

Installation

  1. First you need the nuget package so issue this command to the VS Nuget package console

    Install-Package Xpand.XAF.Modules.MasterDetail.

    The above only references the dependencies and nexts steps are mandatory.

  2. Ways to Register a Module or simply add the next call to your module constructor

    RequiredModuleTypes.Add(typeof(Xpand.XAF.Modules.MasterDetailModule));

Versioning

The module is not bound to DevExpress versioning, which means you can use the latest version with your old DevExpress projects Read more.

The module follows the Nuget Version Basics.

Dependencies

.NetFramework:

DevExpress.Data Any
DevExpress.ExpressApp Any
Ryder 0.8.0
System.Reactive 4.1.6
System.ValueTuple 4.5.0
Xpand.XAF.Modules.Reactive 1.2.46
Xpand.VersionConverter 1.0.34

Issues-Debugging-Troubleshooting

To Step in the source code you need to enable Source Server support in your Visual Studio/Tools/Options/Debugging/Enable Source Server Support. See also How to boost your DevExpress Debugging Experience.

If the package is installed in a way that you do not have access to uninstall it, then you can unload it with the next call when XafApplication.SetupComplete.

((Xpand.XAF.Modules.MasterDetailModule) Application.Modules.FindModule(typeof(Xpand.XAF.Modules.MasterDetailModule))).Unload();

Details

The module satisfies the following conditions:

  1. If a DashboardView contains a one ListView and one DetailView of the same type, then it will be Master-Detail enabled by default. It can be disabled by setting the IModelDashboardViewMasterDetail.MasterDetail to false.

    image

  2. Each time a ListView selection change, it will synchronize the DetailView CurrentObject with the selected from the ListView.

  3. ALL CRUD operations are supported. A valuable module for forcing the DetailView to open in edit mode is the ViewEditModeModule. Additionaly you can use the [AutoCommitModule](https://github.com/eXpandFramework/DevExpress.XAF/tree/master/src/Modules/Agnostic/AutoCommit, for auto commiting the DetailView.

  4. Conditional detailviews can be configured from the model by creating IModelMasterDetailViewObjectTypeLinks

    image

Tests

The module is tested on Azure for each build with these tests

Examples

The module is integrated with the ExcelImporter, XtraDashboard modules.

Next screenshot is an example from ExcelImporter from the view tha maps the Excel columns with the BO members.

image

You can’t perform that action at this time.