MES开发与应用 课件 5.1 工业管理软件系统调试与发布-系统调试

5.1系统调试深圳市信息职业技术学院目

录工业管理软件调试介绍01网页端功能的调试02桌面端功能的调试03Api接口调试04知识回顾MES订单管理系统物料功能的开发实现；MES订单管理系统工序功能的开发实现；MES订单管理系统工艺路线功能的开发实现；MES订单管理系统工单功能的开发实现。学习目标通过本节学习可以：掌握网页端功能直连调试；掌握网页端功能启用代理调试；掌握桌面端功能直连调试；掌握桌面端功能启用代理调试；掌握Api接口调试；了解工业管理软件的调试方式；01工业管理软件调试介绍工业管理软件调试介绍调试介绍工业管理软件能够开发的功能包括网页端功能、桌面端功能和Api接口，而调试是对具体功能的调试，所以调试也分为网页端功能调试、桌面端功能调试和Api接口调试。网页端功能调试，是对BS功能进行直连数据库调试和启用代理调试，使用的调试工程为WebClient。桌面端功能调试，是对CS功能进行直连数据库调试和启用代理调试，使用的调试工程为WpfClient。Api接口调试，是对Api方法进行调试，使用的调试工程为SIE.WebApiHost。BS直连调试介绍BS直连调试介绍BS端的调试工程为WebClient，在对功能调试前，需要将调试功能相关的UI工程直接或间接的引用到调试工程WebClient。WebClient是BS端功能的调试工程，引用的工程和程序集不能包含CS界面端的工程(SIE.Wpf的dll或工程不能依赖进来)，否则会引发异常。添加要调试功能相关的工程引用引用工程说明BS直连调试，设置WebClient为启动项目。设置启动项目BS代理调试介绍BS代理调试介绍启用代理调试，需要同时配置SIE.WebApiHost和WebClient。SIE.WebApiHost工程为服务端调试工程，该工程只能直接或间接引用服务端工程相关的dll，界面相关的dll（带SIE.Web或SIE.Wpf的dll或者工程）不要引用到该工程中。配置工程SIE.WebApiHostBS功能启用代理调试，配置WebClient调试工程，同事设置SIE.WebApiHost和WebClient为启动项目。WebClient启用代理调试主要是为了去模拟服务器发布的环境，在发布之后遇到的一些问题，无法通过直连重现问题，就需要通过代理调试去定位和修复问题。为什么要代理调试CS直连调试介绍CS直连调试介绍CS端的调试工程为WpfClient，在对功能调试前，需要将调试功能对应的工程添加引用到调试工程WpfClient。WpfClient是CS端功能的调试工程，引用的工程dll不能包含BS界面端的工程(即SIE.Web的dll或工程不能依赖进来)，否则会引发异常。添加要调试功能对应的工程引用引用工程说明CS直连调试，设置WpfClient为启动项目。设置启动项目CS代理调试介绍CS代理调试介绍启用代理调试，需要同时配置SIE.WebApiHost和WpfClient。SIE.WebApiHost工程为服务端调试工程，该工程只能直接或间接引用服务端工程相关的dll，界面相关的dll（带SIE.Web或SIE.Wpf的dll或者工程）不要引用到该工程中。配置工程SIE.WebApiHostCS功能启用代理调试，配置WpfClient调试工程。WpfClient启用代理调试主要是为了去模拟服务器发布的环境，在发布之后遇到的一些问题，无法通过直连重现问题，就需要通过代理调试去定位和修复问题。为什么要代理调试API接口调试介绍Api接口调试介绍API接口的调试工程为SIE.WebApiHost，在对API方法调试前，需要将调试接口对应的工程添加引用到调试工程SIE.WebApiHost。SIE.WebApiHost为Api接口调试工程，只能直接或间接引用服务端工程相关的dll，界面相关的dll（带SIE.Web或SIE.Wpf的dll或者工程）不要引用到该工程中，否则会引发异常。添加要调试功能对应的工程引用引用工程说明API接口调试，设置SIE.WebApiHost为启动项目。设置启动项目02网页端功能的调试网页端功能直连调试网页端功能直连调试BS功能调试的配置文件有两个(appsettings.Development.json和appsettings.json)，分别对应IISExpress和WebClient调试。网页端功能直连调试网页端功能直连调试WebClient设置为启动项目，读取对应配置文件的信息，取决于launchSettings.json的配置。网页端功能直连调试网页端功能直连调试启动类型为WebClient读取的配置文件为。网页端功能直连调试网页端功能直连调试启动类型为IISExpress读取的配置文件。网页端功能直连调试网页端功能直连调试以启动类型为IISExpress为例，进行调试说明。设置appsettings.Development.json的DataPortal.Mode为Local。网页端功能直连调试网页端功能直连调试新引入的工程需要添加对应的数据库连接配置，具体看服务端工程的数据提供者类配置的连接字符串，如果工程没有数据提供者类，默认读取的为master的连接字符串。网页端功能直连调试网页端功能直连调试设置WebClient为启用项目，调试模式设置为IISExpress。网页端功能直连调试网页端功能直连调试F5调试，运行项目，进入到登录界面，浏览对应的IP和端口对应的配置为launchSettings.json中的sslPort配置。网页端功能直连调试网页端功能直连调试如调试读者管理的查询功能，在读者管理查询方法中设置断点。网页端功能直连调试网页端功能直连调试打开读者管理功能，点击查询。网页端功能直连调试网页端功能直连调试可以调试进入到前面设置的断点中进行功能的调试。思考题BS直连调试设置的断点执行不进去，可能的原因是？以下三种情况都有可能执行不进去断点：1、WebClient未添加调试工程的依赖；2、WebClient添加的依赖是程序集而不是项目工程的依赖；3、解决方案配置不是为Debug；网页端功能代理调试网页端功能代理调试服务端调试工程需要调试功能的项目工程的引用，如要调试读者管理的查询功能，则把读者管理功能对应的服务端工程SIE.LibMan依赖进来。网页端功能代理调试网页端功能代理调试服务端工程配置端口和数据库连接，其他的配置根据项目实际情况配置。网页端功能代理调试网页端功能代理调试客户端调试工程添加调试功能的UI项目工程(SIE.Web.LibMan)依赖。网页端功能代理调试网页端功能代理调试WebClient以IISExpress启动为例，更改配置文件，设置DataPortal.Mode的值为Remote，DataPortal.Url的IP和端口为SIE.WebApiHost的IP和端口。网页端功能代理调试网页端功能代理调试运行程序调试：前面步骤配置完成后，启动程序进行调试（右键属性-调试-启动新实例），启动程序时要先将SIE.WebApiHost启动成功后再启动WebClient客户端调试工程（也可以设置多个项目启动，同时将SIE.WebApiHost和WebClient设置为启动项目）。网页端功能代理调试网页端功能代理调试F5运行项目，SIE.WebApiHost和WebClient的启动效果。网页端功能代理调试网页端功能代理调试打开读者管理，点击查询，进入到查询方法的断点处。思考题启用代理调试，控制器方法的断点执行不进去，可能的原因是？控制器方法不是虚方法，如果要能够调试执行到方法中，需要在方法中添加关键字virtual；WebClient配置文件介绍WebClient配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明1AllowedHostsstring

