XAF-BI.Dashboard模块概述 web/win

Dashboard模块介绍了在ASP.NET XAF 和 WinForms 应用程序中简单的集成 DevExpress Dashboard控件的方法。

其实不仅仅是控件，利用了现有的XAF数据模型，这是非常关键的。

小贴士

XAF中带了示例程序了。默认情况下，在你本机的 %PUBLIC%\Documents\DevExpress Demo 16.2\Components\eXpressApp Framework\FeatureCenter。web版本的也有： http://demos.devexpress.com/XAF/FeatureCenter/。

Dashboards 模块能干点啥

最终用户：

在运行时创建Dashboard并保存他们。Dashboard存储在数据库中。

在列表视图中查看和修改中的Dashboard，可以在导航中显示Dashboard项目。

开发人员：

预定义Dashboard,程序发布后，就可以直接看到结果了。

创建导航中创建Dashboard项目。

自定义仪表板的控制选项和行为。

注意

不要把 DashboardView 把Dashboard搞混了，他们俩是不同的东西，DashboardView是将XAF中的几个视图显示在一个界面中，和Dashboard没有一毛钱的关系。

Dashboards 模块使用的控件

DashboardDesigner - 在winform中使用了这个控件。

DashboardViewer - 在winform中使用了这个控件.
ASPxDashboard - 在asp.net中使用了这个查看结果.

上面这几行只是告诉你用了什么，实际上如果不做定制个性化扩展开发，并不需要了解这个。

Dashboards 模块组件

如果你是老项目升级过来的，需要把这些模块拖到对应的项目中去。

DashboardsModule - 在Module Designer中拖这个到xxx.Module项目中去.
DashboardsWindowsFormsModule - 拖这个到xxx.Module.Win或winapplication中.
DashboardsAspNetModule -拖这个到xxx.Module.Web或webApplication中.

Note

新建的项目，可以直接选择这个模块的，不需要上面的拖拽步骤.
如果想用代码方式进行填加可以将模块类型填加到： XafApplication.Modules 或 ModuleBase.RequiredModuleTypes (当然你得先填加引用文件).

Dashboards 模块提供了下面的View Items 可以将dashboard显示到detailview或dashboardview中.

Dashboards 扩展了应用程序模型（ Application Model ）- IModelDashboardNavigationItem 结点，为IModelClass类新增加了 IModelClassDashboardsVisibility.IsVisibleInDashboards 属性。

几个意思呢：在xafml的bo上面上，可以设置 IsVisibleInDashboards属性，设置为true时，在创建dashboard时，才能选到这个类型。就像报表模块一样。

Dashboard 数据类型

Dashboard的数据是保存到数据库的（ORM实体实现的），如果你使用了XPO，这是自动的，不用想这个事就行了。如果你使用的是EF,需要手动的设置一下，给DashboardsModule.DashboardDataType 设置类型就行了。

同时要将类型填加到DBContext．

如果你要实现自己的保存数据实体类，可以继承自DashboardData或实现IDashboardData 接口。弄好后还要设置上面说的DashboardsModule.DashboardDataType为你的类型。

Winform中运行时创建,查看和编辑Dashboards

在航中，打开Report那个分组，选中 Dashboards 项目，并点击 New.

注意
如果你不能找到 Reports | Dashboards 导航项目,可能是上面讲的拖拽的事你没干。并且 DashboardsModule.GenerateNavigationItem 也要设置成True.
执行 Data Source Wizard, 选择 XAF Object Data Source 点击Next.
这里要选择一个业务模型（BO），然后按 Finish.

注意
在下拉框中,你可以看到使用了 DefaultClassOptionsAttribute 或 VisibleInDashboardsAttribute 的BO，或在ＸＡＦＭＬ中设置了 IModelClassDashboardsVisibility.IsVisibleInDashboards 为true的BO.
执行 Dashboard Designer.

重要
在dashboard中显示枚举类型本地化（汉化）,填加计算字段到数据源类.设置 IModelMember.Expression 为 GetEnumCaption([Enum Property]).在设计器中,绑定项目到这个计算字段在枚举字符。
之后， dashboard 被保存了,在 Dashboards 列表中，你可以双击去查看.