RuleEngine GetExtendedOptions (.NET)

The GetExtendedOptions method is a convenience method which returns an ExtendedOptions instance that is pre-configured as required for testing all extended properties that a rules file is based on.

Normally when performing an extended property test within BrowserHawk you must use the AddProperties method to tell BrowserHawk which extended property tests you wish to perform. However, when using RET, BrowserHawk can automatically determine what extended properties are needed based on your rules file, and the ExtendedOptions instance for you.

Syntax:

ds = ruleEngine.GetDataSet(BrowserObj bhObj, ExtendedBrowserObj extBrowObj);

bhObj: The BrowserInfo instance for the current request

extBrowObj The ExtendedBrowserObj instance for the current request

Returns:

ds: A .NET DataSet object representing the results of the rules test.

C# Example:

// Configure the properties to test so that they match the properties needed by the XML test file.

// This way the XML can change and this code doesn't have to.

ExtendedOptions options = ruleEngine.GetExtendedOptions();

ExtendedBrowserObj extendedBrowObj = BrowserObj.GetExtendedBrowser(options);

Tip: See the numerous RET samples included with BrowserHawk and the Rules Enforcement Technology Users Guide (available separately) for more information.

Note: This method requires the Enterprise Edition of BrowserHawk.