 - Kanass如何有效集成sward文档)
Tiklab旗下的kanass（项目管理工具）、sward（知识库管理工具）可以有效互相集成，本文将详细介绍如何在Kanass中集成sward文档。
1、kanass的安装与配置
1.1 安装
下载
点此下载
安装
以centos为例，将Linux下的centos安装包下载，并使用rpm命令安装kanass。
sudo rpm -ivh tiklab-kanass-1.2.9.rmp
启动
安装成功后，会自动在opt目录下创建出tiklab-kanass目录，进入tiklab-kanass/bin目录下，使用./kanass start命令启动kanass
cd opt/tiklab-kanass/bin
./kanass start
登录
浏览器输入http://ip:9500，默认用户名/密码：admin/123456。
登录
首页
1.2 配置
通过修改application.yaml配置文件，可以进行自定义配置，如修改端口、配置DB等。centos环境的yaml文件地址：/opt/tiklab-kanass/conf目录下
端口配置
应用端口默认为9500，可以修改为其他端口
#web config
server:
port: 9500
数据库配置
kanass默认使用内嵌DB，如需使用外部Mysql DB则可通过修改以下内容进行自定义。
jdbc:
driverClassName: org.postgresql.Driver
url: jdbc:postgresql://localhost:9501/tiklab_kanass?stringtype=unspecified
username: postgres
password: darth2020
例：链接外部mysql时，可修改为
字段 | 内容 |
driverClassName | com.mysql.cj.jdbc.Driver |
url | jdbc:mysql://ip:3306/sqlname？characterEncoding=utf8&useSSL=false |
username | 有权限连接mysqlDB的用户 |
password | 有权限连接mysqlDB用户的密码 |
集成配置
登录kanass->系统设置->集成开放->服务集成，在sward下点击编辑，输入对应的系统地址。
服务集成
2、项目集成知识库
2.1 创建sward知识库
- 添加
进入kanass项目->文档->知识库，点击添加知识库，可以为当前项目添加并直接关联一个知识库。知识库添加成功后，点击知识库名称，即可打开sward页面，可以在sward中创建或上传文档。
- 删除
在知识库页面，点击列表中的更多按钮，可以删除知识库。注：若知识库是在sward中创建，并关联到kanass，此处删除的是关联关系。若知识库是在kanass中直接创建，则此处删除为删除知识库。
2.2 关联已存在知识库
点击“关联知识库”，页面中出现的是已经存在于sward中的知识库，勾选后确定。
项目关联知识库
3、事项集成文档
关联sward成功后，项目中的事项便可集成知识库中的文档
3.1 创建sward文档
- 添加
进入项目->文档->创建文档。选择所属知识库和目录，输入文档名称后，文档创建成功。点击文档名称打开sward页面进行编辑
- 删除
在文档页面，点击列表中的更多按钮，可以删除文档。注：若文档是在sward中创建，并关联到kanass，此处删除的是关联关系。若文档是在kanass中直接创建，则此处删除为删除文档。
3.2 关联sward中已存在文档
事项关联文档
进入需求详情页面，点击文档->添加文档。页面自动展示出上一步所选知识库的文档列表，可以通过文档名称、文档作者、所属知识库进行筛选，点击文档列表中的文档进行关联。事项支持关联多个文档。
事项关联文档
- 知识库关联文档
不仅具体事项可以关联文档，项目也可以关联文档。进入项目->文档->关联文档，此页面也可以通过文档名称、文档作者、所属知识库进行筛选，点击文档列表中的“+”进行关联。
同时此页面也会显示所有与事项关联的文档。
项目关联文档
3.3 查看文档
在任意关联文档的页面，点击文档名称，页面跳转到sward，登录后既可查看文档。
