`

如何将 O2OA (翱途) 集成到阿里钉钉

阅读更多

O2OA 平台拥有配套的原生开发的安卓和 IOS 移动 APP,可以以微应用的方式集成到阿里钉钉,同步钉钉的企业通讯录作为本地组织人员架构,并且可以将待办等通知直接推送到钉钉进行消息提醒。本篇主要介绍如何将 O2OA 集成到阿里钉钉实现钉钉办公。

如果 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?id=********** ,就是登录成功后跳转到门户页面星号代表门户的id)
开服务器出口IP  :填写服务器公网出口IP地址
首页地址       :http://[serverIp]:[port]/x_desktop/ddsso.html
可使用范围      :根据要求填写

 

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

 

自建应用创建完成

 

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

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

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

查询应用设置

 

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

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

 

2、查询企业 CropId 信息

 

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

查询 CropId

 

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

 

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

 

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

设置通讯录权限

 

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

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

 

六、O2OA 接入配置

此项建议直接在系统界面内配置

1、配置文件配置方式

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": false,
  "workUrl": "",
  "messageRedirectPortal": "",
  "scanLoginEnable": false,
  "scanLoginAppId":"",
  "scanLoginAppSecret":"",
  "###enable": "是否启用###",
  "###corpId": "钉钉corpId###",
  "###agentId": "agentId###",
  "###appKey": "应用的key,唯一标识###",
  "###appSecret": "应用的密钥###",
  "###syncCron": "组织同步cron,默认每10分钟同步一次.###",
  "###forceSyncCron": "强制拉入同步cron,默认在每天的8点和12点强制进行同步.###",
  "###oapiAddress": "oapi服务器地址###",
  "###messageEnable": "是否启用消息推送###",
  "###scanLoginEnable": "是否开启钉钉扫码登录##",
  "###scanLoginAppId": "钉钉扫码登录的AppId###",
  "###scanLoginAppSecret": "钉钉扫码登录的appSecret###"
}

 

参数说明:

"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"
"workUrl":"这个参数是为了钉钉推送的工作消息开启超链接功能,这里配置o2oa服务器地址, 如:http://dev.o2oa.net/x_desktop/",
"messageRedirectPortal":"这个参数是配置一个门户id,是上面工作消息打开后处理完成跳转的门户页面",
"scanLoginEnable": "是否开启钉钉扫码登录: true | false",  
"scanLoginAppId": "钉钉扫码登录的AppId",
"scanLoginAppSecret": "钉钉扫码登录的appSecret"

3)按要求填写配置信息,保存后重启服务器即可。

 

2、系统界面配置方式

1)以管理员身份登录系统

2)打开 系统配置 -> 移动端配置 -> 应用集成 -> 钉钉集成

按要求填写配置信息,保存后重启服务器即可完成 O2OA 在企业钉钉中的接入

 

 

3、钉钉集成界面效果

 

钉钉上的智和办公平台

 

可以在企业钉钉中看到自己配置的企业应用。

 

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

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

服务名称:DingdingAction.pullSync

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

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

 

 

0
0
分享到:
评论

相关推荐

    o2oa用户操作手册-环境部署及搭建应用.zip

    4. **部署应用**:将O2OA的war文件部署到Tomcat的webapps目录下。 5. **启动服务**:启动Tomcat服务器,O2OA应用将自动被加载。 6. **首次登陆与设置**:通过浏览器访问O2OA的默认URL,完成管理员账户的创建和系统...

    o2oa用户操作手册-环境部署及搭建应用-20180925.doc

    O2OA是一款基于J2EE架构的企业信息化系统,它集成了移动办公和智能办公功能,适用于私有化部署,并具有自适应负载的能力。该平台旨在帮助企业节省软件开发成本,同时提供专业的开发运维服务。 1. **O2OA系统概述** ...

    O2OA-master (1).zip

    5. **数据模型与表单设计**:O2OA允许用户自定义数据模型和表单,涉及到数据库设计、ORM映射以及表单展示逻辑。了解这一部分可以实现企业特定的数据管理需求。 6. **API接口与集成**:O2OA提供RESTful API,方便与...

    O2OA开源OA系统 v8.1.1.zip

    考虑到现代办公的移动化趋势,O2OA v8.1.1支持原生的移动应用,用户可以通过手机或平板电脑随时随地处理待办事项,提高工作效率。移动应用提供与桌面端一致的功能体验,包括审批、表单填写、通知提醒等。 ### 5. ...

    O2OA开源OA系统 v8.2.3.zip

    在计算机案例中,O2OA展示了如何将先进的信息技术应用于实际工作场景。系统内建了丰富的建站模板,覆盖了人力资源、财务、项目管理等多个部门,快速构建出符合企业特色的办公环境。这些模板不仅降低了实施难度,也...

    O2OA-master.zip

    **O2OA-master.zip** 是...通过深入研究O2OA-master.zip的内容,开发者和企业IT人员可以了解并掌握一套完整的OA系统开发和实施流程,同时也能学习到如何利用开源技术和国产化软硬件环境来构建安全、高效的企业级应用。

    o2oa-mini-program:开源OA企业信息化平台O2OA的小程序

    O2OA是基于J2EE架构,集成了移动办公,智能办公,支持私有化部署,自适应负载能力的,能够节省成本的企业软件开发成本的基于AGPL协议开放源代码的企业信息化系统需求定制开发解决方案方案,对外提供专业的开发运维等...

    O2OA开源OA系统 v6.0.2-源码.zip

    O2OA提供了丰富的API接口,允许开发者进行二次开发和系统集成,实现与其他业务系统的无缝对接。同时,它还支持自定义插件,可根据企业需求扩展功能。 七、安全机制 O2OA在安全性方面下了很大功夫,采用角色权限管理...

    ​ O2OA企业应用开发平台是使用JavaEE技术栈,分布式架构设计的一款真正全代码开源的企业应用定制化开发平台

    ​ O2OA企业应用开发平台是兰德纵横网络技术股份有限公司发布和维护的开源产品,是使用JavaEE技术栈,分布式架构设计的一款真正全代码开源的企业应用定制化开发平台。适用于企业OA、协同办公类信息化系统的建设和...

    O2OA开源OA系统 v5.2.3

    为您提供O2OA开源OA系统下载,O2OA是基于J2EE架构,集成移动办公、智能办公,支持私有化部署,自适应负载能力的,能够很大程度上节约企业软件开发成本的基于AGPL协议开放源代码的企业信息化系统需求定制开发解决方案...

    O2OA开源OA系统 v5.3.3

    为您提供O2OA开源OA系统下载,O2OA是基于J2EE架构,集成移动办公、智能办公,支持私有化部署,自适应负载能力的,能够很大程度上节约企业软件开发成本的基于AGPL协议开放源代码的企业信息化系统需求定制开发解决方案...

    O2OA开源OA系统 v5.2.5

    为您提供O2OA开源OA系统下载,O2OA是基于J2EE架构,集成移动办公、智能办公,支持私有化部署,自适应负载能力的,能够很大程度上节约企业软件开发成本的基于AGPL协议开放源代码的企业信息化系统需求定制开发解决方案...

    O2OA开源OA系统是基于J2EE架构,集成移动办公、智能办公,支持私有化部署.rar

    O2OA开发平台是一个基于J2EE分布式架构,集成移动办公、智能办公、支持私有化部署、自适应负载能力的,节约企业软件开发成本企业信息化系统需求定制开发平台解决方案。O2OA平台基于AGPL协议开放源代码,提供有偿的...

    开源OA企业信息化平台O2OA iOS端源码.zip

    2. **o2oa-ios_master.zip** - 这个文件可能是O2OA iOS客户端源代码的主分支(master分支)的归档,开发者可以解压后在Xcode(苹果的集成开发环境)中打开并进行编译和调试。它可能包含了项目的各个组件,如视图控制...

    O2OA开源OA系统 v5.3.5

    为您提供O2OA开源OA系统下载,O2OA是基于J2EE架构,集成移动办公、智能办公,支持私有化部署,自适应负载能力的,能够很大程度上节约企业软件开发成本的基于AGPL协议开放源代码的企业信息化系统需求定制开发解决方案...

    最新版O2OA开源OA系统v5.2.5主要功能齐全及特点鲜明.txt

    ### 最新版O2OA开源OA系统v5.2.5主要功能及特点解析 #### O2OA系统简介 O2OA(Office To Office Automation)是一款采用Java语言开发的开源办公自动化平台,支持前后端分离架构,具备良好的扩展性和灵活性。该系统...

    o2oa-android:开源OA企业信息化平台O2OA Android端

    O2OA企业信息化办公平台Android端原始码 O2OA平台Android客户端,最低支持Android版本4.4 Android KitKat,编程语言主要使用kotlin。 环境安装 请使用最新版本的Android Studio进行导入编译,编译的Android SDK版本...

    O2OA开源OA系统 v5.2.2

    为您提供O2OA开源OA系统下载,O2OA是基于J2EE架构,集成移动办公、智能办公,支持私有化部署,自适应负载能力的,能够很大程度上节约企业软件开发成本的基于AGPL协议开放源代码的企业信息化系统需求定制开发解决方案...

    o2oa-ios:开源OA企业信息化平台O2OA iOS端

    O2OA企业信息化办公平台iOS端原始码 O2OA平台iOS客户端,最低支持IOS版本10.0,编程语言使用swift。 准备 Xcode版本使用最新的版本 项目使用了COCOAPODS,需要本地安装最新版本的COCOAPODS。然后到项目根目录执行pod...

Global site tag (gtag.js) - Google Analytics