Definir acciones personalizadas para modificar la cinta de opciones

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

El valor predeterminado, una barra de comandos de la aplicación o la cinta de opciones están definidos por los metadatos de Microsoft Dynamics 365. 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:

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 atributo 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 atributo 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 atributo Id aumentará en gran medida su productividad mientras se modifica RibbonDiffXml.

Basado en la información de ubicación que se proporciona, el valor del atributo 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> (RibbonDiffXml) 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.

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 entidad 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.

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 atributo Location debe coincidir con el identificador del elemento de la cinta de opciones que desea quitar.

Ver también

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

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright