HP ALM Open Test Architecture API 介绍

从事测试工作的同学可能会用过HP ALM（以前叫QC），这是一款基于web的软件测试管理工具，功能非常强大。Test Case Design， Test Case Execution， Bug Tracking，这些想必大家都非常熟了，还有像Dashboard， Management， Requirements，这些可能不熟悉的。随着我们对ALM使用的逐渐深入，我们可能会有一些跟ALM相关的Idea，但是通过现有ALM功能不能手动解决，或者解决起来比较麻烦的，怎么办呢？

接下来我将介绍ALM OTA API，向大家展示如何通过它来实现我们的想法，以抛砖引玉，期待引起有相同需求的同学，共同探讨。

什么是ALM OTA API？

如果你正在使用ALM，可以从 Help->Document Library-> 选择HP ALM Open Test Architecture API Reference 去获得。

里面有详细的API介绍，并且包含丰富的例子。代码是用VB写的，不过我接下来的例子将用C#来诠释，以方便大家参考。

简而言之，ALM OTA API 就是一个COM库，通过它我们就能用代码来与ALM交互。

口说无凭，有例子才有真相：

案例一：老板想方便的知道本项目这周跑了多少case，开了多少bug，怎么办？

分析：我们可以在ALM手动的一点点去查，然后整理成报告，发给老板。但是每次都得查，要是一不小心眼花了，还可能导致统计出错，要是被老板发现了那问题就可大可小了。此时我们想一想，如果我们能做个网站，提供相应的功能，让老板能够随时查询这样岂不很好？！

网站我们可以选择我们擅长的语言来写，至于如何写，不是本篇文章讨论的重点，我们关心的是如何让我们的网站与ALM通信，以获得数据。

这里以统计bug为例，上一段小代码为大家参考：

首先我们要先建立ALM连接：

 1 public static TDConnection ConnectProject(string server, string user, string pass, string domain, string project)

 2         {

 3             TDConnection tdc = new TDConnection();

 4             try

 5             {

 6                 // Connect to ALM

 7                 tdc.InitConnectionEx(server);

 8                 tdc.Login(user, pass);

 9                 tdc.Connect(domain, project);

10             }

11             catch (Exception ex)

12             {

13                 // Report Exception

14                 //Report.Failure("Failed to connect ALM! " + "Debug Trace: " + ex.ToString());

15                 Console.WriteLine("Failed to connect to ALM! " + "Debug Trace: " + ex.Message.ToString());

16             }

17             return tdc;

18         }

然后我们就可以通过ALM全局连接tdc， 去获得bug的List集合。

        public int GetBugCount()

        {

            BugFactory bugFac = null;

            TDFilter bugFilter = null;

            TDAPIOLELib.List lst = null;



            bugFac = tdc.BugFactory;

            bugFilter = bugFac.Filter;



            //这里设置我们期望的条件

            //比如，期望统计是new或者open的bug，并且severity大于等于3

            bugFilter["BG_STATUS"] = "New Or Open";

            bugFilter["BG_SEVERITY"] = ">=3";



            //此时就可以获得我们期望的bug List了

            lst = bugFac.NewList(bugFilter.Text);



            //有了这个bug List，我们就可以遍历每个bug，做我们期望做的事情，当然也可以直接返回bug数量

            return lst.Count;



        }

如果需要，我们甚至可以把每个bug的具体情况在网站上都罗列起来，相信用户体验一定比去ALM亲自去看要好。

总之老板满意了，我们才踏实嘛。

案例二：假设我们使用了一款自动化工具，写了一些自动化的case，这些case都会映射到ALM里的Manual case。于是我们就想，当我们跑完自动化的case时候，ALM里面的Manual Case也能根据我们自动化case跑的结果，去相应的改变状态，这样就不用我们手动去ALM更改这些Manual Case的状态，岂不很好？

分析：有了ALM OTA API，这些都能实现。

        /// <summary>

        /// 

        /// </summary>

        /// <param name="tsName">Test Set Name</param>

        /// <param name="tcName">Test Instance Name</param>

        /// <param name="status">The status of test instance</param>

        /// <param name="path">Path to target the Test Set</param>

        internal static void ModifyTestInstanceStatus(string tsName, string tcName, string status, string path)

        {

            TestSet ts = null;

            TSTest tc = null;          

            TDFilter aFilter = null;

            TestSetFolder tsFolder = null;

            TSTestFactory tcFactory = null;            

            TestSetTreeManager tsTreeMgr = null;      

            TDAPIOLELib.List lst = null;



            // Create the connectuon to ALM

            TDConnection tdc = ALMUtility.getTDCInstance();



            tsTreeMgr = tdc.TestSetTreeManager;

            tsFolder = tsTreeMgr.get_NodeByPath(path);



            // Find the Test Set

            lst = tsFolder.FindTestSets(tsName);



            // There should be only one Test Set 

            if (lst.Count != 1)

            {

                // Report Failure and Exit

                Console.WriteLine("Failed to find the specific Test Set!");

                return;

            }

            ts = lst[1];



            // Find the specific test in the Test Set

            tcFactory = ts.TSTestFactory;

            aFilter = tcFactory.Filter;

            aFilter["TS_NAME"] = tcName;

            lst = tcFactory.NewList(aFilter.Text);



            //There should be only one Test Instance

            if (lst.Count != 1)

            {

                // Report Error

                Console.WriteLine("Failed to find the specific Test Instance");

                return;

            }

            tc = lst[1];

            tc.Status = status;

            tc.Post();

            Console.WriteLine("Update test case successfully!");

        }

有了上面的方法，我们只要传入相应的参数，就可以实现自动改变test case状态了。

总结：

上面两个案例，是ALM OTA API 比较简单的使用，意在为大家发散思维，开拓思想。也许在实际工作中，可能会遇到有更好的案例，期待能共同讨论。