模塊一:文件上傳
1、工作錄像上傳
-
請求地址 :
當type=1維保任務: 192.168.1.101:8080/appLiftController/saveMainPlanVideo.do
當type=2維修任務: 192.168.1.101:8080/appLiftRepairController/saveRepairVideo.do
-
請求參數:
參數名 描述 taskId 任務ID files 視頻文件
-
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
2、工作拍照上傳
-
請求地址 :
當type=1維保任務: 192.168.1.101:8080/appLiftController/saveMainPlanPic.do
當type=2維修任務:192.168.1.101:8080/aappLiftRepairController/saveRepairPic.do
-
請求參數:
參數名 描述 taskId 任務ID files 上傳的圖片集合
-
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
模塊二:簽到簽退
1、獲取今日簽到與簽退記錄
請求地址 : 192.168.1.101:8080/appLoginController/getUserSignToDay.do
-
請求參數:
參數名 描述 userId 用戶ID createRiQi 當日的日期
-
返回值:
"{\"success\":true, \"msg\":\"獲取數據成功!\", \"listModel\":[{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"測試 \",\"createDate\":\"Nov 6, 2017 8:08:21 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"1\",\"createRiQi\":\"2017-11-06\"},{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"測試\",\"createDate\":\"Nov 6, 2017 8:08:20 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"2\",\"createRiQi\":\"2017-11-06\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 listModel 簽到和簽退記錄的集合 listModel[i].type 1:簽到;2:簽退
2、簽到或簽退
請求地址 : 192.168.1.101:8080/appLoginController/appUserSign.do
-
請求參數:
參數名 描述 userId 用戶ID longitude 經度值 latitude 緯度值 address 簽到或簽退的地址 realName 真實姓名 orgId 公司ID phoneNo 用戶手機號 type 1:執行簽到;2:執行簽退
-
返回值:
"{\"success\":true,\"msg\":\"保存成功!\"}"
說明:
key description msg 消息提示 success 接口處理成功與否
3、獲取簽到和簽退的歷史記錄
請求地址 : 192.168.1.101:8080/appLoginController/getAppUserSignList.do
-
請求參數:
參數名 描述 userId 用戶ID page 獲取第幾頁
-
返回值:
"{\"success\":true, \"msg\":\"獲取數據成功!\", \"listModel\":[{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"測試 \",\"createDate\":\"Nov 6, 2017 8:08:21 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"1\",\"createRiQi\":\"2017-11-06\"},{\"longitude\":39.121212005615234,\"latitude\":139.1212158203125,\"address\":\"測試\",\"createDate\":\"Nov 6, 2017 8:08:20 PM\",\"realName\":\"123\",\"userId\":\"123\",\"orgId\":\"123\",\"phoneNo\":\"123\",\"type\":\"2\",\"createRiQi\":\"2017-11-06\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 listModel 簽到和簽退記錄的集合 listModel[i].type 1:簽到;2:簽退
模塊三:維保和維修任務
1、獲取任務的列表
請求地址 : 192.168.1.101:8080/appLiftController/getTaskList.do
-
請求參數:
參數名 描述 userId 用戶ID flag 0:新任務;1:歷史人物;2:今日任務 page 獲取第幾頁
-
返回值:
"{\"success\":true,\"msg\":\"獲取數據成功!\",\"listModel\":[{\"taskId\":\"402881e55fa9fb00015faa0045c20011\",\"liftLocation\":\"測試-11\",\"address\":\"天津市-市轄區-河東區-12號\",\"taskDate\":\"2017-11-23 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"liftType\":\"2\"},{\"taskId\":\"402881e55fa9fb00015faa00453e000f\",\"liftLocation\":\"測試-11\",\"address\":\"天津市-市轄區-河東區-12號\",\"taskDate\":\"2017-11-15 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"liftType\":\"2\"},{\"taskId\":\"402881e55fa9fb00015faa004473000d\",\"liftLocation\":\"測試-11\",\"address\":\"天津市-市轄區-河東區-12號\",\"taskDate\":\"2017-11-13 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"liftType\":\"2\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 listModel 任務集合 集合中個條任務項的的屬性說明:
taskId:任務ID
liftLocation: 列表項中顯示的第一條信息
address:列表項中顯示的第二條信息
taskDate:列表項中顯示的第二條信息
taskType:1:維保;2:維修
liftType:任務中電梯所屬的類型
2、今日任務>執行任務(上傳工時)
請求地址 : 192.168.1.101:8080/appLiftController/saveMainTimer.do
-
請求參數:
參數名 描述 outDate 執行的觸發時間 taskId 任務ID userName 用戶名 userId 用戶ID
-
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
3、獲取任務詳情
請求地址 : 192.168.1.101:8080/appLiftController/getTaskInfo.do
-
請求參數:
參數名 描述 taskId 任務ID taskType 1:維保; 2:維修
-
返回值:
"{\"success\":true,\"msg\":\"獲取數據成功!\",\"model\":{\"taskId\":\"402881e55fa9fb00015faa0045c20011\",\"liftLocation\":\"測試-11\",\"address\":\"天津市-市轄區-河東區-12號\",\"taskDate\":\"2017-11-23 00:00:00.0\",\"taskType\":\"1\",\"liftId\":\"402892865f531241015f53136cb60001\",\"userName\":\"test\",\"liftType\":\"3\",\"taskPositions\":\"1,2,3,4,5\",\"status\":\"1\"}}"
說明:
key description msg 消息提示 success 接口處理成功與否 model 任務的詳細信息 任務對象屬性說明:
liftType:任務所屬電梯的類型;
taskPositions:詳細信息中維修點>1:機房,2:轎頂;3:轎廂;4:廳門,5:坑底,
6:上平層外部,7:曳引機,8:控制柜,9:上平層內部,10:傾斜段
11:下平層外部,12:下平層內部,13:機房,14:轎頂;15:轎廂;16:廳門,17:坑底(雜貨梯)
4、獲取電梯詳情
請求地址 : 192.168.1.101:8080/appLiftController/getLiftInfo.do
-
請求參數:
參數名 描述 liftId 電梯ID
-
返回值:
"{\"msg\":\"獲取數據成功!\",\"success\":true,\"model\":{\"brandName\":\"12\",\"liftChangeModel\":\"11\",\"liftCode\":\"11\",\"liftFactoryCode\":\"233\",\"liftLocation\":\"測試-11\",\"liftModel\":\"11\",\"liftType\":\"3\",\"liftTypeStr\":\"自動扶梯電梯\",\"mainAddress\":\"天津市-市轄區-和平區-市轄區-12號\",\"mainDepartname\":\"津奧電梯\",\"mainDescription\":\"1111\",\"mainFax\":\"13512311122\",\"mainMobile\":\"13512311122\",\"mainPerson\":\"12\",\"mySpeed\":\"11\",\"myWidth\":\"11\",\"projectAddress\":\"天津市-市轄區-河東區-市轄區-12號\",\"projectName\":\"測試\",\"projectOrgName\":\"津奧電梯\",\"promoteHeight\":\"11\",\"registerCode\":\"123123\",\"tiltAngle\":\"11\",\"transportAbility\":\"11\",\"useSectionLength\":\"11\",\"userAddress\":\"遼寧省-營口市-站前區-營口市-11hao\",\"userDepartname\":\"信諾電梯\",\"userDescription\":\"2222\",\"userFax\":\"13512322211\",\"userMobile\":\"13512322211\",\"userPerson\":\"12344\",\"vendorName\":\"sdd\"}}"
說明:
key description msg 消息提示 success 接口處理成功與否 model 電梯的詳細信息 電梯對象屬性說明:
liftChangeModel:電梯改造后型號;
...(詳細見說明文件)
5、獲取維保要求列表
請求地址 : 192.168.1.101:8080/appLiftController/getMainPlanBillInfo.do
-
請求參數:
參數名 描述 liftType 根據上一頁面所傳的lifttype 判斷傳值(124567 傳1 3傳2 89傳3) liftPosition 電梯的維保點(如1:機房,2:轎頂;3:轎廂等)
-
返回值:
"{\"msg\":\"獲取數據成功!\",\"success\":true,\"model\":[{\"id\":\"402892865f37bc6e015f37c0bf6b000d\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-1\",\"wbProject\":\"清潔、潤滑、環境\",\"wbRequirement\":\"清潔、門窗完好 照明正常\"},{\"id\":\"402892865f37bc6e015f37c14452000f\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-2\",\"wbProject\":\"緊急操作裝置\",\"wbRequirement\":\"手動或電動制動器釋放\"},{\"id\":\"402892865f37bc6e015f37c186780011\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-3\",\"wbProject\":\"曳引機\",\"wbRequirement\":\"溫度、噪音\"},{\"id\":\"402892865f37bc6e015f37c1c1d00013\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-4\",\"wbProject\":\"制動器各銷軸\",\"wbRequirement\":\"潤滑、動作靈活\"},{\"id\":\"402892865f37bc6e015f37c203c80015\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-5\",\"wbProject\":\"制動器間隙\",\"wbRequirement\":\"打開時(0.125-0.7)\"},{\"id\":\"402892865f37bc6e015f37c26d760017\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-6\",\"wbProject\":\"編碼器\",\"wbRequirement\":\"潤滑、靈活、電氣開關正常\"},{\"id\":\"402892865f37bc6e015f37c2b1740019\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-7\",\"wbProject\":\"控制柜\",\"wbRequirement\":\"清潔、繼電器阻值\"},{\"id\":\"402892865f37bc6e015f37c2f114001b\",\"liftBigType\":\"1\",\"position\":1,\"typeCode\":\"A1-8\",\"wbProject\":\"機房溫度\",\"wbRequirement\":\"5~40℃\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 model 對電梯點的維保要求的集合
6、獲取工作結果列表
請求地址 : 192.168.1.101:8080/appLiftController/getAttachment.do
-
請求參數:
參數名 描述 planId 任務ID
-
返回值:
"{\"msg\":\"保存數據成功!\", \"scans\":[{\"id\":\"12312313\",\"orgId\":\"402892865eeb26fd015eeb37d5490006\",\"orgName\":\"津奧電梯\",\"planId\":\"402892865f759965015f759cbc1b000e\",\"scanContent\":\"402892865f23c442015f23e46ef10020-402892865f283977015f283a6c190003-A4-1\",\"scanDate\":1509546432000,\"scanResult\":\"掃描 轎廂 序號:1 成功\",\"scanUserId\":\"402892865f42099c015f422bd8fa0003\",\"scanUserName\":\"wb123\"}], \"success\":true, \"videos\":[{\"id\":\"123131321qweqqe\",\"planId\":\"402892865f759965015f759cbc1b000e\",\"videoDate\":1509602201000,\"videoName\":\"測試123\",\"videoPathVirtual\":\"upload/qrcode/C5B0015D2B0E9331C0C9CA8144948C29.mp4\" ,\"videoPicPath\":\"upload/qrcode/5618ee3eed8ac.jpg\"}], \"pics\":[{\"id\":\"12312323\",\"picDate\":1509590563000,\"picName\":\"測試(2017.11.02)\",\"picPath\":\"E:\\\\workspace-zeruiIDE\\\\zrkj-plat\\\\zrkj-web\\\\target\\\\zrkj-web\\\\/upload/qrcode/402892865f531241015f53136cb60001BN68m48381.png\",\"picPathVirtual\":\"upload/qrcode/5618ee3eed8ac.jpg\",\"planId\":\"402892865f759965015f759cbc1b000e\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 scans 掃描表單結果的集合 videos 上傳視頻結果的集合 pics 上傳圖片結果的結合
模塊四:電子填單
1、維保填單提交
請求地址 : 192.168.1.101:8080/appLiftController/saveMainPlanBill.do
-
請求參數:
參數名 描述 liftMainPlanBills List<TLiftMainPlanBill>表單子項的集合 planId 任務ID userId 用戶ID userName 用戶名 TLiftMainPlanBill對象屬性說明:
private String typeId; 表單的子項的ID private String bc1; 該子項的第一條信息 private String bc2; ... private String bc3; ... private String bc4; ... private String bc5; private String bc6;
-
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
2、維修填單提交
請求地址 : 192.168.1.101:8080/appLiftRepairController/saveRepairBill.do
-
請求參數:
參數名 描述 liftRepairSupplies List<TLiftRepairSupplies>使用材料的集合 taskId 任務ID adjustment 調整內容 replaceParts 更換零件 TLiftRepairSupplies對象屬性說明:
private String partId; 材料ID private String num; 材料使用數量 private float totalMoney; 材料使用總價
-
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
3、維修電子填單>獲取材料列表
請求地址 : 192.168.1.101:8080/appLiftRepairController/getPartsList.do
-
請求參數:
參數名 描述 liftId 要維修的電梯的ID page 獲取第幾頁
-
返回值:
"{\"msg\":\"獲取數據成功!\",\"success\":true,\"model\":[{\"id\":\"402892865f1ae2a7015f1ae434930006\",\"partPrice\":123,\"partUnit\":1,\"partsCode\":\"123\",\"partsName\":\"133r\",\"partsType\":\"wee\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 model 材料對象的集合 每個材料對象的屬性說明:
id:材料ID
partPrice:單價
partUnit:單位 只_1,根_2,臺_3,套_4
partsName: 材料名稱
模塊五:電梯新增
1、獲取組織機構或使用單位的列表
請求地址 : 192.168.1.101:8080/appLiftController\getLiftOrgInfo3.do
請求參數(無)
-
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true,\"model\":[{\"name\":\"津奧電梯\",\"pId\":\"1\",\"id\":\"402892865eeb26fd015eeb37d5490006\"},{\"name\":\"信諾電梯\",\"pId\":\"1\",\"id\":\"402892865ef1dfa9015ef1ed9a0f0006\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 model 組織機構或使用單位的對象集合
2、獲取項目的列表
請求地址 : 192.168.1.101:8080/appLiftController/getProject.do
-
請求參數:
參數名 描述 orgId 公司ID -
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true,\"model\":[]}"
說明:
key description msg 消息提示 success 接口處理成功與否 model 項目的集合
3、根據供應商名稱模糊搜索電梯
請求地址 : 192.168.1.101:8080/appLiftController/getVendor.do
-
請求參數:
參數名 描述 vendorName 供應商名稱的關鍵字
-
返回值:
"{\"msg\":\"獲取數據成功!\",\"success\":true,\"model\":[{\"address\":\"\",\"brandCode\":\"ca\",\"brandName\":\"12\",\"brandType\":\"qa\",\"city\":\"\",\"createDate\":1507987504000,\"createUser\":\"系統管理員\",\"id\":\"402892865f1b0d53015f1b0f3c1e000a\",\"partsBrandList\":[{\"id\":\"402892865f1b6bf7015f1b6c91bf0003\",\"tLiftParts\":{\"brandId\":\"402892865efe9cb8015efea8d2b90005\",\"brandName\":\"奧的斯\",\"createDate\":1507984684000,\"createUser\":\"系統管理員\",\"id\":\"402892865f1ae2a7015f1ae434930006\",\"partPrice\":123,\"partUnit\":1,\"partsCode\":\"123\",\"partsName\":\"133r\",\"partsType\":\"wee\",\"vendorId\":\"402892865f1ae2a7015f1ae35a990003\",\"vendorName\":\"123\"},\"tLiftVendorBrand\":{\"$ref\":\"$.model[0]\"}}],\"person\":\"aa\",\"phone\":\"13511266611\",\"province\":\"遼寧省\",\"vendorName\":\"sdd\"}]}"
說明:
key description msg 消息提示 success 接口處理成功與否 model 電梯對象的集合
4、新增直梯或雜貨梯
請求地址 : 192.168.1.101:8080/appLiftController/saveLiftApp.do
-
請求參數:
參數名 描述 userId 用戶ID userName 用戶名 orgId 公司ID createUser 用戶真實名字 createOrgId 所選的組織機構ID projectId 所選的項目ID useOrgId 所選的使用單位ID maintenanceOrgId 所選的維保單位ID registerCode 注冊代碼 brandId 電梯品牌ID liftCode 電梯編號 liftLocation 電梯位置 liftType 電梯類型ID liftFactoryCode 電梯出場編碼 liftModel 電梯型號 liftChangeModel 電梯改造后的型號 controlMode 控制方式 ratedLoad 額定載重 ratedSpeed 額定速度 layer 層數 station 站 door 門 -
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
5、新增扶梯
請求地址 : 192.168.1.101:8080/appLiftController/saveLiftApp.do
-
請求參數:
參數名 描述 userId 用戶ID userName 用戶名 orgId 公司ID createUser 用戶真實名字 createOrgId 所選的組織機構ID projectId 所選的項目ID useOrgId 所選的使用單位ID maintenanceOrgId 所選的維保單位ID registerCode 注冊代碼 brandId 電梯品牌ID liftCode 電梯編號 liftLocation 電梯位置 liftType 電梯類型ID liftFactoryCode 電梯出場編碼 liftModel 電梯型號 liftChangeModel 電梯改造后的型號 controlMode 控制方式 mySpeed 名義速度 tiltAngle 傾斜角度 promoteHeight 提升高度 myWidth 名義寬度 transportAbility 輸送能力 useSectionLength 使用區段長度 -
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
模塊六:二維碼掃描
1、維修或維保掃碼
-
請求地址 :
當type=1維保任務: 192.168.1.101:8080/appLiftRepairController/saveRepairScan.do
當type=2維修任務: 192.168.1.101:8080/appLiftController/saveMainScan.do
-
請求參數:
參數名 描述 userName 用戶名 userId 用戶ID orgId 公司ID orgName 公司名稱 scanContent 掃描結果 taskId 任務ID
-
返回值:
"{\"msg\":\"保存數據成功!\",\"success\":true}"
說明:
key description msg 消息提示 success 接口處理成功與否
其他
1、實時上傳定位
請求地址 : 192.168.1.101:8080/appLoginController/appUserLocation.do
-
請求參數:
參數名 描述 longitude 經度 latitude 緯度 address 實時地址 realName 真實姓名 orgId 公司ID phoneNo 手機號
-
返回值:
"{\"success\":true,\"msg\":\"保存成功!\"}"
說明:
key description msg 消息提示 success 接口處理成功與否
Copyright?天津澤瑞科技