O2OA教程
  • 概述
  • 安装管理及配置
    • 服务器主机推荐配置
    • 平台下载及安装部署
    • 平台升级操作说明
    • 平台基本能力介绍
    • 平台目录结构说明
    • 平台配置文件说明
    • O2OA与移动办公
      • 连接O2云使用APP
      • 集成到企业微信
      • 集成到阿里钉钉(DingTalk)
      • 配置绑定微信扫码登录
    • 平台数据库配置
      • 接入第三方数据库
      • 数据库驱动JAR包的更新或新增
      • 数据库配置信息样例
      • 访问和操作H2数据库
      • 清除废弃的业务数据
      • 压缩H2数据库
    • 平台存储库配置
    • 组织人员架构及管理
      • 密码管理
        • 管理员密码管理
        • 普通初始化密码
        • 用户重置密码
      • 组织架构,组织职位,组织属性
        • 组织架构创建过程
          • 顶组织创建
          • 下级组织创建
          • 组织管理设定
        • 组织职位管理
        • 组织职务意义与使用
      • 人员身份,人员属性
        • 人员信息创建
        • 人员与组织的关系(人员身份)
        • 人员数据导入
      • 角色管理
        • 内置角色介绍
        • 角色信息管理
      • 群组管理
      • 常用脚本
        • 人员信息
        • 组织信息
        • 群组信息
        • 角色信息
      • 数据同步接口
        • 人员数据接口
          • 新增用户
          • 修改用户
          • 删除用户
          • 修改用户密码
          • 修改汇报对象
        • 组织数据接口
          • 新增组织
          • 修改组织
          • 删除组织
    • O2OA集群部署
      • 非对称集群配置
    • 平台消息提醒配置
    • 平台审计日志配置
    • 平台工作日节假日配置
    • API接口服务
    • 启用HTTPS(SSL)
      • 自签名SSL证书验证HTTPS功能
    • SSO与单点认证
      • SSO配置
      • 约定密钥单点认证配置
      • SSO客户端程序
      • SSO服务端程序
    • 平台维护工具
      • 备份恢复数据
      • 自动执行数据备份与恢复
      • 待办
      • 已办
      • 待阅
      • 已阅
      • 流转中工作
      • 已完成工作
      • 授权管理
    • 相关数据表
    • 全文检索功能部署
    • 平台错误日志
      • 日志所在目录
      • 日志使用class
  • 业务开发与设计
    • 流程应用开发与设计
      • 流程开发设计入口
      • 应用创建及权限设置
      • 创建流程
        • 新建流程
        • 新建活动
        • 修改活动属性
        • 修改路由
        • 保存流程
        • 活动配置
        • 路由配置
      • 创建表单
        • 创建表单
        • 修改表单字段
        • 保存表单
      • 常用事件脚本说明
      • 数据字典配置
      • Excel数据导入数据网格(仅支持IE)
      • 流程实际样例需求准备
      • 流程应用的导出导入
      • 拆分流程样例
      • 流程服务调用环节使用
        • 服务地址URL动态参数
        • 自定义HTTP头信息
    • 内容管理与信息发布
      • 创建栏目
      • 创建分类
      • 创建表单
      • 设置表单
      • 栏目的权限
      • 分类的权限
      • 测试发布
      • 如何使用流程发布信息
        • 新建信息发布流程
        • 给分类配置信息发布流程
    • 门户管理与应用包装
      • 功能简介
      • 表单设计
      • 部件设计
      • 脚本开发
      • 数据源使用
      • 相关接口
      • 门户样例
      • 模板导入
      • 其他
    • 数据视图与数据统计
      • 视图
      • 数据表
      • 查询语句
    • 定时任务与服务接口
      • 前后端脚本的差异
      • 代理和接口的脚本编写
      • 代理
      • 接口
    • 系统交互样例
      • 登录认证 For Java
        • 发送用户账号密码进行登录认证
        • 发送用户名使用SSO进行登录认证
      • 流程控制 For Java
        • 启动一个新的流程实例(工单)
      • 外系统启动流程
      • 数据导出
        • 数字档案
    • 项目样例说明
      • 公文
    • 数据字典使用说明
    • 前端开发API说明
      • 业务数据 - Object: data
      • 流程实例 - Object: workContext
      • 内容管理实例 - Object: documentContext
      • 组织架构管理 - Object: org
        • 人员信息: person 操作
        • 人员属性: personAttribute操作
        • 组织信息: unit操作
        • 组织职务: unitDuty
        • 组织属性: unitAttribute
        • 身份信息: identity
        • 角色信息: role
        • 群组信息: group
  • 平台内置应用介绍
    • 会议管理
    • 日程安排
    • 个人文件
    • 执行力管理
    • 考勤管理
    • 论坛管理
    • 办公中心
    • 脑图管理
    • 系统应用权限控制
  • 源码的编译及管理
    • 服务器源码编译
    • 移动端源码介绍
      • Android端编译打包处理
      • IOS端打包处理
    • 平台程序调试方法
      • 前端代码调试定位
      • 后端代码的远程调试
  • 常见问题
    • H2数据库异常修复
    • O2OA平台异常
      • 阿里云ECS服务器的端口启用
      • IOS移动办公无法收到验证码
      • 集群配置
    • 数据导出或者导入时发生OOM异常
    • 服务器错误
