BizUnit 4.0 测试步骤 - MQSC (IBM WebSphere MQ)。

///Himanshu Thawait
///Test step to work with MQSC. using amqmdnet.dll and MQSeriesHelper.cs

using System;
using System.Collections.ObjectModel;
using System.IO;
using BizUnit.TestSteps.Common;
using BizUnit.Xaml;

namespace BizUnit.TestSteps.MQSCStepHT
{

    public class MQSCGetStepHT : TestStepBase
    {
        private string message;

        /// <summary>
        /// Que Manager details server (port)
        /// </summary>
        public string queueManager { get; set; }
        /// <summary>
        /// Query name
        /// </summary>
        public string queue { get; set; }
        /// <summary>
        /// Wait time out
        /// </summary>
        public int waitTimeout { get; set; }

        /// <summary>
        /// Used for Sub steps
        /// </summary>
        public MQSCGetStepHT()
        {
            SubSteps = new Collection<SubStepBase>();
        }

        /// <summary>
        /// Read the data from MQ
        /// </summary>
        /// <param name="context"></param>
        public override void Execute(Context context)
        {
            context.LogInfo("Reading queue: {0}, search queueManager: {1}", queue, queueManager);
            message = MQSeriesHelper.ReadMessage(queueManager, queue, waitTimeout, context);
            context.LogData("MQSeries output message:", message);

            // SubSteps
            // Check it against the validate steps to see if it matches one of them
            foreach (var subStep in SubSteps)
            {
                try
                {
                    Stream fileData = StreamHelper.LoadMemoryStream(message);
                    // Try the validation and catch the exception
                    fileData = subStep.Execute(fileData, context);
                }
                catch (Exception ex)
                {
                    context.LogException(ex);
                    throw;
                }
            }
        }

        /// <summary>
        /// Validation on MQ and Data  data
        /// </summary>
        /// <param name="context"></param>
        public override void Validate(Context context)
        {
            if (string.IsNullOrEmpty(queueManager))
            {
                throw new StepValidationException("queueManager may not be null or empty", this);
            }

            if (string.IsNullOrEmpty(queue))
            {
                throw new StepValidationException("queue may not be null or empty", this);
            }

        }
    }
}

MQSeriesHelper.cs 的代码

构建

项目：测试项目

最后，我们一切就绪，可以为 MQSC 编写测试用例。此测试项目将使用与 BizTalk MQSC 项目相同的文件夹下拉位置、模式和 XML 文件（显然，因为我们将测试该项目）。

• 文件下拉位置：\\FileServer\Share\HT1\IN_MQ\ 与 BizTalk MQSC 项目使用的位置相同
• 输入文件：IN_MQ.xml
• 模式：SchOUT.xsd，与 BizTalk MQSC 的输出消息（大型机模式）相同

HT1_MQ.cs 的代码

此类中有两个测试用例。一个是使用 BizUnit.TestSteps.File（开箱即用的测试步骤）将 XML 文件复制到 BizTalk 拾取位置，另一个是使用我们的 BizUnit.TestSteps.MQSCStepHT 从 MQSC 读取数据。

这里需要记住的事情是：

RunTest() 是关键。您编写的任何代码（在 MQSCStepHT 中）在调用此 RunTest() 之前都不会实际执行。因此，如果您要调试代码，请等待此函数被调用，然后您的断点才会命中（在 MQSCStepHT 中）。

要了解 BizUnit 测试步骤，请阅读：“BizUnit 入门指南.pdf”，它随 BizUnit 4.0 一起安装。默认位置 C:\Program Files\BizUnit\BizUnit 4.0

在我的测试用例中，我决定将代码分为 6 个步骤。

• 步骤 1：创建 TestCase 对象，它实际上将包含许多内容的测试用例。
• 步骤 2：准备步骤，您在此设置要分配给执行步骤的内容。例如，设置文件下拉位置并分配源文件路径。
• 步骤 3：执行步骤，您在此将步骤 2 分配给步骤 1 的 testcase。
• 步骤 4：这是一个可选步骤，您可以在其中将 testcase 保存为 XAML 文件格式。因为 BizUnit 也可以很好地处理基于 XAML 的测试步骤。
• 步骤 5：创建 BizUnit 实例来运行。将步骤 1 的 testcase 分配给 BizUnit 对象。
• 步骤 6：通过 RunTest() 实际运行测试。

这是完整的代码：

using BizUnit.TestSteps.Common;
using BizUnit.TestSteps.DataLoaders.File;
using BizUnit.TestSteps.File;
using BizUnit.TestSteps.MQSCStepHT;
using BizUnit.TestSteps.ValidationSteps.Xml;
using BizUnit.Xaml;
using Microsoft.VisualStudio.TestTools.UnitTesting;


