O2OA教程-安装管理及配置-组织数据接口

一、新增组织

请求报文

{
    "action":"add",
       "name":"",           //名称,可以重名.
       "unique":"",   //唯一标识,不可重复,为空则使用自动填充值
       "distinguishedName":"", //识别名.以@U结尾.
       "typeList":"", //组织类型.
       "description":"", //描述.
       "shortName":"", //组织简称。
       "superior":"", //上级组织.
       "orderNumber":"", //排序号,升序排列,为空在最后
       "controllerList":"", //组织的管理人员.
       "dingdingId":"", //钉钉部门ID.
       "dingdingHash":"", //钉钉部门哈希特征.
       "qiyeweixinId":"", //企业微信人员ID.
       "zhengwuDingdingId":"", //政务钉钉人员ID.
       "zhengwuDingdingHash":"", //政务钉钉人员哈希特征.
       "qiyeweixinHash":"", //企业微信人员哈希特征.
       "attributeList" : [   //组织属性
              {
                     description:"", //描述.
                     name:"", //名称,不可重名.
                     unique:"", //唯一标识,不可重复,为空则使用自动填充值
                     distinguishedName:"", //识别名,自动填充,@UA结尾.
                     orderNumber:"", //排序号,升序排列,为空在最后
                     value:"", //属性值,多值.
              }
              ...
       ],
       "dutyList" : [  //组织职务
              {
                     description:"", //描述.
                     name:"", //名称,同一组织下不可重名.
                     unique:"", //唯一标识,不可重复,为空则使用自动填充值
                     distinguishedName:"", //识别名,自动填充,@UD结尾.
                     orderNumber:"", //排序号,升序排列,为空在最后
                     value:"", //组织职务身份成员,多值.
              }
              ...
       ]
}

属性	上级	类型	单值/多值	说明	样例
action		string	single	add
name		string	single	名称,可以重名.	技术支持
unique		string	single	唯一标识,不可重复,为空则使用自动填充值	1000263571
distinguishedName		string	single	识别名.如果未空系统自动填充.以@U结尾.	技术支持@1000263571@U
typeList		array	multi	组织类型.	[ "部门" ]
description		string	single	描述.
shortName		string	single	组织简称。
levelName		string	single	显示的层级名.	安徽联通/技术支持
superior		string	single	上级组织标志位，可以为组织唯一编码unique/组织的distinguishedName/组织id	"companyLeader/"公司管理层@9b45cb75-52f8-4e73-8470-4cdc78230b7d@U"/9d14f85a-27ba-4e02-b4ef-4ebfcf3f19c0
orderNumber		number	single	排序号,升序排列,为空在最后	20
controllerList		array	multi	组织的管理人员的.distinguishedName 、unique 、employee或mobile	["138000000"]
dingdingId		string	single	钉钉部门ID.
dingdingHash		string	single	钉钉部门哈希特征.
qiyeweixinId		string	single	企业微信人员ID.
zhengwuDingdingId		string	single	政务钉钉人员ID.	1000263571
zhengwuDingdingHash		string	single	政务钉钉人员哈希特征.	8ecfc82b45c5d33be7f84599b265e4fffb56108c0f8f85bde7856e01521a7d0b
qiyeweixinHash		string	single	企业微信人员哈希特征.
attributeList		array	single	组织属性列表
name	attributeList	string	multi	名称,不可重名.	组织属性
description	attributeList	string	single	描述.
distinguishedName	attributeList	string	single	识别名,自动填充,@UA结尾.	组织属性@e762a4df-44ce-418c-bb20-899558b49622@UA
unique	attributeList	string	single	唯一标识,不可重复,为空则使用自动填充值	e762a4df-44ce-418c-bb20-899558b49622
value	attributeList	string/array	multi	属性值,多值.	["组织属性值"]
orderNumber	attributeList	string	single	排序号,升序排列,为空在最后	112345
dutyList		array	multi	组织职务
name	dutyList	string	single	名称,同一组织下不可重名.	部门领导
description	dutyList	string	single	描述.
unique	dutyList	string	single	唯一标识,不可重复,为空则使用自动填充值	7a1b7021-8812-4d18-9447-6b27ce7454ed
distinguishedName	dutyList	string	single	识别名,自动填充,@UD结尾.	部门领导@7a1b7021-8812-4d18-9447-6b27ce7454ed@UD
orderNumber	dutyList	string	single	排序号,升序排列,为空在最后	排序号,升序排列,为空在最后
value	dutyList	aray	multi	组织职务身份成员,多值. 可以是人员的.distinguishedName 、unique 、employee或mobile	["张三@fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01@P","P0780","13800000000","fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01"]

响应报文

{
  "data": {
"value": {
    "id" : "",  //如果成功，组织64位id
    "distinguishedName: "", //如果成功，组织识别名
"result" : "",               //响应成功为 success, 失败为error
        "description": ""          //响应结果描述
     }
  }
}

二、删除组织

请求报文

{ action : "delete", distinguishedName : "", //识别名,@P结尾. unique : "", //唯一标识 }

说明：distinguishedName 、unique 用来查找组织，其中一项不为空即可

响应报文

{ "data": { "value": { "result" : "", //响应成功为 success, 失败为error "description": "" //响应结果描述 } } }

来源：oschina

链接：https://my.oschina.net/o2oa/blog/3168430