O2OA使用手册
第1章 功能简介及概述
第6章 平台部署与配置
  • 6.1 O2OA(翱途)开发平台如何基于nginx上下文分发的方式快速集群部署
  • 6.2 系统架构-平台集群化部署之基于Nginx端口分发机制实现集群部署
  • 6.3 系统架构-基于nginx快速集群部署-上下文分发
  • 6.4 安装部署-在Windows系统中部署O2OA开发平台
  • 6.5 安装部署-在Linux系统中部署O2OA开发平台
  • 6.6 安装部署-在宝塔/PHPStudy中部署O2OA开发平台
  • 6.7 安装部署-O2OA开发平台之HTTP端口规划
  • 6.8 安装部署-平台服务器版本升级操作说明
  • 6.9 安装部署-私有化部署服务器架构推荐
  • 6.10 安装部署-O2OA开发平台集群部署配置及操作说明
  • 6.11 安装部署-在线部署自定义应用的WAR包和JAR包
  • 6.12 服务器配置与管理-​O2OA主要配置文件说明
  • 6.13 服务器配置与管理-服务器端口冲突和端口修改
  • 6.14 服务器配置与管理-如何修改服务器内存占用率?
  • 6.15 服务器配置与管理-如何访问和操作H2内置数据库
  • 6.16 服务器配置与管理-​如何在O2OA中使用MySQL数据库?
  • 6.17 服务器配置与管理-如何修改平台支持的数据库驱动包
  • 6.18 服务器配置与管理-O2OA使用openGauss(华为高斯数据库)配置
  • 6.19 服务器配置与管理-O2OA开发平台平台数据库配置信息样例
  • 6.20 服务器配置与管理-配置O2OA服务器连接O2云
  • 6.21 服务器配置与管理-O2OA实现服务器随操作系统自动启动
  • 6.22 服务器配置与管理-文件存储服务器配置
  • 6.23 服务器配置与管理-工作日节假日配置
  • 6.24 服务器配置与管理-为平台增加全文检索功能
  • 6.25 服务器配置与管理-消息提醒配置说明
  • 6.26 服务器配置与管理-自定义消息提醒
  • 6.27 服务器配置与管理-定制消息通知的内容
  • 6.28 服务器配置与管理-消息通知过滤
  • 6.29 服务器配置与管理-为待办创建配置邮件通知
  • 6.30 服务器配置与管理-待办待阅数据的查询操作和管理
  • 6.31 服务器配置与管理-​自动执行平台数据的备份与恢复
  • 6.32 服务器配置与管理-数据导出导入与系统数据备份
  • 6.33 ​服务器配置与管理-定期自动执行数据备份与恢复
  • 6.34 系统安全-O2OA作为认证中心实现基于OAUTH2单点认证
  • 6.35 系统安全-O2OA基于Nginx的SSL跳转、转发配置
  • 6.36 系统安全-访问日志相关配置
  • 6.37 系统安全-审计日志相关配置
  • 6.38 系统安全-平台日志文件说明
  • 6.39 系统安全-O2OA日志输出设置log4j2.xml
  • 6.40 系统安全-用户密码初始化规则的设定
  • 6.41 系统安全-启用HTTPS(百度云版)
  • 6.42 系统安全-启用HTTPS(腾讯云版)
  • 6.43 系统安全-自签名SSL证书验证HTTPS功能
  • 6.44 系统安全-登录密码RSA加密
  • 6.45 系统安全-用户登录IP限制
  • 6.46 系统安全-在用户登录过程中启用图形验证码
  • 6.47 系统安全-平台部署之使用非root用户运行服务
  • 6.48 系统安全-O2Server启用国密加密设置
  • 6.49 系统安全-日志应用使用说明
  • 6.50 系统安全-用户重置密码操作
  • 6.51 系统安全-超级管理员(xadmin)密码修改
  • 6.52 系统安全-使用Web端运行服务器管理命令
  • 6.53 系统安全-o2server无法正常显示验证码解决办法
  • 6.54 O2OA(翱途)开发平台前端安全配置建议(一)
  • 第16章 开发知识及常见问题
  • 16.1 如何替换登录页面二维码中默认的logo图标
  • 16.2 O2OA(翱途)流程引擎中如何修改,定制流程的流转记录
  • 16.3 mysql数据库备份
  • 16.4 domain不正确的时候如何强制设置成正确的
  • 16.5 配置文件中使用密文存储密码
  • 16.6 常见问题-连接MySQL出现 Public Key Retrieval is not allowed 的错误
  • 16.7 常见问题-查看表结构
  • 16.8 常见问题-7.2及以上版本开启web代理后请求中没有正确使用web端口问题解决方式
  • 16.9 linux环境libreoffice安装及使用
  • 16.10 在O2OA中使用网络会议(二):Openmeetings与O2OA认证配置
  • 16.11 在O2OA中使用网络会议(一):Openmeetings-5.1.0亲手安装整理 Step-By-Step
  • 16.12 藕粉社区问答系列1
  • 16.13 藕粉社区问答系列2
  • 16.14 藕粉社区问答系列3
  • 16.15 快速入门-平台相关资料汇总
  • 16.16 快速入门-服务器总体介绍汇总
  • 16.17 快速入门-流程表单载入基础数据
  • 16.18 快速入门-常用表单脚本样例汇总
  • 16.19 快速入门-自定义表数据分页样例
  • 16.20 OEM白标-如何修改平台中的Logo图标和文字
  • 16.21 云服务器-阿里云ECS服务器的端口启用
  • 16.22 开发知识-React篇:在O2OA平台框架中使用React
  • 16.23 开发知识-React篇:在O2OA门户页面中使用React
  • 16.24 开发知识-Vue篇:在Vue应用中集成O2OA
  • 16.25 开发知识-Vue篇:使用Vue-CLI开发O2应用
  • 16.26 开发知识-Vue篇:在O2门户页面中使用Vue
  • 16.27 平台中使用Druid数据库连接及监控
  • 16.28 开发知识-在PAAS平台上部署O2OA开发平台
  • 16.29 开发知识-如何使用Tomcat架设webdav服务器
  • 16.30 开发知识-单个端口模式的Nginx和系统配置
  • 16.31 开发知识-Linux非root用户如何使用80端口启动O2OA
  • 16.32 开发知识-O2OA平台启用Eruda进行移动端调试
  • 16.33 开发知识-神通数据库安装
  • 16.34 开发知识-人大金仓数据安装
  • 16.35 开发知识-中标麒麟安装达梦数据库(DM8)
  • 16.36 开发知识-中标麒麟安装人大金仓详细步骤
  • 16.37 开发知识-使用VNC连接中标麒麟V7操作系统
  • 16.38 开发知识-鲲鹏(ARM)麒麟操作系统如何替换yum源?
  • 16.39 开发知识-数据优化知识点
  • 16.40 水印安全-附件水印|加密|文档格式转换图片|PDF
  • 16.41 消息队列-配置activeMQ、kafka消息队列
  • 16.42 常见问题-数据导出或者导入时发生OOM异常
  • 16.43 常见问题-如何让用户在首次登录时,必须对初始密码进行修改
  • 16.44 常见问题-如何在模块部署中控制模块的访问权限
  • 16.45 常见问题-如何在平台中开发Ftp文件上传文件的服务?
  • 16.46 常见问题-如何使用服务管理调用WebService
  • 16.47 常见问题-如何使用脚本调用外部服务
  • 16.48 常见问题-如何使用脚本控制流程自动流转
  • 16.49 常见问题-如何通过脚本调用系统内服务
  • 16.50 常见问题-接口代码疑惑解答汇总
  • 16.51 常见问题:Maven编译o2server错误: Java Heap Space
  • 16.52 常见问题-集群配置后启动报错:NullPointerException
  • 16.53 常见问题-服务器错误:can not decrypt token
  • 16.54 常见问题-IOS移动办公无法收到验证码
  • 16.55 常见问题-服务器和日志时间相差12小时的问题
  • 16.56 常见问题-为什么127.0.0.1可以访问但其他IP无法访问
  • 16.57 藕粉社区问答系列4
  • 16.58 开发知识-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