Powered by GitBook
On this page
  • 一、前提条件
  • 二、注册企业钉钉
  • 三、添加钉钉微应用
  • 四、查询应用的AgentId、appKey、appSecret和CorpId信息
  • 1、查询应用的AgentId、appKey、appSecret信息
  • 2、查询企业CropId信息
  • 五、设置钉钉微应用的通讯录权限
  • 六、O2OA接入配置
  • 七、手工从钉钉拉取组织人员数据

Was this helpful?

  1. 安装管理及配置
  2. O2OA与移动办公

集成到阿里钉钉(DingTalk)

O2OA平台可以以第微应用的方式集成到阿里钉钉,同步钉钉的企业通讯录作为本地组织人员架构,并且可以将待办等通知直接推送到钉钉进行消息提醒。

Previous集成到企业微信Next配置绑定微信扫码登录

Last updated 5 years ago

Was this helpful?

如果O2OA成功接入钉钉,O2OA将会自动从钉钉拉取所有的人员和组织进行同步,O2OA的所有人员和组织以企业钉钉中创建的组织架构为准( 本地已经创建的人员和组织将保留不会被删除,可能会造成人员和组织重复 )。

对企业通讯录授权时,所对应的组织请设置为顶层组织,后续将会细化相应的权限设置。

O2OA接入钉钉建议先配置好钉钉应用,待组织和人员从钉钉同步完成后,再进行组织和人员的信息编辑,避免人员和组织信息的重复创建。

一、前提条件

1、完成O2OA部署,平台可以正常访问

2、确保O2OA平台可以正常通过公网进行访问(不是内网)

二、注册企业钉钉

注册地址:https://oa.dingtalk.com/#/login,此步骤需要企业自行准备。

需要提供使用钉钉的企业相关信息。

三、添加钉钉微应用

钉钉注册成功后,使用企业管理员账号登录企业钉钉,在[工作台] 页面中,点击自建应用链接,新建一个企业应用,如下图所示:

填写应用基本信息,如下图所示:

参数说明:

应用Logo:您可以上传您需要显示在钉钉里的O2OA办公应用图标。
应用名称:填写您指定的钉钉里O2OA办公应用的应用名称,如移动办公,企业办公,O2OA办公等等。
功能介绍:填写应用的功能介绍
开发方式:企业内部自主开发

填写完成后点击下一步,填写配置开发信息,如下图所示:

参数说明:

