¶ 修改顶层组织机构
更新时间: 2024-10-10 07:28:40
通过组织 code,修改顶层组织机构,可以选择部门描述、新组织 code、组织名称等。
¶ 请求参数
名称 | 类型 | 必填 | 默认值 | 描述 | 示例值 |
---|---|---|---|---|---|
organizationCode | string | 是 | - | 组织 code。 | steamory |
description | string | 否 | - | 部门描述。 | 技术研发部门 |
openDepartmentId | string | 否 | - | 根节点自定义 ID。 | 60b49eb83fd80adb96f26e68 |
leaderUserIds | string[] | 否 | - | 部门负责人 ID。 | ["60b49eb83fd80adb96f26e68"] |
i18n | OrganizationNameI18nDto | 否 | - | 多语言设置。 | {"organizationName":{"zh-CN":{"enabled":false,"value":"中文"},"en-US":{"enabled":false,"value":"English"}}} |
organizationNewCode | string | 否 | - | 新组织 code。 | steamory2 |
organizationName | string | 否 | - | 组织名称。 | 蒸汽记忆 |
¶ 示例代码
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);
OrganizationSingleRespDto result = await managementClient.UpdateOrganization
( new UpdateOrganizationReqDto{ OrganizationCode= "steamory" ,
Description= "技术研发部门" ,
OpenDepartmentId= "60b49eb83fd80adb96f26e68" ,
LeaderUserIds= new List<string>{"60b49eb83fd80adb96f26e68",} ,
I18n= new OrganizationNameI18nDto
{
OrganizationName= new LangObject
{
Zh-CN= new LangUnit
{
Enabled= false ,
Value= false ,
},
En-US= new LangUnit
{
Enabled= false ,
Value= false ,
},
},
},
OrganizationNewCode= "steamory2" ,
OrganizationName= "蒸汽记忆" ,
}
);
}
}
}
¶ 请求响应
类型: OrganizationSingleRespDto
名称 | 类型 | 描述 |
---|---|---|
statusCode | number | 业务状态码,可以通过此状态码判断操作是否成功,200 表示成功。 |
message | string | 描述信息 |
apiCode | number | 细分错误码,可通过此错误码得到具体的错误类型。 |
data | OrganizationDto | 响应数据 |
示例结果:
{
"statusCode": 200,
"message": "操作成功",
"apiCode": 20001,
"data": {
"organizationCode": "steamory",
"organizationName": "蒸汽记忆",
"description": "组织描述信息",
"departmentId": "60b49eb83fd80adb96f26e68",
"openDepartmentId": "60b49eb83fd80adb96f26e68",
"hasChildren": true,
"leaderUserIds": "[\"60b49eb83fd80adb96f26e68\"]",
"membersCount": 150,
"i18n": {
"organizationName": {
"zh-CN": {
"enabled": false,
"value": "中文"
},
"en-US": {
"enabled": false,
"value": "English"
}
}
}
}
}
¶ 数据结构
¶ OrganizationNameI18nDto
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
organizationName | 是 | 支持多语言的字段。嵌套类型:LangObject。 示例值: [object Object] |
¶ LangObject
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
zh-CN | 是 | 多语言的中文内容。嵌套类型:LangUnit。 示例值: [object Object] | |
en-US | 是 | 多语言的英文内容。嵌套类型:LangUnit。 示例值: [object Object] |
¶ LangUnit
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
enabled | boolean | 是 | 是否已开启。若开启,且控制台选择该语言,则展示该内容。(默认关闭)。 |
value | boolean | 是 | 多语言内容。 |
¶ OrganizationDto
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
organizationCode | string | 是 | 组织 code。 示例值: steamory |
organizationName | string | 是 | 组织名称。 示例值: 蒸汽记忆 |
description | string | 否 | 组织描述信息。 示例值: 组织描述信息 |
departmentId | string | 是 | 根节点 ID。 示例值: 60b49eb83fd80adb96f26e68 |
openDepartmentId | string | 否 | 根节点自定义 ID。 示例值: 60b49eb83fd80adb96f26e68 |
hasChildren | boolean | 是 | 是否包含子节点。 示例值: true |
leaderUserIds | array | 否 | 部门负责人 ID。 示例值: ["60b49eb83fd80adb96f26e68"] |
membersCount | number | 是 | 部门人数。 示例值: 150 |
isVirtualNode | boolean | 是 | 是否是虚拟部门。 |
i18n | 否 | 多语言设置。嵌套类型:OrganizationNameI18nDto。 示例值: [object Object] |
¶ OrganizationNameI18nDto
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
organizationName | 是 | 支持多语言的字段。嵌套类型:LangObject。 示例值: [object Object] |
¶ LangObject
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
zh-CN | 是 | 多语言的中文内容。嵌套类型:LangUnit。 示例值: [object Object] | |
en-US | 是 | 多语言的英文内容。嵌套类型:LangUnit。 示例值: [object Object] |
¶ LangUnit
名称 | 类型 | 必填 | 描述 |
---|---|---|---|
enabled | boolean | 是 | 是否已开启。若开启,且控制台选择该语言,则展示该内容。(默认关闭)。 |
value | boolean | 是 | 多语言内容。 |