*是项目自动生成（无需手动配置）2urlsstring

ApiHost：http://*:1034

WebClient:http://*:1038是域名与端口配置

注：端口不能重复，所以每一端都必须配置3server.serviceNamestring

否windows服务名称4server.serviceDisplayNamestring

否windows服务显示名称5server.serviceDescriptionstring

否windows服务描述6loggerFactoryAdapterstring适配程序集完全限定名如:SIE.Log4Net.Log4NetLoggerFactoryAdapter,SIE.Log4Net

否日志适配设置，不设置将不记录日志信息7Log.SqlTraceElapsedint

1000否监听SQL语句消耗时间，单位：毫秒

监听时间大于此时间，写入日志8Log.EnableAuditItembool

TRUE否true：启用监听登录日志/按钮操作日志WebClient配置文件介绍WebClient配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明9Log.Hoststring日志服务器例：37

否日志服务host地址10Log.RemotePortint

2020否日志远程端口11Log.LocalPortint

2019否日志本地端口12DataPortal.Mode枚举Local/RemoteLocal否Local表示直连数据库，Remote表示通过服务中间件连数据库13DataPortal.Urlstringhttp://服务器IP:端口号/api/dataportal/Execute

否数据门户请求的URL地址（apihost地址）

注:DataPortal.Mode为Remote必须配置14DataPortal.TimeoutMinutesint

