Walkthrough: Add a Custom Tab to a Specific Entity

Article
10/04/2013

[Applies to: Microsoft Dynamics CRM 2011]

This walkthrough describes how to add a custom tab to the Opportunity entity. The procedure to add a custom tab to any entity will be the similar.

Tip

A managed solution that includes the goal of this walkthrough is available in the Microsoft Dynamics CRM SDK download at SDK\Walkthroughs\Ribbon\AddaCustomTabtoaSpecificEntity.zip.

Because it is a managed solution, you can install (import) it to view the customized ribbon. You can then uninstall (delete) it to remove it from the system.

If you install this managed solution, make sure that you uninstall it before you try the walkthrough steps.

Prerequisites

Before you can begin you must have a clear set of requirements. The following images describe the goal:

Opportunity entity form ribbon

Opportunity entity grid ribbon

Account form ribbon with the related Opportunity grid selected

The following are the requirements for the custom tab that will be met in this example:

Will appear only for the Opportunity entity.
Will appear to the right of any other tabs.
Will appear in the following areas:
- Opportunity form
- Opportunity grid
- Opportunity sub grid, to the right of the Opportunities tab in the List Tools contextual group.
Will have the label Custom Tab.
The custom tab for each ribbon will have one group and four buttons as described in the following table.

Tab Id	Group Id	Button Id
Sample.Form.opportunity.CustomTab	Sample.Form.opportunity.CustomTab.FirstGroup	Sample.Form.opportunity.CustomTab.FirstGroup.FirstButton
		Sample.Form.opportunity.CustomTab.FirstGroup.SecondButton
		Sample.Form.opportunity.CustomTab.FirstGroup.ThirdButton
		Sample.Form.opportunity.CustomTab.FirstGroup.FourthButton
Sample.Grid.opportunity.CustomTab	Sample.Grid.opportunity.CustomTab.FirstGroup	Sample.Grid.opportunity.CustomTab.FirstGroup.FirstButton
		Sample.Grid.opportunity.CustomTab.FirstGroup.SecondButton
		Sample.Grid.opportunity.CustomTab.FirstGroup.ThirdButton
		Sample.Grid.opportunity.CustomTab.FirstGroup.FourthButton
Sample.SubGrid.opportunity.CustomTab	Sample.SubGrid.opportunity.CustomTab.FirstGroup	Sample.SubGrid.opportunity.CustomTab.FirstGroup.FirstButton
		Sample.SubGrid.opportunity.CustomTab.FirstGroup.SecondButton
		Sample.SubGrid.opportunity.CustomTab.FirstGroup.ThirdButton
		Sample.SubGrid.opportunity.CustomTab.FirstGroup.FourthButton

Each button will reference a Web resource image to display icons as shown in the following table.

Tip

You can import the Microsoft Dynamics CRM SDK sample images managed solution to add these icons to your organization. The solution is available in the downloadable files for the SDK at SDK\Walkthroughs\Ribbon\MicrosoftCRMSDKSampleImages.zip.

Or, you can create your own image Web resources by using the names in the following list.

Button	Web Resource Name	Action
FirstButton	sample_/icons/1Icon16x16.png	Display Message: “Button 1 action performed”.
FirstButton	sample_/icons/1Icon32x32.png	Display Message: “Button 1 action performed”.
SecondButton	sample_/icons/2Icon16x16.png	Display Message: “Button 2 action performed”.
SecondButton	sample_/icons/2Icon32x32.png	Display Message: “Button 2 action performed”.
ThirdButton	sample_/icons/3Icon16x16.png	Display Message: “Button 3 action performed”.
ThirdButton	sample_/icons/3Icon32x32.png	Display Message: “Button 3 action performed”.
FourthButton	sample_/icons/4Icon16x16.png	Display Message: “Button 4 action performed”.
FourthButton	sample_/icons/4Icon32x32.png	Display Message: “Button 4 action performed”.

When clicked, each button will display a message "Button [N] action performed." where N represents the number of the button.
Each tab, group, and button will have a localizable label. Buttons will also have a tooltip.

Note

This walkthrough does not show how to configure scaling for the group in the tab. In this example, the limited number of buttons on the tab will not provide an opportunity for scaling to function because the width of the window cannot be reduced to the point where scaling would begin to take effect.

If you are defining a custom tab that will include more buttons and groups, you should also define scaling definitions. For more information, see Define Scaling for Ribbon Elements.

