DataEase V2 利用 API 创建带系统变量的用户

背景场景：

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

步骤：

注意事项

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

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

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

创建用户请求说明

API 接口：/de2api/user/create

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

请求参数示例

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

{
  "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}

请求参数示例

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

查询系统变量的值

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

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

请求参数示例

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