背景说明
私网客户对协作的使用存在很大的差异,定制需求是一定会存在的,因此协作必须得具备定制能力,这些定制能力根据实际场景需要,可以通过定制api实现,也可以通过打包来实现。下面详细介绍定制场景、定制功能、以及定制功能的备注说明。 特别强调:该文档仅供参考,新增的插件api能力能够实现的定制效果图未完全补充在“定制api”效果图中,另外,具体实现效果由插件开发者实现。
定制能力
定制能力提供实现定制需求的技术支持,主要包括定制api(需要经过研发写代码实现定制需求),打包配置项(通过开关实现某些功能的开启和关闭,不需要写代码)。
定制api
| 定制场景 | 定制能力api | 效果图(仅供参考) | 说明 |
|---|---|---|---|
| 左侧新增功能入口,一般会将客户高频使用的系统固定到左侧,并根据需要调整显示顺序;或者屏蔽协作本身的功能 | 支持新增功能入口、支持将协作自带的功能调整入口顺序、支持将自定义的入口调整顺序、支持修改功能入口的打开方式(点击事件)、支持屏蔽协作左侧自带的功能 | ![]() | 工作台、会议和通讯录均是自定义的功能入口,点击后直接在右侧打开,屏蔽了“我的”功能入口 |
| 客户需要修改协作的主题、背景色等风格样式,提高企业认同感 | 支持修改背景色、支持修改侧边栏图标、支持修改按钮选中颜色、支持修改logo等等 | ![]() | 背景色不是默认的“湖水蓝”,而是客户自定义的颜色“财信蓝” |
| 在第三方页面快捷与用户发起单聊、群聊,方便用户使用,而不需要到首页找到用户发起单聊或者群聊 | 支持在三方页面快捷发起单聊、支持在三方页面创建群聊 | ![]() | 第三方页面可以通过插件调用接口快捷发起单聊或者群聊 |
| 有些次高频的功能没有必要固定在左侧栏,需要在顶部新增快捷入口,方便用户使用 | 支持将协作自带的功能入口固定在顶部、支持将三方系统的功能入口固定在顶部、支持在顶部下拉框中新增功能入口 | ![]() | 协作自带的功能:发起群聊三方功能入口:上方意见反馈、下方预约会议、创建日程、新建表单流程 |
| 用户在聊天过程中需要对其中的关键消息进行类似“转发”的操作,以此提高操作便捷性 | 支持新增消息功能操作、支持自定义功能按钮的点击事件 | ![]() | 在消息操作的下方可以自定义消息操作功能菜单 |
| 个人中心下拉模块会添加一些常用的功能入口或者企业自己的通讯录,方便用户使用 | 支持新增功能入口、支持屏蔽功能入口、支持设置新增功能入口的点击事件 | ![]() | 该“通讯录”不是协作的通讯录,是用户自己的通讯录 |
| 在集成三方系统后,可能会唤起通讯录,发送一些消息,转发,分享等一些操作,将关键信息通知到相关人员 | 支持通过接口唤起协作通讯录选择器、支持将选择的用户传给应用的服务端 | ![]() | 在第三方页面唤起协作通讯录选择器,实现相关功能操作 |
| 三方页面会涉及一些功能操作,功能操作后需要给到用户一些操作反馈,成功还是失败等 | 支持在窗口顶部唤起通知、支持设置弹窗提示文字 | ![]() | 这是第三方全时会议,当用户加入一个已经结束的会议时,窗口顶部的通知 |
| 三方页面可能会涉及获取某些具体的用户信息,比如在三方审批页面,审批通过后将消息通知到申请人,需要知道该申请人的身份信息,用于推送消息 | 支持获取用户的company_uid、支持根据用户的ThirdId转化成协作的company_uid | 暂无 | 插件调用接口获取用户company_uid,传给应用服务端实现推送消息等业务 |
| 用户在很多场景下会打开链接,希望能够在协作中快速打开,不需要复制一下再到浏览器中去打开,操作繁琐 | 支持调起浏览器打开链接、支持在端内tab打开链接 | ![]() | 在tab栏打开链接需要定义好网页页签和标题,不定义默认使用原网页页签和标题 |
| 一些自建会通知一些强提醒消息到用户,比如弹窗呼叫、持续消息弹窗;或者需要更新一些三方页面 | 支持订阅三方websocket cmd消息、支持透传第三方服务端通过调用cmd msg接口传入的数据、支持客户端响应websocket事件 | ![]() | 客户端响应服务端下发的ws cmd消息,通过插件能力绘制弹窗,实现呼叫场景 |
| 搜索是用户非常常见的场景,用户会搜索一些三方系统的信息,提高用户使用的便捷性和粘性 | 支持注册自定义搜索分类、支持设置自定义搜索结果的头像、支持设置自定义搜索结果的主标题、支持设置自定义搜索结果的UI布局、支持设置搜索结果的点击事件 | ![]() | “待阅”这个搜索分类是自定义的搜索分类 |
| 用户在搜索信息时,希望能够将关键信息展示在显眼的位置,提高搜索效率 | 支持调整自定义搜索分类的顺序、支持调整综合面板自定义搜索分类的顺序 | ![]() | 目前暂不支持调整内置搜索分类顺序 |
| 用户需要将协作自带的功能挪到其他位置,以便快速找到 | 基座提供接口,直接调用相应功能 | ![]() | 比如将收藏的功能入口放到个人中心下拉下面 |
| 一些三方应用(全时会议等)会推送一些比较重要消息给到用户,比如弹窗呼叫等 | 支持创建自定义弹窗、支持调整自定义窗口的展示位置、支持显示自定义窗口、支持关闭自定义窗口 | ![]() | 比如在消息界面绘制定制弹窗 |
打包配置项
客户不使用一些功能,或者需要开启、修改默认功能的状态时,可在打包配置中开启或者关闭某些功能、修改功能配置,下表是可以通过打包配置来关闭或者开启的功能或者修改功能配置。
关闭功能
| 功能名称 | 默认状态 | 是否可以关闭 |
|---|---|---|
| 日历 | 开启 | 是 |
| 群公告 | 开启 | 是 |
| fp文档 | 开启 | 是 |
| 思维导图 | 开启 | 是 |
| 流程图 | 开启 | 是 |
| 位置消息 | 开启 | 是 |
| 金山文档会话 | 开启 | 是 |
| 笔记 | 开启 | 是 |
| 快捷回复 | 开启 | 是 |
| 分块上传 | 开启 | 是 |
| 工作台 | 开启 | 是 |
| 定制启动页 | 关闭 | 是 |
| 定制登录页 | 关闭 | 是 |
| 定制安装脚本 | 关闭 | 是 |
| 登出登录仍保留的cookie | 关闭 | 是 |
开启或者修改功能配置
| 功能名称 | 默认状态 | 状态修改 |
|---|---|---|
| 自动清理缓存 | 开启 | 可开启自动清理缓存 |
| Windows、Linux托盘闪动 | 开启 | 可关闭闪动 |
| 云文档打开方式 | 通过浏览器打开 | 可修改为顶部tab打开 |
| 登录弹窗 | 关闭 | 可开启定制化弹窗 |
| 国密登录 | 关闭 | 可开启国密登录 |
| 会议 | 关闭 | 可开启会议功能 |
| 远程控制 | 关闭 | 可开启远程控制功能 |
| 是否优先显示扫码登录 | 关闭 | 可开启优先扫码登录 |
| 待办 | 关闭 | 可开启待办功能 |
| 语音通话 | 默认agora声网服务商 | 可切换为cloudhub云枢服务商 |
| 搜索框位置 | 默认在左上角 | 可切换至顶部右侧位置 |
| 个人中心邀请定制 | 关闭 | 可开启自定义邀请功能设置下载链接等 |
以上,不定期补充和更新。