Export the Opportunity Entity

By exporting and making changes only to the ribbon for the Opportunity entity, you will meet requirement 1.

You can export the whole default solution, including the Opportunity entity, but to minimize the total file size, we recommend that you create a new solution and add the Opportunity entity to it.

Create a New Solution
1. For more information, see Export, Prepare to Edit, and Import the Ribbon.
Export the Solution
1. For more information, see Export, Prepare to Edit, and Import the Ribbon.

Identify the Ids for Existing Items

Each entity does not have a specific collection of tabs so this tab must be added to the general collection of application tabs: Mscrm.Tabs.

Note

To restrict this tab from appearing for all entities, you must apply a tab display rule that includes a restriction to only apply this tab for a specific entity.

Create the Script Web Resource

Create a script Web resource named sample_ShowMessage.js.

Note

The full name of the script Web resource you create depends on the solution it is created in. For this sample, the solution publisher customization prefix is sample. The default solution publisher prefix is new. You may have to change how you reference the name of this Web resource in the following example XML if the name of the script Web resource you use is different.

For more information, see Script (JScript) Web Resources and JScript Libraries for Microsoft Dynamics CRM.

Set the source of this Web resource to the following example:

function show(number){alert("Button "+number+" action performed.");}

Save and publish the script Web resource.

Edit the customizations.xml File

Extract the compressed solutions file.
Open the customizations.xml file.

Tip

Although you can edit the customization.xml file by using any text editor, we recommend that you use Microsoft Visual Studio or another XML editing application that supports XSD schema validation. This will help avoid XML validation errors when you import the ribbon.

Associate the customizations.xml file with the customizationsSolution.xsd file. You can find this schema in the SDK\Schemas\CustomizationsSolution.xsd file in the SDK download package.
For more information, see Prepare to edit the XML.

Locate the default RibbonDiffXml node shown in the following example:

<RibbonDiffXml>
 <CustomActions />
 <Templates>
  <RibbonTemplates Id="Mscrm.Templates">
  </RibbonTemplates>
 </Templates>
 <CommandDefinitions />
 <RuleDefinitions>
  <TabDisplayRules />
  <DisplayRules />
  <EnableRules />
 </RuleDefinitions>
 <LocLabels />
</RibbonDiffXml>

Edit the <RuleDefinitions> (RibbonDiffXml) node to define <TabDisplayRules> (RibbonDiffXml) to support requirement 1 as shown in the following example:

<TabDisplayRules>
  <TabDisplayRule TabCommand="Sample.Form.opportunity.CustomTab" >
    <EntityRule EntityName="opportunity"
                Context="Form"
                AppliesTo="PrimaryEntity" />
  </TabDisplayRule>
  <TabDisplayRule TabCommand="Sample.Grid.opportunity.CustomTab" >
    <EntityRule EntityName="opportunity"
                Context="HomePageGrid" />
  </TabDisplayRule>
  <TabDisplayRule TabCommand="Sample.SubGrid.opportunity.CustomTab" >
    <EntityRule EntityName="opportunity"
                Context="SubGridStandard" />
    <EntityRule EntityName="opportunity"
                Context="SubGridAssociated" />
  </TabDisplayRule>
</TabDisplayRules>

Edit the <LocLabels> (RibbonDiffXml) node to set the localized labels for requirement 8.

Note

You can enter text directly into the XML for labels. However, using localized labels as shown in the following example makes re-use of text and localization easier:

<LocLabels>
  <LocLabel Id="Sample.opportunity.CustomTab.Title">
    <Titles>
      <Title languagecode="1033"
              description="Custom Tab"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.Description">
    <Titles>
      <Title languagecode="1033"
              description="A custom tab for the Opportunity entity."/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.Title">
    <Titles>
      <Title languagecode="1033"
              description="First Group"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.SecondGroup.Title">
    <Titles>
      <Title languagecode="1033"
              description="Second Group"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.ThirdGroup.Title">
    <Titles>
      <Title languagecode="1033"
              description="Third Group"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText">
    <Titles>
      <Title languagecode="1033"
              description="First Button"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription">
    <Titles>
      <Title languagecode="1033"
              description="The first button in the first group."/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText">
    <Titles>
      <Title languagecode="1033"
              description="Second Button"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription">
    <Titles>
      <Title languagecode="1033"
              description="The second button in the first group."/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText">
    <Titles>
      <Title languagecode="1033"
              description="Third Button"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription">
    <Titles>
      <Title languagecode="1033"
              description="The third button in the first group."/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText">
    <Titles>
      <Title languagecode="1033"
              description="Fourth Button"/>
    </Titles>
  </LocLabel>
  <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription">
    <Titles>
      <Title languagecode="1033"
              description="The fourth button in the first group."/>
    </Titles>
  </LocLabel>
