MES开发与应用 课件 3.12 工业管理软件开发基础-调度功能的使用与开发

3.12调度功能的使用与开发深圳市信息职业技术学院目

录调度功能介绍01调度界面配置说明02调度功能开发示例03常见异常问题列举04知识回顾接口介绍；Api接口的定义；Api接口的开发与测试；Api接口的调用。学习目标通过本节学习可以：掌握调度任务的配置；掌握调度参数类的开发实现；掌握调度任务类的开发实现；了解调度常见问题；01调度功能介绍调度功能介绍调度功能介绍调度：是指根据一定的策略和算法，按照预定的规则和优先级，安排任务或资源的执行顺序和时间分配的过程。工业管理软件的调度任务是指系统按配置要求，定时执行相关的任务，这里分别有两个方面，一个是要执行的任务，需要开发人员使用代码实现相关的业务逻辑，另一个是实施人员在系统中配置执行任务的时间、周期、参数等。使用调度的功能，如果是直连数据库调试，需要在WebClient工程中引用Hangfire.Oracle.Core.dll，SIE.Schedule.dll和SIE.Web.Schedule.dll，依赖的第三方包：Hangfire1.7.8，Hangfire.Core1.7.8。调度的数据库连接名：hangfire；VS自带的数据库连接配置"hangfire":{"Name":"hangfire","ConnectionString":"DataSource=(LocalDB)\\MSSQLLocalDB;AttachDbFilename=D:\\Project\\DEMO\\SMOM.Demo.V9.1\\App_Data\\DEMO_91.mdf;IntegratedSecurity=True;UserId=DEMO_91","ProviderName":"System.Data.SqlClient"},调度功能介绍调度功能介绍调度功能的开发，最好是与业务工程区分开，单独建调度工程进行调度功能的开发，工程名以Job结尾。命名规范：调度任务类命名以Job结尾；调度参数类命名以JobParameter结尾。做调度功能开发时，调度任务类是必须的，调度参数类非必须(根据具体的业务来决定是否需要参数类)。做调度功能开发时，日志必须记录详细。02调度界面配置说明调度界面配置调度界面配置调度的界面配置都是在“调度任务设置”功能配置完成的。调度界面配置调度界面配置在“调度任务设置”功能中添加调度任务，选择一笔数据，点击确定。调度界面配置调度界面配置调度名称可以修改，配置cron表达式和方法参数。调度界面配置调度界面配置配置调度任务参数（执行时间和周期）点击调度任务的“cron表达式”，可配置调度任务的执行时间及周期，即告诉调度器什么时候执行，或者隔多久执行一次。调度界面配置调度界面配置配置调度任务的参数（业务参数）点击调度任务的“方法参数”，即可弹出该任务的业务参数配置页面，该页面就是由调度任务参数视图进行配置的。调度界面配置调度界面配置配置完成后，保存数据，任务状态默认是可用的。调度界面配置调度界面配置运行和触发启动后点击触发按钮，进入调度任务排队等待，根据时间先后顺序执行。运行和触发的区别：运行：表示立即执行，在本地环境运行调度，在开发时可通过这个按钮进行调试调度任务。触发：进入排队等待，在调度服务运行，由调度器执行。触发依赖于调度服务，本地调试配置了cron表达式，点击触发，也不会定时去执行调度任务；在调度服务执行调度任务时，任务状态必须是启用的才会进行排队等待执行。思考题调度任务配置为每天的16点执行，该如何配置？03调度功能开发示例调度功能开发示例需求描述需求描述：开发一个调度任务，根据类别名称、状态来统计读者数量（类别名称和状态作为参数传入）。思考题上页PPT中，要实现需求描述的要求的调度任务，至少需要开发几个类？调度功能开发示例开发步骤开发调度参数类，命名以JobParameter结尾，标记特性根实体和序列化[RootEntity,Serializable]，继承JobParameter，通过代码段添加属性。调度功能开发示例开发步骤调度参数界面配置：跟普通实体视图配置一样，需继承WebViewConfig<T>，调度参数设置中弹出的是表单页面，所以调用的是ConfigDetailsView视图，相关字段在ConfigDetailsView设置即可。调度功能开发示例开发步骤调度任务类的开发：命名以Job结尾，继承JobBase，标记特性[Job(“统计读者数量”,typeof(ReaderJobParameter))]，实现调度任务执行方法ExecuteJob。调度功能开发示例调度任务类说明[Job("统计读者数量",typeof(ReaderJobParameter))]所有的调度任务类，都需要标记Job标签，用于告诉系统当前的类是一个调度任务类，在“调度任务设置”中识别并添加到调度任务中。JobBase所有的调度任务的类，都需要继承JobBase类，只有继承了JobBase，才提供相关调度任务的相关标准方法。ExecuteJob继承了JobBase的类，需要实现ExecuteJob方法，调度器在执行调度任务时，会自动调用调度任务类的ExecuteJob方法，就是说系统在定时执行这个方法。在执行ExecuteJob方法时，会将“调度任务设置”中设置的参数传给ExecuteJob的param参数。调度功能开发示例调度任务类说明AddLog调度任务在执行过程中，可以将相关的日志信息写入到数据库中，同时会在“调度任务设置”功能中看到。需要注意的是，调度任务中执行一次任务，就算写多个日志信息，都会合并成一个，并不会出现多条记录。ReaderJobParameter（JobParameter）ReaderJobParameter是自己定义的参数实体，用于提供当前调度任务类可以要接收的自定义业务参数，如果调度任务类不需要设定任何业务参数，则默认为JobParameter即可，即typeof(JobParameter)。调度功能开发示例开发步骤完成后，运行项目，在“调度任务设置”功能中，点击添加，任务就会添加进来了，就可以进行任务的配置了。04常见异常问题列举常见异常问题常见异常问题调度平台执行升级数据库操作升级表失败。问题描述：调度平台相关dll都依赖进来了，也配置了调度的数据库连接字符串且正确，但是执行升级数据库操作生成调度平台表时，生成表失败。原因：调度平台如果是使用的sqlserver数据库，使用平台的升级数据库操作可以正常生成调度平台的表；如果使用的是oracle数据库，使用平台的升级数据库操作无法生成调度平台的表。解决方案：平台使用的是oracle的数据库，则通过脚本生成调度相关表，脚本如下。常见异常问题常见异常问题调度任务需要先禁用再删除，否则删除后调度还会在hangfire运行。如果删除后调度还在运行，可以在调度的控制台Recurringjobs页签进行删除。常见异常问题常见异常问题部署的调度任务不执行。问题描述：部署后调度任务不执行，对应场景：调度测试环境（windows环境）执行成功，但正式环境（linux+docker）不执行。解决方案：打开调度控制台检查linux环境是否时区正确，两个系统的环境的时区标识是不是样的。常见异常问题常见异常问题下面第1个图是windows环境，第2个图是linux环境。常见异常问题常见异常问题某个调度任务执行失败。问题描述：其他调度任务都正常，某个调度任务执行不了或者失败，失败如下图。原因：调度服务没有发布，只发布了Host和BS。解决方案：调度服务、Host和BS同时发布。练习1、工业软件开发中，开发调度功能，调用任务是以Job结尾，继承JobBase类及子类吗?（）2、工业软件开发中，调度任务需要配置参数是需要继承JobParameter类吗?（）3、

工业软件开发中，调用任务如果定义了参数类并继承了JobParameter类