Upgrading the WebForms configuration file

Upgrade the WebForms configuration file by copying the new Business Rules over the old ones, and changing the format of name-value parameters.

Procedure

  1. Open your backed-up webforms_conf.xml in a plain-text editor or XML editor, and search for <BusinessRule> elements. Check which ones refer to your custom Business Rules, and which refer to predefined WebForms Business Rules.
  2. Delete all WebForms <BusinessRule> elements; leave all your custom Business Rules as they are.
  3. Now locate the new WebForms configuration file:
    • In a Web application, the default location for this file is the WEB-INF/classes subdirectory of the deployment directory of the Web application.
    • In a Windows/IIS environment, the default location for this file is the folder %TRIDION_HOME%\config (where %TRIDION_HOME% is the value of the TRIDION_HOME environment variable, that is, the root directory of your WebForms Server).
  4. From this new XML file, copy all <BusinessRule> elements and insert them in the location from which you removed the old ones. Keep your custom Business Rules as they are, but make sure that the execute Business Rule appears last in the list of Business Rules.
  5. Next, in your webforms_conf.xml, find all instances of a Param element with Name and Value subelements. Change all these Param elements to have Name and Value attributes rather than subelements.

    For example, if you see a Param element that looks like this:

    <Param>
      <Name="foo" />
      <Value="bar" />
    </Param>

    change it to look like this:

    <Param Name="foo" Value="bar" />
  6. Save your webforms_conf.xml to the location of the new one (that is, in WEB-INF/classes or in %TRIDION_HOME%\config).
  7. Now restart your ASP.NET or Java Web application.

Results

You have upgraded the WebForms configuration.