</LocLabels>

Edit the <CommandDefinitions> (RibbonDiffXml) node to add 18 commands, one for each tab, group, and button.

The <CommandDefinition> (RibbonDiffXml) consolidates a set of enable rules, display rules, and actions associated with a control.

Note

In this example, you use a standard set of existing enable and display rules.

The enable rule Mscrm.Enabled sets the control to always be enabled.
The display rule Mscrm.CanWriteOpportunity requires that the user be associated with a security role that grants them the write privilege on the Opportunity entity.

The enable rules and display rules you use will depend on the functionality contained in the actions for each button.

Note

Because the custom tabs will be displayed on the form, grid, and sub grid; separate commands allow for clearly defining the expected behavior in each location. In the following example, because the CommandDefinitions are very simple and do not vary based on the location, it may be more efficient to define only six command definitions and re-use them. Despite this fact, this walkthrough uses 18 separate <CommandDefinition> (RibbonDiffXml) elements to attempt to minimize complexity at the expense of efficiency:

<CommandDefinitions>
  <!-- Form Command Definitions Start-->
  <CommandDefinition Id="Sample.Form.opportunity.CustomTab">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions />
  </CommandDefinition>

  <CommandDefinition Id="Sample.Form.opportunity.FirstGroup">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions />
  </CommandDefinition>

  <CommandDefinition Id="Sample.Form.opportunity.FirstButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="1"/>
      </JavaScriptFunction>

    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.Form.opportunity.SecondButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="2"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.Form.opportunity.ThirdButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="3"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.Form.opportunity.FourthButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="4"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>
  <!-- Form Command Definitions End-->

  <!-- Grid Command Definitions Start-->
  <CommandDefinition Id="Sample.Grid.opportunity.CustomTab">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions />
  </CommandDefinition>

  <CommandDefinition Id="Sample.Grid.opportunity.FirstGroup">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions />
  </CommandDefinition>

  <CommandDefinition Id="Sample.Grid.opportunity.FirstButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="1"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.Grid.opportunity.SecondButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="2"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.Grid.opportunity.ThirdButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="3"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.Grid.opportunity.FourthButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="4"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>
  <!-- Grid Command Definitions End-->

  <!-- SubGrid Command Definitions Start-->
  <CommandDefinition Id="Sample.SubGrid.opportunity.CustomTab">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions />
  </CommandDefinition>

  <CommandDefinition Id="Sample.SubGrid.opportunity.FirstGroup">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions />
  </CommandDefinition>

  <CommandDefinition Id="Sample.SubGrid.opportunity.FirstButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="1"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.SubGrid.opportunity.SecondButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="2"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.SubGrid.opportunity.ThirdButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="3"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>

  <CommandDefinition Id="Sample.SubGrid.opportunity.FourthButton">
    <EnableRules>
      <EnableRule Id="Mscrm.Enabled "/>
    </EnableRules>
    <DisplayRules >
      <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
    </DisplayRules>
    <Actions>
      <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                          FunctionName="show">
        <StringParameter Value="4"/>
      </JavaScriptFunction>
    </Actions>
  </CommandDefinition>
  <!-- SubGrid Command Definitions End-->
</CommandDefinitions>

Edit the <CustomActions> (RibbonDiffXml) element to add detail about the form tab

Note

In the following example, note that the Location attribute value of the form custom action is set to Mscrm.Tabs._children. This is what adds the tab to the collection of application tabs:

