背景场景： {#%E8%83%8C%E6%99%AF%E5%9C%BA%E6%99%AF%EF%BC%9A}

在现代化的企业管理系统中，用户管理是核心模块之一。为了支持多样化的用户角色和动态的系统变量，提供灵活的 API 接口显得尤为重要。本篇指南将介绍如何通过 API 创建用户，并为用户分配角色与系统变量，满足企业复杂业务需求。

步骤： {#%E6%AD%A5%E9%AA%A4%EF%BC%9A}

注意事项

在创建用户时，如果需要传递系统变量，必须提前查询系统变量及其对应的值I D。这包括：

• 使用系统变量查询接口获取所有相关系统变量的详细信息。

• 查询指定系统变量的值，以获取需要使用的值 ID。

创建用户请求说明

API 接口：/de2api/user/create

以下是创建用户所需的请求参数说明：

|-------------|----------|----------|-----------------|----------| | 名称 | 是否必填 | 请求类型 | 数据类型 | 说明 | | name | true | Body | integer(int32) | 名称 | | account | true |
| integer(int32) | 账号 | | email | true |
| string | 邮箱 | | phonePrefix |
|
| BaseGridRequest | 电话前缀 | | phone |
|
| string | 电话 | | roleIds | true |
| array | 角色 ID 集合 | | enable | true |
| boolean | 状态 | | variables |
|
| array | 系统变量 |

请求参数示例

以下是请求体的完整示例：

{
  "id": null,
  "account": "demo1",
  "name": "demo1",
  "email": "856132659@qq.com",
  "enable": true,
  "phone": "13286599634",
  "phonePrefix": "+86",
  "roleIds": [
    "2"
  ],
  "variables": [
    {
      "variableId": "1026186754438336512",
      "variableValueId": "",
      "valueList": [
        {
          "id": "1026186967089549312",
          "sysVariableId": "1026186754438336512",
          "value": "男",
          "begin": "",
          "end": ""
        },
        {
          "id": "1026186982386176000",
          "sysVariableId": "1026186754438336512",
          "value": "女",
          "begin": "",
          "end": ""
        }
      ],
      "sysVariableDto": {
        "id": "1026186754438336512",
        "type": "text",
        "name": "性别",
        "min": null,
        "max": null,
        "startTime": null,
        "endTime": null,
        "root": false,
        "disabled": false
      },
      "variableValue": null,
      "variableValueIds": [
        "1026186967089549312"
      ]
    },
    {
      "variableId": "1059810370333577216",
      "variableValueId": "",
      "valueList": [
        {
          "id": "1059810459298959360",
          "sysVariableId": "1059810370333577216",
          "value": "商务部一组",
          "begin": "",
          "end": ""
        }
      ],
      "sysVariableDto": {
        "id": "1059810370333577216",
        "type": "text",
        "name": "省级",
        "min": null,
        "max": null,
        "startTime": null,
        "endTime": null,
        "root": false,
        "disabled": false
      },
      "variableValue": null,
      "variableValueIds": [
        "1059810459298959360"
      ]
    }
  ]
}

查询系统变量列表

为了正确分配系统变量，需要先查询系统变量列表。

API 接口：POST {{url}}/de2api/sysVariable/value/selected/{goPage}/{pageSize}

|---------------|----------|----------|----------------|---------| | 名称 | 是否必填 | 请求类型 | 数据类型 | 说明 | | goPage | true | path | integer(int32) | 页数 | | pageSize | true | path | integer(int32) | 页数大小 | | sysVariableId | true |
| integer(int32) | 系统变量 id | | value |
|
| string |
|

请求参数示例

{
  "id": 0,
  "type": "",
  "name": "",
  "min": 0,
  "max": 0,
  "startTime": "",
  "endTime": "",
  "root": true,
  "disabled": true
}

查询系统变量的值

获取系统变量的值，以便在创建用户时正确分配。

API 接口：POST {{url}}/de2api/sysVariable/value/selected/{goPage}/{pageSize}

|---------------|----------|----------|----------------|---------| | 名称 | 是否必填 | 请求类型 | 数据类型 | 说明 | | goPage | true | path | integer(int32) | 页数 | | pageSize | true | path | integer(int32) | 页数大小 | | sysVariableId | true |
| integer(int32) | 系统变量 id | | value |
|
| string |
|

请求参数示例

{
    "sysVariableId":"1026186754438336512",
    "value":""
}