15否数据门户请求超时时间分钟数15path.attachmentType枚举disk/ftp

是"disk"为磁盘上传下载跟path.attachment同时配置，path.attachment不设置将使用C:/MES/Attachment

"ftp"为ftp上传下载必须跟ftp.path、ftp.userName、ftp.password同时配置，否则配置不生效WebClient配置文件介绍WebClient配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明16ftp.pathstringftp访问地址例1:2:1005/例2：2/

否ftp使用默认端口(80),端口根据ftp服务设置端口设置17ftp.userNamestringftp用户名

否ftp用户名18ftp.passwordstringftp密码

否ftp密码19path.attachmentstring

C:/MES/Attachment否path.attachmentType为disk才生效20client.attachmentDownloadUrlstring

否path.attachmentType为disk才生效，配置的地址与path.attachment地址对应上21ConnectionStrings@SectionJson"数据仓库名称":{

"Name":"数据仓库名称",

"ConnectionString":"连接字符串",

"ProviderName":"数据类型"

},

是数据库连接字符串，支持多库同时配置使用（Oracle/SqlServer）22RedisCacheJson"RedisCache":{

"Configuration":"缓存连接配置（连接字符串)",

"Sentinels":"服务节点列表",

"SentinelMasterConverter":"主机服务节点"

},

是Configuration:master,testcluster=false单机版的连接字符串，哨兵模式为：mymaster,password=123,prefix=my_;

Sentinels:哨兵服务节点列表，逗号分隔

SentinelMasterConverter:主机服务节点转换，逗号分隔单个规则，‘|’分隔多个转换规则;WebClient配置文件介绍WebClient配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明23dev.isDebuggingEnabledbool

FALSE否开发调试模式:启用开发调试模式可获取错误信息的堆栈信息24PlatformCommandsDirstring

Scripts/Commands/否设置编码命令存放地址，程序将会根据此地址(程序集根目录+配置地址)

把命令加入到视图元数据中25LoginCheckCodeEnabledbool

TRUE否是否允许登录验证码26UserSecurityCheckOptionsjson"UserSecurityCheckOptions":{

"Enable":true,

"KeepAliveInterval":10

},

否Enable:true启用安全检验，检查使用心跳，false：不启用安全检验，检查使用心跳;

KeepAliveInterval:心跳包检查间隔：单位秒、未配置则默认60秒;

注意：配置越少秒,相对影响服务器资源消耗就越多。27CookieAuthenticationjson"CookieAuthentication":{

"Name":"UAT_ELEC",

"Interval":1440

},

否配置实体-cookie认证

Name：cookie名称;

Interval:过期间隔时间(分钟)28SessionTimeoutint

30否Session过期时间(单位:分种)29JsFClient_date_FormatstringY:年m:月d:日H:时i:分s:秒Y-m-dH:i:s否配置浏览器日期数据显示的格式30DevCulture枚举语言(文化)代码zh-CN否DEV开发语言WebClient配置文件介绍WebClient配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明31Client.runtimestring

SMOM-PROD(Web)否客户端运行时，标识当前使用环境32ORM.DataLangFieldServicebool

FALSE否ORM数据多语种启用状态33DB.DataLimitint

50000否数据库每次查询数据量的最大限制34Product.Versionstring

程序集版本否产品版本35RetrievePwd.Email.UserNamestring邮件用户名

否发件人用户名，不配置将不能以邮件的方式找回密码(重置密码)

注:视使用项目是否使用邮件方式找回密码决定配置与否36RetrievePwd.Email.Passwordstring邮件密码

