工业管理软件Api接口和调度功能开发案例-实训任务书.docx

工业管理软件Api接口和调度功能开发案例实训任务书

一、实训目的

本课程的教学目的是让学生掌握工业管理软件Api接口和调度功能的开发流程和关键技术。

从系统的需求分析出发，了解到开发需要实现和满足的实际业务功能点；根据功能点的业务需求。使用VisualStudio2019及以上开发工具对其进行开发实现，然后在功能中进行测试，完成Api接口和调度功能的开发实现及效果验证。

通过综合实训帮助学生全面牢固地掌握教学内容、培养学生的实践动手能力，提高学生综合运用专业知识和专业技能解决实际问题的能力，强化课堂教学与实践教学相结合，锻炼学生的职业能力。

实训描述

根据实训内容，完成对Api接口和调度功能的开发实现和效果验证。通过实训，让学生掌握工业管理软件中Api接口的开发与调试，调度和调度参数的开发实现，同时能够对完成或存在异常的调度任务进行配置和调试，从而提高学生的实操能力，以便学生熟练掌握工业软件Api接口和调度功能的开发步骤。

三、实训准备

1、掌握C#编程开发技能。

2、了解工业管理软件的基础开发。

3、事先要能够根据实训工程源代码，配置环境，搭建项目工程。

4、安装好实训开发环境，下载实训工程源代码。

5、Api接口和调度功能的开发依赖于采购订单，需要先完成采购订单功能的开发实现。

四、实训环境

Windows10或以上操作系统(不能是Windows11家庭版)、Visual?Studio2019或以上开发工具安装、数据库可以选择SqlServer数据库（安装VS时将VS自带的SqlServer安装上，就可以不用单独安装SqlServer的数据库）或者Oracle数据库（安装ODAC、安装Oracle客户端、安装PLSQL）、安装EAP.Modelfirst、VS中导入代码片段。

五、实训内容

实训任务：Api接口与调度任务功能

实现逻辑包括：

Api接口：

传入参数：开始时间和结束时间（不可为空），页数（可为空，为空查第一页），页数据数量（可为空，为空查所有）；

接口实现逻辑：传入的开始时间和结束时间去跟采购日期进行匹配，开始时间〈=采购日期〈=结束时间，根据页数和页数据量将满足条件的订单和对应订单明细的数据返回；

接口返回值说明：

订单包含的字段内容：订单号、采购日期、订单总金额、订单状态、备注；

订单明细包含的字段内容：产品编码、产品名称、采购价、销售价、采购数量、总金额、备注；

接口完成后需要编写接口卡。

调度任务：

调度任务执行逻辑：根据页数和页数据量查询采购信息，查询数据按采购时间的升序进行排序，通过调度定时去更改采购订单的状态，状态变更的条件：

订单对应所有订单明细的入库数量为0，采购订单的状态变更为新建；

订单对应所有订单明细的0〈入库数量〈采购数量，采购订单的状态变更为部分接收；

订单对应所有订单明细的入库数量=采购数量，采购订单的状态变更为全部接收；

调度参数：页数、页数据量，调度任务未配置页数和页数量，提示页数和页数据量必须配置；

调度任务必须记录日志信息；