文章采集api(介于tapd跨项目统计的困难，开发了基于tapdAPI的数据同步的工具TapdCollect)

　　文章采集api(介于tapd跨项目统计的困难，开发了基于tapdAPI的数据同步的工具TapdCollect)

　　前言：

　　由于tapd跨项目统计的难度，我们开发了基于tapd API的数据同步工具TapdCollect，可以将数据传输到本地数据库，然后进行分析统计。Net Core 用于开发，可以定期跨平台部署。任务排期采集，支持项目、需求、缺陷、用例、测试计划、变更历史等数据采集，可选择是否保存历史记录、失败自动重试等辅助职能。

　　下载链接：

　　源地址：

　　特征

　　01、 输入【01】，启动【同步项目】

　　同步项目列表，对应数据库表名：tapd_project

　　02、 输入【02】，开始【同步工作流状态中英文名称对应】

　　同步工作流状态中英文名称对应关系，对应数据库表名：tapd_statusmap

　　03、 输入【03】，开始【同步自定义字段配置】

　　同步自定义字段配置，对应数据库表名：tapd_custom_fields_settings

　　04、 进入【04】，开始【同步需求分类】

　　同步需求分类，对应数据库表名：tapd_story_categories

　　05、 进入【05】，开始【同步测试用例分类】

　　同步测试用例分类，对应数据库表名：tapd_tcase_categories

　　06、 进入【06】，开始【同步需求】

　　同步需求，对应数据库表名：tapd_stories

　　07、 输入【07】，启动【同步缺陷】

　　同步缺陷，对应数据库表名：tapd_bugs

　　08、 输入【08】开始【同步任务】

　　同步任务，对应数据库表名：tapd_tasks

　　09、 进入【09】，开始【同步测试计划】

　　同步测试计划，对应数据库表名：tapd_test_plans

　　10、 输入【10】，开始【同步测试用例】

　　同步测试用例，对应数据库表名：tapd_tcases

　　11、 进入【11】，开始【同步需求变化历史】

　　同步需求变更历史，对应数据库表名：tapd_story_changes

　　12、 进入【12】，开始【同步缺陷变更历史】

　　同步缺陷变更历史，对应数据库表名：tapd_bug_changes

　　13、进入【13】开始【同步发布审核】

　　同步发布审核，对应数据库表名：tapd_launch_forms

　　14、输入【14】开始【同步发布计划】

　　同步发布计划，对应数据库表名：tapd_releases

　　15、 输入【97】，开始【删除配置文件】

　　删除配置文件，之前的配置文件会被删除

　　16、 输入【98】，启动【重置配置文件】

　　重置配置参数，可以在修改用户名和密码时使用

　　17、 输入【99】启动【初始化数据库】

　　第一次使用时，可以调用该方法初始化数据库

　　默认会在配置文件重置后调用，需要手动确认

　　配置文件设置

　　>>>>>>>>>> 1、Api_User-API 账号

　　>>>>>>>>>> 2、Api_Password-API密码

　　>>>>>>>>>> 3、CompanyId-公司ID

　　>>>>>>>>>> 4、PageLimit-每个请求的最大数量（1-200）

　　>>>>>>>>>> 5、RetryLimit-出错后的重试次数(1-10）

　　>>>>>>>>>> 6、IsKeepHistory-是否保留历史（0-不保留，1-保留）

　　>>>>>>>>>> 7、DataBaseConn-数据库连接配置（数据库仅支持Mysql，其他数据库请自行开发）

　　DataBaseConn 请参考如下配置： Server=xx;Database=Tapd;User=xx;Password=xx;pooling=False;port=xx;Charset=utf8;Allow Zero Datetime=True;

　　预防措施：

　　1、 请务必通过本程序设置

　　2、设置后参数为加密参数，不支持手动修改

　　3、如需修改参数，请重置配置文件

　　4、重置配置文件时，请根据自己的情况决定是否初始化数据库

　　5、 深度使用6个月后，可以联系客服申请api内测资质。申请通过后可以在公司管理-api open申请api账号

　　采集日志

　　采集的所有动作都会被记录在对应的日志中，在程序目录的日志文件夹中

　　1、log.log 带时间戳的日志，可以查看具体操作详情对应的时间

　　2、log_console.log 控制台日志，可以查看具体操作详情

　　3、log_error.log 错误日志，错误后可以查看错误对应的内容

　　4、log_debug.log 调试日志，默认不输出，需要调整NLog.config进行配置，具体数据内容

　　关于程序的调用（仅供参考，请根据实际情况进行配置）

　　需要提前安装.net Core Runtime

　　跳转到目录：cd %TapdCollect%\手动执行：dotnet TapdCollect.dll 自动执行（单功能）：dotnet TapdCollect.dll 1 自动执行（*敏*感*词*）：dotnet TapdCollect.dll 1 2 3 4 5 6 7 8 13 对于超过14个功能的配置，请在每个功能参数后加一个空格

　　.Net Core 运行时下载链接

　　视窗：

　　其他平台：请到MicroSoft网站查找

　　定时任务配置（仅供参考）

　　1、首先配置bat脚本

　　2、设置定时任务

　　预防措施：

　　1) 开始填写程序所在目录，否则配置文件会被%windows%\system32\下的计划任务配置

　　2) 以双引号开头，否则无效

　　3)程序或脚本选择之前配置好的bat文件，建议选择自动运行的脚本

　　3、 设置触发条件（建议根据实际情况和需要设置）

　　预防措施：

　　1) 建议根据实际情况设置。它可以每天同步一次或几个小时同步一次。

　　2)但是建议不要在一个小时以内同步一次，因为Tapd请求是有时间限制的，理论上是1Req/S

　　3)tapd 请求过多会抛出过多请求错误