C#教程之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中.

• WinDashboardViewerViewItem
• WebDashboardViewerViewItem

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 列表中，你可以双击去查看.

  

注意

在winform程序中，你可以访问在ASP.NET中建立的dashboard，因为都是一个库！

• 下图展示了如何修改存在的dashboard.

  

  在上下文菜中也有.

  

 

 

在ASP.NET Application中创建, 查看和编辑 Dashboards 

 

• 和win是一样的，只是长得不太一样.

  
   

• 创建

  
   

• 开始设置

  
   

• 保存之后

  

注意

同样的，你可以看到win中创建的dashboard.

• 编辑现有的.