Blame view

绿纤uni-app/apis/modules/README-staff-api.md 1.77 KB
29608708   李宇   增加unia-app和html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
  # 员工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组件中调用
  ```javascript
  // 获取健康师选项
  const jksOptions = await this.getJksOptions(1, '搜索关键词');
  
  // 获取科技部人员选项
  const kjbOptions = await this.getKjbOptions(1, '搜索关键词');
  ```
  
  ### 参数说明
  - `page`: 页码,从1开始
  - `searchKeyword`: 搜索关键词,可选
  
  ## 错误处理
  - 当API调用失败时,会返回空数组 `[]`
  - 错误信息会输出到控制台
  - 支持分页和搜索功能
  
  ## 注意事项
  1. 两个API都使用同一个后端接口,通过不同的参数进行区分
  2. 科技部人员通过`department: '科技部'`参数进行筛选
  3. 字段映射考虑了多种可能的字段名称,确保兼容性
  4. 当字段不存在时,会使用默认值或索引生成名称