钉钉集成

为什么集成钉钉#

华炎魔方几乎没有考虑在手机浏览器上的使用效果。如果您希望使用手机来访问华炎魔方,推荐安装和使用我们的 手机客户端,您也可以考虑把华炎魔方集成到钉钉,以便在钉钉客户端中使用华炎魔方。

单点登录#

华炎魔方集成到钉钉后,只要使用钉钉账户登录钉钉客户端,即可在钉钉中直接使用华炎魔方,而不需要再次使用华炎魔方账户来登录使用。

消息推送#

华炎魔方集成到钉钉后,当其绑定的华炎魔方账户有通知消息时,钉钉会弹出消息提醒,可点击该消息直接进入华炎魔方查看或处理相关消息。

支持各种客户端#

得益于钉钉本身支持各种手机、平板电脑、PC电脑等,华炎魔方集成进去后也可以在这些客户端上直接使用。

如何集成钉钉#

准备工作#

在集成钉钉前,请确保您的华炎魔方项目已经绑定到某个可通过互联网访问进入的域名地址,只能通过局域网IP或外网IP地址访问的华炎魔方项目是不可以集成到钉钉的,以下说明均假定您的项目已经绑定到域名地址https://www.test-dingtalk.com

创建钉钉应用#

请注册钉钉,并在钉钉后台(工作台->自建应用)创建“H5微应用”,以下说明都假设这里创建了一个名为“华炎魔方合同”的H5微应用。

设置钉钉开发管理#

请在钉钉后台,进入刚刚创建的“华炎魔方合同”应用,点击“开发管理”进行相关配置。

服务器出口IP:请配置服务器的公网ip,类似于白名单的功能。

应用首页地址:请配置华炎魔方服务的域名地址加上sso/dingtalk?corpid=$CORPID$后缀,比如https://www.test-dingtalk.com/sso/dingtalk?corpid=$CORPID$

PC端首页地址:建议配置和应用首页地址一样。

管理后台地址:不需要配置。

提示

后缀中添加$CORPID$占位符,系统在跳转时会自动将url中的占位符替换成当前企业的corpid。

设置钉钉版本管理与发布#

请在钉钉后台,进入刚刚创建的“华炎魔方合同”应用,并在“版本管理与发布”中选择可使用范围,在可使用范围内的员工可以在工作台中看到“华炎魔方合同”应用和收到推送消息。

确定使用范围后,点击“发布”使配置生效。

添加钉钉插件#

把钉钉集成到华炎魔方之前,请先在华炎魔方项目中安装和启用插件 @steedos/plugin-dingtalk

如何安装和启用插件请参考:华炎魔方插件

绑定钉钉应用#

在启用钉钉插件之后,华炎魔方管理员可以在华炎魔方的“设置->公司设置->公司”界面看到新加了一栏“钉钉”,完善这些信息即可把钉钉应用绑定到华炎魔方中。

  • 企业ID(CorpId):在钉钉后台,“首页”界面可以查看和复制该ID值。
  • AgentID:在钉钉后台,“应用开发->华炎魔方合同”的“凭证与基础信息”界面可以查看和复制该ID值。
  • AppKey:在钉钉后台,“应用开发->华炎魔方合同”的“凭证与基础信息”界面可以查看和复制该Key值。
  • AppSecret:在钉钉后台,“应用开发->华炎魔方合同”的“凭证与基础信息”界面可以查看和复制该Secret值。

在钉钉中使用华炎魔方#

把钉钉集成到华炎魔方之后,还需要在华炎魔方中配置每个用户的“钉钉账号”才能正常在钉钉中使用华炎魔方。

系统管理员可以通知需要在钉钉中使用华炎魔方的用户前往钉钉的通讯录中查找自己的“钉钉账号”,并把它复制下来,然后在华炎魔方的“设置->个人账户设置->我的资料”界面上编辑保存其“钉钉账号”信息;也可以统一由系统管理员在华炎魔方“设置->公司设置->用户”界面上维护每个用户在钉钉通讯录上的“钉钉账号”信息。

以上所有就绪后,华炎魔方用户只要登录钉钉账户就可以在钉钉客户端上无缝使用华炎魔方服务了。

工作台#

如果钉钉上集成了上述创建的“华炎魔方合同”项目,那么只要在手机或PC客户端登录了钉钉,就可以在其“工作台”栏上看到“华炎魔方合同”这个应用,直接点击即可进入应用主页。

消息#

如果钉钉上集成了上述创建的“华炎魔方合同”项目,那么只要在手机或PC客户端登录了钉钉,当其绑定的华炎魔方账户上有推送通知消息时,钉钉客户端会主动通知用户收到推送通知,也可以在其“消息”栏上直接看到来自华炎魔方的消息列表。

华炎魔方

华炎魔方基于商业智能和模型驱动,即使是不懂编程的业务人员,也能轻松便捷地创建智能化、移动化的企业应用。

© 2020 华炎软件. 保留所有权利.

开发人员微信群
商务咨询
微信公众号