如何在应用中直接使用钉钉的组织架构进行组织管理

适用场景

通过使用钉钉组织架构模块，开发者可快速实现钉钉和系统组织架构模块之间的数据同步。

模块介绍

钉钉组织架构模块通过引用系统组织架构模块和钉钉连接模块，完成了系统组织架构模块与钉钉组织架构模块信息的连接。同时通过系统组织架构模块向开发者提供了管理钉钉组织架构模块的能力，方便开发者快速复用。

钉钉组织架构模块，分别通过数据模型、定时任务、页面、逻辑流向开发者提供了各层次的能力。

数据模型

通过数据建模完成对系统组织架构模块的扩展，具体实体关系见下：

• 应用API信息：存储钉钉的APIKey和APISecret。

• token：存储钉钉的应用token。

• 用户扩展信息：存储用户钉钉ID。

• 角色扩展信息：存储角色钉钉ID。

• 角色组扩展信息：存储角色组钉钉ID。

• 部门扩展信息：存储部门钉钉ID。

定时任务

通过定时任务，提供定时刷新应用token的能力，解决应用token刷新时效性问题。

• 定时任务的配置。

  

• 定时任务触发获取应用token后端逻辑流。

  

页面

提供面向部门、业务角色和用户的管理页面。

逻辑流

提供获取钉钉组织架构数据并保存至魔笔应用的后端逻辑流。

操作步骤

通过以下步骤，可实现在自建的魔笔应用内，基于钉钉组织架构模块，完成对于钉钉组织架构的角色、角色组、部门和用户的管理。本文以搭建一个自定义的钉钉组织架构为例说明具体操作。

步骤一、收藏模块

在物料市场收藏钉钉组织架构模块，具体操作请参见收藏应用模板和模块。

步骤二、引用模块

在魔笔应用设计器左侧选择，单击添加引用模块，在引用模块管理中，引用钉钉组织架构模块，具体操作请参见引用模块管理。

引用成功后引用模块管理显示组织架构模块、钉钉连接模块、钉钉组织架构模块。

步骤三、新建导航组

1. 新建导航组系统管理。在左侧功能区选择 > 导航 > 添加导航组，设置导航组名称为系统管理。

   

2. 新建导航项部门管理。单击添加导航项，在页面处引用钉钉组织架构模块的部门-列表页。

   

3. 新建导航项用户管理。单击添加导航项，在页面处引用钉钉组织架构模块的用户-列表页。

   

4. 新建导航项角色管理，单击添加导航项，在页面处引用钉钉组织架构模块业务角色-列表页。

   

5. 新建导航项角色组管理，单击添加导航项，在页面处引用钉钉组织架构模块角色组-列表页。

   

6. 将新建的4个导航项拖入系统管理导航组。

   

步骤四、新建组织架构页面

1. 新建组织架构页面。

   在左侧功能区选择 > 页面 > 添加新页面，设置页面名称为组织架构页面，选择模板空白页，单击创建页面。

   

2. 新增组织架构的三级导航，在左侧组件区选择大纲树> 三级导航，右侧属性区在导航项筛选选择系统管理。

   

步骤五、配置首页

1. 新增钉钉API信息按钮。

   在左侧功能区选择 > 页面 > 首页，在左侧功能区拖入组件按钮，设置按钮文字为设置钉钉API信息，并在右侧属性区绑定跳转页面为钉钉组织架构模块 > 应用API信息设置页面。

   

2. 在左侧功能区拖入组件容器，在容器中拖入组件Data，绑定上下文“钉钉组织架构模块 > 锁”。

3. 在左侧功能区拖入组件按钮到Data容器中，设置按钮文字为组织架构页面，绑定前端逻辑流为钉钉组织架构模块 > 同步所有数据并跳转用户页面。

   

步骤六、配置钉钉应用

1. 从钉钉应用后台管理中的应用信息中获取AppKey和AppSecret。关于钉钉应用后台，请参见钉钉开放平台。

   

2. 在钉钉应用后台管理的权限管理模块加上通讯录管理的所有权限。

   

步骤七、启动应用

1. 上述步骤完成后，单击页面右上角预览，进入预览页面，单击访问应用。

   

2. 设置钉钉API信息。

   1. 单击设置钉钉API信息，进入钉钉API设置页面。

      

   2. 设置appKey和appSecret，单击确定。

      

3. 单击组织架构页面，进入组织架构页面。查看系统管理菜单下的页面。