Definir acciones personalizadas para modificar la cinta de opciones

Nota

Este tema trata sobre comandos clásicos.

Hay una nueva forma de definir comandos. Consulte Información general de los comandos modernos (versión preliminar)

El valor predeterminado, una barra de comandos de la aplicación o la cinta de opciones están definidos por los metadatos de Microsoft Dataverse. Estos datos predeterminados no se puede cambiar, pero se pueden incluir definiciones de acciones específicas que reemplazarán la cinta de opciones predeterminada.

Tipos de acciones personalizadas

Existen dos tipos de acciones personalizadas para las cintas de opciones:

• <CustomAction>: Define una acción para agregar o sustituir elementos de la cinta de opciones.

• <HideCustomAction>: Quita un elemento existente de la cinta de opciones para que no se procese para la cinta.

Acciones personalizadas

Una acción personalizada es una instrucción de cómo se desea cambiar la definición de la cinta de opciones predeterminada. Se evalúa y se aplica a la cinta de opciones en tiempo de ejecución. Para establecer el contexto de una acción personalizada, debe incluir información sobre la ubicación de los elementos que desea cambiar. Use el parámetro Location para especificar dónde se aplica el cambio.

Cuando se agrega un nuevo elemento de la cinta de opciones, se hace referencia al elemento que contiene, por ejemplo, una pestaña o grupo existente. Después, se incluye el sufijo ._children para indicar que esta acción personalizada agregará algo a un elemento existente.

Cuando se cambia la definición del elemento existente, el valor Location se corresponde con el identificador de ese elemento.

También debe especificar un identificador único para la acción personalizada. Use el parámetro Id para configurar este valor. Se recomienda usar una convención de nomenclatura que garantice un valor único. Para mantener la coherencia y la legibilidad, recomendamos que use un punto para separar componentes. El primer elemento de la convención de nomenclatura debe ser algo relacionado con el editor de soluciones o solución, por ejemplo, Contoso.contact.form.CustomButton.CustomAction.

Sugerencia

De forma consistente, al aplicar sus convenciones de nomenclatura al parámetro Id aumentará en gran medida su productividad mientras se modifica RibbonDiffXml.

Basado en la información de ubicación que se proporciona, el valor Sequence determina el orden en el que se representan elementos. Si desea un control personalizado para que aparezca entre dos controles existentes, debe seleccionar un valor de secuencia que esté entre los valores de secuencia de los elementos existentes.

Ocultar acciones personalizadas

<HideCustomAction> es una instrucción que se usa cuando se desea quitar un elemento de cinta de opciones existente de manera que no se representa. Esto no oculta el elemento de la cinta de opciones, quita el elemento de la cinta de opciones en tiempo de ejecución de modo que no existe en la cinta de opciones.

El elemento HideActionId proporciona un identificador único para la acción. Para mantener la coherencia y la legibilidad, debe seguir la misma convención de nomenclatura que la descrita para los elementos <CustomAction>. El parámetro Location debe coincidir con el identificador del elemento de la cinta de opciones que desea quitar.

Nota

Puesto que el elemento HideCustomAction quita un nodo especificado de la cinta de opciones, quitar elementos de la cinta de opciones de esta manera puede no ser la mejor opción para cada situación.

• Si desea quitar el botón que está asociado a un privilegio específico, deberá ajustar los privilegios de la tabla en los roles de seguridad de su implementación. Esto permitirá la visualización de la cinta de opciones predeterminada y permite reglas para ocultar o deshabilitar elementos de la cinta de opciones, de modo que los usuarios no tienen los privilegios necesarios para realizar estas acciones.
  • Si desea reemplazar un elemento de cinta de opciones existente con un elemento personalizado de la cinta de opciones, puede sobrescribir ese elemento especificando un valor CustomAction.Location idéntico al elemento existente.
• Para quitar el elemento HideCustomAction que necesita para crear una nueva versión actualizada de la misma solución que instaló el elemento HideCustomAction. Un nuevo parche de la solución no puede eliminar el elemento HideCustomAction.

El elemento HideCustomAction no se puede eliminar una vez agregado, excepto mediante la creación de una nueva solución actualizada. En cambio, los botones de la cinta deben ocultarse con un elemento DisplayRule que siempre se evalúe como falso. Tener ambos Mscrm.HideOnModern y Mscrm.ShowOnlyOnModern siempre evaluaría como falso. Por ejemplo, para ocultar un botón de desactivación:

<CommandDefinition Id="Mscrm.HomepageGrid.Deactivate">
    <EnableRules>
      </EnableRules>
      <DisplayRules>
        <DisplayRule Id="Mscrm.HideOnModern" />
        <DisplayRule Id="Mscrm.ShowOnlyOnModern" />
      </DisplayRules>
      <Actions>
        </Actions>
    </CommandDefinition>

Consultar también

Personalizar comandos y la cinta de opciones
Pasar los datos desde una página como parámetro a las acciones de la cinta de opciones
Definir escalabilidad para elementos de la cinta de opciones

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).