Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The uigen.exe config file is the configuration file for uigen.exe.
It specifies "placeholders" and their values, which uigen.exe uses in
the templates. You can find the sample uigen.exe config file
here: sample uigen.exe configuration file. As always, it assumes
canonical project structure, and that the re-motion framework is
located in a sub-directory of the solution, as explained here:
PhoneBook project structure.

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

...

  • $ReferencesDir$: the name of the directory 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 directory with the
    domain project in Visual Studio . $DomainProjectAssembly$: don't know, FIXME(not to be confused with the
    namespace)
  • $DomainProjectAssembly$: The name of the domain assembly
    that shall be inspected by uigen.exe (i.e. where to find
    the domain object classes, without ".dll")
  • $WebProjectName$: the name of the node directory with the web application
    project in Visual Studio. (generated by uigen.exe.)
  • $WebProjectAssembly$: don't know, FIXME$WebClientAssembly$: the name of the assembly that is the
    target of the web project's target. (i.e. the .dll-product showing up
    in bin\Debug or bin\Release after a compile and link).
  • $USER_APPNAME$: a string with the display name of the
    generated 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'")
    This is harder to explain than to demonstrate. Click here and
    you will easily understand it: FIXME
  • $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_when the user clicks "Start" (or equivalent).
    (try it out with the online PhoneBook)
  • $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) – this should be
    the same as specified for dbschema.exe's App.Config,
    explained here: using dbschema.exe
  • $USER_LAYERSUPERTYPE$: The identifier of the domain object
    classes common ancestor (see also: layer super-typeSTATUSBAR$: legacy placeholder, always set to "yes"
  • $USER_CLASSIC_APPSTYLE$: legacy placeholder, always set to "no"
Note

Please note that these placeholders are not the
only ones that exist. Placeholders are also extracted from
the domain assemblies as well. You can find a
list of these extracted placeholders at
https://at-vie-remotion/svn/Remotion/trunk/ObjectBinding/Web.CodeGenerator/Core/Placeholder.cs

What's more, the values of settings are mirrored by placeholders,
but those placeholders have slightly different names:

  • projectNamespaceRoot is mirrored by $PROJECT_ROOTNAMESPACE$
  • domainNamespaceRoot is mirrored by $DOMAIN_ROOTNAMESPACE$
  • templateRoot is mirrored by $ROOT_TEMPLATE_DIR$
  • targetRoot is mirrored by $ROOT_TARGET_DIR$
See also