否发件人密码，不配置将不能以邮件的方式找回密码(重置密码)

注:视使用项目是否使用邮件方式找回密码决定配置与否37RetrievePwd.Email.Portstring邮件服务端口

否发送邮件服务端口，不配置将不能以邮件的方式找回密码(重置密码)

注:视使用项目是否使用邮件方式找回密码决定配置与否WebClient配置文件介绍WebClient配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明38RetrievePwd.Email.Hoststring邮件服务IP地址

否发送邮件服务地址，不配置将不能以邮件的方式找回密码(重置密码)

注:视使用项目是否使用邮件方式找回密码决定配置与否39RetrievePwd.Email.SendFromDisplayNamestring发件人显示名称

否发件人邮箱显示名，可不配置，不配置将显示发件人邮箱地址40RetrievePwd.Email.SendFromstring发件人邮箱地址

否发件人邮箱地址，不配置将不能以邮件的方式找回密码(重置密码)

注:视使用项目是否使用邮件方式找回密码决定配置与否41RetrievePwd.Email.EnableSSLstringtrue/false

否发送邮件服务是否允许SSL，视邮件服务是否需要启用SSL发送方式设置42DefaultFieldMaximumLength

int默认为20，通常设置为8020否string类型属性默认验证长度设置03桌面端功能的调试桌面端功能直连调试桌面端功能直连调试1.WpfClient添加要调试工程的dll引用；2.配置DataPortal.Mode为Local；

3.新工程需要在ConnectionStrings@Section节点增加数据库配置；4.如果启动程序要显示升级数据库对话，dev.generateDbOnStartup设置为true,否则设置为false桌面端功能直连调试桌面端功能直连调试选择WpfClient，右键将WpfClient工程设置为启动项目WpfClient设置为启动项目桌面端功能直连调试桌面端功能直连调试1、在员工维护的界面方法配置中设置断点，F5运行程序；2、登录系统，点击“员工维护”功能，会执行到对应的断点处。思考题CS本地启用代理调试应该如何配置？桌面端功能代理调试桌面端功能代理调试服务端调试工程添加dll和项目工程的引用：添加需要调试功能对应的服务端工程的引用，添加引用的程序集和项目不能包含界面端工程。桌面端功能代理调试桌面端功能代理调试服务端调试工程配置文件修改：SIE.WebApiHost工程的配置文件appsettings.json按项目需要修改urls、redis和数据库连接的配置。桌面端功能代理调试桌面端功能代理调试客户端调试工程添加dll引用：需要同时添加要调试功能对应的服务端和客户端工程的引用。桌面端功能代理调试桌面端功能代理调试客户端工程配置文件修改：修改对应客户端调试工程的配置文件的配置节点DataPortal.Mode和DataPortal.Url。桌面端功能代理调试桌面端功能代理调试运行程序调试：前面步骤配置完成后，启动程序进行调试（右键属性-调试-启动新实例），启动程序时要先将SIE.WebApiHost启动成功后再启动WpfClient客户端调试工程（也可以设置多个项目启动，同时将SIE.WebApiHost和WpfClient设置为启动项目）。WPFClient配置文件介绍WpfClient配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明1dev.generateDbOnStartupbool

false是是否弹出升级数据库对话框2DataPortal.Urlstringhttp://服务器IP:端口号/api/dataportal/Execute否数据门户请求的URL地址（apihost地址）注:DataPortal.Mode为Remote必须配置3DataPortal.TimeoutMinutesint

15否数据门户请求超时时间分钟数4DataPortal.Mode枚举Local/RemoteLocal是Local表示直连数据库，Remote表示通过服务中间件连数据库5loggerFactoryAdapterstring适配程序集完全限定名如:SIE.Log4Net.Log4NetLoggerFactoryAdapter,SIE.Log4Net

否日志适配设置，不设置将不记录日志信息6DevCulture枚举语言(文化)代码zh-CN否Dev开发语言7SieQueueConnectionStringstringhost=消息队列服务IP;virtualHost=/;username=sieque;password=sieque否消息队列MQ配置8Client.UpdateAddressstringhttp://服务器IP:端口号/9.1/Client/

