扩展模块介绍 | 开放平台文档

# 扩展模块介绍

# 扩展模块

Tapd 在系统核心页面入口提供了嵌入能力，让第三方应用灵活选择扩展模块进行集成。目前提供如下扩展模块：

# 系统级

工作台-我的仪表盘

# 项目级

# 业务对象级

# 上下文参数

上下文参数可以让开发者通过在扩展模块的入口地址或者其他配置拼接相应的参数来获取上下文信息，有通用参数和扩展模块参数两大类

# 通用参数

系统级上下文参数(支持所有扩展模块)

参数名称	参数描述
system.user.id	当前登录用户id
system.user.nick	当前登录用户nick
system.user.name	当前登录用户名字
system.user.name_pinyin	当前登录用户拼音名
system.user.enabled	当前登录用户状态
system.user.status_name	当前登录用户是否在职
system.user.bu_id	当前登录用户bu_id
system.user.bu_name	当前登录用户bu_name
system.user.dept_id	当前登录用户dept_id
system.user.dept_name	当前登录用户dept_name
system.user.group_id	当前登录用户group_id
system.user.group_name	当前登录用户group_name
system.user.group_names	当前登录用户group_names
system.user.post_name	当前登录用户post_name

# 扩展模块参数

项目级上下文参数(支持所有项目级扩展模块、业务对象级扩展模块)

参数名称	参数描述
workspace.id	当前所在项目id
workspace.name	当前所在项目名称
workspace.pretty_name	当前所在项目英文名称
workspace.parent_id	当前所在项目父项目id
workspace.created	当前所在项目创建时间
workspace.creator	当前所在项目创建人
workspace.status	当前所在项目状态

其他扩展模块参数会在各个扩展模块说明

# 灰度配置

支持按照灰度配置，控制当前扩展模块的可见性。

gray 灰度配置，包含 parser、gray_list属性

{
    //required max:20 对象详情页Tab名
    "name"      :"Demo对象tab",       
    //required Tab打开链接
    "url"       :"http://www.tapd.cn/open_demo/app_for_obj_tab?workspace_id=$workspace.id$&obj_type=$object.type$&obj_id=$object.id$",    
    //default null Tab页显示数字（可选）
    "count_url" :"http://www.tapd.cn/open_demo/get_tab_count?workspace_id=$workspace.id$&obj_type=$object.type$&obj_id=$object.id$" ,
    "height": 300,
    "gray": {                               
        "parser" : "WORKSPACE_IN_LIST", //按照项目ID控制灰度
        "gray_list" : [ //控制灰度的列表，当parser 为WORKSPACE_IN_LIST时，gray_list 就是可见的项目ID列表
            10158901
        ],
    }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

# 用法

假设你的入口地址是 https://demo.oa.com/path ，则：

获取当前访问的用户ID：https://demo.oa.com/path?user_id=$system.user.id$
获取当前访问的项目ID：https://demo.oa.com/path?project_id=$workspace.id$