【开发】特种设备(一):基本增删改查以及导入导出
需求说明
特种设备从属于设备,是设备的一个特殊分类。
现在公司要求把特种设备从设备中拎出来,单独做个页面,具备常规的增删改查,导入导出以及二维码的功能。
同时要求对特种设备的数据进行数据过滤和权限管控。
若依框架的数据过滤组件是成熟的,可以直接使用,而且配置也非常简单(通过主角
@DataScope
就可实现,主要是区分全部权限
,本部门权限
,本部门及其子部门
,共三种过滤。)
若依框架的权限管控有两个维度,一是
用户
维度,这种方式要求对每一个用户都进行赋权。二是角色
维度,将权限赋给角色,为用户分配角色,这样能够对权限进行集中管理,推荐
。)
特种设备和设备一样,同样具有设备验收和延迟验收的功能,功能入口均在移动端,位于公司企业微信内。
该功能开发完成后,每一个特种设备都会有唯一的二维码,该二维码会打印成设备标签,贴在设备上。
巡检人员只需要扫面二维码就可以完成设备填报的录入,如果遇到节假日,设备更改,设备整改等情况,还可以在移动端进行延迟验收,从而推迟下次检验日期。
同时要开发智能推送的功能,当一台设备临近下次检验日期时,提前30天,23天,以及当天各推送一次(共推送三次!)
表数据
CREATE TABLE `spec_equipment` (
`id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主键ID',
`category_id` bigint(20) NOT NULL COMMENT '设备分类ID',
`spec_name` varchar(255) NOT NULL COMMENT '特种设备名称',
`asset_model` varchar(255) NOT NULL COMMENT '规格型号',
`dept_id` varchar(255) NOT NULL COMMENT '所属部门',
`install_location` varchar(255) NOT NULL COMMENT '安装使用地点',
`factory_number` varchar(255) NOT NULL COMMENT '厂内使用编号',
`manufacturer` varchar(255) DEFAULT '' COMMENT '生产厂家',
`regist_code` varchar(255) DEFAULT '' COMMENT '设备注册登记代码',
`inspection_no` varchar(255) DEFAULT '' COMMENT '监督检验报告编号',
`last_inspection_date` datetime DEFAULT NULL COMMENT '上次检验日期',
`valid_period` int(5) DEFAULT '0' COMMENT '有效期(天)',
`next_inspection_date` datetime DEFAULT NULL COMMENT '下次检验日期',
`create_by` varchar(100) DEFAULT NULL COMMENT '创建人',
`create_time` datetime DEFAULT NULL COMMENT '创建时间',
`update_by` varchar(100) DEFAULT NULL COMMENT '更新人',
`update_time` datetime DEFAULT NULL COMMENT '更新时间',
`status` varchar(1) DEFAULT NULL COMMENT '状态(0正常 1停用)',
`attachment` varchar(500) DEFAULT NULL COMMENT '附件',
`reserve2` varchar(255) DEFAULT NULL COMMENT '预留字段2',
`reserve3` varchar(255) DEFAULT NULL COMMENT '预留字段3',
`reserve4` varchar(255) DEFAULT NULL COMMENT '预留字段4',
`reserve5` varchar(255) DEFAULT NULL COMMENT '预留字段5',
PRIMARY KEY (`id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=23 DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC COMMENT='特种设备';
增删改查,导入导出,这都是基础的功能,不用多说。
但是客户提了个改动,上次检验日期是必填的,有限期和下次检验日期是选填的。
如果有效期已填写,则判断下次检验日期是否填写,填写了,直接新增即可,未填写,则根据上次检验日期+有效期对应的天数,自行计算下次检验日期。
如果有效期未填写,则判断下次检验日期是否填写,填写了,直接新增即可,未填写,返回前台数据格式不正确。
另外再提一句,公司使用的框架版本是3.4.0,这种框架比较老,生成的代码中只有导出,没有导入的功能。
导入按钮
<el-col :span="1.5">
<el-button
type="info"
plain
icon="el-icon-upload2"
size="mini"
@click="handleImport"
v-hasPermi="['hxems:attach:import']"
>导入</el-button>
</el-col>
导入模态框
<!-- 特种设备导入对话框 -->
<el-dialog :title="upload.title" :visible.sync="upload.open" width="400px" append-to-body>
<el-upload
ref="upload"
:limit="1"
accept=".xlsx, .xls"
:headers="upload.headers"
:action="upload.url"
:disabled="upload.isUploading"
:on-progress="handleFileUploadProgress"
:on-success="handleFileSuccess"
:auto-upload="false"
drag
>
<i class="el-icon-upload"></i>
<div class="el-upload__text">将文件拖到此处,或<em>点击上传</em></div>
<div class="el-upload__tip text-center" slot="tip">
<span style="color:#ff0000">仅允许导入xls、xlsx格式文件。</span>
<el-link type="primary" :underline="false" style="font-size:12px;vertical-align: baseline;" @click="importTemplate">下载模板</el-link>
</div>
</el-upload>
<div slot="footer" class="dialog-footer">
<el-button type="primary" @click="submitFileForm">确 定</el-button>
<el-button @click="upload.open = false">取 消</el-button>
</div>
</el-dialog>
js方法
必须导入getToken
和importTemplate
。
getToken
方法是全局方法,引用即可,而importTemplate
是在equipment.js中单独定义的。
// 下载设备导入模板
export function importTemplate() {
return request({
url: '/equipment/importTemplate',
method: 'get'
})
}
这个方法importTemplate
需要在后台控制类中添加处理逻辑:
/**
* 导出特种设备模板
*/
@GetMapping("/importTemplate")
@Permission(level = ResourceLevel.SITE, permissionLogin = true)
public AjaxResult importTemplate(){
ExcelUtil<SpecEquipment> util = new ExcelUtil<>(SpecEquipment.class);
return util.importTemplateExcel("特种设备模板");
}
/**
* 导入特种设备列表
*/
@Log(title = "特种设备", businessType = BusinessType.IMPORT)
@PreAuthorize("@ss.hasPermi('hxems:archives:import')")
@PostMapping("/importData")
@Permission(level = ResourceLevel.SITE, permissionLogin = true)
public AjaxResult importData(MultipartFile file) throws Exception{
ExcelUtil<SpecEquipment> util = new ExcelUtil<>(SpecEquipment.class);
List<SpecEquipment> equipmentList = util.importExcel(file.getInputStream());
String message = specEquipmentService.importAssetArchives(equipmentList);
return AjaxResult.success(message);
}
前端vue页面:
import { getToken } from '@/utils/auth'
import { importTemplate } from "@/api/hxems/attach";
data(){
return {
// 下次检验日期时间范围
daterangeNextInspectionDate: [],
// 安全附件导入参数
upload: {
// 是否显示弹出层(组件导入)
open: false,
// 弹出层标题(组件导入)
title: "",
// 是否禁用上传
isUploading: false,
// 设置上传的请求头部
headers: { Authorization: "Bearer " + getToken() },
// 上传的地址
url: process.env.VUE_APP_BASE_API + "/3/attach/importData"
},
};
}
/** 导入按钮操作 */
handleImport() {
this.upload.title = "特种设备导入";
this.upload.open = true;
},
/** 下载模板操作 */
importTemplate() {
importTemplate().then(response => {
this.download(response.msg);
});
},
// 文件上传中处理
handleFileUploadProgress(event, file, fileList) {
this.upload.isUploading = true;
},
// 文件上传成功处理
handleFileSuccess(response, file, fileList) {
this.upload.open = false;
this.upload.isUploading = false;
this.$refs.upload.clearFiles();
this.$alert("<div style='overflow: auto;overflow-x: hidden;max-height: 70vh;padding: 10px 20px 0;'>" + response.msg + "</div>", "导入结果", { dangerouslyUseHTMLString: true });
this.getList();
},
// 提交上传文件
submitFileForm() {
this.$refs.upload.submit();
}
搞定。