Click or drag to resize

Getting Started with the Integration Library

The Integration Library is a .Net assembly that enables you to programmatically access the data and functionality available in CloudNine Explore® and LAW Turbo Import.

Minimum Requirements

The Integration Library has the following requirements

  1. LAW 7.5 or greater installed

  2. Configuration of the environment completed via the LAW Configuration Utility

  3. LAW and/or CloudNine Explore® launched to verify installation and configuration

Installation

The Integration Library is installed with LAW/Explore. Both 32-bit and 64-bit versions of the API are installed and can be found in the LAW50\EdAnalyzer and LAW50\EdAnalyzer64 folders respectively.

Accessing the Integration Library

To access the Integration Library, add a reference to EdaIntegration.Contract.dll in your project. This contains the interface definitions that will be used to interact with the Integration Library. A reference to EdaIntegration.dll will also be necessary since this contains the implementation details for the interfaces (NOTE: The other LAW50 libraries will be referenced indirectly by this library).

There are two ways to access this library:

  • Add a reference to EdaIntegration.dll in your project.

  • Dynamically load EdaIntegration.dll at run-time. This may be a better solution if you plan to use your project against multiple versions of LAW or CloudNine Explore®. The below example shows how to dynamically load the Integration Library for use with CloudNine Explore®.

    C#
    using EdaIntegrationContract;
    
    /// <summary xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">
    ///     Connects to the Integration Library 
    /// </summary>
    /// <returns xmlns="http://ddue.schemas.microsoft.com/authoring/2003/5">The Explore API root</returns>
    private IExploreIntegration ConnectToExploreAPI()
    {
        try
        {
            var edaIntegrationDLL = Assembly.LoadFrom(@"C:\Program Files (x86)\LAW50\EDAnalyzer64\Law.EdaIntegration.dll");
            Type edaIntegrationType = edaIntegrationDLL.GetType("Law.EdaIntegration.EdaIntegration");
            object edaIntegrationObj = Activator.CreateInstance(edaIntegrationType);
            var apiObj = (IEdaIntegration)edaIntegrationObj;
            IExploreIntegration edaIntegration = apiObj.ConnectToExplore();
            return edaIntegration;
        }
        catch (Exception edaIntEx)
        {
            Console.Writeline("Error creating EDA Integration instance: " + edaIntEx.ToLogMessage());
            throw;
        }
    }

Examples

Using the Integration Library, it is possible to automate many of the functions in CloudNine Explore® and LAW. However, not all features of either product are exposed through these interfaces. To understand what features are available and how to use them, refer to the Programming Examples that provide detailed examples and to the API Reference which outlines all of the functions/properties that are available.