##############################

简介：
	由于testlink每次执行一个case都要点击选中case然后点击执行结果，这个过程受到网络环境的影响，非常的耗时
	因此，开发该工具，将testlink中相应project或plan的用例整理到Excel中，保留了出详细测试步骤的所有信息和关联
	将case的执行结果和情况写入到Excel中，然后自动将所有结果都统一上传到testlink，
	Excel操作相对网页操作要简单方便的多，为实际测试节省时间

##############################

运行环境：
 	Python2/3
	需要的模块：xlwt，xlrd, testlink
	因此，请将这三个文件夹拷贝到Python安装目录的Lib目录下，例如我的路径D:\Program Files\Python37\Lib

##############################

程序详细说明：

1. convertFromTestlinkProjectToExcel.py

【说明】：
	从testlink产生指定project下所有testcase和testsuite的关系，并以Excel表格的形式呈现，
	适用于未在testlink相应project下创建plan的测试项目，更通用 一些。

【输入】：
	Python程序内需要修改或注意的参数：
		
		testProjectName = "Linux Risc Standard"
	
		备注：
		（1）testProjectName是必须确认的参数，请根据具体项目进行修改

【输出】：
	Excel文档
	备注：Excel的名称由testProjectName加“.xls”后缀产生

--------------------------------------

2. convertFromTestlinkPlanToExcel.py

【说明】：
	从testlink产生指定project和plan下所有testcase和testsuite的关系，并以Excel表格的形式呈现，
	适用于已经在testlink相应project下创建plan的测试项目。

【输入】：
	Python程序内需要修改或注意的参数：
		
		testProjectName = "Linux Risc Standard"

		testPlanName = "ITA-1501_imx6_ubuntu16.04"
	
		备注：
		（1）testProjectName和testPlanName是必须确认的参数，请根据具体项目进行修改

【输出】：
	Excel文档
	备注：Excel的名称由testPlanName加“.xls”后缀产生

--------------------------------------

2. uploadResultFormExeclToTestLink.py

【说明】：
	从Excel表格中读取测试结果，并通过调用uploadTestLink.py中的函数将Excel中的结果上传到测试用例

【输入】：
	Python程序内需要修改或注意的参数：

		fileName='Linux Risc Standard.xls'

		testprojectName="Linux Risc Standard"

		testplanName="WISE-710 yocto"

		testBuild="cycle2"

	备注：
	（1）fileName指定的是Excel表格的名称，也就是convertFromTestlinkProjectToExcel.py或者convertFromTestlinkPlanToExcel.py生成的Excel表格
	（2）testprojectName，testplanName，	testBuild是关联测试用例必须的参数，且一个项目这几个参数都是相同的，故需要根据具体项目进行修改

【输出】：
	testlink上执行结果更新


--------------------------------------


3. uploadTestLink.py

【说明】：
	用于自动化关联测试用例结果的程序，里面定义了一个关联测试用例的基本函数可以供其他程序调用



#########################################################
仍需改进的地方：
convertFromTestlinkPlanToexcel.py/convertFromTestlinkProjectToExcel.py
uploadResultFormExeclToTestLink.py
两个程序有共同的参数，
（1）考虑写一个程序，里面指定这些所需的所有参数，然后根据实际使用情况调用相应程序
或者（2）写一个config文件专门用于配置参数

鉴于目前参数较少，且时间问题，暂时这样，待后续有需求再upgrate