MES开发与应用 课件 模块2 班组成员管理模块

2.1项目运行配置知识回顾平台启动原理前端界面生成原理学习目标通过本节学习可以：对BS端功能运行配置和启动有个基础的认识对CS端功能运行配置与启动有个基础的认识对数据库生成与菜单配置有个基础的认识01网页端功能运行配置与启动说明网页端功能运行与启动配置说明WebClient启动配置文件说明网页端功能运行和启动时需要将WebClient设置为启动项目，读取对应配置文件的信息，取决于launchSettings.json的配置，配置启动类型分为:WebClient与IISExpress.启动类型为WebClient时读取WebClient工程文件的appsettings.json配置文件启动类型为IISExpress时读取WebClient工程文件的appsettings.Development.json文件网页端功能运行与启动配置说明启动类型为Webclient读取的配置文件为appsettings.json文件：WebClient启动配置文件说明网页端功能运行与启动配置说明启动类型为IISExpress读取的配置文件为appsettings.Development.json文件：IISExpress启动配置文件说明启用WebClient本地模式调试步骤说明1.启动类型为WebClient时，分为两种模式:本地模式:Local;代理模式:Remote。本地模式：需要设置appsettings.json的DataPortal.Mode为Local网页端功能运行与启动配置说明网页端功能运行与启动配置说明启用WebClient本地模式调试步骤说明2.运行调试时，还需要配置数据库连接字符串，如果工程没有数据提供者类，默认读取的为master的连接字符串网页端功能运行与启动配置说明启用WebClient本地模式调试步骤说明3.运行调试时，设置WebClient为启用项目，调试模式设置为WebClient网页端功能运行与启动配置说明启用WebClient本地模式调试步骤说明4.运行调试，进入到登录界面，浏览对应的IP和端口对应的配置为urls的配置启用WebClient代理模式调试步骤说明1.启动类型为WebClient时，代理模式：需要设置appsettings.json的DataPortal.Mode为Remote，并配置代理地址:DataPortal.Url.。网页端功能运行与启动配置说明启用WebClient代理模式调试步骤说明2.启动类型为WebClient时，需要设置配置启动项目。勾选多个启动项目，选择SIE.WebApiHost启动，WebClient启动。网页端功能运行与启动配置说明网页端功能运行与启动配置说明启用WebClient代理模式调试步骤说明3.运行调试时，设置完成后可以看到多个启动项目，然后直接点启动。网页端功能运行与启动配置说明启用WebClient代理模式调试步骤说明4.运行调试，进入到登录界面，浏览对应的IP和端口对应的配置为urls的配置启用IISEx本地模式调试步骤说明设置appsettings.Development.json的DataPortal.Mode为Local网页端功能运行与启动配置说明启用IISExpress本地模式调试步骤说明设置WebClient为启用项目，调试模式设置为IISExpress网页端功能运行与启动配置说明网页端功能运行与启动配置说明启用IISExpress本地模式调试步骤说明4.运行调试，进入到登录界面，浏览对应的IP和端口对应的配置为launchSettings.json中的sslPort配置启用IISExpress代理模式调试步骤说明1.启动类型为IISExpress时，代理模式：需要设置appsettings.Development，并配置代理地址:DataPortal.Url.。网页端功能运行与启动配置说明启用IISExpress代理模式调试步骤说明启动类型为IISExpress时，需要设置配置启动项目。勾选多个启动项目，选择SIE.WebApiHost启动，WebClient启动，后续的启动步骤和本地模式一样的。网页端功能运行与启动配置说明02桌面端功能运行配置与启动说明启用WpfClient本地模式调试步骤说明1.启动WpfClient，设置appsettings.json的DataPortal.Mode为Local桌面端功能运行配置与启动说明启用WpfClient本地模式调试步骤说明2.运行调试时，还需要配置数据库连接字符串，如果工程没有数据提供者类，默认读取的为master的连接字符串桌面端功能运行配置与启动说明网页端功能运行与启动配置说明启用WpfClient本地模式调试步骤说明3.运行调试，进入到登录界面，则表示启动成功。03数据库生成与菜单配置介绍数据库生成与菜单配置介绍数据库生成通用说明SMOM程序的数据库表是通过程序生成的:项目源码第一次升级数据库表时，要通过CS端进行数据库升级操作，生成成功后可以在BS端配置菜单，之后就可通过BS端的“实体元数据”菜单进行升级操作CS端升级数据库只能本地模式进行操作，不能启用代理模式进行数据库升级操作，升级数据库，会生成表和表对应的序列(id和系统序列)，通过脚本创建表时要同时创建对应的两个序列,BS端“实体元数据”菜单的升级数据库时尽量不勾选“更新实体元数据”，可在“实体元数据”的“更新”或者“选择更新”进行操作。CS端升级数据库操作步骤说明1.启动WpfClient，设置appsettings.json的DataPortal.Mode为Local，通过将dev.generateDbOnStartup属性设置为true，打开升级数据库窗体数据库生成与菜单配置介绍CS端升级数据库操作步骤说明2.启动项目，在弹出的升级数据库对话框中进行如下操作数据库生成与菜单配置介绍CS端升级数据库操作步骤说明3.升级完成后，关闭升级数据库对话框，在跳转到的登录界面，输入用户名：SysAdmin，密码：123456，进行登录，第一次登录要修改密码，修改成功登录成功后，关闭窗体，在BS端进行菜单配置和后续操作。数据库生成与菜单配置介绍BS端升级数据库操作步骤说明1.WebClient的项目引用和配置更改好后，将WebClient设置为启动项目，启动项目注意：必须用CS端将框架的数据库生成出来，才能在BS端进行数据库升级操作。数据库生成与菜单配置介绍BS端升级数据库操作步骤说明2.输入用户名和密码登录成功后，点击“实体元数据”功能（如果没有该功能，在菜单功能中进行菜单配置）。数据库生成与菜单配置介绍BS端升级数据库操作步骤说明3.在进入的“实体元数据”功能中，点击“升级数据库”按钮数据库生成与菜单配置介绍BS端升级数据库操作步骤说明4.在“升级数据库窗口”中，点击“确定”按钮就那些数据库升级操作数据库生成与菜单配置介绍初始菜单配置说明SMOM初始菜单配置是在界面端模块初始化类的初始化方法中添加模块操作的事件进行配置的数据库生成与菜单配置介绍初始菜单配置说明1.同一个实体类只能配置一个菜单；2.配置的菜单显示不出来，可以在配置菜单的初始化方法中设置断点，看是否能进入，可以通过下图的方式逐步排查原因；数据库生成与菜单配置介绍初始化菜单操作说明1.运行程序，点击“菜单”功能，在进入的菜单功能中点击“更新功能模块”(批量操作)或者是“更新选择的功能模块”(单个操作)，进行初始化操作(这一步操作也可以在“模块定义”功能进行操作)说明：新增加的菜单要先进行初始化操作才能配置菜单数据库生成与菜单配置介绍初始化菜单操作说明2.更新完成后，点击左边的“刷新”按钮，或者是关闭“菜单”功能重新打开，新添加的菜单就会在左边的列表中显示出来。数据库生成与菜单配置介绍平台菜单配置说明初始化完成后，将左边列表的数据拖到右边菜单列表中，点击保存，菜单就配置好了。数据库生成与菜单配置介绍自定义菜单配置步骤说明1.在“模块定义”菜单中添加模块，保存添加的模块注意:1.自定义菜单一定要加上Url，并且Url必须带http://或者https://，方能展示分配的菜单权限；2.自定义外部的菜单如果修改了模块定义的信息，在菜单功能中已经配置的对应菜单需要先删除保存后再重新配置该菜单。数据库生成与菜单配置介绍自定义菜单配置步骤说明2.在“菜单”中将左边的模块菜单拖动到右边菜单中，点击保存注意：这里第三方系统的连接能打开，打开方式需要配置为“窗体”数据库生成与菜单配置介绍自定义菜单配置步骤说明3.在“功能地图”中点击右边的“刷新”图标，菜单就能显示出来，点击“百度”菜单，就能调整到百度数据库生成与菜单配置介绍练习✎本章练习了解BS端功能运行配置和启动，CS端运行配置和启动知识？了解数据库生成和菜单配置知识？✎预习练习SMOM项目结构知识了解？本章小节本章主要讲解了项目运行配置的说明，包括：首先介绍了网页端运行和启动配置说明

