Microsoft KB Archive/330889

= If You Change the Name of an IIS Application that Contains MCMS Templates, the MCMS Template Breaks =

Article ID: 330889

Article Last Modified on 10/29/2007

-

APPLIES TO


 * Microsoft Content Management Server 2002

-



This article was previously published under Q330889



SUMMARY
Microsoft Content Management Server (MCMS) templates reference their template file by using the template file property. The template file property is a Microsoft Internet Information Services (IIS) application (or virtual directory) path that tells MCMS where the template file is located. If you change to the name of the IIS application, the binding of the template to the template file is no longer valid and the template does not work.

For example, if you have a template file in the IIS application WoodgroveNet, and you change the name of the IIS application to WoodgroveNet2, the templates that reference the template file in the WoodgroveNet IIS application cannot function. You must also change the template file property in each of the templates that reference this template file from WoodgroveNet to WoodgroveNet2.

To set the template file property for a template, use Properties for the template in Visual Studio .NET. This can be cumbersome when you must change the template file property in many templates (as in the previous example).



MORE INFORMATION
To make this process easier, use the following sample code to generate a simple command line utility that changes the template file property for all templates from one specified path to a new path.

Note Microsoft provides programming examples for illustration only, without warranty either expressed or implied, including, but not limited to, the implied warranties of merchantability and/or fitness for a particular purpose. This article assumes that you are familiar with the programming language being demonstrated and the tools used to create and debug procedures. Microsoft support professionals can help explain the functionality of a particular procedure, but they will not modify these examples to provide added functionality or construct procedures to meet your specific needs. If you have limited programming experience, you may want to contact a Microsoft Certified Partner or the Microsoft fee-based consulting line at (800) 936-5200. For more information about Microsoft Certified Partners, see the following Microsoft Web site:

https://partner.microsoft.com/global/30000104

For additional information about the support options available from Microsoft, visit the following Microsoft Web site:

http://support.microsoft.com/default.aspx?scid=fh;EN-US;CNTACTMS

To download the sample code, visit the following Microsoft Web site:

Download the package now.

Preconditions

 * The computer from which you run this tool must have MCMS installed.
 * To run this tool, you must have MCMS Administrator rights.

Use
CmsFindReplaceTemplateSourceFile / / / / [nosubmit]

Example
The following example will change the file template property to WoodgroveNet2 for all templates that have a template file property that currently begins with WoodgroveNet.

At a command prompt, type the following:

CmsFindReplaceTemplateSourceFile /WoodgroveNet/ /WoodgroveNet2/