# Lark工作台

##  工作台小组件

宿主为工作台场景的小组件即为 **工作台小组件**。

你可以按需设计并开发小组件，将其添加至工作台，灵活定制企业个性化工作台。除自行开发外，你也可以使用Lark提供的服务商付费定制服务。联系客户成功经理，帮助你借助服务商打造小组件和企业的专属工作台。
**注意事项**：定制工作台小组件能力目前仅面向企业版或旗舰版租户的自建应用开放。

## 示例场景
下图小组件仅供参考，具体样式与功能可定制开发。

### 场景一：图表类小组件

![场景配图-1-2.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/24cd364786ebf573f30b8e3898d893ed_7mLwhWswgQ.png?lazyload=true&width=1600&height=600)
**注意事项**：开发图表类小组件需使用 ChartSpace 图表能力，用于引入柱状图、条形图、散点图等图表。

1. ChartSpace 官网正在内测中，可联系客户成功经理加入内测，查看图表类型与示例效果；

2. 查看小组件[内置 ChartSpace](https://open.larksuite.com/document/uAjLw4CM/uYjL24iN/block/component/extend/chartspace-component) 的接入方式。

### 场景二：项目管理类小组件

![场景配图-2-2.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/a031d8492748b22a2fa8ddaada6857ad_tQk1r0fPYP.png?lazyload=true&width=1600&height=600)

### 场景三：员工关怀类小组件

![场景配图-3-2.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/05d38e3fb751b122a54ac92c160a3efe_ipo14guPPp.png?lazyload=true&width=1600&height=600)

## 小组件类型

工作台小组件有两种适配类型：**标准小组件** 和 **非标准小组件**，对应两种使用场景和添加路径。可添加到**定制工作台**或**默认工作台**。

> 定制工作台：企业可自定义的个性化工作台、为企业提供的轻型门户解决方案，详见 [定制工作台功能介绍](https://www.larksuite.com/hc/zh-CN/articles/625896351850)。
> 
> 默认工作台：没有定制过的标准工作台。

### 非标准小组件
容器大小由小组件开发者自定义，可以展示在**定制工作台**除我的常用外的**任意区域**的小组件。

**添加方式**：
- 管理员可进入 管理后台 > 工作台 > 定制工作台，打开定制工作台编辑器，按需添加小组件。

工作台展示效果，如下图所示：

![海外知识效率-pc-中文.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/ff76356402e1aa93d13ca3de39aabd44_BlH18I5fu4.png?lazyload=true&width=2400&height=2958)

### 标准小组件

容器大小受一定限制，高度固定 150 px、宽度会随着工作台的大小改变而进行拉伸适配的小组件。仅限添加到 **默认工作台**或**定制工作台**的 **我的常用** 区域。

**添加方式：** 
- 	普通成员添加常用应用：**工作台** > **我的常用** > **添加**
- 管理员添加推荐应用：进入 **管理后台** > **工作台** > **工作台设置** > **管理员推荐** > **+ 添加推荐规则**

桌面端和移动端的工作台展示效果，如下图所示：
![image.png](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/ea7e3e5212f3cd15d2e7e117c21e5f0b_V8sbkMh4OS.png?lazyload=true&width=1640&height=1402)

## 小组件设置

在开发者后台新建小组件时，在工作台配置中，可选择是否启用 **小组件设置** 。

**小组件设置** 也称为小组件内容设置，即当小组件的内容需要用户在前台手动或主动定义时，开发者可为小组件开启小组件设置能力，供特定人员配置小组件的内容。如果小组件内容更新频率较高，业务人员便可在定制工作台时或运营阶段，进入小组件设置配置小组件内容。

**注**：小组件设置非必选能力。如果小组件中**没有需要用户在前台自定义内容，则无需启用该设置**。

### 使用样例

以官方小组件“图文列表”为例。企业使用“图文列表”小组件进行企业内部的新闻宣发，业务人员就需要定期更新其中的企业新闻。因此，该小组件在开发过程中就可以启用 **小组件设置**，为业务人员提供内容配置入口。
1. **小组件设置** 开启后，可通过两种方式前往内容配置页面。
   - 通过客户端工作台，点击 **小组件设置**，直接进入内容配置页面。

![](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/ca4d6c531ea4921f2e9f461dfa85f891_Ix9KSiZ6yh.png?lazyload=true&width=1392&height=648)
   - 进入[Lark管理后台](https://larksuite.com/admin)，前往 **工作台** > **定制工作台** > **定制工作台编辑器。** 选中“图文列表”小组件，在右侧面板中的 **内容设置** 中，点击 **前往设置**，进入小组件内容设置页 **。**

![](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/54bc2b7fbb657231909eab138756d813_HXuJXSvjDr.png?lazyload=true&width=2744&height=1374)

**注**：有工作台权限的管理员可进入小组件设置页。如小组件的内容需要开放给更多业务角色使用，可联系Lark技术支持，Lark官方提供了一套标准的权限管理机制供参考。

2. 在内容配置页面，可以通过手动配置或自定义接口两种方式配置内容。具体信息，参见[图文列表小组件使用手册](https://www.larksuite.com/hc/zh-CN/articles/461747785604)。

![](//sf16-sg.larksuitecdn.com/obj/open-platform-opendoc-sg/93a5a623d14eb97b145f023e87324f3f_r9zfVoIsJ9.png?lazyload=true&width=2722&height=974)

### 如何开启小组件设置
1.  进入**开发者后台**，前往 **企业** **自建应用** > **应用功能** > **小组件** > **小组件列表**
2. 打开小组件，前往 **工作台配置** > **小组件设置** > **启用设置**。
**注**：
   - **小组件适配类型** 选择 **非标准小组件**。
   - 如果开发者的组件不提供内容设置相关的能力，则此处可以不启用设置。
3. 填写 **设置页** **URL** 。
只能填写Lark的网页应用或者小程序 URL，不限制配置应用的范围。比如 ISV 应用 A 开发了一个小组件，设置能力既可以在原有应用 A 中实现，也可以单独开发独立应用 B 来实现。

## 开发指引
工作台小组件能力已面向自建应用，支持开发者便捷开发。你可以通过下一章 快速开始 了解如何开发一款小组件。
完成研发后，你需要在开发者后台申请发布小组件，发布申请被审核通过后，你所在的租户中在该应用可用性范围内的用户便可以在工作台使用你的小组件。