<CustomActions>
  <!-- Form Custom Tab START-->
  <CustomAction Id="Sample.Form.opportunity.CustomTab.CustomAction"
                Location="Mscrm.Tabs._children"
                Sequence="40">
    <CommandUIDefinition>
      <Tab Id="Sample.Form.opportunity.CustomTab"
            Command="Sample.Form.opportunity.CustomTab"
            Title="$LocLabels:Sample.opportunity.CustomTab.Title"
            Description="$LocLabels:Sample.opportunity.CustomTab.Description"
            Sequence="40">
        <Scaling Id="Sample.Form.opportunity.CustomTab.Scaling">
          <MaxSize Id="Sample.Form.opportunity.CustomTab.FirstGroup.MaxSize"
                    GroupId="Sample.Form.opportunity.CustomTab.FirstGroup"
                    Sequence="10"
                    Size="LargeMedium" />
        </Scaling>
        <Groups Id="Sample.Form.opportunity.CustomTab.Groups">
          <Group Id="Sample.Form.opportunity.CustomTab.FirstGroup"
                  Command="Sample.Form.opportunity.FirstGroup"
                  Sequence="10"
                  Title="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.Title"
                  Template="Mscrm.Templates.3.3">
            <Controls Id="Sample.Form.opportunity.CustomTab.FirstGroup.Controls">
              <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.FirstButton"
                      ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                      ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription"
                      Command="Sample.Form.opportunity.FirstButton"
                      Sequence="10"
                      LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                      Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                      Image16by16="$webresource:sample_/icons/1Icon16x16.png"
                      Image32by32="$webresource:sample_/icons/1Icon32x32.png"
                      TemplateAlias="o1" />
              <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.SecondButton"
                      ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                      ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription"
                      Command="Sample.Form.opportunity.SecondButton"
                      Sequence="20"
                      LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                      Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                      Image16by16="$webresource:sample_/icons/2Icon16x16.png"
                      Image32by32="$webresource:sample_/icons/2Icon32x32.png"
                      TemplateAlias="o1" />
              <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.ThirdButton"
                      ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                      ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription"
                      Command="Sample.Form.opportunity.ThirdButton"
                      Sequence="30"
                      LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                      Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                      Image16by16="$webresource:sample_/icons/3Icon16x16.png"
                      Image32by32="$webresource:sample_/icons/3Icon32x32.png"
                      TemplateAlias="o1" />
              <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.FourthButton"
                      ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                      ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription"
                      Command="Sample.Form.opportunity.FourthButton"
                      Sequence="40"
                      LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                      Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                      Image16by16="$webresource:sample_/icons/4Icon16x16.png"
                      Image32by32="$webresource:sample_/icons/4Icon32x32.png"
                      TemplateAlias="o1" />
            </Controls>
          </Group>
        </Groups>
      </Tab>
    </CommandUIDefinition>
  </CustomAction>
  <!-- Form Custom Tab END-->

</CustomActions>

Edit the <CustomActions> (RibbonDiffXml) element to add a <CustomAction> (RibbonDiffXml) for the grid tab. In this example, there are two significant differences between the form and grid custom actions:

The naming convention used for Id attributes begins with Sample.Grid rather than Sample.Form.
The Tab.Sequence value is significantly higher (500). This is necessary to force the tab to display to the right of any other tabs. The value 500 was chosen in the following example as an arbitrary high value:

<!-- Grid Custom Tab START-->
<CustomAction Id="Sample.Grid.opportunity.CustomTab.CustomAction"
              Location="Mscrm.Tabs._children"
              Sequence="40">
  <CommandUIDefinition>
    <Tab Id="Sample.Grid.opportunity.CustomTab"
          Command="Sample.Grid.opportunity.CustomTab"
          Title="$LocLabels:Sample.opportunity.CustomTab.Title"
          Description="$LocLabels:Sample.opportunity.CustomTab.Description"
          Sequence="500">
      <Scaling Id="Sample.Grid.opportunity.CustomTab.Scaling">
        <MaxSize Id="Sample.Grid.opportunity.CustomTab.FirstGroup.MaxSize"
                  GroupId="Sample.Grid.opportunity.CustomTab.FirstGroup"
                  Sequence="10"
                  Size="LargeMedium" />
      </Scaling>
      <Groups Id="Sample.Grid.opportunity.CustomTab.Groups">
        <Group Id="Sample.Grid.opportunity.CustomTab.FirstGroup"
                Command="Sample.Grid.opportunity.FirstGroup"
                Sequence="10"
                Title="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.Title"
                Template="Mscrm.Templates.3.3">
          <Controls Id="Sample.Grid.opportunity.CustomTab.FirstGroup.Controls">
            <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.FirstButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription"
                    Command="Sample.Grid.opportunity.FirstButton"
                    Sequence="10"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                    Image16by16="$webresource:sample_/icons/1Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/1Icon32x32.png"
                    TemplateAlias="o1" />
            <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.SecondButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription"
                    Command="Sample.Grid.opportunity.SecondButton"
                    Sequence="20"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                    Image16by16="$webresource:sample_/icons/2Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/2Icon32x32.png"
                    TemplateAlias="o1" />
            <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.ThirdButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription"
                    Command="Sample.Grid.opportunity.ThirdButton"
                    Sequence="30"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                    Image16by16="$webresource:sample_/icons/3Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/3Icon32x32.png"
                    TemplateAlias="o1" />
            <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.FourthButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription"
                    Command="Sample.Grid.opportunity.FourthButton"
                    Sequence="40"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                    Image16by16="$webresource:sample_/icons/4Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/4Icon32x32.png"
                    TemplateAlias="o1" />
          </Controls>
        </Group>
      </Groups>
    </Tab>
  </CommandUIDefinition>