开发模式       :开发应用
开发应用类型    :微应用
应用首页链接    :http://[serverIp]:[port]/x_desktop/ddsso.html
(其中[serverIp]为您部署的O2OA公网IP或者域名。
[port]是开放的web端口,默认为80不用填写。
后面还可以跟一个redirect参数,如:?redirect=portalmobile.html%3Fid%3D********** ,就是登录成功后跳转到门户页面星号代表门户的id)
开服务器出口IP  :填写服务器公网出口IP地址
首页地址       :http://[serverIp]:[port]/x_desktop/ddsso.html
可使用范围      :根据要求填写

填写完成后点击提交即可完成应用创建,填写好的界面如下图所示:

四、查询应用的AgentId、appKey、appSecret和CorpId信息

1、查询应用的AgentId、appKey、appSecret信息

点击自建应用设置,查看应用的详细设置信息

查询已经创建好的应用设置信息,如下图所示:

请记录应用的AgentId、AppKey以及AppSecret信息,后续需要配置到服务器设置里

2、查询企业CropId信息

进入钉钉开放平台,点击左侧导航:开发信息 -> 开发账号信息:

请记录企业的CorpId信息,后续需要配置到服务器设置里。

五、设置钉钉微应用的通讯录权限

在已经创建好的微应用的权限设置栏可以对应用的操作权限进行设置,如下图所示:

企业通讯录权限:请开启通讯录只读权限、手机号码信息以及邮箱等个人信息,并且将选择授权范围设置为最顶层组织。

至此,钉钉应用创建以及设置工作已经完成。

六、O2OA接入配置

1、进入o2oa安装目录,从o2server/configSample 目录下拷贝 dingding.json 到 o2server/config 目录(如果已经复制过了,请跳过此步骤);

2、使用文本编辑器打开dingding.json进行编辑:

{
  "enable": true,
  "corpId": "",
  "agentId": "",
  "appKey": "",
  "appSecret": "",
  "syncCron": "10 0/10 * * * ?",
  "forceSyncCron": "10 45 8,12 * * ?",
  "oapiAddress": "https://oapi.dingtalk.com",
  "messageEnable": true,
  "###enable": "是否启用###",
  "###corpId": "钉钉corpId###",
  "###agentId": "agentId###",
  "###appKey": "应用的key,唯一标识###",
  "###appSecret": "应用的密钥###",
  "###syncCron": "组织同步cron,默认每10分钟同步一次.###",
  "###forceSyncCron": "强制拉入同步cron,默认在每天的8点和12点强制进行同步.###",
  "###oapiAddress": "oapi服务器地址###",
  "###messageEnable": "是否启用消息推送###"
}

参数说明:

"enable": "是否启用企业钉钉接入: true | false",  
"agentId": "企业钉钉应用信息AgentId(从企业钉钉信息中获取 'AgentId')",
"appKey": "企业钉钉参数SSOsecret(从企业钉钉开放平台信息中获取 'AppKey')",
"appSecret": "企业钉钉参数SSOsecret(从企业钉钉开放平台信息中获取 'AppSecret')",
"syncCron": "拉入同步时间表达式, 默认每10分钟同步一次(10 0/10 * * * ?).",
"forceSyncCron": "强制拉入同步cron, 默认在每天的8点和12点强制进行同步(10 45 8,12 * * ?)",
"oapiAddress": "企业钉钉api服务器地址, 固定填写:https://oapi.dingtalk.com",
"messageEnable": "是否允许推送消息到企业钉钉: true | false"

完成以上配置后重启O2OA,即可完成O2OA在企业钉钉中的接入,可以在企业钉钉中看到自己配置的企业应用。

七、手工从钉钉拉取组织人员数据

服务地址:http://localhost:20030/x_program_center/jest/index.html

服务名称:DingdingAction.pullSync

如下图所示界面,点击GET之后,观察服务器控制台或者日志文件信息(o2server/logs),可以查看到同步日志。

请注意,不要多次点击GET,点击一次后,控制台会有正在拉取组织人员信息相关的日志。

企业注册钉钉
企业首页
企业控制台工作台
创建自建应用
配置应用详细信息
自建应用创建完成
查询应用设置
查询CropId
设置通讯录权限
钉钉上的智和办公平台
中心服务器API