Sample Projects

Several sample projects demonstrating how to build the Configurizer Runtime Engine into your own application are included with the installation of Configurizer.  The default location for these is C:\Program Files\Configurizer\Runtime\Samples.

These samples are provided to help you as a developer understand the basic means of interfacing with the Runtime Engine, so you can quickly begin building your own Configurizer applications.  Keep in mind these samples are intended for learning purposes only and that— for the sake of simplicity— they lack the error trapping and robustness which normally would be desirable in a production application.

Here is a bief overview of each sample project:

ASP

A very simple Active Server Pages application that presents a drop-down list of released items, gathers input for the selected one, and displays results in a table.  The project consists of two files: CFZR_Test.asp and Global.asa.  The Global.asa defines a server-side object of the main runtime engine class with session scope.  To test this sample:

1. Make sure Configurizer.cController (the public creatable class of the runtime engine, CFZREng.dll) is installed as a COM+ component on your IIS server.  You may find it best to unregister CFZREng.dll first, and then install it in COM+ as a new component (not an already register one).
2. Copy the two files into the virtual root of an IIS server.

Excel

Uses Excel's VBA capabilities to integrate Configurizer into a workbook.  This sample (Configurizer_Sample.xls) populates a drop-down list with released items, gathers input for the selected item, shows the results in separate worksheet, and/or displays errors (if any) in another separate worksheet.

VB.NET

COM Interop makes integrating the Runtime Engine into a .NET application very easy, and since interfacing with the Runtime Engine does not require many calls across the managed/unmanaged code barrier performance degradation is not an issue.  This sample demonstrates how released item definitions may be accessed on a local machine, LAN, or web site.  It also incorporates two methods of handling inputs: one at a time as the InputNeeded event fires, and in batches.  A hierarchical recordset is then used to populate a DataGrid when all inputs have been entered.

WScript

A VBScript file that simply shows how the Runtime Engine can be used with Windows Script Host.

Help with the Samples

As these samples do not take into account the vast variety of environments in which they may be tried, if you have any difficulty running them, setting them up, or if you just have questions, please feel free to contact us here.  It would be our pleasure to assist you.

Happy testing!