modules/deploy/dsc/ext/PsGallery/xReleaseManagement.1.0.0.0/en-US/about_xTokenize.help.txt

TOPIC
   about_xTokenize
 
SHORT DESCRIPTION
   Describes how to use the xTokenize DSC Resource to transform files based on
   a token file for use with Release Management for Visual Studio.
 
LONG DESCRIPTION
   Tokenization is the process of introducing tokens (any word surrounded by
   double underscores "__") to a target file to be replaced during deployment.
 
   Here is an example of how to tokenize a portion of your web.config. Create
   a copy of your web.config file and name it web.config.token. Be sure as you
   continue development that you keep the files in sync. Open the
   web.config.token file and replace values that need to be changed during
   deployment with tokens. For example let's tokenize the connection string to
   the database. You would change the following line from:
 
   <add name="DemoDBEntities" connectionString="data source=.\sqlexpress;initial
      catalog=MyDevDatabase;integrated security=True" />
 
   to:
    
   <add name="DemoDBEntities" connectionString="data source=__Server__;initial
      catalog=__Database__;integrated security=True" />
 
   There are two techniques for creating token files. The first is to simply
   make a copy of the target file and introduce tokens. This will result in a
   token file being deployed with your application. This technique has a couple
   of advantages. First it is very simple. Second it allows the resource to
   more accurately test if the transformation has been performed or not.
 
   The second technique described here http://tinyurl.com/tokenization requires
   more work but results in a cleaner deployment because no second token file is
   placed in the deployed applications folder.
 
SEE ALSO
   Examples folder of this resource