在上篇随笔《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 = ;
for (int i = ; 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-基于框架的开发过程