namespace HT1.TestData
{
    [TestClass]
    public class HT1_MQ
    {
        [TestMethod]
        public void MQ_TC1_CopyFileToProcess()
        {
            //1. Creat test case
            var TC1 = new TestCase { Name = "H31 TC2", Category = "In Run", Preconditions = "H31 TC1" };

            //2.0 Prepration for **Execution Step**- Copy file to IN folder
            var createStep = new CreateStep();
            createStep.CreationPath = @"\\FileServer\Share\HT1\IN_MQ\IN_MQ.xml";
            //2.3 Source File
            var dataLoder = new FileDataLoader { FilePath = @"\\FileServer\Share\HT1\IN_MQ.xml" };

            createStep.DataSource = dataLoder;


            //3 Execution Step- Copy file
            TC1.ExecutionSteps.Add(createStep);

            //4 Optional steps- Save Test case to XMAL file
            TestCase.SaveToFile(TC1, TC1.Name + ".xmal");

            //5.Create BizUnit instance to run
            var bizunit = new BizUnit.BizUnit(TC1);

            //6.Actually run the test
            bizunit.RunTest();
        }


        [TestMethod]
        public void MQ_TC2_Read()
        {
            //1. Create Test case
            var TC1 = new TestCase { Name = "H31.MQ.TC1", Category = "IN run", Purpose = "Verify MQData" };

            //2.0 Prepration for **Execution Step**- Setup MQSC setting
            var mqscStep = new MQSCGetStepHT();
            mqscStep.queueManager = "MQSCMger";
            mqscStep.queue="MQSC.TEST.IN";


            //2.1 Validate XML again Schems
            var xmlValidationStep = new XmlValidationStep();
            var schemaDefination = new SchemaDefinition
            {
                XmlSchemaPath = @"\\FileServer\Share\HT1\SchOUT.xsd",
                XmlSchemaNameSpace = "http://HT1_MQ.SchOUT"
            };

            //2.2 Adding schemt to validate
            xmlValidationStep.XmlSchemas.Add(schemaDefination);

            //2.3 Validate XML data Using XPath
            var xpathRecCount = new XPathDefinition
            {
                Description = "Checking the GrpPolicyNum",
                XPath = "/*[local-name()='Member' and namespace-uri()='http://HT1_MQ.SchOUT']/*[local-name()='GrpPolicyNum' and namespace-uri()='']",
                Value = "GRP:iGate01"
            };


            //3 Execution Step- check MQ data
            xmlValidationStep.XPathValidations.Add(xpathRecCount);
           
            //3.1 sub step
            mqscStep.SubSteps.Add(xmlValidationStep);

            //3.2 Main step
            TC1.ExecutionSteps.Add(mqscStep);

            //4 Optional steps- Save Test case to XMAL file
            TestCase.SaveToFile(TC1, TC1.Name + ".xmal");

            //5.Create BizUnit instance to run
            var bizunit = new BizUnit.BizUnit(TC1);

            //6.Actually run the test
            bizunit.RunTest();

           
        }
    }
}

MQ_TC2_Read()

在步骤 2（2.1、2.2、2.3）中包含了一些额外的内容，用于验证消息格式和其中的数据。

• 步骤 2.0：我们只是设置 MQSC 详细信息
• 步骤 2.1 和 2.2：我们知道数据是 XML 格式，并且我们有该 XML 的模式。因此，我们想根据模式验证 MQ 数据。
• 步骤 2.3：我们还想深入到节点级别并验证其中的值。所以我们使用 xpath 查询来获取节点的值。我们从 BizTalk 模式编辑器“实例 xpath”属性中获取了这个 xpath 查询。

获取实例 xpath

现在是时候运行了

BizUnit 测试用例将像任何其他测试用例一样运行。只需选择您的测试用例，右键单击并点击运行。

需要记住的事情：如果您想调试代码并命中断点，请右键单击测试用例并选择“Debug Selection”。

测试结果

运行测试用例时，会在 VS 底部的窗体中出现“Test Result”选项卡。在这里，您可以看到测试用例的状态，如 pass、failed、aborted 和 running。要查看详细信息，请右键单击测试结果并选择“View Test Result Details”。

这是测试详情的样子，让我们看看如何读取它。

它有两部分：

• Common Result 只会提供有关谁在何时在哪个计算机上运行等信息。
• Standard Console Output：在这里您会得到大部分信息。我标记了 4 个地方，让我们看看每个地方告诉我们什么。

1. 告诉我们 MQSC 的配置值
2. 告诉我们 MQSC 中有什么数据
3. 将要验证模式和值
4. 3.1：表示值符合预期。所以测试通过了

每次测试运行都会将完整的详细信息存储在“.trx”文件中，即“Visual Studio Test Results File”格式，位于“TestResults”文件夹中。文件名包含运行此测试用例的用户以及计算机名称以及日期时间戳。

最后，完成了，希望它能帮到您。

下一步

历史