1.概述编辑
将数知鸟与帆软其他产品,以及更多第三方服务连为一体,实现跨产品的需求自动创建,节省人工成本、减少工作失误,让团队更高效地工作
2.权限编辑
「设置」>「企业权限」-「功能权限」>【通讯录】-【集成设置】,拥有该权限用户可配置集成服务
(图)
3.新增“集成服务”编辑
「设置」>「集成配置」>「集成服务」,新增集成,可设置集成服务名称用于区别集成服务类型、方便管理。
注1:集成服务列表按照创建时间正序排列
注2:默认“关闭”状态,“开启”后才能应用
(图)
4.配置“集成服务”编辑
新增后进入配置页面,存在两个默认模块,一为默认卡片“收到webhook”,二为“添加步骤”
(图)
4.1查看并填写webhook地址
建立“集成服务”后,默认生成webhook地址,支持复制与重置。复制该地址、贴入其他系统的webhook输出位,数知鸟将收到其他系统的请求
(图)
4.2建立动态数据映射
从其他系统发送的请求中提取关键信息,用于动态填充“添加步骤”中的字段,即为建立动态数据映射
(图)
具体建立动态数据映射关系,需了解请求内容、知晓关键信息所处位置,从而填写关键信息的“显示名”、“KEY”、“类型”、“来源”、“获取方式”字段
字段名称 | 释义 | 填写要求 |
---|---|---|
显示名 | 重命名 | 【必填】 |
KEY | 唯一性检验标志 | 【必填】以字母开头,整体由字母数字与下划线组成 |
类型 | 在数知鸟中的存储字段类型,有text、number、boolean 注:目前仅text类型生效 | 【必填】 |
来源 | 在HTTP请求中位置,有 header、query 、 body | 【必填】 |
获取方式 | 在HTTP请求中的jsonpath | 【必填】点击查看填写指南 |
(图)
4.3设置空间
由于数知鸟的操作单位以空间划分,所以需要在此设置下列步骤的作用空间
注:支持选择当前配置者所属任意空间
(图)
4.4添加步骤
默认提供五个步骤,分别是过滤步骤2个“过滤条件”、“筛选需求”,执行步骤3个“新增需求”、“提交备注”、“变更字段值”
步骤类型 | 步骤 | 步骤作用 | 字段名称 | 释义 | 填写要求 |
---|---|---|---|---|---|
过滤步骤 | 过滤条件 | 对收到的请求进行过滤,排除无效请求,方便进行后续操作 | / | 排除无意义动态映射 | |
筛选需求 | 过滤出目标需求,方便进行后续操作 | / | 对已有需求进行筛选 | ||
执行步骤 | 新增需求 注:若提出人在当前空间无“新增需求”权限,则无法新增需求 | 在数知鸟内生成新需求 | 需求类型 | 对应类型 | 【必填】支持选择已有需求类型 |
提出人 | 需求提出人 | 【必填】 | |||
需求标题 | 标题命名 | 【必填】支持输入纯文字、纯动态内容,也支持输入出文字+动态内容 注:动态内容即集成卡片中设置完成的动态数据映射 | |||
详情 | 详情内容 | ||||
提交备注 注1:该步骤前必须有目标需求 注2:操作人默认为空间创建者 | 在目标需求中新增备注 | 内容 | 备注内容 | 【必填】 | |
变更字段值 注1:该步骤前必须有目标需求 注2:操作人默认为空间创建者 | 修改目标需求的目标字段内容 | 字段 | 需求字段 | 【必填】 | |
对象 注:当所选“字段”类型为【下拉单选】时,为选择确切的修改目标,“对象”字段才会出现 | 变更前目标内容 | 【必填】 | |||
变更为 | 变更后内容 | 【必填】 |
(图)
5.应用集成卡片编辑
点击“开启”按键,正式应用
(图)