在上篇随笔《Winform开发框架之客户关系管理系统(CRM)的开发总结系列1-界面功能展示》中介绍了我的整个CRM系统的概貌,本篇继续本系列的文章,介绍如何基于我的《winform开发框架》的基础上进行CRM系统模块的开发工作,希望对大家在系统模块开发有所启示或者帮助。
在我整个开发框架的体系结构中,我都希望开发的业务模块尽可能重用,因此遵循这个要求,所有的模块除了一些基础模块外,尽可能和其他业务模块没有任何耦合关系,同时也可以动态对模块进行加载使用,和我在《Winform开发框架之插件化应用框架实现》的思想一样,各个模块之间可以动态组合起来,实现更多的业务整合。
1、CRM系统的工程项目介绍
本客户关系管理系统,也是基于这个目的和基础上进行模块开发,在整个项目模块开发过程中,将会利用到整个Winform开发框架的相关组件模块,包括基础界面模块、程序启动模块、权限管理模块、字典管理模块、分页控件、公用类库、附件管理等公用模块。
整个CRM系统的界面效果如下所示。
首先我们来看看CRM系统主要项目工程的布局和说明。
WHC.Framework.BaseUIDx | 重用模块。各模块的界面基类,包括通用窗体界面基类BaseUI;通用高级查询模块AdvanceSearch;通用Excel导入模块;插件化接口相关类PlugInInterface等。 |
WHC.Framework.StarterDx | 重用模块。插件化应用程序启动界面。通过用户登录后,获取用户的菜单,动态创建菜单并加载插件,该模块集成权限管理系统模块、集成字典数据管理模块、集成多文档界面控件和布局控件、集成美观实用的登陆界面、闪屏展示界面、托盘缩小提示功能、全局运行一次实例限制模块代码等内容。 |
WHC.CRM.Core | 新开发模块。客户关系管理系统的核心模块,包括业务处理、数据接口层、数据访问层、实体层等相关类。 |
WHC.CRM.UIDx | 新开发模块。客户关系管理系统的界面层,包括所系统模块的各种界面、控件等内容。 |
设计好CRM的相关数据库表后,利用C#代码生成工具Database2Sharp生成框架各层的代码,模块开始开发的时候,可以一次性把所有业务表的代码一次性生成,然后在整个新的解决方案(.sln)上进行递增式完善即可,如果是后续模块的开发,则需要增量把生成的代码,复制到相关的框架目录即可,整理后的业务逻辑层代码结构如下所示
这个时候,我们生成了界面层以下的所有分层代码,整个代码生成后,一次性即可编译通过,界面层我们另外建立一个Winform项目工程WHC.CRM.UIDx ,然后添加相关的界面引用程序集(如DevExpress的相关界面程序集)。处理完这些后,我们又可以利用C#代码生成工具Database2Sharp来实现界面的快速开发工作了,代码生成工具生成界面的操作界面如下所示,具体生成界面的操作可以参考随笔《利用代码生成工具Database2Sharp设计数据编辑界面》进行了解。
最后得到类似项目目录结构的CRM系统界面模块工程。
由于整个CRM系统包含很多界面元素,因此以上模块的界面部分只是其中一部分,如果内容较多,可以建立目录进行分类管理,这样会更加清晰。
2、CRM系统的界面层代码分析
利用C#代码生成工具Database2Sharp,可以快速生成所需要的框架界面代码,包括集成各种已有模块的界面基类、导入导出模块支持、高级查询能功能模块,各种实体类对应关系等内容,这些如果利用手工操作,效率非常低下,而且容易出错。即使利用一些代码生成工具,如果没有和现成的界面模块进行很好的整合,也需要花费大量的时间进行整理,下面通过几个界面代码的展示进行大致的了解。
1)列表显示界面的集成和分页整合
2)字典模块的整合处理(通过扩展类方法实现)
3)导入导出模块的整合
private string moduleName = "客户合同信息"; /// <summary> /// 导入Excel的操作 /// </summary> private void btnImport_Click(object sender, EventArgs e) { string templateFile = string.Format("{0}-模板.xls", moduleName); FrmImportExcelData dlg = new FrmImportExcelData(); dlg.SetTemplate(templateFile, System.IO.Path.Combine(Application.StartupPath, templateFile)); dlg.OnDataSave += new FrmImportExcelData.SaveDataHandler(ExcelData_OnDataSave); dlg.OnRefreshData += new EventHandler(ExcelData_OnRefreshData); dlg.ShowDialog(); } void ExcelData_OnRefreshData(object sender, EventArgs e) { BindData(); } bool ExcelData_OnDataSave(DataRow dr) { string customerName = dr["客户名称"].ToString(); if (string.IsNullOrEmpty(customerName)) return false; CustomerInfo customerInfo = BLLFactory<Customer>.Instance.FindByName(customerName); if (customerInfo == null) { throw new ArgumentException(string.Format("客户名称【{0}】不存在,记录已跳过", customerName)); } bool success = false; bool converted = false; DateTime dtDefault = Convert.ToDateTime("1900-01-01"); DateTime dt; ContractInfo info = new ContractInfo(); info.Customer_ID = customerInfo.ID;//客户ID info.HandNo = dr["合同编号"].ToString(); info.ExpenditureType = dr["收支类型"].ToString(); info.ContractType = dr["合同类型"].ToString(); info.ContractName = dr["合同名称"].ToString(); info.ContractMoney = dr["合同金额"].ToString().ToDecimal(); converted = DateTime.TryParse(dr["签约日期"].ToString(), out dt); if (converted && dt > dtDefault) { info.SignDate = dt; } ........................................ success = BLLFactory<Contract>.Instance.Insert(info); return success; } /// <summary> /// 导出Excel的操作 /// </summary> private void btnExport_Click(object sender, EventArgs e) { string file = FileDialogHelper.SaveExcel(string.Format("{0}.xls", moduleName)); if (!string.IsNullOrEmpty(file)) { string where = GetConditionSql(); List<ContractInfo> list = BLLFactory<Contract>.Instance.Find(where); DataTable dtNew = DataTableHelper.CreateTable("序号|int,客户名称,合同编号,收支类型,合同类型,合同名称,合同金额,公司签约人,客户签约人,签约日期,签约地点,乙方名称,合同开始日期,合同结束日期,结算情况,合同状态,关联项目,联系人,联系人电话,联系人手机,合同内容,备注说明,经办人"); DataRow dr; int j = 1; for (int i = 0; i < list.Count; i++) { dr = dtNew.NewRow(); dr["序号"] = j++; dr["客户名称"] = BLLFactory<Customer>.Instance.GetCustomerName(list[i].Customer_ID);//转义为客户名称 dr["合同编号"] = list[i].HandNo; dr["收支类型"] = list[i].ExpenditureType; dr["合同类型"] = list[i].ContractType; ...................................... dr["经办人"] = list[i].Operator; dtNew.Rows.Add(dr); } try { string error = ""; AsposeExcelTools.DataTableToExcel2(dtNew, file, out error); if (!string.IsNullOrEmpty(error)) { MessageDxUtil.ShowError(string.Format("导出Excel出现错误:{0}", error)); } else { if (MessageDxUtil.ShowYesNoAndTips("导出成功,是否打开文件?") == System.Windows.Forms.DialogResult.Yes) { System.Diagnostics.Process.Start(file); } } } catch (Exception ex) { LogTextHelper.Error(ex); MessageDxUtil.ShowError(ex.Message); } } }
4)高级查询模块的整合
private FrmAdvanceSearch dlg; private void btnAdvanceSearch_Click(object sender, EventArgs e) { if (dlg == null) { dlg = new FrmAdvanceSearch(); dlg.FieldTypeTable = BLLFactory<Contract>.Instance.GetFieldTypeList(); dlg.ColumnNameAlias = BLLFactory<Contract>.Instance.GetColumnNameAlias(); dlg.DisplayColumns = "Customer_ID,HandNo,ExpenditureType,ContractType,ContractName,ContractMoney,CompanySigner,CustomerSigner,SignDate,SignLocation,PartyBName,StartDate,EndDate,Settlement,Status,RelatedItems,Contact,ContactPhone,ContactMobile,Content,Note,Operator"; #region 下拉列表数据 //dlg.AddColumnListItem("UserType", Portal.gc.GetDictData("人员类型"));//字典列表 //dlg.AddColumnListItem("Sex", "男,女");//固定列表 //dlg.AddColumnListItem("Credit", BLLFactory<Contract>.Instance.GetFieldList("Credit"));//动态列表 #endregion dlg.ConditionChanged += new FrmAdvanceSearch.ConditionChangedEventHandler(dlg_ConditionChanged); } dlg.ShowDialog(); } void dlg_ConditionChanged(SearchCondition condition) { advanceCondition = condition; BindData(); }
5)编辑界面的基类继承
3、CRM系统的界面层的用户及权限信息传递
我们知道,每个业务模块都可能需要获取当前登录的一些用户信息和权限信息,以便达到更好的控制和数据的显示,如某些模块,可能只需要显示当前用户的数据,由于CRM系统的界面是独立开发,不整合在启动界面模块里面,那么如何获得用户和权限控制信息呢?例如下面的CRM模块里面的界面,需要根据当前用户获取到客户的分组列表的。
首先我们可以在界面基类中实现一个接口,以便传递相关的用户和权限信息。
namespace WHC.Framework.BaseUI { public partial class BaseForm : DevExpress.XtraEditors.XtraForm, IFunction {
其中IFunction的定义如下所示。
namespace WHC.Framework.BaseUI { /// <summary> /// 父窗体实现的权限控制接口 /// </summary> public interface IFunction { /// <summary> /// 初始化权限控制信息 /// </summary> void InitFunction(LoginUserInfo userInfo, Dictionary<string, string> functionDict); /// <summary> /// 是否具有访问指定控制ID的权限 /// </summary> /// <param name="controlId">功能控制ID</param> /// <returns></returns> bool HasFunction(string controlId); /// <summary> /// 登陆用户基础信息 /// </summary> LoginUserInfo LoginUserInfo { get; set; } /// <summary> /// 登录用户具有的功能字典集合 /// </summary> Dictionary<string, string> FunctionDict { get; set; } /// <summary> /// 应用程序基础信息 /// </summary> AppInfo AppInfo { get; set; } } }
其中就定义了接口进行用户和权限信息的赋值。在界面按钮构建相关模块的功能界面窗体的时候,我们可以为这些传递传递相关的对象信息。
private void barCRMContact_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) { ChildWinManagement.LoadMdiForm(this, typeof(FrmCustomerContact)); } private void barCRMCustomer_ItemClick(object sender, DevExpress.XtraBars.ItemClickEventArgs e) { ChildWinManagement.LoadMdiForm(this, typeof(FrmCustomerManage)); }
tableForm = (Form) Activator.CreateInstance(formType); tableForm.MdiParent = mainDialog; //如果窗体集成了IFunction接口(第一次创建需要设置) IFunction function = tableForm as IFunction; if (function != null) { //初始化权限控制信息 function.InitFunction(Portal.gc.LoginUserInfo, Portal.gc.FunctionDict); //记录程序的相关信息 function.AppInfo = new AppInfo(Portal.gc.AppUnit, Portal.gc.AppName, Portal.gc.AppWholeName, Portal.gc.SystemType); }
通过在构造窗体的时候,传入相关的用户和权限对象属性即可实现这些信息的传递和使用。
另外,为了更加方便信息的传递,我们也可以在用户登陆的时候,把这些信息通过Cache对象把它缓存起来,类似Web开发里面的Session功能。
我的该CRM系统系列的几篇随笔链接如下,供阅读。
Winform开发框架之客户关系管理系统(CRM)的开发总结系列1-界面功能展示
Winform开发框架之客户关系管理系统(CRM)的开发总结系列2-基于框架的开发过程
Winform开发框架之客户关系管理系统(CRM)的开发总结系列3-客户分类和配置管理实现
Winform开发框架之客户关系管理系统(CRM)的开发总结系列4-Tab控件页面的动态加载
本文转自博客园伍华聪的博客,原文链接:Winform开发框架之客户关系管理系统(CRM)的开发总结系列2-基于框架的开发过程,如需转载请自行联系原博主。