FIS 2.0-OMD子系统工程师审核 接口设计说明书
方正国际软件有限公司
1 / 9
百胜
文档控制
版本 1.0 作者/修改者 吴新宇 审核者 时间 2014-07-29 备注
2 / 9
接口方法设计说明
1、数据操作采用面向对象方式进行。 2、对象的Json格式在详细设计时提供。
3、接口方法设计只是初步方案，具体实现中可能有所改动，届时会予以通知。
接口设计考虑：
1、系统架构问题，omd2.0系统采用ORM方式访问数据库。
2、很多数据验证和内部操作和更新数据在对象保存过程中进行，这种方式的数据处理比较成熟，已经经过大量测试实践验证、具有可靠性，安全性，系统影响小，风险低。
3、接口实现与具体移动端需求无关。 4、开发成本和测试成本低。
5、减少对原系统的访问数量，及操作。
接口设计变更说明：
1、 新增接口GetRepairSheetList 2、 新增接口GetAttachmentList
接口使用说明：
1、
UrlEnCode编码问题：
基于安全性、可实现性方面考虑，对实体传输进行了编码 详细使用只要先取的实体的集合，处理后，编码传输即可
2、
对子项进行增删改操作时请按照：
新增子项：复制现有项格式，修改ID=0，update操作 删除子项：实体字符串中，删除该节点及子节点，update操作 修改子项：实体字符串中，直接修改相应项，update操作
3 / 9
一、接口方法GetRepairSheetList
1、 GetRepairSheetList
接口方法名 接口方法说明 获取工单列表 使用说明 备注 GetRepairSheetList
1.1 (GetRepairSheetList) 方法参数:
参数 参数名称 数据类型 是否必填 参数格式 F873E667-54F6-4C81-B35B-B53B3FA7F40F 1 1 说明 guid 验证用户的ID 字符 必填项 LoginCheck获取的guid currentUserID currentRoleID marketIDs brandIDs storeNameOrCode startDate endDate 当前登录用户ID 当前登录角色ID 市场IDs 品牌IDs 餐厅名称或餐厅编码 服务商实际结案日期(开始) 服务商实际结案日期(截止) 数字 数字 必填项 必填项 1维修中2暂缓3已修复4已审价已审核5已完成6已停止7已报价已完善 0全部 status 工单状态 facilityType supplierCheckResultID sheetType startCompleteDate endCompleteDate factRepairStartDate factRepairEndDate facilityTypeChange sheetSearchType 设施设备类型 服务商验收结果 工单类型 修复日期（开始） 修复日期（截止） 第一次到店日期（开始） 第一次到店日期（截止） 是否转设备/设施 1维修2保养 1多状态查询2巡检关注3工单跟踪4工单批量审价/审核工单5费用争议6锁定 查询条件 4 / 9
