百胜FIS2.0-OMD子系统-工程师审核接口设计v1.0.docxVIP

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