接入工作流指南.md

接入工作流指南

一、介绍

DataSphereStudio定位为闭环涵盖数据应用的全流程，在统一的UI下，以工作流式的图形化拖拽开发体验。Qualitis可以接入DataSphereStudio，成为其中的一个工作流节点。

Qualitis接入DataSphereStudio，会有以下变动。

项目同步

Qualitis中工作流项目与DataSphereStudio中工程打通并同步。
若DataSphereStudio中创建工程，则Qualitis中会同步创建工程，删除修改亦然。
以DataSphereStudio中工程为主。

用户自动创建

由于DataSphereStudio内嵌Qualitis的页面，并且DataSphereStudio和Qualitis中登录系统不同。
为了保证DataSphereStudio中能够打开Qualitis的页面，当DataSphereStudio中触发打开Qualitis页面时，若登录DataSphereStudio用户在Qualitis端不存在，则Qualitis会自动创建该用户，且该用户的密码与用户名相同。

DataSphereStudio工作流节点与Qualitis规则组一一对应

一个DataSphereStudio Qualitis工作流节点与Qualitis中的一组规则对应。 当在DataSphereStudio中拖出一个工作流节点，并创建出规则时，会在Qualitis中创建一组规则与之对应。

二、接入步骤

Qualitis修改(已默认开启，如无变动，可跳过该步骤)

修改配置文件

vim conf/application.yml

并修改workflow.enable=true

DataSphereStudio修改

DataSphereStudio接入外部系统原理可看文章：第三方系统接入DSS指南
1. DataSphereStudio服务端修改

数据库修改

修改dss_application表，增加如下记录，该表用于增加首页以及菜单页面的跳转逻辑

id	name	is_user_need_init	level	exists_project_service	project_url	if_iframe	homepage_url	redirect_url
{application_id}	qualitis	0	1	1	http://{qualitis_host}:{qualitis_port}/#/projects/list?id=${projectId}&flow=true	1	http://{qualitis_host}:{qualitis_port}/#/dashboard	http://{qualitis_host}:{qualitis_port}/qualitis/api/v1/redirect

修改dss_workflow_node表，新增如下记录，该表用于增加双击工作流节点的逻辑以及跳转页面。

node_type	application_id	enable_copy	should_create_before_node	support_jump	jump_url
linkis.appjoint.qualitis	{application_id}	1	0	1	http://{qualitis_host}:{qualitis_port}/#/addGroupTechniqueRule?tableType=1&id=${projectId}&ruleGroupId=${ruleGroupId}&nodeId=${nodeId}

{application_id}是dss_application表中的记录id号 {qualitis_host}是Qualitis的机器ip {qualitis_port}是Qualitis的服务端口

插件包(已默认修改，如无变动，可跳过该步骤)

下载插件包

并将插件包放在dss-server/appjoints/qualitis/lib以及linkis-appjoint-entrance/appjoints/qualitis/lib路径中。
如果目录不存在，请自行创建。

并创建dss-server/appjoints/qualitis/appjoint.properties以及linkis-appjoint-entrance/appjoints/qualitis/appjoint.properties文件(空文件)。

2. DataSphereStudio客户端修改(已默认修改，如无变动，可跳过该步骤)
2.1 增加节点类型 修改src/js/service/nodeType.js文件，增加Qualitis节点类型

2.2 增加节点图标 将节点图标复制到src/js/module/process/images/路径下，目前只支持SVG格式。

2.3 新增节点配置 修改src/js/module/process/shape.js文件，增加Qualitis的节点配置信息。

2.4 修改首页单击节点事件 修改src/js/module/process/index.vue文件，增加节点单击事件以及单击事件的处理逻辑。

2.5 修改工作流节点双击事件 修改src/js/view/process/index.vue以及src/js/module/process/index.vue，增加节点双击事件以及双击事件的处理逻辑。