工业管理软件物料功能开发案例-实训指导书

工业管理软件物料功能开发案例实训指导书一、实训目的本课程的教学目的是让学生掌握工业管理软件物料功能的开发流程和关键技术。从系统的需求分析出发，了解到开发需要实现和满足的实际业务功能点；然后根据功能点之间的逻辑关系，使用Modelfirst工具绘制UML关系图。再根据每一个功能点，绘制对应的功能界面以及使用VisualStudio2019及以上开发工具补充对应的后台逻辑，最后形成一个完整的物料功能。通过综合实训帮助学生全面牢固地掌握教学内容、培养学生的实践动手能力，提高学生综合运用专业知识和专业技能解决实际问题的能力，强化课堂教学与实践教学相结合，锻炼学生的职业能力。二、实训准备1、掌握C#编程开发技能。2、了解工业管理软件开发的基础开发。3、事先要能够根据实训工程源代码，配置环境，搭建项目工程。4、安装好实训开发环境，下载实训工程源代码。5、物料的开发依赖于单位功能，需要先完成单位功能的开发。三、实训环境Windows10或以上操作系统(不能是Windows11家庭版)、Visual

Studio2019或以上开发工具安装、数据库可以选择SqlServer数据库（安装VS时将VS自带的SqlServer安装上，就可以不用单独安装SqlServer的数据库）或者Oracle数据库（安装ODAC、安装Oracle客户端、安装PLSQL）、安装EAP.Modelfirst。四、实训步骤任务描述本实训让学生体验一个完整带关系单表功能从设计到开发的全过程，包括系统的需求分析到功能设计、数据库设计、页面设计及功能实现等。通过本指导书展开详细的开发步骤。任务：物料功能实现逻辑包括：主列表列属性：编码、名称、描述、单位、物料类型、创建人、创建时间、修改人、修改时间。操作命令：查询、添加、复制新增、修改、删除、保存、导出、导入、配置项；编辑模式：行内编辑；主列表显示配置：编码、名称为固定列；描述列显示问号，鼠标移到问号处显示“物料信息详情”；当物料类型为产品时，行背景色显示为橙色；查询命令：查询条件：编码、名称、单位、物料类型；单位：下拉操作；物料类型：枚举下拉操作，可以选择查询全部数据；添加命令：编码根据配置项自动生成，只读；名称非空；描述可空；单位下拉选择，非空，显示为名称，下来操作的数据为可用的数据，能够根据编码和名称模糊查询单位下拉框的数据进行筛选；物料类型：非空，枚举下拉选择，枚举值包括：物料和产品，默认为物料；复制新增命令：编码根据配置项自动生成，只读；名称、描述、单位、物料类型默认为复制行的内容；修改命令：编码只读；名称非空，描述可空；单位下拉选择，非空，显示为名称，下来操作的数据为可用的数据，能够根据编码和名称模糊查询单位下拉框的数据进行筛选；物料类型：非空，枚举下拉选择，枚举值包括：物料和产品；删除按钮物料删除按钮不做限制；单位功能的删除按钮增加校验：单位被物料引用不允许删除；保存按钮验证逻辑：编码、名称、单位、物料类型非空；导入按钮：编码根据配置项生成；名称非空；描述可空；单位非空，需要验证数据，在单位中存在的数据才能导入，否则提示异常，导入失败；物料类型非空，需要验证数据，在类型枚举中存在的值才能导入成功，否则提示异常，导入失败；验证通过的数据保存成功，失败的数据提示失败的原因；配置项配置物料编码的生成规则；物料功能界面实现效果：图1-1物料功能详细开发步骤需求清单分析：表1-1需求清单序号功能功能需求描述备注1查询根据编码、名称、单位、类型查询物料信息，其中单位下拉查询，类型枚举下拉支持输入%模糊查询2添加添加物料，编码根据配置项自动生成且只读，名称非空，单位选择单位功能可用的数据且非空，类型默认为物料且非空3复制新增编码根据配置项自动生成，只读名称、描述、单位、类型默认为复制行的内容4修改修改物料，编码不允许修改，名称非空，单位选择单位功能可用的数据且非空，类型非空，枚举选择5删除能成功删除一笔或多笔数据6保存验证通过的数据能成功保存，不通过提示具体的异常7导入1）编码根据配置项生成，名称非空2）单位非空，需要验证数据，在单位中存在的数据才能导入3）类型非空，需要验证数据，在类型枚举中存在的值才能导入成功8导出能够导出选中和导出全部9配置项配置编码自动生成规则10界面配置编码、名称为固定列；描述列显示问号，鼠标移到问号处显示“物料信息详情”；当类型为产品时，背景色显示为橙色；界面字段说明：图1-2界面字段开发操作步骤流程说明：图1-3操作步骤流程图数据库代码开发步骤打开EAP.ModelFirst。在项目总管中建一个SIE.Test的工程。在SIE.Test的工程中新建一个ItemTests的文件夹，右键文件夹可按图操作：图1-4创建Diagram创建完后将出现如下效果：图1-5Diagram效果双击目录的ItemTests进入界面后右键新建ItemTest类：图1-6创建ItemTest类图双击对ItemTest类进行编辑，创建好的物料类属性如下：图1-7设置ItemTest类属性物料和单位的关系建立图1-8单位类添加到物料设计器中图1-9设置单位和物料的关联关系图1-10关联关系设置备注物料类型枚举实现图1-11新建枚举类图1-12枚举类的实现创建物料与物料类型的关系，使用可空的关联关系，因为查询中要能够查询全部，这里建关系建成可空的，可以不用重写查询实体也能满足业务需求。图1-13物料与物料类型的关系完成以上所有步骤，选中ItemTest类和ItemType，右键生成代码图1-14实体生成代码接下来将生成ER图实体类文件：图1-15生成实体类文件选中ItemTest类，右键生成代码图1-16界面生成代码生成ER图界面类文件图1-17生成界面类文件生成的实体类文件放置到服务端工程代码目录如下：图1-18服务端代码目录图生成的界面类文件放置到客户端工程代码目录如下：图1-19客户端代码目录图按以上所有步骤，数据库设计我们已经完成，并且已生成了相关的类文件。接下来开始进入代码编写。物料实体类功能开发ItemTest类添加名称空间的引用，取消[CriteriaQuery]的注释，生成不报错。图1-20物料实体类报错和查询面板实现物料类型非空处理图1-21物料类型验证实现物料下拉显示名称和配置项按钮的实现图1-22物料下拉显示名称和配置项按钮的实现物料界面类ViewConfig功能开发编码只读，编码、名称为固定列设置图1-23编码只读和固定列设置描述列显示问号，鼠标移到问号处显示“物料信息详情”实现图1-24描述详情设置单位编辑器开发实现查询状态为可用的单位信息方法实现，在UnitTestController控制器类中增加方法GetUnits，实现如下：图1-25查询可用状态下单位信息单位实体配置的查询条件与单位查询方法的查询关键字配置为一致的，下拉列表查询条件取的是实体显示成员和查询成员的并集。图1-26下拉查询条件配置自定义单位编辑器的实现，在客户端定义一个扩展静态类，在静态类中实现单位自定义编辑器。图1-27单位自定义编辑器的实现在界面使用编辑器图1-28使用自定义编辑器物料类型默认为物料实现图1-29物料类型默认值设置物料下拉列表选择和查询视图配置图1-30物料下拉列表和查询条件配置物料类型为产品时行背景色的变更实现，在行为的beforeCreate方法中实现图1-31物料类型为产品时行背景色为橙色在ConfigListView方法中使用行为图1-32使用行为添加和复制添加按钮的重写实现，主要是处理编码根据配置项自动生成添加按钮的前端实现：图1-33物料添加命令前端实现获取配置项配置值方法的实现：图1-34获取配置项配置值方法实现添加按钮的后端实现：图1-35物料添加命令后端实现复制添加按钮的前端实现，继承SIE.cmd.Copy，重写_setCopyEntity方法。图1-36复制添加命令前端实现复制添加命令后端实现。图1-37复制添加命令后端实现在ConfigListView方法中替换框架的添加和复制添加命令。图1-38替换添加和复制添加命令物料导入命令的开发实现导入前端命令实现：图1-39导入命令前端实现导入命令的handle类实现，文件创建在服务端工程的ItemTests文件夹下。图1-40列和列验证的实现图1-41物料名称非空验证图1-42单位列数据校验图1-43物料类型列数据校验图1-44数据释放及异常消息处理图1-45导入命令保存逻辑处理导入后端命令实现：图1-46导入命令后端实现导入下载模板的开发实现：图1-47导入模板列配置在物料界面端的ConfigListView中使用导入命令：图1-48导入命令的使用单位被物料引用不允许删除的开发实现图1-49单位被物料引用不允许删除实现配置模块与初始化配置初始化菜单，在客户端工程的初始化类中配置物料初始菜单图1-50物料初始菜单配置运行项目，配置功能菜单图1-51配置后的效果物料功能的数据库表和序列的生成，在实体元数据功能中点击“升级数据库”按钮，进行数据库表的升级操作。图1-52升级数据库图1-53执行升级数据库操作更新验证，执行实体元数据的更新，需要更新物料和单位的规则。图1-54更新物料规则校验效果验证物料功能的效果图1-55物料功能效果添加按钮效果，编码根据配置项规则自动生成且只读，物料类型默认为物料图1-56添加按钮编码和物料类型默认赋值效果单位下拉效果，查询为可用的数据图1-57单位下拉效果保存按钮的数据验证，数据验证不通过，会有对应的提示信息，验证通过可以成功保存数据。图1-58保存按钮验证未通过效果导入验证。图1-59导入界面效果图点击下载模板，在下载的excel模板中录入数据，浏览把录入数据的模板加入进来，点击导入，数据验证通过的能够导入成功，验证不通过的会有具体的异常提示，如下：图1-60导入数据操作失败的数据会显示在对应失败行的失败原因中。图1-61导入失败详情单位被物料