是MAP-S不ys-DG-应用开发者指导手册.docx

应用开发者指导手册 项目名称：MAP应用框架 MAP 作者 说明 日期 版本 Mike 2013-10-1 1.0 目录 概述 2 C#命名规范 2 T-Sql命名规范 2 客户端界面项目创建步骤 3 客户端界面项目注册步骤 5 客户端类库项目创建步骤 8 服务器端类库项目创建步骤 9 开发默认规则 11 典型开发案例 12 Demo工作流设计 13 Demo出差申请 13 角色 13 流程图 14 流程说明 14 界面原型 15 Demo报价单评审 15 角色 15 流程图 17 流程说明 17 界面原型 17  概述 对于使用MAP开发界面或服务的开发人员，可通过学习本指导手册了解应用服务器端和客户端框架，掌握开发界面和服务的开发技巧，并了解命名规范。 开发前请按文档【MAP-Sys-DG-VS2010开发环境安装设置指导.docx】中的说明安装好VS2010开发环境和方案。 C#命名规范 ? 类名，方法名，成员变量名，属性名，委托名，枚举名均采用首字母大写英文命名； ? 类名不要使用名词复数形式应使用单数形式； ? 方法内部变量用小写字母tmp开头； ? 方法输入参数用小写字母the开头； ? 接口名用I开头； ? 常量名用大写英文字母，个单词间用_连接，也可用和常量值一样字符作为常量名； ? 服务器端项目或客户端类库项目的项目名，程序集名和命名空间应相同，使用【应用英文简称.Xxx.Xxx】模式命名 ? 客户端界面项目名，程序集名和Xap文件名，使用【应用英文简称XxxV001】模式命名，每次对已发布版本的修改可新建项目，名字改为V002，V003，命名空间建议都用Client.App T-Sql命名规范 ? 数据库名采用全大写字母 ? 表名，字段名，视图名，存储过程名，标量值函数名，表值函数名均使用首字母大写英文命名，并使用其所属应用的英文简称为前缀 ? 视图采用V，V1，V2等作为后缀 ? 表函数采用FV，FV1，FV2等作为后缀 ? 数据库Job采用_Job作为后缀 ? 存储过程等的参数采用@p_作为前缀，内部变量使用@tmp作为前缀 ? 表名不要使用名词复数形式，应使用单数形式； ? 各表主键字段建议采用XxxID命名，类型为nvarchar(100) not null，T-Sql中使用lower(replace(newid(),-,))获取唯一标示符。C#中使用GuidUtl. NewGuid获取唯一标示符； ? 主键索引名用【表名_PK】命名，唯一索引名用【表名_U1,2,3…】命名，非唯一索引名用【表名_N1,2,3…】命名 客户端界面项目创建步骤 以开发DemoTravelRequestV001项目为例，说明界面项目开发步骤 ? 复制DemoSampleV001，命名为新界面项目名DemoTravelRequestV001 = ? 打开项目目录，将.csproj，.csproj.user两个文件名改为DemoTravelRequestV001 = ? 在VS2010中打开解决方案D:\MAP\Code\ MAP.sln,通过鼠标右键选择【添加-现有项目】，打开DemoTravelRequestV001目录下的DemoTravelRequestV001.csproj项目文件 ? 打开AssemblyInfo.cs，修改Guid为任意新的Guid，推荐在sql server数据库执行select lower(newid())，即可得到一个新的Guid,你还可以修改其他assembly信息为你需要的字符 ? 点击项目右键属性，打开项目属性界面，将程序集名称修改为DemoTravelRequestV001，将Xap文件名也修改为DemoTravelRequestV001.xap 在MAP.Web项目中复制DemoSampleV001.htm，并命名为DemoTravelRequestV001.htm，打开新复制的文件，修改value=ClientBin/DemoSampleV001.xap为下图的值 ? 对于开发新应用的第一个界面时，还应复制MAP.Web的MCfg下的DemoResource_ZHS.Xml文件为[新应用英文简称Resource_ZHS.Xml]文件，并修改其DBName，SysFileDBName，SysFileTableName为适合的值。 ? 新项目已经创建完毕，可进行程序开发 客户端界面项目注册步骤 以注册DemoTravelRequestV001项目为例，说明界面项目注册步骤，注册成功后，用户即可从应用中心订阅应用，并打开应用，从应用菜单访问各功能界面。 ? 开发完毕后，可以按下图注册程序，功能，菜单，角色，并将角色分配给应用 ? 功能参数可按每个界面的功能设计自由设定，