Application Ribbon

- La ribbon de aplicaciones contiene los tabs y grupos de botones comunes a todas las entidades en CRM

- Si tenemos que personalizar el despliegue de alguna de sus secciones o botones debemos tener en cuenta que además de las reglas custom que incluyamos, estos ya tienen además las suyas propias, con lo que debemos añadir en lugar de sobrescribir las propiedades de display, enable y custom actions

- En este ejemplo vamos a incluir una DisplayRule para el botón Búsqueda Avanzada

- El primer paso será crear una solución que incluya la ribbon de aplicaciones y exportarla

- El xml de customizaciones es mostrado a continuación

<ImportExportXml xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Entities></Entities>
  <Roles></Roles>
  <Workflows></Workflows>
  <FieldSecurityProfiles></FieldSecurityProfiles>
  <Templates />
  <RibbonDiffXml>
    <CustomActions />
    <Templates>
      <RibbonTemplates Id="Mscrm.Templates"></RibbonTemplates>
    </Templates>
    <CommandDefinitions />
    <RuleDefinitions>
      <TabDisplayRules />
      <DisplayRules />
      <EnableRules />
    </RuleDefinitions>
    <LocLabels />
  </RibbonDiffXml>
  <EntityMaps />
  <EntityRelationships />
  <OrganizationSettings />
  <optionsets />
  <Languages>
    <Language>3082</Language>
  </Languages>
</ImportExportXml>

- Para implementar el nuevo despliegue del botón Advanced Find, haremos uso del recurso de SDK applicationribbon.xml, y haremos una búsqueda para encontrar el valor del atributo Command de este botón, en este caso Mscrm.OpenGridAdvancedFind

- Conociendo el Command que localiza en la ribbon nuestro botón, implementaremos la siguiente CommandDefinition en su sección correspondiente CommandDefinitions

    <CommandDefinitions>
      <CommandDefinition Id="Mscrm.OpenGridAdvancedFind">
        <EnableRules/>
        <DisplayRules>
          <DisplayRule Id="Mscrm.OpenGridAdvancedFind.Display" />
        </DisplayRules>
        <Actions>
          <JavaScriptFunction FunctionName="Mscrm.RibbonActions.openAdvancedFind" 
             Library="/_static/_common/scripts/RibbonActions.js">
            <CrmParameter Value="SelectedControl" />
          </JavaScriptFunction>
        </Actions>
      </CommandDefinition>
    </CommandDefinitions>

- Observe que en nuestra customización hemos vuelto a incluir el tag Actions definido en el archivo de SDK applicationribbon.xml

- La implementación de la regla de display Mscrm.OpenGridAdvancedFind.Display es la siguiente

    <DisplayRule Id="Mscrm.OpenGridAdvancedFind.Display">          
      <EntityRule AppliesTo="SelectedEntity" 
           Context="HomePageGrid" EntityName="contact" />
    </DisplayRule>

- Guardaremos los cambios e importaremos la solución customizada, y publicaremos los resultados

- El resultado de este despliegue es que el botón Búsqueda Avanzada se muestra sólo para la entidad seleccionada Contacto
Puede consultar una lista completa de las DisplayRules en el sitio oficial de Microsoft

Desde Innovar Tecnologías esperamos que este documento les sea de ayuda en su desarrollo