</CustomAction>
<!-- Grid Custom Tab END-->

Edit the <CustomActions> (RibbonDiffXml) element to add a custom action for your sub grid tab. Because the sub grid ribbon is displayed using a contextual group within the parent entity ribbon, the sub grid custom action Location attribute value in the following example is set to Mscrm.SubGrid.opportunity.ContextualTabs._children:

<!-- SubGrid Custom Tab START-->
<CustomAction Id="Sample.SubGrid.opportunity.CustomTab.CustomAction"
              Location="Mscrm.SubGrid.opportunity.ContextualTabs._children"
              Sequence="40">
  <CommandUIDefinition>
    <Tab Id="Sample.SubGrid.opportunity.CustomTab"
          Command="Sample.SubGrid.opportunity.CustomTab"
          Title="$LocLabels:Sample.opportunity.CustomTab.Title"
          Description="$LocLabels:Sample.opportunity.CustomTab.Description"
          Sequence="500">
      <Scaling Id="Sample.SubGrid.opportunity.CustomTab.Scaling">
        <MaxSize Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.MaxSize"
                  GroupId="Sample.SubGrid.opportunity.CustomTab.FirstGroup"
                  Sequence="10"
                  Size="LargeMedium" />
      </Scaling>
      <Groups Id="Sample.SubGrid.opportunity.CustomTab.Groups">
        <Group Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup"
                Command="Sample.SubGrid.opportunity.FirstGroup"
                Sequence="10"
                Title="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.Title"
                Template="Mscrm.Templates.3.3">
          <Controls Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.Controls">
            <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.FirstButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription"
                    Command="Sample.SubGrid.opportunity.FirstButton"
                    Sequence="10"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                    Image16by16="$webresource:sample_/icons/1Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/1Icon32x32.png"
                    TemplateAlias="o1" />
            <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.SecondButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription"
                    Command="Sample.SubGrid.opportunity.SecondButton"
                    Sequence="20"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                    Image16by16="$webresource:sample_/icons/2Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/2Icon32x32.png"
                    TemplateAlias="o1" />
            <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.ThirdButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription"
                    Command="Sample.SubGrid.opportunity.ThirdButton"
                    Sequence="30"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                    Image16by16="$webresource:sample_/icons/3Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/3Icon32x32.png"
                    TemplateAlias="o1" />
            <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.FourthButton"
                    ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                    ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription"
                    Command="Sample.SubGrid.opportunity.FourthButton"
                    Sequence="40"
                    LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                    Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                    Image16by16="$webresource:sample_/icons/4Icon16x16.png"
                    Image32by32="$webresource:sample_/icons/4Icon32x32.png"
                    TemplateAlias="o1" />
          </Controls>
        </Group>
      </Groups>
    </Tab>
  </CommandUIDefinition>
</CustomAction>
<!-- SubGrid Custom Tab END-->

Your final modified RibbonDiffXml node will look like the following example:

