Cubicle Configuration

Configuration is done using two files:
  1. conf.xml used for all Cubicle Tools configuration
  2. NLog.xml used for NLog configuration

conf.xml

This is the main configuration file for Cubicle Tools and contain three main configuration categories:
  1. Object Handler connections - links to either local or remote handlers
  2. Invocation pipeline - configures the Method Invocation sub-system
  3. Binding pipeline - configures the Function Binding sub-system
  4. Marshalling pipeline - configures the Marshalling sub-system

Object Handler connections

This element allows users to specify connections to "Object Handlers". Three types of connection are allowed:
  1. Embedded - An object handler hosted within the same AppDomain as the Excel Add-In.
  2. Local - Object handlers hosted within their own AppDomain by the Excel Add-In.
  3. Remote - Connections to object handlers hosted on web-servers
The first link element will automatically be the default alias.

XML Element:
  • link
XML Attributes:
  • alias - specifies the name used to refer to the Object Handler through worksheet functions. The "default" alias is a special case used to refer to the object handler within the same AppDomain as the add-in.
  • address - specifies the url to the web-service of remote Object Handlers (omit for local handlers)

Example:
  <link alias="default"  /> <!-- Embedded -->
  <link alias="local"  /> <!-- Local -->
  <link alias="remote" address="http://localhost:61565/Engine.svc" /> <!-- Remote -->

Invocation pipeline

The invocation pipeline contains a series of processor components, each of which is responsible for a part of invocation functionality. The invocation pipeline is extensible and currently have the following features:
  1. Method invocation with generics support
  2. Object creation with generics support
  3. Field and Property get/set
  4. Parameter resolution
Developers can configure this pipeline to add custom behaviour. More documentation required.

Binding pipeline

The binding pipeline contains a series of processor components, each of which is a responsible for different aspects and features of Function Binding. Developers can configure this pipeline to add custom behaviour. More documentation required.

Marshalling pipeline

The binding pipeline contains a series of processor components, each of which is a responsible for marshalling a custom type into an Excel-friendly format, see Marshalling. Developers can configure this pipeline to add custom behaviour. More documentation required.

NLog.xml

This is the standard NLog config file. Included in Cubicle Tools is a custom logger that prints log information into Pane in Excel. The format of the logging output can be configured here.

Last edited Apr 21, 2013 at 7:47 PM by Tjaart, version 6

Comments

No comments yet.