using System;
|
using System.Xml.Serialization;
|
using System.Collections.Generic;
|
using Top.Api.Util;
|
using Top.Api;
|
using Top.Api.DingTalk;
|
|
namespace DingTalk.Api.Request
|
{
|
/// <summary>
|
/// TOP API: dingtalk.oapi.v2.department.update
|
/// </summary>
|
public class OapiV2DepartmentUpdateRequest : BaseDingTalkRequest<DingTalk.Api.Response.OapiV2DepartmentUpdateResponse>
|
{
|
/// <summary>
|
/// 如果有新人加入部门是否会自动加入部门群
|
/// </summary>
|
public Nullable<bool> AutoAddUser { get; set; }
|
|
/// <summary>
|
/// 开启后，加入该部门的申请将默认同意
|
/// </summary>
|
public Nullable<bool> AutoApproveApply { get; set; }
|
|
/// <summary>
|
/// 部门简介
|
/// </summary>
|
public string Brief { get; set; }
|
|
/// <summary>
|
/// 部门编码
|
/// </summary>
|
public string Code { get; set; }
|
|
/// <summary>
|
/// 是否创建一个关联此部门的企业群，默认为false
|
/// </summary>
|
public Nullable<bool> CreateDeptGroup { get; set; }
|
|
/// <summary>
|
/// 部门ID
|
/// </summary>
|
public Nullable<long> DeptId { get; set; }
|
|
/// <summary>
|
/// 部门的主管列表，主管的userid列表
|
/// </summary>
|
public string DeptManagerUseridList { get; set; }
|
|
/// <summary>
|
/// 可以查看指定隐藏部门的其他部门列表，如果部门隐藏，则此值生效。总数不能超过200。
|
/// </summary>
|
public string DeptPermits { get; set; }
|
|
/// <summary>
|
/// 开启后，允许员工加入部门
|
/// </summary>
|
public Nullable<bool> EmpApplyJoinDept { get; set; }
|
|
/// <summary>
|
/// 扩展字段，JSON格式
|
/// </summary>
|
public string Extension { get; set; }
|
|
/// <summary>
|
/// 强制更新的字段，支持清空指定的字段，使用逗号分隔。目前支持字段：dept_manager_userid_list
|
/// </summary>
|
public string ForceUpdateFields { get; set; }
|
|
/// <summary>
|
/// 部门群是否包含隐藏部门
|
/// </summary>
|
public Nullable<bool> GroupContainHiddenDept { get; set; }
|
|
/// <summary>
|
/// 部门群是否包含外包部门
|
/// </summary>
|
public Nullable<bool> GroupContainOuterDept { get; set; }
|
|
/// <summary>
|
/// 部门群是否包含子部门
|
/// </summary>
|
public Nullable<bool> GroupContainSubDept { get; set; }
|
|
/// <summary>
|
/// 是否隐藏部门， true表示隐藏 false表示显示
|
/// </summary>
|
public Nullable<bool> HideDept { get; set; }
|
|
/// <summary>
|
/// 部门隐藏的生效场景配置
|
/// </summary>
|
public string HideSceneConfig { get; set; }
|
|
public SceneConfigDomain HideSceneConfig_ { set { this.HideSceneConfig = TopUtils.ObjectToJson(value); } }
|
|
/// <summary>
|
/// 通讯录语言
|
/// </summary>
|
public string Language { get; set; }
|
|
/// <summary>
|
/// 部门名称，长度限制为1~100个字符，不允许包含字符‘-’‘，’以及‘,’
|
/// </summary>
|
public string Name { get; set; }
|
|
/// <summary>
|
/// 在父部门中的排序值，order值小的排序靠前
|
/// </summary>
|
public Nullable<long> Order { get; set; }
|
|
/// <summary>
|
/// 企业群群主的userid
|
/// </summary>
|
public string OrgDeptOwner { get; set; }
|
|
/// <summary>
|
/// 限制本部门成员查看通讯录，限制开启后，本部门成员只能看到限定范围内的通讯录。true表示限制开启
|
/// </summary>
|
public Nullable<bool> OuterDept { get; set; }
|
|
/// <summary>
|
/// 是否只能看到所在部门及下级部门通讯录
|
/// </summary>
|
public Nullable<bool> OuterDeptOnlySelf { get; set; }
|
|
/// <summary>
|
/// 本部门的员工仅可见员工自己为true时，可以配置额外可见部门，departmentId列表，总数不能超过200。
|
/// </summary>
|
public string OuterPermitDepts { get; set; }
|
|
/// <summary>
|
/// 本部门的员工仅可见员工自己为true时，可以配置额外可见人员，userid列表，总数不能超过200。
|
/// </summary>
|
public string OuterPermitUsers { get; set; }
|
|
/// <summary>
|
/// 部门限制可见的生效场景配置
|
/// </summary>
|
public string OuterSceneConfig { get; set; }
|
|
public SceneConfigDomain OuterSceneConfig_ { set { this.OuterSceneConfig = TopUtils.ObjectToJson(value); } }
|
|
/// <summary>
|
/// 父部门id，根部门id为1
|
/// </summary>
|
public Nullable<long> ParentId { get; set; }
|
|
/// <summary>
|
/// 部门标识字段，开发者可用该字段来唯一标识一个部门，并与钉钉外部通讯录里的部门做映射
|
/// </summary>
|
public string SourceIdentifier { get; set; }
|
|
/// <summary>
|
/// 部门联系方式
|
/// </summary>
|
public string Telephone { get; set; }
|
|
/// <summary>
|
/// 可以查看指定隐藏部门的其他人员列表，如果部门隐藏，则此值生效，总数不能超过200。
|
/// </summary>
|
public string UserPermits { get; set; }
|
|
#region IDingTalkRequest Members
|
|
public override string GetApiName()
|
{
|
return "dingtalk.oapi.v2.department.update";
|
}
|
|
public override string GetApiCallType()
|
{
|
return DingTalkConstants.CALL_TYPE_OAPI;
|
}
|
|
public override IDictionary<string, string> GetParameters()
|
{
|
TopDictionary parameters = new TopDictionary();
|
parameters.Add("auto_add_user", this.AutoAddUser);
|
parameters.Add("auto_approve_apply", this.AutoApproveApply);
|
parameters.Add("brief", this.Brief);
|
parameters.Add("code", this.Code);
|
parameters.Add("create_dept_group", this.CreateDeptGroup);
|
parameters.Add("dept_id", this.DeptId);
|
parameters.Add("dept_manager_userid_list", this.DeptManagerUseridList);
|
parameters.Add("dept_permits", this.DeptPermits);
|
parameters.Add("emp_apply_join_dept", this.EmpApplyJoinDept);
|
parameters.Add("extension", this.Extension);
|
parameters.Add("force_update_fields", this.ForceUpdateFields);
|
parameters.Add("group_contain_hidden_dept", this.GroupContainHiddenDept);
|
parameters.Add("group_contain_outer_dept", this.GroupContainOuterDept);
|
parameters.Add("group_contain_sub_dept", this.GroupContainSubDept);
|
parameters.Add("hide_dept", this.HideDept);
|
parameters.Add("hide_scene_config", this.HideSceneConfig);
|
parameters.Add("language", this.Language);
|
parameters.Add("name", this.Name);
|
parameters.Add("order", this.Order);
|
parameters.Add("org_dept_owner", this.OrgDeptOwner);
|
parameters.Add("outer_dept", this.OuterDept);
|
parameters.Add("outer_dept_only_self", this.OuterDeptOnlySelf);
|
parameters.Add("outer_permit_depts", this.OuterPermitDepts);
|
parameters.Add("outer_permit_users", this.OuterPermitUsers);
|
parameters.Add("outer_scene_config", this.OuterSceneConfig);
|
parameters.Add("parent_id", this.ParentId);
|
parameters.Add("source_identifier", this.SourceIdentifier);
|
parameters.Add("telephone", this.Telephone);
|
parameters.Add("user_permits", this.UserPermits);
|
if (this.otherParams != null)
|
{
|
parameters.AddAll(this.otherParams);
|
}
|
return parameters;
|
}
|
|
public override void Validate()
|
{
|
RequestValidator.ValidateMaxLength("brief", this.Brief, 255);
|
RequestValidator.ValidateRequired("dept_id", this.DeptId);
|
RequestValidator.ValidateMaxListSize("dept_manager_userid_list", this.DeptManagerUseridList, 999);
|
RequestValidator.ValidateMaxListSize("dept_permits", this.DeptPermits, 200);
|
RequestValidator.ValidateMaxListSize("force_update_fields", this.ForceUpdateFields, 999);
|
RequestValidator.ValidateMaxLength("name", this.Name, 100);
|
RequestValidator.ValidateMaxListSize("outer_permit_depts", this.OuterPermitDepts, 200);
|
RequestValidator.ValidateMaxListSize("outer_permit_users", this.OuterPermitUsers, 200);
|
RequestValidator.ValidateMaxLength("telephone", this.Telephone, 50);
|
RequestValidator.ValidateMaxListSize("user_permits", this.UserPermits, 200);
|
}
|
|
/// <summary>
|
/// SceneConfigDomain Data Structure.
|
/// </summary>
|
[Serializable]
|
|
public class SceneConfigDomain : TopObject
|
{
|
/// <summary>
|
/// 当前部门是否采用单独的配置。如果设置了false，则采用组织维度的配置
|
/// </summary>
|
[XmlElement("active")]
|
public Nullable<bool> Active { get; set; }
|
|
/// <summary>
|
/// 是否在单聊框生效
|
/// </summary>
|
[XmlElement("chatbox_subtitle")]
|
public Nullable<bool> ChatboxSubtitle { get; set; }
|
|
/// <summary>
|
/// 是否在查看组织架构生效
|
/// </summary>
|
[XmlElement("node_list")]
|
public Nullable<bool> NodeList { get; set; }
|
|
/// <summary>
|
/// 是否在个人资料页生效
|
/// </summary>
|
[XmlElement("profile")]
|
public Nullable<bool> Profile { get; set; }
|
|
/// <summary>
|
/// 是否在搜索生效
|
/// </summary>
|
[XmlElement("search")]
|
public Nullable<bool> Search { get; set; }
|
}
|
|
#endregion
|
}
|
}
|
