Interface SzProduct

Namespace

Senzing.Sdk

Assembly

Senzing.Sdk.dll

Defines the C# interface to the Senzing product functions.

public interface SzProduct

Examples

An SzProduct instance is typically obtained from an SzEnvironment instance via the GetProduct() method as follows.

For example:

// How to obtain an SzProduct instance
try
{
    // obtain the SzEnvironment (varies by application)
    SzEnvironment env = GetEnvironment();

    // get the product from the environment
    SzProduct product = env.GetProduct();

    . . .

}
catch (SzException e)
{
    // handle or rethrow the exception (varies by application)
    LogError("Failed to get SzProduct.", e);
}

Remarks

The Senzing product functions provide information regarding the Senzing product installation and user license.

Methods

GetLicense()

Gets the details and entitlements of the applied product license.

string GetLicense()

Returns

string

The JSON document describing the license details.

Examples

Usage:

// How to obtain the Senzing product license JSON 
try
{
    // obtain the SzEnvironment (varies by application)
    SzEnvironment env = GetEnvironment();

    // get the SzProduct instance
    SzProduct product = env.GetProduct();

    // obtain the license JSON
    string license = product.GetLicense();
    demoResult = license; // @replace
    // do something with the returned JSON (e.g.: parse it and extract values)
    JsonObject? jsonObj = JsonNode.Parse(license)?.AsObject();

    string? expiration = jsonObj?["expireDate"]?.GetValue<string>();
    int? recordLimit = jsonObj?["recordLimit"]?.GetValue<int>();

    . . .

}
catch (SzException e)
{
    // handle or rethrow the exception
    LogError("Failed to get license information.", e);
}

Example Result: (formatted for readability)

{
  "customer": "",
  "contract": "",
  "issueDate": "2025-08-11",
  "licenseType": "EVAL (Solely for non-productive use)",
  "licenseLevel": "",
  "billing": "",
  "expireDate": "2026-08-12",
  "recordLimit": 500,
  "advSearch": 0
}

Remarks

NOTE: The details do not include the license key.

Exceptions

SzException

Thrown if a failure occurs.

GetVersion()

Gets the product version details.

string GetVersion()

Returns

string

The JSON document of version details.

Examples

Usage:

// How to obtain the Senzing product version JSON 
try
{
    // obtain the SzEnvironment (varies by application)
    SzEnvironment env = GetEnvironment();

    // get the SzProduct instance
    SzProduct product = env.GetProduct();

    // obtain the version JSON
    string result = product.GetVersion();
    demoResult = result; // @replace
    // do something with the returned JSON (e.g.: parse it and extract values)
    JsonObject? jsonObj = JsonNode.Parse(result)?.AsObject();

    string? version = jsonObj?["VERSION"]?.GetValue<string>();
    string? buildDate = jsonObj?["BUILD_DATE"]?.GetValue<string>();

    . . .

}
catch (SzException e)
{
    LogError("Failed to get version information.", e);
}

Example Result: (formatted for readability)

{
  "PRODUCT_NAME": "Senzing SDK",
  "VERSION": "4.0.0",
  "BUILD_VERSION": "4.0.0.25223",
  "BUILD_DATE": "2025-08-11",
  "BUILD_NUMBER": "2025_08_11__07_35",
  "COMPATIBILITY_VERSION": {
    "CONFIG_VERSION": "11"
  },
  "SCHEMA_VERSION": {
    "ENGINE_SCHEMA_VERSION": "4.0",
    "MINIMUM_REQUIRED_SCHEMA_VERSION": "4.0",
    "MAXIMUM_REQUIRED_SCHEMA_VERSION": "4.99"
  }
}

Exceptions

SzException

Thrown if a failure occurs.