# xmind2excel

**Repository Path**: xiaoYxiao/xmind2excel

## Basic Information

- **Project Name**: xmind2excel
- **Description**: 使用XMind用例编写&用例评审；然后使用该工具把用例生成Excel并导入到TAPD（腾讯提供的一个软件研发管理平台），最后执行跟踪。 目前仅支持XMind8.0（以XML解析文档内容）
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 4
- **Created**: 2022-06-14
- **Last Updated**: 2022-06-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# xmind2excel

#### 背景介绍
为了方便用例评审，团队大多数人使用XMind编写用例并评审；然后再把评审后的用例整理成Excel导入到TAPD（腾讯提供的一个软件研发管理平台），最后执行跟踪。
在从XMind用例转换成符合TAPD导入模板的用例时，特别耗时且都是无效工作，为了提高效率，故开发XMind2Excel工具，以快速从XMind转换成符合TAPD模板的Excel方便快速导入。
但编写XMind文件时有一些特殊要求，以方便工具解析XMind文件，要求会在 **使用说明** 处介绍。

#### 软件架构
使用spring-boot快速构建工程完成开发。


#### 安装教程

1.  安装1.8以上的jdk
2.  copy xmind2excel-1.1.0-RELEASE.jar 到本地双击即可使用

#### 使用说明
目前XMind仅支持8.0，以xml解析存储文件。

step 1 使用XMind进行用例设计

必须需遵循以下规则：

1、保证XMind文件只有1个画布、1个根节点。

2、旗帜：功能模块，不同颜色表示重要等级（从前到后重要级别逐步减低）。

3、星星：需求，不同颜色表示重要等级（从前到后重要级别逐步减低）。

4、数字：表示用例和用例等级（1：高、2：中、3：低）。

5、用例上加备注：表示前提条件

6、用例下的第一层分支表示【测试步骤】，第二层分支表示【期望结果】，【测试步骤】和【期望结果】节点禁止使用标识；多【测试步骤】和多【期望结果】均使用多个分支表示；支持没有【测试步骤】、【期望结果】的用例情况。

7、中心主题（根节点）可以使用备注标识项目的基本信息，但工具转换过程暂不解析。

PS：

a. 旗帜和星星标识的功能模块和需求，在工具解析时都会处理成模块，成为TAP用例模板中的目录；如下图第1个用例的目录是：模块(目录)1-子模块1-子模块1.1

b. XMind中测试用例节点，用例描述一定要包含上层各功能模块节点的关键信息（TAPD中测试计划的执行测试用例时看不到目录信息）。

模板如下：
![输入图片说明](https://images.gitee.com/uploads/images/2021/0517/135149_e9fe359a_9109521.png "1.png")


step 2 使用XMind-Excel转换工具把XMind转换成Excel

在package目录下载 xmind2excel-1.1.0-RELEASE.jar 转换工具（需要JDK环境，双击可运行）。或下载源码，自己打包后本地target目录可获取。

![输入图片说明](https://images.gitee.com/uploads/images/2021/0517/140141_59a3a301_9109521.png "2.png")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0517/140214_c1aef12d_9109521.png "3.png")


step 3 把Excel用例导入到TAPD

![输入图片说明](https://images.gitee.com/uploads/images/2021/0517/140351_3631d130_9109521.png "4.png")
![输入图片说明](https://images.gitee.com/uploads/images/2021/0517/140401_d64ff38c_9109521.png "5.png")


#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request