README-staff-api.md 1.77 KB

员工API使用说明

概述

已成功调整健康师和科技部人员的API使用,现在都使用封装好的appointmentApi.getHealthWorkerList接口。

调整内容

1. 健康师API (getJksOptions)

  • 使用接口: appointmentApi.getHealthWorkerList
  • 搜索参数: jksxm (健康师姓名)
  • 返回字段映射:
    • value: item.id
    • label: item.jksxm || item.name || 默认名称
    • jkszh: item.id
    • jksxm: item.jksxm || item.name || 默认名称
    • subtitle: item.department || item.role || ''

2. 科技部人员API (getKjbOptions)

  • 使用接口: appointmentApi.getHealthWorkerList
  • 搜索参数: kjblsxm (科技部人员姓名)
  • 筛选参数: department: '科技部' (可根据实际API调整)
  • 返回字段映射:
    • value: item.id
    • label: item.kjblsxm || item.name || 默认名称
    • kjblszh: item.id
    • kjblsxm: item.kjblsxm || item.name || 默认名称
    • subtitle: item.department || item.role || ''

使用方式

在Vue组件中调用

// 获取健康师选项
const jksOptions = await this.getJksOptions(1, '搜索关键词');

// 获取科技部人员选项
const kjbOptions = await this.getKjbOptions(1, '搜索关键词');

参数说明

  • page: 页码,从1开始
  • searchKeyword: 搜索关键词,可选

错误处理

  • 当API调用失败时,会返回空数组 []
  • 错误信息会输出到控制台
  • 支持分页和搜索功能

注意事项

  1. 两个API都使用同一个后端接口,通过不同的参数进行区分
  2. 科技部人员通过department: '科技部'参数进行筛选
  3. 字段映射考虑了多种可能的字段名称,确保兼容性
  4. 当字段不存在时,会使用默认值或索引生成名称