O2OA使用手册
第一章 服务器部署及管理
  • 1.1 平台服务器主机架构配置推荐
  • 1.2 平台服务器版本升级操作说明
  • 1.3 o2server无法正常显示验证码解决办法
  • 1.4 在宝塔面板中安装O2OA(For Linux)
  • 1.5 系统安全-启用HTTPS(腾讯云版)
  • 1.6 系统安全-自签名SSL证书验证HTTPS功能
  • 1.7 系统安全-加密登录-登录密码RSA加密
  • 1.8 功能部署-为平台增加全文检索功能
  • 1.9 平台维护-流转中工作数据的查询、操作和管理
  • 1.10 平台维护-待办待阅数据的查询操作和管理
  • 1.11 平台维护-自动执行平台数据的备份与恢复
  • 1.12 平台维护-备份和恢复平台数据操作
  • 1.13 平台维护-在线部署自定义应用的WAR包和JAR包
  • 1.14 平台服务器下载及安装部署-Windows系统
  • 1.15 开源平台O2OA服务器下载及安装部署(Linux环境)
  • 1.16 华为云服务器部署O2OA-麒麟操作系统
  • 1.17 平台维护-使用Web端运行服务器管理命令
  • 1.18 密码管理-超级管理员密码修改
  • 1.19 密码管理-普通用户初始化密码设置
  • 1.20 密码管理-用户重置密码操作
  • 1.21 系统配置-如何访问和操作内置数据库-H2
  • 1.22 系统配置-第三方数据库配置-MySQL
  • 1.23 日志管理-访问日志相关配置
  • 1.24 日志管理-审计日志相关配置@日志管理
  • 1.25 日志管理-平台日志文件说明
  • 1.26 系统架构-集群部署配置及操作说明
  • 1.27 系统架构-基于nginx快速集群部署-端口分发
  • 1.28 系统配置-主要配置文件说明
  • 1.29 系统配置-配置服务器连接O2云
  • 1.30 系统配置-流程催办提醒配置
  • 1.31 系统配置-自定义消息提醒
  • 1.32 系统配置-消息提醒配置说明
  • 1.33 系统配置-文件存储服务器配置
  • 1.34 系统配置-工作日节假日配置
  • 1.35 系统配置-开机自动启动O2Server
  • 1.36 系统安全-启用HTTPS(百度云版)
  • 1.37 系统架构-基于nginx快速集群部署-上下文分发
  • 第十五章 开发知识及常见问题
  • 15.1 linux环境libreoffice安装及使用
  • 15.2 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 15.3 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 15.4 藕粉社区问答系列1
  • 15.5 藕粉社区问答系列2
  • 15.6 藕粉社区问答系列3
  • 15.7 快速入门-平台相关资料汇总
  • 15.8 快速入门-服务器总体介绍汇总
  • 15.9 快速入门-流程表单载入基础数据
  • 15.10 快速入门-常用表单脚本样例汇总
  • 15.11 快速入门-自定义表数据分页样例
  • 15.12 OEM白标-如何修改平台中的Logo图标和文字
  • 15.13 云服务器-阿里云ECS服务器的端口启用
  • 15.14 开发知识-React篇:在O2OA平台框架中使用React
  • 15.15 开发知识-React篇:在O2OA门户页面中使用React
  • 15.16 开发知识-Vue篇:在Vue应用中集成O2OA
  • 15.17 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 15.18 开发知识-Vue篇:在O2门户页面中使用Vue
  • 15.19 平台中使用Druid数据库连接及监控
  • 15.20 开发知识-在PAAS平台上部署O2OA开发平台
  • 15.21 开发知识-如何使用Tomcat架设webdav服务器
  • 15.22 开发知识-单个端口模式的Nginx和系统配置
  • 15.23 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 15.24 开发知识-O2OA平台启用Eruda进行移动端调试
  • 15.25 开发知识-神通数据库安装
  • 15.26 开发知识-人大金仓数据安装
  • 15.27 开发知识-中标麒麟安装达梦数据库(DM8)
  • 15.28 开发知识-中标麒麟安装人大金仓详细步骤
  • 15.29 开发知识-使用VNC连接中标麒麟V7操作系统
  • 15.30 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 15.31 开发知识-数据优化知识点
  • 15.32 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 15.33 消息队列-配置activeMQ、kafka消息队列
  • 15.34 常见问题-数据导出或者导入时发生OOM异常
  • 15.35 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 15.36 常见问题-如何在模块部署中控制模块的访问权限
  • 15.37 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 15.38 常见问题-如何使用服务管理调用WebService
  • 15.39 常见问题-如何使用脚本调用外部服务
  • 15.40 常见问题-如何使用脚本控制流程自动流转
  • 15.41 常见问题-如何通过脚本调用系统内服务
  • 15.42 常见问题-接口代码疑惑解答汇总
  • 15.43 常见问题:Maven编译o2server错误: Java Heap Space
  • 15.44 常见问题-集群配置后启动报错:NullPointerException
  • 15.45 常见问题-服务器错误:can not decrypt token
  • 15.46 常见问题-IOS移动办公无法收到验证码
  • 15.47 常见问题-服务器和日志时间相差12小时的问题
  • 15.48 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 15.49 藕粉社区问答系列4
  • 15.50 开发知识-React篇:在React应用中集成O2OA

  • 组织人员同步-封装Api接口完成同步

    时间:2022-08-03   

    O2OA允许用户自定义接口和代码逻辑来完成系统与第三方业务系统的数据同步,人员和组织的同步。本文主要介绍组织人员同步的数据操作规范

    本文档适用于组织和用户的同步。

    用户信息包括3个部分:基本信息、用户属性和所在部门。新增用户(add)和修改用户(update)时,需列式该用户下的全量属性和所在部门。接口根据报文的用户所在部门对用户的身份进行增删改。

    组织信息包括3个部分:基本信息、组织属性和组织职务。新增组织(add)和修改组织(update)时,需列式该组织下的全量组织属性和组织职务。接口同时根据报文对组织属性和组织职务进行增删改。

    用户同步接口

    1.1 调用说明

    服务地址

    http://{centerserver}:20030/x_program_center/jaxrs/invoke/personSync/execute

     

    调用方式

    HTTP

    调用方法

    POST

    请求报文Content-Type

    application/json; charset=utf-8

    响应报文Content-Type

    application/json; charset=utf-8

     

     

    本服务对应用户的增删改查操作,通过传请求报文的action参数进行对应的操作:

     

    参数

    执行操作

    add

    新增用户

    update

    修改用户

    updatepwd

    修改密码

    updateSuperior

    修改用户的汇报对象

    delete

    删除用户

     

    如:删除用户的请求报文为

     

     

    {

    "action": "delete", //删除用户

    "flag" : "" //用户标志

    }

     

     

     

    1.2 新增用户

    用户信息包括3个部分:基本信息、用户属性和所在部门。新增用户,需列式该用户下的全量属性和所在部门。接口根据报文的用户所在部门对用户的身份进行新增。

     

    请求报文

    {

        action : add,

    genderType : "m", //性别.男:m,女:f,未知:d

        signature : "", //个性签名

        description :"", // 描述.

        name: "", //名称,可重名.

        employee: "", //工号,必填,不可重复.

        unique: "", //唯一标识,不可重复,为空则使用自动填充值

        distinguishedName: "", //识别名,系统自动填充,@P结尾.

        orderNumber: "", //排序号,升序排列,为空在最后

        controllerList: "", //个人管理者.默认为创建者。

        superior: "", //汇报对象.

        mail: "", //邮件地址.

        weixin: "", //微信号.

        qq: "",//QQ号.

        mobile: "", //必填,手机号.

        officePhone: "", //办公电话.

        boardDate: "", //入职时间.

        birthday: "", //生日.

        age: "", //年龄

        dingdingId: "", //钉钉人员ID.

        dingdingHash: "" //钉钉人员哈希特征.

    attributeList : [//用户的其他属性,需全量列式

    {

    name : "",//属性名称,

    value : "",//属性值,允许字符串或者数组

    description : "" //属性描述

    orderNumber: "" //排序号,升序排列,为空在最后

    }

    ...

    ],

    unitList : [//用户所在部门,需全量列式

    {

    flag: "",//组织标志位,可以为组织唯一编码unique/组织的distinguishedName/组织id

    orderNumber: "",//在组织里的排序号,升序排列,为空在最后

    description: "",//描述

    duty : "",//用户的职务

    position : ""//用户的岗位

    }

    ...

    ]

    }

     

    属性

    上级

    类型

    单值/多值

    必填

    说明

    样例

    action


    string

    single

    true

    操作

    add

    genderType


    string

    single

    true

    性别.男:m,女:f,未知:d

    m

    signature


    string

    single


    个性签名.

    香港移动

    description


    string

    single


    描述.

    香港移动

    name


    string

    single

    true

    名称,可重名.

    张三

    employee


    string

    single

    true

    工号,必填,不可重复.

    P0780

    unique


    string

    single


    唯一标识,不可重复,为空则使用自动填充值

    fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01

    distinguishedName


    string

    single


    识别名,自动填充,@P结尾.

    张三@fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01@P

    orderNumber


    number

    single


    排序号,升序排列,为空在最后

    1

    controllerarray


    array

    multi


    个人管理者.默认为创建者。

    83de86fc-60bc-4b4c-955c-1085915865a4

    superior


    string

    single


    汇报对象.

    可以为汇报对象的distinguishedName 、unique 、employee、mobile。如果未找到汇报对象,不设置。

    P0180

    mail


    string

    single


    邮件地址.

    1234567@qq.com

    weixin


    string

    single


    微信号.


    qq


    string

    single


    QQ号.

    1234567

    mobile


    string

    single

    true

    必填,手机号.

    13800000000

    officePhone


    string

    single


    办公电话.

    0571-88888888

    boarddate


    date-string

    single


    入职时间.

     2015-02-02

    birthday


    date-string

    single


    生日.

     1995-10-12

    age


    number

    single


    年龄

    20

    dingdingId


    string

    single


    钉钉人员ID.


    dingdingHash


    string

    single


    钉钉人员哈希特征.


    zhengwuDingdingId


    string

    single


    政务钉钉人员ID.

     1000833324

    zhengwuDingdingHash


    string

    single


    政务钉钉人员哈希特征.

     b388708eb84d6ae6328e03526a069ec864416a3b916ce22b8fb8bbfa3d84eb6b

    qiyeweixinId


    string

    single


    企业微信人员ID.


    qiyeweixinHash


    string

    single


    企业微信人员哈希特征.


    attributeList


    array

    multi


    其他人员属性列表


    name

    attributeList

    string

    single


    属性名称

    级别

    description

    attributeList

    string

    single


    属性描述

    级别描述

    value

    attributeList

    string/array

    multi


    属性值

    1 / [ "1" ]

    orderNumber

    attributeList

    string

    single


    排序号,升序排列,为空在最后

    18315158

    unitList


    array

    multi


    所在组织列表


    flag

    unitList

    string

    single


    组织标志位,可以为组织唯一编码unique/组织的distinguishedName/组织id

    "companyLeader/"公司管理层@9b45cb75-52f8-4e73-8470-4cdc78230b7d@U",

    orderNumber

     

    unitList

    string

    single


    用户在组织里的排序号升序排列,为空在最后

    123

    description

     

    unitList

    string

    single


    描述

    公司管理层

    duty

    unitList

    string

    single


    用户在该组织的职务

    正职领导

    position

    unitList

    string

    single


    用户在该组织的岗位

    管理岗

     

    响应报文

     

    {

      "data": {

    "value": {

        "id" : "",  //如果成功,用户64位id

    "result" : "",  //响应成功为 success, 失败为error

            "description": ""//响应结果描述

         }

      }

    }

     

      

    1.3 修改用户

    用户信息包括3个部分:基本信息、用户属性和所在部门。修改用户,需列式该用户下的全量属性和所在部门。接口根据报文的用户所在部门对用户的身份进行增删改。

     

    请求报文

     

     

    {

        action : update,

    genderType : "m", //性别.男:m,女:f,未知:d

        signature : "", //个性签名

        description :"", // 描述.

        name: "", //名称,可重名.

        employee: "", //工号,必填,不可重复.

        unique: "", //唯一标识,不可重复,为空则使用自动填充值

        distinguishedName: "", //识别名,系统自动填充,@P结尾.

        orderNumber: "", //排序号,升序排列,为空在最后

        controllerList: "", //个人管理者.默认为创建者。

        superior: "", //汇报对象.

        mail: "", //邮件地址.

        weixin: "", //微信号.

        qq: "",//QQ号.

        mobile: "", //必填,手机号.

        officePhone: "", //办公电话.

        boardDate: "", //入职时间.

        birthday: "", //生日.

        age: "", //年龄

        dingdingId: "", //钉钉人员ID.

        dingdingHash: "" //钉钉人员哈希特征.

    attributeList : [//用户的其他属性

    {

    name : "",//属性名称,

    value : "",//属性值,允许字符串或者数组

    description : "" //属性描述

    orderNumber: "" //排序号,升序排列,为空在最后

    }

    ...

    ],

    unitList : [//用户所在部门

    {

    flag: "",//组织唯一编码unique/组织的distinguishedName/组织id

    orderNumber: "",//在组织里的排序号,升序排列,为空在最后

    description: "",//描述

    duty : "",//用户在该组织的职务

    position : ""//用户在该组织的岗位

    }

    ...

    ]

    }

     

     

    属性

    上级

    类型

    单值/多值

    必填

    说明

    样例

    action


    string

    single

    true

    操作

    update

    genderType


    string

    single

    true

    性别.男:m,女:f,未知:d

    m

    signature


    string

    single


    个性签名.

    香港移动

    description


    string

    single


    描述.

    香港移动

    name


    string

    single

    true

    名称,可重名.

    张三

    employee


    string

    single

    true

    工号,必填,不可重复.

    P0780

    unique


    string

    single


    唯一标识,不可重复,为空则使用自动填充值

    fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01

    distinguishedName


    string

    single


    识别名,自动填充,@P结尾.

    张三@fb3ea7de-d54f-4679-8e9a-35cb1e6b3d01@P

    orderNumber


    number

    single


    排序号,升序排列,为空在最后

    1

    controllerarray


    array

    multi


    个人管理者.默认为创建者。

    83de86fc-60bc-4b4c-955c-1085915865a4

    superior


    string

    single


    汇报对象.

    可以为汇报对象的distinguishedName 、unique 、employee、mobile。如果未找到汇报对象,不设置。

    P0180

    mail


    string

    single


    邮件地址.

    1234567@qq.com

    weixin


    string

    single


    微信号.


    qq


    string

    single


    QQ号.

    1234567

    mobile


    string

    single

    true

    必填,手机号.

    13800000000

    officePhone


    string

    single


    办公电话.

    0571-88888888

    boarddate


    date-string

    single


    入职时间.

     2015-02-02

    birthday


    date-string

    single


    生日.

     1995-10-12

    age


    number

    single


    年龄

    20

    dingdingId


    string

    single


    钉钉人员ID.


    dingdingHash


    string

    single


    钉钉人员哈希特征.


    zhengwuDingdingId


    string

    single


    政务钉钉人员ID.


    zhengwuDingdingHash


    string

    single


    政务钉钉人员哈希特征.


    qiyeweixinId


    string

    single


    企业微信人员ID.


    qiyeweixinHash


    string

    single


    企业微信人员哈希特征.


    attributeList


    array

    multi


    其他人员属性列表


    name

    attributeList

    string

    single


    属性名称

    级别

    description

    attributeList

    string

    single


    属性描述

    级别描述

    value

    attributeList

    string/array

    multi


    属性值

    1 / [ "1" ]

    orderNumber

    attributeList

    string

    single


    排序号,升序排列,为空在最后

    18315158

    unitList


    array

    multi


    所在组织列表


    flag

    unitList

    string

    single


    组织标志位,可以为组织唯一编码unique/组织的distinguishedName/组织id

    "companyLeader/"公司管理层@9b45cb75-52f8-4e73-8470-4cdc78230b7d@U"

    orderNumber

     

    unitList

    string

    single


    用户在组织里的排序号升序排列,为空在最后

    123

    description

     

    unitList

    string

    single


    描述

    公司管理层

    duty

    unitList

    string

    single


    用户在该组织的职务

    正职领导

    position

    unitList

    string

    single


    用户在该组织的岗位

    管理岗

     

    响应报文

    {

      "data": {

    "value": {

        "id" : "",  //如果成功,用户64位id

    "result" : "",  //响应成功为 success, 失败为error

            "description": ""//响应结果描述

         }

      }

    }

     

     

     

     

    1.4 修改用户密码

    请求报文

    {

      action : "updatepwd",

    flag: "",  //用户标志位

    password: ""  //新密码

    }

     

     

    说明:flag用来查找用户

    可以为distinguishedName : "",  //识别名,,@P结尾.

    unique : "",   //唯一标识,

    employee: "", //工号,.

    mobile: "", //,手机号.

    Id : ""//个人数据库主键

    响应报文

    {

      "data": {

    "value": {

    "result" : "",  //响应成功为 success, 失败为error

            "description": ""//响应结果描述

         }

      }

    }

     

      

    1.5 修改汇报对象

    请求报文

    {

      action : "updateSuperior",

    flag: "",  //用户标志位

    superior: ""  //用户汇报对象

    }

     

    说明:flag用来查找用户

    可以为distinguishedName : "",  //识别名,,@P结尾.

    unique : "",   //唯一标识,

    employee: "", //工号,.

    mobile: "", //,手机号.

    Id : ""//个人数据库主键

     

    响应报文

    {

      "data": {

        "value": {

    "result" : "",  //响应成功为 success, 失败为error

            "description": ""//响应结果描述

         }

      }

    }

     

     

     

    1.6 删除用户

    请求报文

    {

      action : "delete",

    flag: "",  //用户标志位

    }

     

    说明:说明:flag用来查找用户

    可以为distinguishedName : "",  //识别名,,@P结尾.

    unique : "",   //唯一标识,

    employee: "", //工号,.

    mobile: "", //,手机号.

    Id : ""//个人数据库主键

     

    响应报文

    {

      "data": {

        "value": {

    "result" : "",  //响应成功为 success, 失败为error

            "description": ""//响应结果描述

         }

      }

    }

     

     

    组织同步接口

    2.1 调用说明

    服务地址

    http://ahpp.zoneland.net:20030/x_program_center/jaxrs/invoke/unitAsync/execute

     

    调用方式

    HTTP

    调用方法

    POST

    请求报文Content-Type

    application/json; charset=utf-8

    响应报文Content-Type

    application/json; charset=utf-8

     

     

    本服务对应组织的增删改查操作,通过传请求报文的action参数进行对应的操作:

     

    参数

    执行操作

    add

    新增组织

    update

    修改组织

    delete

    删除组织

     

    如:删除组织的请求报文可以为

     

     

    {

    "action": "delete", //删除组织

    "flag" : "" //组织标志

    }

     

     

     

     

     

     

     

    2.2 新增组织

    请求报文

    {

        "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": ""//响应结果描述

         }

      }

    }

     

     

     

     

    2.3 更新组织

    请求报文

    {

        "action":" update",

    "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:"", //排序号,升序排列,为空在最后

    attributeList:"", //属性值,多值.

    }

    ...

    ],

    "dutyList" : [  //组织职务

    {

    description:"", //描述.

    name:"", //名称,同一组织下不可重名.

    unique:"", //唯一标识,不可重复,为空则使用自动填充值

    distinguishedName:"", //识别名,自动填充,@UD结尾.

    orderNumber:"", //排序号,升序排列,为空在最后

    identityList:"", //组织职务身份成员,多值.

    }

    ...

    ]

    }

     

    属性

    上级

    类型

    单值/多值

    说明

    样例

    action


    string

    single

    update


    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": ""//响应结果描述

         }

      }

    }

     

     

     

     

    2.4 删除组织

    请求报文

    {

      action : "delete",

    distinguishedName : "",  //识别名,@P结尾.

    unique : "",   //唯一标识

    }

     

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

    响应报文

    {

      "data": {

        "value": {

    "result" : "",  //响应成功为 success, 失败为error

            "description": ""//响应结果描述

         }

      }

    }

     

     

    接口-组织同步接口-unitSync.txt

    接口-人员同步接口-personSync.txt