# 20230513 - 更新说明
URL: https://docs.ones.cn/release-notes/20230513
| 更新时间 | 20230513 |
| --- | --- |
| 更新内容 | **新增功能：**
- Confluence 迁移易用性优化
- 工作项新建与编辑权限解耦
- Jira数据迁移至 ONES SaaS
- 安全水印支持自定义文案和透明度
- 通知中心列表支持新窗口打开
- Resource预估工时可选是否包含工作日
- 【ONES Pipeline】 拆分为【Code Integration】&【Pipeline Integration】两个新应用
- Resource新增成员登记工时日历甘特视图
- Confluence 自助迁移能力 |
## 一、Confluence 迁移易用性优化
> 适用于「企业版」的 ONES 系统
### 1.迁移详情
点击迁移任务名称，弹窗展示迁移详情。包括开始迁移时间、Confluence 连接环境，以及任务中所迁移的空间，按照迁移状态分类显示；
- 空间迁移状态中，「迁移完成」表示迁移过程结束的空间，「迁移中」表示正在执行迁移的空间，「迁移异常」表示迁移过程中出现 Confluence 环境无法连接、无法获取数据包等错误导致迁移未能正常结束的空间，「准备迁移」表示正在从 Confluence 导出、正在下载 Confluence 数据包以及排队等待处理的未迁移空间
- 列表中展示展示 Confluence 空间名称、关键字、页面迁移进度以及数据包大小
- 如果迁移的 Confluence 空间无任何页面，会在迁移到 ONES Wiki 后自动创建空间主页，因此页面迁移进度会展示为 1/1
## 二、工作项新建与编辑权限解耦
> 适用于「团队版」和「企业版」的 ONES 系统
### 1.功能介绍
解耦属性修改权限，支持按创建和编辑工作项场景，单独控制属性修改权限。
### 2.功能入口
- 在「配置中心-项目管理配置-工作项类型-编辑-工作项权限」下，点击「属性权限」Tab进行设置。
- 在「项目管理-项目-设置-工作项类型-工作项权限」下，点击「属性权限」Tab进行设置。
### 3.操作流程
#### 3.1 新建、编辑或删除创建工作项（或编辑工作项）的属性修改权限
管理员可在「属性权限」中，管理不同场景下的属性的修改权限，包括创建工作项场景和编辑工作项场景。设置属性修改权限后，仅成员域内用户可在创建（或编辑）工作项时，修改属性值。
管理属性权限需具备以下权限：
- 项目内：需具备 超级管理员 或 管理项目 权限；
- 配置中心内：需具备 超级管理员 或 「项目管理」管理员 权限；
## 三、Jira数据迁移至 ONES SaaS
> 适用于「团队版」和「企业版」的 ONES 系统
### 1.功能入口
「团队管理员」可以在「配置中心」-「导入数据」- 「从 Jira 导入数据」进行导入
### 2.导入说明
如果团队之前使用 Jira，ONES 支持导入团队成员和业务数据，只需通过
- 从 Jira 导出数据包
- 将数据包提交到 ONES
两步即可简单完成数据迁移。
#### 2.1 如何从 Jira 导出数据包
##### 2.1.1 导出路径
Jira 主菜单 > Jira Settings (设置) > System (系统) > Backup manager (备份管理器) > Creat backup for cloud (创建云备份) > Download cloud backup (下载云备份)
##### 2.1.2 数据包准备
Jira 的 Cloud 版本，直接上传备份得到的 zip 即可。
Jira 的私有部署版本，且希望导入系统里的附件，则需要：
- 解压缩备份得到的 zip（一般位于 /var/atlassian/jira/export）；
- 把附件文件夹（一般位于/var/atlassian/jira/data/attachments）放进第一步解压缩得到的文件夹里；
- 压缩包含了附件文件夹的系统数据文件夹；
- 导入时，应上传包含了附件文件夹的 zip 包。
### 3. Jira 数据包导入 ONES
- 导入前，请确认需要导入的 Jira 团队的用户数不超过当前团队的用户限额。注意，用户限额 ≠ 用户授权。
- ONES 团队/SaaS公有云版本：用户限额默认 1000。如需调整限额，可发送邮件至 [support@ones.ai](mailto:support@ones.ai) 寻求帮助。
- 数据包限制为 1GB（超出时，可发送邮件至 [support@ones.ai](mailto:support@ones.ai) 寻求帮助）；
- 兼容 Jira 7.10，如导入 Jira 其他版本，可能有部分数据未能正常导入
#### 3.1 导入路径
配置中心 - 迁移数据 -迁移 Jira 数据 - 上传 Jira 备份文件 - 开始导入
#### 3.2 导入数据
点击开始导入时，管理员需要设置新导入成员登录 ONES 系统的初始密码。
Jira 用户密码将不会被导入，新导入的成员首次登录 ONES 系统时需要使用初始密码或忘记密码流程完成登录
导入过程中会生成进度管理器，用户可以离开当前页面进行其他操作。导入完成后，将在通知中心、邮件或第三方平台中发送通知信息。
## 四、安全水印支持自定义文案和透明度
> 适用于「团队版」和「企业版」的 ONES 系统
### 1.功能场景/功能入口
权限：团队管理员
入口：配置中心-〉系统安全-〉安全水印
场景：使用此功能，以增强团队工作项或页面信息的安全性，避免截图泄露信息的风险。
### 2.功能说明
1. 选择开启水印后，Web端、移动端、H5页面均会出现水印。
1. 开启水印后展示配置项，支持自定义显示内容、不透明度。修改配置项会在预览框中实时预览效果。
2.1内容设置
支持勾选用户名、邮箱、自定义内容，勾选【自定义内容】后，可在输入框内输入自定义文本，最多输入256字符。
2.2不透明度设置
可通过拖拽的的方式调整不透明度。
- 配置完成后点击更新即可应用在Web端。
注：移动端、H5页面的安全水印固定为「用户名」+「邮箱」。
### 3.其他影响
- 在「知识库管理配置」-「导出水印配置」中，开启导出水印后，对应格式的Wiki协同页面导出时会显示水印，水印内容为团队管理员「安全水印」中自定义配置的内容。
1. 多团队组织前往「组织配置中心」-「系统安全」-「安全水印」。
## 五、通知中心列表支持新窗口打开
> 适用于「团队版」和「企业版」的 ONES 系统
### 1.功能场景/功能入口
通知列表、项目列表、工作项列表支持新标签页打开、新窗口打开，以便于用户切换查看不同页面
### 2.功能说明与产品规则
通知列表、项目列表、工作项列表接入浏览器原生链接
1. 支持鼠标中键，在新标签页打开链接
2. 支持鼠标右键菜单，包括但不限于新窗口打开、新标签页打开。
## 六、Resource预估工时可选是否包含工作日
> 适用于「团队版」和「企业版」的 ONES 系统
### 1. 功能介绍
在汇总工时模式下，在新建预估工时的时候，支持选择工时日期是否覆盖非工作日。
### 2. 功能入口
- 在「工作项详情-工时」下，点击「预估工时」按钮展开新建预估工时的弹窗。
- 在「工时管理-工时日历-成员排期日历」中，点击成员的日期饱和度后展开新建预估工时的弹窗。
### 3. 操作流程
#### 3.1按需要选择是否勾选「包含非工作日」
系统默认不勾选「包含非工作日」，提交后，预估工时结果将剔除非工作日。若成员需要预估非工作日的工时，则可选择勾选「包含非工作日」，提交后，预估工时结果与用户选择的"日期"保持一致。
## 七、【ONES Pipeline】 拆分为【Code Integration】&【Pipeline Integration】两个新应用
> 适用于「企业版」的 ONES 系统
### 1.背景信息
根据DevOps能力的规划和定位，更好满足的服务客户软件研发管理需求的目标，将旧的「ONES Pipeline 」产品拆分为「Code Integeration」、「Pipeline Integration」两个应用，以便后续能力的扩展，同时完成相同能力的内聚，不同模块之间的解耦。
### 2.【DevOps 工具链】介绍
DevOps是软件研发工程领域的一次伟大的变革，从理论到实践推动软件工程领域的快速发展。行业内也不断涌现很多优秀的DevOps工具，帮助和支撑企业的DevOps能力建设。
ONES作为研发管理的工具，深刻了解与这些优秀的DevOps集成的价值。ONES 不断与优秀DevOps工具集成，逐步搭建满足DevOps实践的应用矩阵，打通项目管理与工程开发协作，提升客户持续集成、持续交付的能力，以便更好更快的发布
### 3.代码集成
#### 3.1 「代码集成」应用简介
通过集成代码仓库，将代码开发工程场景与项目管理流程打通。代码提交关联到工作项，支持统计分析代码提交次数、提交趋势、影响行数等指标。及时掌握研发进度，提升协作效率。
#### 3.2 应用能力
目前「代码集成」应用，支持集成 GitHub、GitLab、私有 GitLab、SVN、私有 Bitbucket 等类型的代码仓。仓库集成到ONES后，支持以下功能点：
- 支持关联代码提交信息到工作项详情。
- 迭代概览中支持展示代码提交次数、提交趋势、影响行数的统计图标。
- 迭代下有「代码」组件，支持查看迭代中的代码提交汇总
不同的仓库类型对以上功能的支持有所不同，具体参考以下仓库类型的详细操作说明
GitHub/公有GitLab
私有GitLab
私有Bitbucket
SVN
#### 3.3 权限管理
在团队权限配置中，可以配置「代码集成」应用的管理员。「代码集成」应用的管理员拥有代码集成配置的全局设置能力，以进行代码仓库的关联、移除操作。
### 4.流水线集成
#### 4.1 「流水线集成」应用简介
通过集成流水线工具，将持续集成、持续交付与项目管理流程打通。将流程线与项目、迭代关联，在OENS Project可视化流水线运行状态，及时掌握持续集成、持续交付的各个环节阻塞情况，不断推动客户完成价值交付。
#### 4.2 应用能力简介
目前「流水线集成」应用，支持集成Jenkins服务。Jenkins服务集成到ONES后，支持以下功能点：
- 一级导航【流水线管理】页面支持查看服务器下的Jenkins流水线信息，包括运行状态，运行步骤、日志等内容。目前支持同步到ONES的Jenkins任务类型如下：
- 流水线
- 多分支流水线
- 文件夹
其他类型的任务如：自由风格流水线，ONES暂不支持同步
- 在项目中内置了「流水线」组件，支持将流水线与Project中的项目关联
- 迭代内置「流水线运行」组件，自动关联、同步和迭代名称匹配的分支流水线信息
目前「流水线集成」应用暂只支持关联Jenkins流水线，详细操作见以下Jenkins使用手册
Jenkins
#### 4.3 权限管理
在团队权限配置中，可以配置「流水线集成」应用的管理员。「流水线集成」应用的管理员可以管理、删除流水线管理页面下的流水线，同时可以更改「流水线集成配置」的全局设置。
在每条流水线的「流水线设置」页面中，可以配置除「流水线集成」管理员之外的成员，查看和管理某一条流水线的权限。
## 八、Resource新增成员登记工时日历甘特视图
> 适用于「团队版」和「企业版」的 ONES 系统
### 1. 功能介绍
通过甘特图形式，查看成员的登记工时情况，支持对工时进行筛选、分组，还可直接通过拖拽或点击等方式调整登记工时记录，从而帮助管理者清晰、高效的管控成员的工作投入。
### 2. 功能入口
在「工时管理」中，在「甘特视图」中新增「成员登记工时日历」。
### 3. 操作流程
#### 3.1筛选成员
在「成员登记工时日历」中，系统初始化成员为空，用户首次使用需点击成员列表筛选器，筛选所需了解排期的成员，支持按部门、成员、成员所属项目组、用户组筛选成员。
#### 3.2查看成员登记工时饱和度情况
查看成员在此时间段内登记工时的饱和度情况。提供多种方式帮助管理者了解成员登记工时投入情况：
- 平均饱和度：支持查看成员在此时间段内的登记工时平均饱和度情况，平均饱和度会按筛选结果重新计算。
- 合计工时：支持查看成员在此时间段内的合计登记工时，合计工时会按筛选结果重新计算。
#### 3.3甘特图形式查看成员登记工时明细
用户可展开成员查看登记工时明细，可通过点击或拖拽方式调整工时记录。提供多种方式帮助管理者了解成员登记工时投入情况：
- 工作项分组：支持对登记工时所关联的工作项进行分组，了解成员在不同项目或迭代中的登记工时投入情况。
- 筛选工作项：支持对登记工时所关联的工作项进行筛选，了解成员在不同任务中的登记工时投入情况，成员饱和度情况会按筛选结果重新计算。
## 九、Confluence 自助迁移能力
> 适用于「企业版」的 ONES 系统
### 1. 功能介绍
#### Confluence 迁移助手简介
ONES Confluence 迁移助手能够将 Server 版 Confluence 中的空间、用户、权限等数据迁移至 ONES Wiki 与系统中。迁移数据与迁移效果具体见下方：
| Confluence 数据类型 | 是否支持迁移 | 迁移效果 | 备注 |
| --- | --- | --- | --- |
| 空间 | 是 | 迁移空间名称 | |
| 页面 | 是 | 保留文本、表格、图片、代码段、超链接、待办事项、引用等内容，可保留大部分文本样式 | |
| 附件 | 是 | 保留页面中的上传的附件、通过部分插件生成的附件文件 | 如有超出 300M 的附件，需运维人员修改 ONES 系统的附件上限配置 |
| 宏 | 是 | 已支持的宏可迁移数据与保留样式；未支持的宏以占位符显示 | 可参考下文支持迁移的宏列表 |
| 页面树 | 是 | 保留页面树结构 | |
| 空间主页 | 是 | 保留 Confluence 空间主页，如果主页无内容，则使用 ONES Wiki 的默认主页 | |
| 博客 | 是 | 保留博客页面内容与权限配置 | 迁移后放置在「博客」节点下 |
| *孤儿页面 | 是 | 保留孤儿页面的页面内容与数据 | 迁移后放置在 「Confluence 特殊页面」 节点下 |
| 用户与用户组 | 是 | 迁移空间中的用户与用户组，保留用户的昵称、邮箱，保留用户组的名称与其中的用户 | 邮箱格式错误用户，迁移时需手工设置邮箱或映射为 ONES 系统中已有用户
邮箱重复用户，迁移时默认合并为同一个用户，也可选择不合并，分别设置邮箱或映射已有用户
在 ONES 系统中被删除的历史迁移用户，迁移后状态默认为未激活状态
在 ONES 系统组织中已存在但状态为未接受团队邀请的用户，迁移后状态默认为未激活状态 |
| 页面相关人 | 是 | 保留页面创建者、编辑者、关注者 | 如果相关角色用户数据不存在，将使用迁移执行者账号进行替换 |
| 权限 | 是 | 保留空间权限配置，包括全部查看权限、页面添加、页面删除权限；评论添加、评论删除权限；空间导出、空间管理权限
保留页面权限配置，包括加密、共享设置
保留权限配置中的用户与用户组数据 | Confluence 空间主页的加密权限不保留 |
*孤儿页面：指在 Confluence 空间中父页面不存在的页面
#### 支持迁移的宏
| Confluence 宏/插件名称 | 迁移效果 | 备注 |
| --- | --- | --- |
| 附件宏 | 保留数据，样式替换为 ONES Wiki 附件样式 | 跨页面引用附件暂无法展示 |
| 目录宏 | 静态形式展示页面目录，最多支持 7 个层级 | |
| 代码宏 | 保留数据，样式替换为 ONES Wiki 代码段样式 | |
| Jira-issue 宏 | 支持 URL 状态展示的单个 issue | |
| 状态宏 | 保留数据 | |
| 页面树插件 | 超链接形式展示，仅支持已迁移页面 | 暂不支持搜索、展开或折叠 |
| 展开宏 | 保留文本 | 暂不支持展开或折叠 |
| drawio 插件 | 保留图片与原始 drawio 文件（附件形式展示） | 暂不支持直接编辑 |
| markdown 宏 | 保留 Markdown 原始文本 | 暂不支持编辑 |