# Jira2Tapd

**Repository Path**: codehexx/jira2-tapd

## Basic Information

- **Project Name**: Jira2Tapd
- **Description**: 处理Jira导出来的bug，转换为Tapd的导入格式后，同步到Tapd以便于开发进行处理Bug
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-11-06
- **Last Updated**: 2023-12-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 脚本使用文档
## 1. 下载所需的第三方库到当前使用者的虚拟环境中
~~~ linux
pip install -r requirements.txt
~~~

## 2. 配置数据源
- 进入data>staffing.yaml修改部分数据
~~~ yaml
items: [wpb] -- 用于存放项目，名字要与下面的对象的名对应，需要小写
wpb:    -- 对象名，需要小写
  creator: 创建人员
  releases: 
  -- 版本号要对应，第一个数组存放Tpad的版本号，后续的存储jira的版本号，顺序要一一对应 1-1 2-2
      - [Tapd版本号1, Tapd版本号2]
      - [jira对应的版本号1]
      - [jira对应的版本号2]
  demands:  
  -- default用于匹配不到需求时的默认值，必须要有，后续的值为 需求ID: {人员信息}的对象值
      default: {coder: 开发人员/处理人, tester: 测试人员}
      SCRM-R33: {coder: 开发人员/处理人, tester: 测试人员}
~~~
- 参数使用示例
~~~ yaml
# 项目
items: [wpb, pinnacle]

# 项目 => a/b/c代表人的名字 可相同或不同
wpb:
  creator: c
  releases:
      - [release-wpb-0.9.7.r35.1117, release-wpb-0.9.7.r35.1117]
      - [WPB-R34-SIT-Defects, WPB-SCRM-R34-UAT-defect]
      - [WPB-R34-SIT-Defects, WPB-SCRM-R34-UAT-defect]
  demands:
      default: {coder: a, tester: b}
      SCRM-R33: {coder: a, tester: b}
      
~~~

- bug的有效时间的设置
~~~yaml
# 过期时间设置
timeSet:
  overdue: 168
  overtime: 24

overdue: bug在BugRecords的存活时长，创建时间 + overdue >= 168h（当前设置的时长，可修改） 则将该bug从该excel文件中移除
overtime: bug已存在于BugRecords中，但创建时间 + overtime >= 24h（当前设置的时长，可修改） 则也将该bug新增到新建的bugLists中导入到Tapd（来防止重新打开的bug没有再导入的情况）
~~~

## 3.使用runner文件执行代码
~~~ python
    1. 传递需要转化的bugLisst文件到 Transform(xlsxFile)
    2. buildBugList 可以传递 overtime
        - overtime 为与bug单的创建时间作为超时对比，用于对重打开的bug再次导入，避免重复bug。默认值为24小时
    3. 执行函数体，生成所需的bugList，文件名为TapdBugList-[日期时间]
~~~

## 注意事项：
- BugRecords.xlsx是手动创建的文件，记录一周内新增的bug，用于过滤重新打开的bug，请勿删除
- BugRecrod.xlsx的默认表头值为：
    title/content/release/coder/tester/createTime/creator