uigen.exe configuration file

The uigen config file is the configuration file for uigen.exe.
It specifies "placeholders" and their values, which uigen.exe uses in
the templates.

There is also a settings node with path information to uigen.exe templates.

Settings and <applicationGenerator template...>

The template attribute contains the path to the uigen.exe master file,
always TabbedEditor.xml.

• templateRoot: which set of templates to use
  for generating the web application project.

For re-motion version 1.13.6. and lower, these directories
are located under the Remotion directory, the root directory
of the re-motion distribution. Since uigen.exe can only
handle absolute paths, you must adapt them to your particular
location of that directory.

• targetRoot: This is the solution root, not the root directory
  for the web project, i.e. the top-level directory for all your
  Visual Studio sub-projects.

Just as the name suggests, the namespace settings are namespaces, NOT
paths:

• projectNameSpaceRoot: namespace of the web application project
• domainNameSpaceRoot: namespace of the domain project

Visual Studio mildly enforces that the directory name of a project
is the same as the namespace, so this might not matter if you follow
this convention. However, if you don't, make sure that you specified
the namespace.

Instead of a listing with complicated syntactic variables, here
is an illustration of what is which:

Placeholders

• $ReferencesDir$: the name of the node in
  the web application project for storing the
  references to the domain- and re:motion assemblies
  By convention, this node is named "References" in
  Visual Studio, so that's probably what you will use
  for the placeholder value.
• $DomainProjectName$: the name of the node with the
  domain project in Visual Studio.
• $DomainProjectAssembly$: don't know, FIXME
• $WebProjectName$: the of the node with the web application
  project in Visual Studio. (generated by uigen.exe.)
• $WebProjectAssembly$: don't know, FIXME
• $USER_APPNAME$: a string with the display name of the
  web application (generated by uigen.exe.)
• $USER_DEFAULT_ASPX_TOPIC$: a string to be shown on the default.aspx
  page showing the Start link to aid the user (the string
  usually says "To start the application, just click 'Start'")
• $USER_DEFAULT_STARTPAGES$: an invocation of the re:call
  function to be called automatically after startup. In
  other words, an URL-fragment for the browser to go to
  after the user has clicked the 'Start' link
• $USER_STATUSBAR$: don't know, FIXME
• $USER_CLASSIC_APPSTYLE$: don't know, FIXME
• $USER_STORAGEPROVIDER$: the name of the storage-provider, as
  declared in the web project's Web.config file (generated by
  uigen.exe)
• $USER_CATALOGNAME$: the name of the database (and the
  identifier for the connection string) in the web project's
  Web.config file (generated by uigen.exe)
• $USER_LAYERSUPERTYPE$: The identifier of the domain object
  classes common ancestor (see also: layer super-type