否客户端更新程序地址04Api接口调试API接口调试Api接口调试Api接口调试是使用SIE.WebApiHost工程进行调试的，调试之前要把Api接口实现的工程添加引用到SIE.WebApiHost，同时根据需要修改服务的ip，数据库配置和redis服务的配置。添加项目工程的引用和更改配置文件API接口调试Api接口调试右键将SIE.WebApiHost设置为启动项目，F5启动程序（也可以选择SIE.WebApiHost右键启动），左图为启动的方式，右图为启动成功的服务界面显示。设置SIE.WebApiHost为启动项目进行调试API接口调试Api接口调试服务启动成功后，在浏览器输入http://localhost:1154/api/dataportal即可进入到我们的api平台进行调试，其中localhost:1154为Api服务对应的Ip和端口。Api平台API接口调试Api接口调试如调试EmployeeController控制器的GetEmployees方法，将ApiRequest的内容复制到请求中。复制开放接口的请求ApiRequest的内容API接口调试Api接口调试将上一步复制的接口信息粘贴到Api使用说明的“请求”中，更改传入接口的参数、票据和库存组织。Api使用说明配置接口请求的信息API接口调试Api接口调试点击上一步“请求”中的“POST”按钮，就可以执行到具体接口的代码实现。调试接口SIE.WebApiHost配置文件介绍SIE.WebApiHost配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明1AllowedHostsstring

*是项目自动生成（无需手动配置）2urlsstring

ApiHost：http://*:1034

WebClient:http://*:1038是域名与端口配置

注：端口不能重复，所以每一端都必须配置3server.serviceNamestring

否windows服务名称4server.serviceDisplayNamestring

否windows服务显示名称5server.serviceDescriptionstring

否windows服务描述6loggerFactoryAdapterstring适配程序集完全限定名如:SIE.Log4Net.Log4NetLoggerFactoryAdapter,SIE.Log4Net

否日志适配设置，不设置将不记录日志信息7Log.SqlTraceElapsedint

1000否监听SQL语句消耗时间，单位：毫秒

监听时间大于此时间，写入日志8Log.EnableAuditItembool

TRUE否true：启用监听登录日志/按钮操作日志SIE.WebApiHost配置文件介绍SIE.WebApiHost配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明9Log.Hoststring日志服务器例：37

否日志服务host地址10Log.RemotePortint

2020否日志远程端口11Log.LocalPortint

2019否日志本地端口12path.attachmentType枚举disk/ftp

是"disk"为磁盘上传下载跟path.attachment同时配置，path.attachment不设置将使用C:/MES/Attachment

"ftp"为ftp上传下载必须跟ftp.path、ftp.userName、ftp.password同时配置，否则配置不生效13ftp.pathstringftp访问地址例1：2:1005/例2：2/

否ftp使用默认端口(80),端口根据ftp服务设置端口设置14ftp.userNamestringftp用户名

否ftp用户名15ftp.passwordstringftp密码

否ftp密码16path.attachmentstringC:/MES/Attachment否path.attachmentType为disk才生效SIE.WebApiHost配置文件介绍SIE.WebApiHost配置文件介绍序号配置名称(KEY)值类型值说明默认值是否必须用途说明17ConnectionStrings@SectionJson"数据仓库名称":{

"Name":"数据仓库名称",

"ConnectionString":"连接字符串",

"ProviderName":"数据类型"

},

是数据库连接字符串，支持多库同时配置使用（Oracle/SqlServer）18RedisCacheJson"RedisCache":{

"Configuration":"缓存连接配置（连接字符串)",

"Sentinels":"服务节点列表",

"SentinelMasterConverter":"主机服务节点"

},

是Configuration:master,testcluster=false单机版的连接字符串，哨兵模式为：mymaster,password=123,prefix=my_;

Sentinels:哨兵服务节点列表，逗号分隔

SentinelMasterConverter:主机服务节点转换，逗号分隔单个规则，‘|’分隔多个转换规则;19RegisterServerInfo