；其次讲解了桌面端运行和启动配置说明；再次讲解了数据库生成操作步骤说明；最后讲解了菜单配置说明。一般在SMOM项目运行启动中，启动调试不同的模式时，需要配置不同的配置文件。因此要求学生必须了解清晰并掌握本章知识。2.2项目结构介绍知识回顾WebClient启动配置IISExpress启动配置WpfClient启动配置CS端数据库生成操作BS端数据库生成操作菜单配置说明学习目标通过本节学习可以：对解决方案项目层级有个基础的认识对项目工程有个基础的认识对项目文件存储目录有个基础的认识对平台程序集有个基础的认识01解决方案项目层级说明解决方案项目层级说明Modules文件夹下是存放我们具体业务的项目工程，业务开发实现的工程都要建在Modules文件夹下解决方案下的SIE.ScheduleServer、SIE.WebApiHost、WebClient、WpfClient为项目调试工程。Modules调试工程解决方案项目层级说明02项目工程说明项目工程说明项目工程说明Modules文件夹下项目工程说明Modules文件夹下是业务工程，包含服务端工程，BS界面端工程和CS界面端工程。新建的业务工程不要放到Modules文件夹最外面，最好根据实际业务用文件夹包起来，不然项目工程一多，工程维护比较麻烦。建具体工程时，最好评估下工程要做的功能来引用依赖的dll，不要一建工程就不管有没有用，先把dll引用进来，而是需要什么就引用什么。工程的dll依赖不要出现循环依赖。服务端工程不要引用客户端相关dll。BS界面端工程不要引用CS界面端工程。CS界面端工程不要引用BS界面端工程。项目工程说明调试工程调试工程SIE.ScheduleServer：调度调试工程，只能引用服务端工程或者是dll。SIE.WebApiHost：Api接口调试工程，用于调试api接口方法，只能引用服务端工程或者是dll。WebClient：BS端功能调试工程，如果要还原部署后功能问题，需要启用代理进行调试；该工程不能引用CS端工程或者是dll，否则会引发异常。WpfClient：CS端功能调试工程，如果要还原部署后功能问题，需要启用代理进行调试；该工程不能引用BS端工程或者是dll，否则会引发异常。03项目文件存储目录结构介绍项目文件储存目录结构说明Common文件存储目录说明Common文件存储目录说明Common文件夹下存储的是公共的服务包，例如:WpfClient，WebClient，SIE.WebApiHost,SIE.ScheduleServer(调度服务)，Resources(资源文件)等服务包文件。项目文件储存目录结构说明Modules文件存储目录说明Modules文件存储目录说明Modules文件夹下存储的是公共工程文件，业务工程文件，例如：Common（公共工程文件），ERPInterface(ERP接口工程文件)，SMES(MES业务工程文件),SQMS(QMS业务工程文件)，SWMS(WMS业务工程文件)等。也可以按照项目需求自行添加项目业务工程文件的。项目文件储存目录结构说明nupkgs文件存储目录说明nupkgs文件存储目录说明nupkgs文件夹下存储的是Nuget下的包文件：DevExpress相关包文件，Hangfire(用于执行后台任务工具函数库)相关包文件，RazorEngine(模版引擎)相关包文件,SIE平台框架程序集相关包文件等。项目文件储存目录结构说明packages文件存储目录说明packages文件存储目录说明packages文件夹下存储的是WPF工程项目引用过包文件，WpfClient编译生成时会自动生成的packages文件夹，并将引用的文件放到packages文件夹下。项目文件储存目录结构说明platform文件存储目录说明platform文件存储目录说明platform文件夹下存储的是解决方案里面生成以后的目录文件：生成SMOM解决方案时会自动生成platform文件夹，目录结构是SMOM=>netcoreapp3.1,netstandard2.0。netcoreapp3.1存储的WebClient引用的dll文件；netstandard2.0存储的服务端引用的dll文件。项目文件储存目录结构说明Projects文件存储目录说明Projects文件存储目录说明Projects文件夹下存储的是项目启动服务文件：Projects文件夹里面的生成的文件夹是根据解决方案来生成的，例如：只有一个SMOM解决方案，就生产一个SMOM文件夹，如果多个则会生成多个解决方案对应的文件夹。文件夹下面储存的是项目启动服务文件。SIE.ScheduleServer(调度服务)启动文件；SIE.WebApiHost(服务端)启动文件。WebClient(BS客户端)启动文件;WpfClient(CS客户端)启动文件.04平台封装程序集介绍平台封装程序集说明平台封装程序集说明SIE.dll：核心类库的实现及接口定义，基础通用功能的封装等。SIE.Wpf.dll：所有界面生成的封装，如使用到的Wpf生成界面布局、基础控件、命令的封装等。SIE.Common.dll：命令、编辑器、界面布局等后端通用实现；编码段、通用序列算法生成的实现和员工，预警，调度，推送，打印，模板的基类及接口定义。SIE.Wpf.Common.dll：命令、编辑器、界面布局等前端通用实现；以及员工、打印、模板的基类前端实现。SIE.ORM.MappingColumn.dll：ORM数据库映射库。SIE.Log4Net.dll、SIE.LogClient.dll、SIE.LogData.dll、SIE.SqlLogger.dll：日志库，框架日志的实现。SIE.dllSIE.Wpf.dllSIE.Common.dllSIE.Wpf.Common.dllSIE.ORM.MappingColumn.dllSIE.Log4Net.dllSIE.LogClient.dllSIE.LogData.dllSIE.SqlLogger.dll平台封装程序集说明平台封装程序集说明SIE.Caches.dll：缓存实现库。SIE.Diagnostics.dll：性能诊断库，主要写数据库操作。SIE.Iscript.dll：接口库。SIE.Script.dll：脚本库，对SIE.Iscript.dll的实现。SIE.Messages.dll：消息库，框架消息的实现。SIE.RazorEngine.dll：模板引擎库。SIE.Session.Redis.dll：Redis库。SIE.Localization.dll：本地化库，框架多语言的后端实现。SIE.Wpf.Localization.dll：本地化库，框架多语言的前端实现。SIE.Caches.dllSIE.Diagnostics.dllSIE.Iscript.dllSIE.Script.dllSIE.Messages.dllSIE.RazorEngine.dllSIE.Session.Redis.dllSIE.Localization.dllSIE.Wpf.Localization.dll平台封装程序集说明平台封装程序集说明SIE.Mda.dll：模块库，如模块，实体元数据，数据库升级相关操作的后端实现。SIE.Wpf.Mda.dll：模块库，如模块，实体元数据，数据库升级相关操作的前端实现。SIE.Rbac.dll：权限库，如菜单，用户，角色及权限相关的后端实现。SIE.Wpf.Rbac.dll：权限库，如菜单，用户，角色及权限相关的前端实现。SIE.Dashboard.dll：看板设计器的后端实现。SIE.Wpf.Dashboard.dll：看板设计器的前端实现。SIE.Mda.dllSIE.Wpf.Mda.dllSIE.Rbac.dllSIE.Wpf.Rbac.dllSIE.Dashboard.dllSIE.Wpf.Dashboard.dll平台封装程序集说明平台封装程序集说明SIE.Schedule.dll：调度库，调度平台的后端实现。SIE.Wpf.Schedule.dll：调度库，调度平台的前端实现。Hangfire.Core.dll：调度平台核心实现。SIE.Queue.dll：消息队列库，平台消息队列的实现。SIE.Wpf.MQ.dll：消息队列前端实现。SIE.Alert.dll：预警库，平台预警功能的后端实现。SIE.Wpf.Alert.dll：预警库，平台预警功能的前端实现。SIE.Senders.dll：推送库，平台推送功能的后端实现。SIE.Wpf.Senders.dll：推送库，平台推送功能的前端实现。SIE.Schedule.dllSIE.Wpf.Schedule.dllHangfire.Core.dllSIE.Queue.dllSIE.Wpf.MQ.dllSIE.Alert.dllSIE.Wpf.Alert.dllSIE.Senders.dllSIE.Wpf.Senders.dll平台封装程序集说明平台封装程序集说明SIE.ReportServerCore.Common.dll：报表库，报表平台的通用后端实现。SIE.ReportServerCore.Extension.dll：报表库，报表平台的扩展实现。SIE.ReportServerCore.dll：报表库，报表平台功能后端逻辑实现。SIE.Wpf.ReportServerCore.dll：报表库，报表平台功能前端界面实现。SIE.Print.dll：打印库，打印功能的后端实现，通常与报表一起使用。SIE.Wpf.Print.dll：打印库，打印功能的前端实现，通常与报表一起使用。SIE.ReportServerCore.Common.dllSIE.ReportServerCore.Extension.dllSIE.ReportServerCore.dllSIE.Wpf.ReportServerCore.dllSIE.Print.dllSIE.Wpf.Print.dll练习✎本章练习了解解决方案项目层级，以及项目工程作用和用途？了解项目储存文件路径，以及平台框架程序集作用？✎预习练习新建业务项目工程文件？本章小节本章主要讲解了解决方案项目工程的说明，包括：首先介绍了解决方案项目层级说明

