¶ 修改部门

更新时间: 2024-10-10 07:28:40

通过组织 code、部门 ID，修改部门，可以设置多种参数。

¶ 请求参数

名称	类型	必填	默认值	描述	示例值
departmentId	string	是	-	部门系统 ID（为 Authing 系统自动生成，不可修改）。	`60b49eb83fd80adb96f26e68`
organizationCode	string	是	-	组织 Code（organizationCode）。	`steamory`
leaderUserIds	string[]	否	-	部门负责人 ID。	`["60b49eb83fd80adb96f26e68"]`
description	string	否	-	部门描述。	`技术研发部门`
code	string	否	-	部门识别码。	`6229c4deb3e4d8a20b6021ff`
i18n	I18nDto	否	-	多语言设置。	`{"name":{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}}`
name	string	否	-	部门名称。	`开发部`
departmentIdType	string	否	department_id	此次调用中使用的部门 ID 的类型。枚举值：`department_id`,`open_department_id`	`department_id`
parentDepartmentId	string	否	-	父部门 ID。	`6229c4deb3e4d8a20b6021ff`
customData	object	否	-	自定义数据，传入的对象中的 key 必须先在用户池定义相关自定义字段。	`{"icon":"https://example.com/icon"}`

¶ 示例代码


using Authing.CSharp.SDK.Models;
using Authing.CSharp.SDK.Services;
using Authing.CSharp.SDK.Utils;
using Authing.CSharp.SDK.UtilsImpl;
using System.Collections.Generic;
using System.Threading;
using System.Threading.Tasks;

namespace Example
{
    class Program
    {
      private static ManagementClientOptions options;
      private static string ACCESS_Key_ID = "AUTHING_USERPOOL_ID";
      private static string ACCESS_KEY_SECRET = "AUTHING_USERPOOL_SECRET";

      static void Main(string[] args)
      {
          MainAsync().GetAwaiter().GetResult();
      }

      private static async Task MainAsync()
      {
          options = new ManagementClientOptions()
          {
              AccessKeyId = ACCESS_Key_ID,
              AccessKeySecret = ACCESS_KEY_SECRET,
          };

          ManagementClient managementClient = new ManagementClient(options);
        
          DepartmentSingleRespDto  result = await managementClient.UpdateDepartment
          (  new UpdateDepartmentReqDto{                  OrganizationCode= "steamory" ,
                  DepartmentId= "60b49eb83fd80adb96f26e68" ,
                  LeaderUserIds= new List<string>{"60b49eb83fd80adb96f26e68",} ,
                  Description= "技术研发部门" ,
                  Code= "6229c4deb3e4d8a20b6021ff" ,
                I18n= new I18nDto
                {
                        Name= new LangObject
                {
                        Zh-CN= new LangUnit
                {
                          Enabled= false ,
          Value= false ,
        },
        En-US= new LangUnit
                {
                          Enabled= false ,
          Value= false ,
        },
        },
        },
                  Name= "开发部" ,
                  DepartmentIdType= UpdateDepartmentReqDto.departmentIdType.DEPARTMENT_ID ,
                  ParentDepartmentId= "6229c4deb3e4d8a20b6021ff" ,
                  CustomData= new UpdateDepartmentReqDto{    icon="https://example.com/icon",} ,
            }
          );
        }
    }
}

¶ 请求响应

类型： DepartmentSingleRespDto

名称	类型	描述
statusCode	number	业务状态码，可以通过此状态码判断操作是否成功，200 表示成功。
message	string	描述信息
apiCode	number	细分错误码，可通过此错误码得到具体的错误类型。
data	DepartmentDto	响应数据

示例结果：

{
  "statusCode": 200,
  "message": "操作成功",
  "apiCode": 20001,
  "data": {
    "organizationCode": "steamory",
    "departmentId": "60b49eb83fd80adb96f26e68",
    "createdAt": "2022-07-03T02:20:30.000Z",
    "openDepartmentId": "ou_7dab8a3d3cdccxxxxxx777c7ad535d62",
    "name": "开发部",
    "leaderUserIds": "[\"60b49eb83fd80adb96f26e68\"]",
    "description": "技术研发部门",
    "parentDepartmentId": "6229c4deb3e4d8a20b6021ff",
    "code": "6229c4deb3e4d8a20b6021ff",
    "membersCount": 11,
    "hasChildren": true,
    "i18n": {
      "name": {
        "zh-CN": {
          "enabled": false,
          "value": "中文"
        },
        "en-US": {
          "enabled": false,
          "value": "English"
        }
      }
    },
    "customData": {
      "icon": "https://example.com/logo"
    }
  }
}

¶ 数据结构

¶ I18nDto

名称	类型	必填	描述
name	是	支持多语言的字段。嵌套类型：LangObject。示例值： `[object Object]`

¶ LangObject

名称	类型	必填	描述
zh-CN	是	多语言的中文内容。嵌套类型：LangUnit。示例值： `[object Object]`
en-US	是	多语言的英文内容。嵌套类型：LangUnit。示例值： `[object Object]`

¶ LangUnit

名称	类型	必填	描述
enabled	boolean	是	是否已开启。若开启，且控制台选择该语言，则展示该内容。（默认关闭）。
value	boolean	是	多语言内容。

¶ DepartmentDto

名称	类型	必填	描述
organizationCode	string	是	组织 Code（organizationCode）。示例值： `steamory`
departmentId	string	是	部门系统 ID（为 Authing 系统自动生成，不可修改）。示例值： `60b49eb83fd80adb96f26e68`
createdAt	string	是	部门创建时间。示例值： `2022-07-03T02:20:30.000Z`
openDepartmentId	string	否	自定义部门 ID，用于存储自定义的 ID。示例值： `ou_7dab8a3d3cdccxxxxxx777c7ad535d62`
name	string	是	部门名称。示例值： `开发部`
leaderUserIds	array	否	部门负责人 ID。示例值： `["60b49eb83fd80adb96f26e68"]`
description	string	否	部门描述。示例值： `技术研发部门`
parentDepartmentId	string	是	父部门 id。示例值： `6229c4deb3e4d8a20b6021ff`
code	string	否	部门识别码。示例值： `6229c4deb3e4d8a20b6021ff`
membersCount	number	是	部门人数（仅包含直属成员）。示例值： `11`
hasChildren	boolean	是	是否包含子部门。示例值： `true`
isVirtualNode	boolean	否	是否是虚拟部门。
i18n	否	多语言设置。嵌套类型：I18nDto。示例值： `[object Object]`
customData	object	否	部门的扩展字段数据。示例值： `[object Object]`

¶ I18nDto

名称	类型	必填	描述
name	是	支持多语言的字段。嵌套类型：LangObject。示例值： `[object Object]`

¶ LangObject

名称	类型	必填	描述
zh-CN	是	多语言的中文内容。嵌套类型：LangUnit。示例值： `[object Object]`
en-US	是	多语言的英文内容。嵌套类型：LangUnit。示例值： `[object Object]`

¶ LangUnit

名称	类型	必填	描述
enabled	boolean	是	是否已开启。若开启，且控制台选择该语言，则展示该内容。（默认关闭）。
value	boolean	是	多语言内容。