Rule Policies and Vocabularies

Parent Previous Next

The Deployment Framework includes comprehensive support for BizTalk Rules Engine (BRE) policies and vocabularies.  Deployments are based on policy and vocabulary XML files exported from the rules engine.


NOTE: You MUST re-export your policies and/or vocabularies any time they are modified.


To deploy one or more rule policies and/or vocabularies, edit your Deployment Framework for BizTalk project file (.btdfproj) as follows:


1. Set the IncludeVocabAndRules property to true

The property may be included in any PropertyGroup, but is commonly placed in the first PropertyGroup in the project file.


<PropertyGroup>

 ...

 <IncludeVocabAndRules>true</IncludeVocabAndRules>

 ...

</PropertyGroup>


2. Add a RulePolicies ItemGroup, a RuleVocabularies ItemGroup or both

The following are typical examples that properly follow the common ItemGroup structure:


<ItemGroup>

 <RulePolicies Include="MyFirstPolicy_v1.xml">

   <LocationPath>..\BRE\Policies</LocationPath>

 </RulePolicies>

</ItemGroup>


<ItemGroup>

 <RuleVocabularies Include="MyFirstVocabulary_v1.xml">

   <LocationPath>..\BRE\Vocabularies</LocationPath>

 </RuleVocabularies>

</ItemGroup>


The following is the default configuration, which corresponds to the optional naming conventions.  This default is in effect if you do not include any RulePolicies or RuleVocabularies elements in your project file.


<ItemGroup>

 <RulePolicies Include="$(ProjectName).Policies.xml">

   <LocationPath>..\$(ProjectName).BRE</LocationPath>

 </RulePolicies>

</ItemGroup>


<ItemGroup>

 <RuleVocabularies Include="$(ProjectName).Vocabularies.xml">

   <LocationPath>..\$(ProjectName).BRE</LocationPath>

 </RuleVocabularies>

</ItemGroup>


If you have more than one policy or vocabulary file, then repeat the corresponding element for each file (usually within the same ItemGroup).


Rule policies and vocabularies are published to BizTalk with the command-line tool DeployBTRules.exe in the Deployment Framework's Framework\DeployTools folder.


Related MSBuild Properties


Created with the Personal Edition of HelpNDoc: Easily create PDF Help documents