主题
自定义城市等级
基础信息
| 项 | 说明 |
|---|---|
| 菜单路径 | /operationsManagement/defineCityLevels |
| 路由名称 | productManage-defineCityLevels |
| 页面组件 | src/views/operationsManagement/defineCityLevels/index.vue |
| 接口模块 | 组件内 this.$api.post(...) 直接调用 |
| Store | 无 |
| 页面定位 | 按合作企业客户维护其自定义的城市等级配置(一线 / 二线等),支持列表查看、Excel 模板下载与导入 |
页面功能
列表页用于管理各合作企业(承保公司)自定义的城市分级配置。筛选区按合作企业客户查询,操作区提供导入与下载模板,表格行可展开查看该企业下的城市等级明细。
1. 筛选条件
- 合作企业客户:使用承保公司选择器组件
v-accept-Insurance-company选择,选中后取其id作为businessCustomerId。
2. 操作按钮
- 导入:打开
ImportPopup弹窗(type="2"后台解析模式),上传 Excel 文件后由后端解析。 - 下载模板:前端按内置多 sheet 模板生成「城市等级模板.xlsx」(含「合作企业」「城市定义」两个 sheet),不调接口。
3. 表格字段(主表)
序号、合作企业客户(businessCustomerName)、业务类型(businessTypeName)、创建时间(createTime)、操作人(createPersonName)。
主表含 type="expand" 展开行,展开后渲染该企业下的城市等级明细子表 configList,字段:城市级别(levelName)、城市(cityName)、城市编码(cityCode)、省份/直辖市(provinceName)、省份/直辖市编码(provinceCode)。
4. 导入弹窗(ImportPopup 组件)
components/ImportPopup.vue,标题「导入城市等级」,采用后台解析模式(type="2",父级传入)。流程:
- 「选取文件」选择 Excel(可多选,列出文件名,单选 radio 选定要上传的文件)。
- 「确认上传」将选中的文件封装为
FormData(字段名uploadFile),调用cityLevel/importList上传,成功后刷新列表。
注:该弹窗组件内含前端解析(
type="1")分支逻辑及必填校验(依赖父级importParams),但本页固定以type="2"调用,故前端校验分支不触发。
5. 下载模板
页面内置的模板数据(list / sheetNames)通过 export2multiExcel(@/assets/js/excelexport.js)导出为多 sheet 的 Excel 文件,结构为:
- sheet1「合作企业」:合作企业客户、合作企业客户编码、业务类型、业务类型编码(含示例行「大地宠财险_宠物增值服务」)。
- sheet2「城市定义」:合作企业客户编码、城市级别、城市级别编码、城市、城市编码、省份/直辖市、省份/直辖市编码(含一线 / 二线示例行)。
使用组件
| 组件 | 路径 | 用途 |
|---|---|---|
Container | @/components/container | 页面容器 |
SearchContainer / TableContainer | @/components/SearchTableContainer/index.js | 筛选区 / 表格区容器 |
ImportPopup | ./components/ImportPopup | 导入城市等级弹窗 |
export-excel | @/components/exportExcel/export | 下载模板按钮触发 |
v-accept-Insurance-company | @/components/acceptInsuranceCompany/v-accept-Insurance-company | 合作企业客户(承保公司)选择器 |
export2multiExcel | @/assets/js/excelexport.js | 多 sheet 模板导出(JS 方法) |
使用 Store
无。
调用接口
所有接口实际请求统一带
/api前缀(下表为业务路径简写)。
| 接口 URL | 方法 | 用途 |
|---|---|---|
cityLevel/pageQuery | POST | 城市等级配置分页列表(含每行 configList 明细) |
cityLevel/importList | POST(FormData) | 上传 Excel 文件,后端解析并导入城市等级 |
承保公司下拉数据由
v-accept-Insurance-company组件内部获取,未在本页直接调用。
修改记录
| 修改人 | 修改时间 | 修改内容 |
|---|---|---|
| zhouw | 2026-07-03 | 初始化页面 |
| zhouw | 2026-07-09 | 编写页面内容 |