；其次讲解了项目工程说明；再次讲解了项目工程储存文件目录结构介绍；最后讲解了平台封装程序集说明。一般在SMOM产品业务开发中，很多项目工程都必须引用平台封装好的程序集进行开发的。因此要求学生必须了解清晰并掌握本章知识。2.3项目工程的搭建深圳市信息职业技术学院业务端工程项目搭建01目

录网页端工程项目搭建02桌面端工程项目搭建03项目工程目录结构及规范04项目运行原理05知识回顾数据库的基础语法；数据库的基础操作；学习目标通过本节学习可以：掌握工业软件的业务端工程项目搭建；掌握工业软件的网页端工程项目搭建；掌握工业软件的桌面端工程项目搭建；掌握工业软件的项目工程目录结构及规范；了解工业软件项目运行原理；01业务端工程项目搭建思考题如何搭建工业管理软件开发的业务端工程项目？业务端工程搭建步骤右键添加->新建项目业务端工程搭建步骤选择.NETStandard或.NETCore的类库项目，点击下一步业务端工程搭建步骤修改“项目名称”和存储“位置”，点击下一步业务端工程搭建步骤框架选择“.NETStandard2.0”点击“创建”业务端工程搭建步骤添加Nuget程序包源。在VisualStudio选择【工具】-【选项】-【Nuget包管理器】-【程序包源】业务端工程搭建步骤设置程序包源（只需设置一次）。源目录选择本地代码中的nupkgs目录，作为本地包源。业务端工程搭建步骤右键新建的项目，选择管理Nuget程序包，以添加工程必须的Nuget包。业务端工程搭建步骤安装所需要的包。框架通用只需要引用SIE和SIE.Common包。业务端工程搭建步骤安装成功后，可在工程的依赖项中查看到包。业务端工程搭建步骤在业务端工程下，添加初始化类(必须)，继承DomainModule，用于对该工程进行初始化操作业务端工程搭建步骤添加数据提供者配置业务端工程搭建步骤数据提供者配置数据提供者的ConnectionStringName关联Appsetting.json配置文件连接字符串业务端工程搭建步骤在SIE.WebApiHost工程添加新工程的引用02网页端工程搭建思考题如何搭建工业管理软件开发的网页端工程项目？网页端工程搭建步骤网页端工程搭建右键添加->新建项目网页端工程搭建步骤网页端工程搭建选择类库->点击下一步网页端工程搭建步骤网页端工程搭建配置项目名称和位置->点击下一步网页端工程搭建步骤网页端工程搭建框架选择.NetCore3.1->点击创建网页端工程搭建步骤网页端工程搭建创建成功网页端工程搭建步骤网页端工程搭建工程添加项目引用->选择SIE.Web.Core网页端工程搭建步骤网页端工程搭建客户端添加Module类，用于模块初始化配置网页端工程搭建步骤网页端工程搭建在SIE.WebClient工程添加新工程的引用.03桌面端工程搭建思考题如何搭建工业管理软件开发的桌面端工程项目？桌面端工程搭建步骤桌面端工程搭建右键添加->新建项目桌面端工程搭建步骤桌面端工程搭建选择.NETFramework的类库，点击“下一步”桌面端工程搭建步骤桌面端工程搭建在弹出的“配置新项目”中，配置项目名称、位置和框架，点击“创建”桌面端工程搭建步骤桌面端工程搭建添加项目引用：SIE.dll、SIE.Common.dll、SIE.Wpf.dll、SIE.Wpf.Common.dll和对应服务端的工程SIE.LibMan，选择完成后点击“确定”桌面端工程搭建步骤桌面端工程搭建添加初始化菜单类,继承UIModule桌面端工程搭建步骤桌面端工程搭建在初始化类的初始化方法中，添加模块操作事件App_ModuleOperations，用于配置初始菜单，具体的菜单配置在做具体功能时再配置。桌面端工程搭建步骤桌面端工程搭建在SIE.WpfClient工程添加新工程的引用.04项目工程目录结构及规范思考题项目规范作用是什么？项目工程目录结构是怎样?项目工程目录结构及规范项目工程目录结构及规范代码目录规范作用：让开发人员形成共识，以便后续接手人员查看代码。层次：按业务模块区分1.通用目录。包含业务模块共用的文件。2.数据库初始化目录。包含系统初始化数据库时的代码文件。3.业务模块。每个业务模块对应一个目录（例如图中对应4个业务模块）。4.Module文件。SIE.WebApiHost服务启动时，本工程的执行逻辑。5.EntityDataProvider文件。配置对应的数据库连接。业务端工程代码目录结构项目工程目录结构及规范项目工程目录结构及规范业务端工程代码目录结构-业务模块实体类。如OobInspBill,OobInspBillDetail,OobInspVal查询实体类。自定义实体的查询方法。如OobInspBillCriteriaController。包含业务逻辑方法。如OobInspBillController实体验证规则。如OobInspBillRule实体打印类。如OobInspBillPrintable业务模块中的复杂部分。如WorkFlows目录，包含该业务模块的工作流部分。项目工程目录结构及规范项目工程目录结构及规范网页端工程代码目录结构主要按业务模块进行区分目录。Common是通用目录。包含各个业务模块的共用代码文件。业务模块。每个业务模块对应一个目录。Module文件。SIE.WebClient服务启动时，本工程的执行逻辑。项目工程目录结构及规范项目工程目录结构及规范网页端工程代码目录结构Behaviors目录。包含视图的行为文件，实现前端的自定义逻辑。Commands目录。包含命令文件。实现按钮功能。DataQueryer目录。包含前端数据查询方法。Scripts目录。包含前端的js文件，例如自定义控件，自定义布局文件等，不包含行为文件。实体视图配置文件。放在业务模块目录下。实体对应的前端视图配置文件。系统会根据该文件，自动生成前端页面展示。项目工程目录结构及规范项目工程目录结构及规范桌面端工程代码目录结构主要按业务模块进行区分目录。业务模块。每个业务模块对应一个目录。Templates目录。包含导入模板文件。Module文件。SIE.WpfClient服务启动时，本工程的执行逻辑。项目工程目录结构及规范项目工程目录结构及规范桌面端工程代码目录结构-业务模块Behaviors目录。包含视图的行为文件，实现前端的自定义逻辑。Commands目录。包含命令文件。实现按钮功能。实体视图配置文件。放在业务模块目录下。实体对应的前端视图配置文件。系统会根据该文件，自动生成前端页面展示。05项目运行原理思考题新建的业务端、网页端、桌面端工程有什么关系？这些工程是怎么运行起来的？项目运行原理SMOM主要应用WebApiHost服务服务器上运行。主要包含各模块的业务逻辑层、数据访问层提供WebApi接口DataProtalControllerWebClient服务服务器上运行。使用浏览器访问。版本是.NetCore3.1主要包含各模块的网页端展示层通过调用WebApiHost服务的接口进行数据交互。WpfClient应用程序

客户端上运行。需要安装。版本是.NetFramework4.7.2包含各模块的客户端展示层。通过调用WebApiHost服务的接口进行数据交互。WebApiHostWebClientWpfClient项目运行原理WebApiHost服务控制台应用程序。支持直接运行，也支持以服务形式挂载。引用所需的业务端工程。程序启动时，加载所有业务端的SIE.*.dll执行dll对象的初始化逻辑，例如接口注册、服务初始化等。提供WebApi接口DataPortalControll