<RibbonDiffXml>
  <CustomActions>
    <!-- Form Custom Tab START-->
    <CustomAction Id="Sample.Form.opportunity.CustomTab.CustomAction"
                  Location="Mscrm.Tabs._children"
                  Sequence="40">
      <CommandUIDefinition>
        <Tab Id="Sample.Form.opportunity.CustomTab"
              Command="Sample.Form.opportunity.CustomTab"
              Title="$LocLabels:Sample.opportunity.CustomTab.Title"
              Description="$LocLabels:Sample.opportunity.CustomTab.Description"
              Sequence="40">
          <Scaling Id="Sample.Form.opportunity.CustomTab.Scaling">
            <MaxSize Id="Sample.Form.opportunity.CustomTab.FirstGroup.MaxSize"
                      GroupId="Sample.Form.opportunity.CustomTab.FirstGroup"
                      Sequence="10"
                      Size="LargeMedium" />
          </Scaling>
          <Groups Id="Sample.Form.opportunity.CustomTab.Groups">
            <Group Id="Sample.Form.opportunity.CustomTab.FirstGroup"
                    Command="Sample.Form.opportunity.FirstGroup"
                    Sequence="10"
                    Title="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.Title"
                    Template="Mscrm.Templates.3.3">
              <Controls Id="Sample.Form.opportunity.CustomTab.FirstGroup.Controls">
                <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.FirstButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription"
                        Command="Sample.Form.opportunity.FirstButton"
                        Sequence="10"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        Image16by16="$webresource:sample_/icons/1Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/1Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.SecondButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription"
                        Command="Sample.Form.opportunity.SecondButton"
                        Sequence="20"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        Image16by16="$webresource:sample_/icons/2Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/2Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.ThirdButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription"
                        Command="Sample.Form.opportunity.ThirdButton"
                        Sequence="30"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        Image16by16="$webresource:sample_/icons/3Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/3Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.Form.opportunity.CustomTab.FirstGroup.FourthButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription"
                        Command="Sample.Form.opportunity.FourthButton"
                        Sequence="40"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        Image16by16="$webresource:sample_/icons/4Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/4Icon32x32.png"
                        TemplateAlias="o1" />
              </Controls>
            </Group>
          </Groups>
        </Tab>
      </CommandUIDefinition>
    </CustomAction>
    <!-- Form Custom Tab END-->
    <!-- Grid Custom Tab START-->
    <CustomAction Id="Sample.Grid.opportunity.CustomTab.CustomAction"
                  Location="Mscrm.Tabs._children"
                  Sequence="40">
      <CommandUIDefinition>
        <Tab Id="Sample.Grid.opportunity.CustomTab"
              Command="Sample.Grid.opportunity.CustomTab"
              Title="$LocLabels:Sample.opportunity.CustomTab.Title"
              Description="$LocLabels:Sample.opportunity.CustomTab.Description"
              Sequence="500">
          <Scaling Id="Sample.Grid.opportunity.CustomTab.Scaling">
            <MaxSize Id="Sample.Grid.opportunity.CustomTab.FirstGroup.MaxSize"
                      GroupId="Sample.Grid.opportunity.CustomTab.FirstGroup"
                      Sequence="10"
                      Size="LargeMedium" />
          </Scaling>
          <Groups Id="Sample.Grid.opportunity.CustomTab.Groups">
            <Group Id="Sample.Grid.opportunity.CustomTab.FirstGroup"
                    Command="Sample.Grid.opportunity.FirstGroup"
                    Sequence="10"
                    Title="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.Title"
                    Template="Mscrm.Templates.3.3">
              <Controls Id="Sample.Grid.opportunity.CustomTab.FirstGroup.Controls">
                <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.FirstButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription"
                        Command="Sample.Grid.opportunity.FirstButton"
                        Sequence="10"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        Image16by16="$webresource:sample_/icons/1Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/1Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.SecondButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription"
                        Command="Sample.Grid.opportunity.SecondButton"
                        Sequence="20"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        Image16by16="$webresource:sample_/icons/2Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/2Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.ThirdButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription"
                        Command="Sample.Grid.opportunity.ThirdButton"
                        Sequence="30"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        Image16by16="$webresource:sample_/icons/3Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/3Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.Grid.opportunity.CustomTab.FirstGroup.FourthButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription"
                        Command="Sample.Grid.opportunity.FourthButton"
                        Sequence="40"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        Image16by16="$webresource:sample_/icons/4Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/4Icon32x32.png"
                        TemplateAlias="o1" />
              </Controls>
            </Group>
          </Groups>
        </Tab>
      </CommandUIDefinition>
    </CustomAction>
    <!-- Grid Custom Tab END-->
    <!-- SubGrid Custom Tab START-->
    <CustomAction Id="Sample.SubGrid.opportunity.CustomTab.CustomAction"
                  Location="Mscrm.SubGrid.opportunity.ContextualTabs._children"
                  Sequence="40">
      <CommandUIDefinition>
        <Tab Id="Sample.SubGrid.opportunity.CustomTab"
              Command="Sample.SubGrid.opportunity.CustomTab"
              Title="$LocLabels:Sample.opportunity.CustomTab.Title"
              Description="$LocLabels:Sample.opportunity.CustomTab.Description"
              Sequence="500">
          <Scaling Id="Sample.SubGrid.opportunity.CustomTab.Scaling">
            <MaxSize Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.MaxSize"
                      GroupId="Sample.SubGrid.opportunity.CustomTab.FirstGroup"
                      Sequence="10"
                      Size="LargeMedium" />
          </Scaling>
          <Groups Id="Sample.SubGrid.opportunity.CustomTab.Groups">
            <Group Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup"
                    Command="Sample.SubGrid.opportunity.FirstGroup"
                    Sequence="10"
                    Title="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.Title"
                    Template="Mscrm.Templates.3.3">
              <Controls Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.Controls">
                <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.FirstButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription"
                        Command="Sample.SubGrid.opportunity.FirstButton"
                        Sequence="10"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText"
                        Image16by16="$webresource:sample_/icons/1Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/1Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.SecondButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription"
                        Command="Sample.SubGrid.opportunity.SecondButton"
                        Sequence="20"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText"
                        Image16by16="$webresource:sample_/icons/2Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/2Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.ThirdButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription"
                        Command="Sample.SubGrid.opportunity.ThirdButton"
                        Sequence="30"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText"
                        Image16by16="$webresource:sample_/icons/3Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/3Icon32x32.png"
                        TemplateAlias="o1" />
                <Button Id="Sample.SubGrid.opportunity.CustomTab.FirstGroup.FourthButton"
                        ToolTipTitle="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        ToolTipDescription="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription"
                        Command="Sample.SubGrid.opportunity.FourthButton"
                        Sequence="40"
                        LabelText="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        Alt="$LocLabels:Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText"
                        Image16by16="$webresource:sample_/icons/4Icon16x16.png"
                        Image32by32="$webresource:sample_/icons/4Icon32x32.png"
                        TemplateAlias="o1" />
              </Controls>
            </Group>
          </Groups>
        </Tab>
      </CommandUIDefinition>
    </CustomAction>
    <!-- SubGrid Custom Tab END-->
  </CustomActions>
  <Templates>
    <RibbonTemplates Id="Mscrm.Templates">
    </RibbonTemplates>
  </Templates>
  <CommandDefinitions>
    <!-- Form Command Definitions Start-->
    <CommandDefinition Id="Sample.Form.opportunity.CustomTab">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions />
    </CommandDefinition>

    <CommandDefinition Id="Sample.Form.opportunity.FirstGroup">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions />
    </CommandDefinition>

    <CommandDefinition Id="Sample.Form.opportunity.FirstButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="1"/>
        </JavaScriptFunction>

      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.Form.opportunity.SecondButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="2"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.Form.opportunity.ThirdButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="3"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.Form.opportunity.FourthButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="4"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>
    <!-- Form Command Definitions End-->

    <!-- Grid Command Definitions Start-->
    <CommandDefinition Id="Sample.Grid.opportunity.CustomTab">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions />
    </CommandDefinition>

    <CommandDefinition Id="Sample.Grid.opportunity.FirstGroup">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions />
    </CommandDefinition>

    <CommandDefinition Id="Sample.Grid.opportunity.FirstButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="1"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.Grid.opportunity.SecondButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="2"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.Grid.opportunity.ThirdButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="3"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.Grid.opportunity.FourthButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="4"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>
    <!-- Grid Command Definitions End-->

    <!-- SubGrid Command Definitions Start-->
    <CommandDefinition Id="Sample.SubGrid.opportunity.CustomTab">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions />
    </CommandDefinition>

    <CommandDefinition Id="Sample.SubGrid.opportunity.FirstGroup">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions />
    </CommandDefinition>

    <CommandDefinition Id="Sample.SubGrid.opportunity.FirstButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="1"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.SubGrid.opportunity.SecondButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="2"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.SubGrid.opportunity.ThirdButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="3"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>

    <CommandDefinition Id="Sample.SubGrid.opportunity.FourthButton">
      <EnableRules>
        <EnableRule Id="Mscrm.Enabled "/>
      </EnableRules>
      <DisplayRules >
        <DisplayRule  Id="Mscrm.CanWriteOpportunity"/>
      </DisplayRules>
      <Actions>
        <JavaScriptFunction Library="$webresource:sample_ShowMessage.js"
                            FunctionName="show">
          <StringParameter Value="4"/>
        </JavaScriptFunction>
      </Actions>
    </CommandDefinition>
    <!-- SubGrid Command Definitions End-->
  </CommandDefinitions>
  <RuleDefinitions>
    <TabDisplayRules>
      <TabDisplayRule TabCommand="Sample.Form.opportunity.CustomTab" >
        <EntityRule EntityName="opportunity"
                    Context="Form"
                    AppliesTo="PrimaryEntity" />
      </TabDisplayRule>
      <TabDisplayRule TabCommand="Sample.Grid.opportunity.CustomTab" >
        <EntityRule EntityName="opportunity"
                    Context="HomePageGrid" />
      </TabDisplayRule>
      <TabDisplayRule TabCommand="Sample.SubGrid.opportunity.CustomTab" >
        <EntityRule EntityName="opportunity"
                    Context="SubGridStandard" />
        <EntityRule EntityName="opportunity"
                    Context="SubGridAssociated" />
      </TabDisplayRule>
    </TabDisplayRules>
    <DisplayRules/>
    <EnableRules/>
  </RuleDefinitions>
  <LocLabels>
    <LocLabel Id="Sample.opportunity.CustomTab.Title">
      <Titles>
        <Title languagecode="1033"
                description="Custom Tab"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.Description">
      <Titles>
        <Title languagecode="1033"
                description="A custom tab for the Opportunity entity."/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.Title">
      <Titles>
        <Title languagecode="1033"
                description="First Group"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.SecondGroup.Title">
      <Titles>
        <Title languagecode="1033"
                description="Second Group"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.ThirdGroup.Title">
      <Titles>
        <Title languagecode="1033"
                description="Third Group"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FirstButton.LabelText">
      <Titles>
        <Title languagecode="1033"
                description="First Button"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FirstButton.ToolTipDescription">
      <Titles>
        <Title languagecode="1033"
                description="The first button in the first group."/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.SecondButton.LabelText">
      <Titles>
        <Title languagecode="1033"
                description="Second Button"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.SecondButton.ToolTipDescription">
      <Titles>
        <Title languagecode="1033"
                description="The second button in the first group."/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.ThirdButton.LabelText">
      <Titles>
        <Title languagecode="1033"
                description="Third Button"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.ThirdButton.ToolTipDescription">
      <Titles>
        <Title languagecode="1033"
                description="The third button in the first group."/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FourthButton.LabelText">
      <Titles>
        <Title languagecode="1033"
                description="Fourth Button"/>
      </Titles>
    </LocLabel>
    <LocLabel Id="Sample.opportunity.CustomTab.FirstGroup.FourthButton.ToolTipDescription">
      <Titles>
        <Title languagecode="1033"
                description="The fourth button in the first group."/>
      </Titles>
    </LocLabel>
  </LocLabels>
</RibbonDiffXml>

Import and Publish the Solution

For more information, see Export, Prepare to Edit, and Import the Ribbon.

Test and Verify the Requirements Are Met

Open Microsoft Dynamics CRM 2011 and view the Opportunities sub area of the Navigation Pane to view the Opportunity grid ribbon.
Verify the following:
- The Custom Tab appears to the right of any other tabs.
- The Custom Tab tab displays one group and four buttons.
- All groups and buttons display the expected text for labels and tooltips.
- The expected message is displayed when you click each button.
Open an opportunity record to view the form ribbon.
Verify that the form ribbon matches the grid ribbon.
Open the Potential Customer record and click the Opportunities link in the Sales area.
Verify that the Custom Tab appears to the right of the Opportunities tab within the List Tools contextual group.
Open other entities to verify that the custom tab is only displayed for the Opportunity entity.

Walkthrough: Add a Custom Tab to a Specific Entity

Prerequisites

Export the Opportunity Entity

Create a New Solution

Export the Solution

Identify the Ids for Existing Items

Create the Script Web Resource

Edit the customizations.xml File

Import and Publish the Solution

Test and Verify the Requirements Are Met

See Also

Tasks

Other Resources

Additional resources