Dynamics CRM 2011 编程系列(32):Ribbon的开发二（按钮的禁用规则）

     在上篇博文里介绍了如何在Dynamics CRM 2011系统中添加Ribbon按钮。但现实的需求往往都比较的复杂，它们都涉及了按钮的禁用技术。Dynamics CRM 2011为我们提供了2种按钮禁用技术：一、使用DisplayRule；二、使用EnableRule。

    DisplayRule和EnableRule的区别：使用DisplayRule可以彻底的将按钮在Ribbon中隐藏，DisplayRule是在服务器端执行的；使用EnableRule可以将按钮禁用但是依然显示，禁用的逻辑是通过JS来控制的，所以EnableRule是在客户端执行的。

   我们来看几个例子吧：

DisplayRule

图1

图2

图3 Dynamics CRM 2011 提供的DisplayRule类型

图4  DisplayRule在SDK中的描述

图5 DisplayRule在SDK中的描述

图6 DisplayRule在SDK中的描述

 

图7  为按钮添加DisplayRule规则

图8

图9

图10

使用到的XML片段

<RibbonDiffXml>        <CustomActions>          <!--Form-->          <CustomAction Id="CustomAction1" Location="Mscrm.Form.campaign.MainTab.Groups._children" Sequence="90">            <CommandUIDefinition>              <Group Id="CustomAction.MyGroup"                     Template="Mscrm.Templates.Flexible2"                     Description="按钮组"                     Title="按钮组"                     >                <Controls Id="CustomAction.MyGroup.Controls1">                  <Button  Id="CustomAction.MyGroup.Button1"                           Command ="CustomAction.MyGroup.Button1.Command"                           Alt="HelloRibbon"                           Image16by16="\_imgs\Ribbon\Actions_32.png"                           Image32by32="\_imgs\Ribbon\Actions_32.png"                           Description="按钮"                           LabelText="按钮"                           ToolTipDescription="按钮"                           ToolTipTitle="按钮"                           TemplateAlias="o1"                      />                </Controls>              </Group>            </CommandUIDefinition>          </CustomAction>          <CustomAction Id="CustomAction1.Scaling1" Location="Mscrm.Form.campaign.MainTab.Scaling._children" Sequence="140">            <CommandUIDefinition>              <MaxSize Id="CustomAction1.Scaling1.MaxSize1" GroupId="CustomAction.MyGroup" Sequence="21" Size="LargeLarge"/>            </CommandUIDefinition>          </CustomAction>          <CustomAction Id="CustomAction1.Scaling2" Location="Mscrm.Form.campaign.MainTab.Scaling._children" Sequence="150">            <CommandUIDefinition>              <Scale Id="CustomAction1.Scaling1.MaxSize2" GroupId="CustomAction.MyGroup" Sequence="85" Size="Popup"/>            </CommandUIDefinition>          </CustomAction>          <!--Form-->        </CustomActions>        <Templates>          <RibbonTemplates Id="Mscrm.Templates"></RibbonTemplates>        </Templates>        <CommandDefinitions>          <CommandDefinition Id="CustomAction.MyGroup.Button1.Command">            <EnableRules>              <EnableRule Id="CustomAction.MyGroup.Button1.Command.EnableRule1"/>            </EnableRules>            <DisplayRules>              <DisplayRule Id="CustomAction.MyGroup.Button1.Command.DisplayRule1"/>            </DisplayRules>            <Actions>              <JavaScriptFunction Library="$webresource:new_ghostbear.js" FunctionName="helloworld"></JavaScriptFunction>            </Actions>          </CommandDefinition>        </CommandDefinitions>        <RuleDefinitions>          <TabDisplayRules>          </TabDisplayRules>          <DisplayRules>            <DisplayRule Id="CustomAction.MyGroup.Button1.Command.DisplayRule1">              <OrRule>                <Or>                  <ValueRule Field="name" Value="Test1"/>                </Or>                <Or>                  <ValueRule Field="name" Value="Test2"/>                </Or>              </OrRule>            </DisplayRule>          </DisplayRules>          <EnableRules>          </EnableRules>        </RuleDefinitions>        <LocLabels />      </RibbonDiffXml>

 

 

 

EnableRule

图11  Dynamics CRM 2011 提供的EnableRule类型

图12  EnableRule在SDK中的描述

图13 EnableRule在SDK中的描述

图14 EnableRule在SDK中的描述

图15 EnableRule在SDK中的描述

 

图16 为CustomRule添加JS函数

图17

使用到的XML片段

<RibbonDiffXml>        <CustomActions>          <!--Form-->          <CustomAction Id="CustomAction1" Location="Mscrm.Form.campaign.MainTab.Groups._children" Sequence="90">            <CommandUIDefinition>              <Group Id="CustomAction.MyGroup"                     Template="Mscrm.Templates.Flexible2"                     Description="按钮组"                     Title="按钮组"                     >                <Controls Id="CustomAction.MyGroup.Controls1">                  <Button  Id="CustomAction.MyGroup.Button1"                           Command ="CustomAction.MyGroup.Button1.Command"                           Alt="HelloRibbon"                           Image16by16="\_imgs\Ribbon\Actions_32.png"                           Image32by32="\_imgs\Ribbon\Actions_32.png"                           Description="按钮"                           LabelText="按钮"                           ToolTipDescription="按钮"                           ToolTipTitle="按钮"                           TemplateAlias="o1"                      />                </Controls>              </Group>            </CommandUIDefinition>          </CustomAction>          <CustomAction Id="CustomAction1.Scaling1" Location="Mscrm.Form.campaign.MainTab.Scaling._children" Sequence="140">            <CommandUIDefinition>              <MaxSize Id="CustomAction1.Scaling1.MaxSize1" GroupId="CustomAction.MyGroup" Sequence="21" Size="LargeLarge"/>            </CommandUIDefinition>          </CustomAction>          <CustomAction Id="CustomAction1.Scaling2" Location="Mscrm.Form.campaign.MainTab.Scaling._children" Sequence="150">            <CommandUIDefinition>              <Scale Id="CustomAction1.Scaling1.MaxSize2" GroupId="CustomAction.MyGroup" Sequence="85" Size="Popup"/>            </CommandUIDefinition>          </CustomAction>          <!--Form-->        </CustomActions>        <Templates>          <RibbonTemplates Id="Mscrm.Templates"></RibbonTemplates>        </Templates>        <CommandDefinitions>          <CommandDefinition Id="CustomAction.MyGroup.Button1.Command">            <EnableRules>              <EnableRule Id="CustomAction.MyGroup.Button1.Command.EnableRule1"/>            </EnableRules>            <DisplayRules>              <DisplayRule Id="CustomAction.MyGroup.Button1.Command.DisplayRule1"/>            </DisplayRules>            <Actions>              <JavaScriptFunction Library="$webresource:new_ghostbear.js" FunctionName="helloworld"></JavaScriptFunction>            </Actions>          </CommandDefinition>        </CommandDefinitions>        <RuleDefinitions>          <TabDisplayRules>          </TabDisplayRules>          <DisplayRules>          </DisplayRules>          <EnableRules>            <EnableRule Id="CustomAction.MyGroup.Button1.Command.EnableRule1">              <CustomRule FunctionName="campaignEnableRule1" Library="$webresource:new_ghostbear.js">                <CrmParameter Value="FirstPrimaryItemId"/>              </CustomRule>            </EnableRule>          </EnableRules>        </RuleDefinitions>        <LocLabels />      </RibbonDiffXml>