Description

Futurama allows you to define plugins to override and/or extend certain Futurama behavior.

Currently there is one plugin supported which allows you to extend the Futurama Formula library. 

Configuration

Settings

Within the configuration element the next code has to be included:

<configSections>
	<sectionGroup name="futuramaSettings">
		<section name="plugins" type="ActuIT.Futurama.Config.PlugInSection, ActuIT.Futurama.Engine,Version=1.0.0.0, Culture=neutral, PublicKeyToken=null">
	</sectionGroup>
</configSections>

Next to this code, also within the configuration element the next code has to be included:

<futuramaSettings>
	<plugins>
		<pluginlist>
			<plugin formulaLibraryID="1" assemblypath="c:\sample.dll" maptoclass="SampleFormulaPlugin.CustomFormulas" interface="ActuIT.Futurama.IoCInterfaces.IExternalFormulaLibrary"/>
		</pluginlist>
	</plugins>
</futuramaSettings>

The futuramaSettings element is the general part for more configuration settings. Within this element the plugin element is set. 

Explanation

Within the plugin element you can define multiple plugins. You do this by creating multiple instances of the plugin tag. Below the possible values of the various fields of the plugin:

interface

The name of the interface for which you want to provide an implementation. The name of the interface must be one of the next (as currently one plugin exist, there now is one interface available):

• ActuIT.Futurama.IoCInterfaces.IExternalFormulaLibrary

maptoclass

The class that provides a new implementation for the interface

assemblypath

The path to the DLL that contains the class mentioned in maptoclass. This should be a DLL built in .Net, and the DLL should use the same .Net Framework version as Futurama.

formulaLibraryID

When you provide a plugin with an external formula library, this field contains the number you want to give this plugin. The value 0 is reserved for the default Futurama formula library. Choose successive numbers for the plugins you use. This number is stored in all Futurama Formulas that use a method from this external formula library. Therefore all installations of Futurama should use the same formulaLibraryID.

Example

See  Creating custom formulas in Futurama for an example how to use the formula plugin.