# plm-ztimporter-plugin

**Repository Path**: ibizplm-open/plm-ztimporter-plugin

## Basic Information

- **Project Name**: plm-ztimporter-plugin
- **Description**: 为用户将正在使用的zentao数据迁移到iBizPLM而设计的应用程序。该工具通过图形化配置界面，能够将禅道中的产品、项目、测试、用户等信息导入到iBizPLM中，简化了数据迁移的过程并为用户提供了一种长期维持数据一致性的解决方案。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-24
- **Last Updated**: 2025-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

禅道是一款优秀的开源项目管理软件，覆盖了项目管理的核心流程。禅道Importer是为用户将正在使用的禅道数据迁移到iBizPLM而设计的应用程序。该工具通过图形化配置界面，能够将禅道中的产品、项目、测试、用户等信息导入到iBizPLM中，最大限度的还原禅道中的数据内容和结构，不仅简化了一次性数据迁移的过程，还为用户提供了一种长期维持数据一致性的解决方案。图形化配置界面使得配置过程更加简单直观，减少了误操作的可能性，提高了用户体验。

## 功能特性
- **全面的数据迁移**：支持从禅道迁移产品、项目、测试用例及结果、用户等关键信息。
- **图形化配置界面**：提供了一个直观的 Web 界面，用户可以直接在网页上完成所有的配置工作，而无需编辑复杂的配置文件。
- **自动化的字典转换**：内置了从禅道到 iBizPLM的数据格式转换逻辑，保证了数据的准确性和一致性。
- **灵活的选择性迁移**：用户可以选择特定的产品、项目或测试库进行迁移，这使得迁移过程更加灵活，可以针对不同的业务需求定制迁移范围。通过图形化界面的手工选择，用户可以精确控制哪些数据会被迁移。
- **持续化迁移定时任务**：对于那些希望保持两个系统间数据同步的用户，提供了一种定时任务机制，允许按照设定的时间间隔自动执行数据迁移。这种策略非常适合于增量更新场景，确保即使在初次迁移后，新的改动也能及时反映到目标系统中。

## 使用方法
本工具提供了配置界面用于配置禅道数据库链接信息、选择迁移模式（全量迁移或自定义迁移）、手工选定要同步的内容以及角色映射功能，主要功能包括：

### 设置
- **设置禅道数据库连接信息**：输入禅道数据库的连接参数，包括主机名、端口、数据库名称、用户名和密码，点击 **测试连接** 按钮可以测试应用程序能否正确连接到数据源。

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/setting_db.png)

- **数据统计**：数据统计区展示从禅道数据库中抽取的用户、产品、项目、测试库数量，并支持通过反查来查看迁移数据明细。

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/setting_db_cnt.png)

- **选择迁移模式**：用户可以选择全量迁移或自定义迁移。对于自定义迁移，用户还可以进一步选择具体的产品、项目或测试库，精确控制迁移范围。

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/setting_selected.png)

- **配置角色映射**：通过图形界面手动设定禅道角色和 iBizPLM角色之间的对应关系，确保迁移后用户能正常使用对应功能。

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/setting_roleMapping.png)

- **配置持续化迁移定时任务（可选）**：如果需要定期同步数据，可以在页面上设置定时任务的时间间隔。

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/setting_job.png)

### 执行
- **执行迁移**：一旦所有配置都已完成，点击 **执行** 按钮即可启动数据迁移过程。

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/execute.png)

- **配置持续化迁移定时任务**：在设置界面中配置了定时执行策略的，本工具会按时执行迁移。
- **详细的迁移日志**：记录每次迁移操作的过程与结果，可以跟踪迁移起止时间、迁移状态（成功或失败）、涉及的迁移项数据量等。

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/execute_log.png)

![image.png](https://code.ibizlab.cn/plm_addons/zentao-importer/-/raw/master/doc/images/execute_logDetails.png)