Testing with Microsoft™ .NET objects

You can import serializable .NET objects from .NET assembly files (.exe or .dll) into HCL OneTest™ API and apply them to messages in the same way as you would apply a schema. A service-based test or stub can then send and receive a message containing a serialized form of a .NET object from the assembly file. You can construct and parse the .NET objects and perform validation, but you cannot test the objects directly.

HCL OneTest™ API makes available as schema roots those classes that meet the following requirements:
  • The class must be public.
  • The class and all its references must be serializable, that is, marked with the [Serializable] attribute.
  • The class must have a public no-argument constructor.
  • The class must be instantiable.
Of the classes added, the following are supported and will be visible in the resulting schema:
  • Public fields (primitive data types, single dimensional arrays, ArrayList, and List<>)
  • Public properties
This schema and associated roots can then be applied to messages in the usual way from the schema wizard.
Note: A .NET object schema can be applied to byte array or string fields. Byte array fields are serialized to binary format, and string fields are serialized to XML format.

Requirements

Microsoft™ .NET Framework

If you want to use HCL OneTest™ API with .NET, you must install the following software:
  • Microsoft™ .NET Framework 4 or later (Microsoft™ .NET Framework Client Profile is different from the full version and does not meet the requirement)
  • Microsoft™ Windows™ SDK for Windows™ 7 and .NET Framework 4 or later
    Note: Some versions of Microsoft™ Windows™ do not support the .NET Framework. For information about supported operating systems, go to the Microsoft™ website.

HCL OneTest™ API DLL file

After installing the required .NET Framework software, you must add the GHDotNetUtils.dll file to the global assembly cache (GAC). The GHDotNetUtils.dll file is located in the root of the HCL OneTest™ API installation directory.
Note: Sometimes, HCL OneTest™ API might detect the GHDotNetUtils.dll file, but adding the file to the GAC ensures that it will be detected by HCL OneTest™ API.