Skip to content

自定义城市等级

基础信息

说明
菜单路径/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/pageQueryPOST城市等级配置分页列表(含每行 configList 明细)
cityLevel/importListPOST(FormData)上传 Excel 文件,后端解析并导入城市等级

承保公司下拉数据由 v-accept-Insurance-company 组件内部获取,未在本页直接调用。

修改记录

修改人修改时间修改内容
zhouw2026-07-03初始化页面
zhouw2026-07-09编写页面内容