Cintas de opciones disponibles

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)

En este artículo se describe cómo se definen y modifican las cintas de opciones en aplicaciones basadas en modelos.

Definiciones de cintas de opciones

Las aplicaciones basadas en modelos contienen definiciones <RibbonDiffXml> predeterminadas para todas las cintas de opciones de la aplicación. Puede exportar y ver el código XML que define actualmente la cinta de opciones de su organización, pero no puede actualizar directamente el XML. La definición de la cinta se personaliza definiendo cómo se desea que cambie. Las definiciones de los cambios que especifique se aplican en tiempo de ejecución cuando la cinta se muestra en la aplicación. Todos los cambios estarán en los elementos <CustomAction> o <HideCustomAction>. Estos elementos se aplican sobre las definiciones de cintas de opciones predeterminadas proporcionadas por aplicaciones basadas en modelo.

Cuando escriba definiciones de cambios, normalmente deberá consultar con frecuencia las definiciones de las cintas de opciones predeterminadas. Por ejemplo, si desea ocultar un elemento específico de una cinta de opciones, deberá conocer el id. único del elemento. Si desea situar un nuevo elemento de cinta de opciones dentro o junto a un elemento de cinta de opciones existente, deberá conocer los valores de los id. de los elementos, así como el orden de la secuencia que controlará la posición relativa de los elementos.

Debido a este requisito de hacer referencia a las definiciones de los elementos existentes de las cintas de opciones, es muy importante conocer las definiciones actuales de las cintas de opciones de la organización. Hay dos mensajes que puede usar para exportar los archivos XML que representan el estado actual de las cintas de opciones. Esas definiciones incluyen las personalizaciones que ya se han aplicado en el sistema de modo que pueda personalizar las cintas de opciones personalizadas que se aplicaron previamente. Para obtener más información, consulte Exportar definiciones de cinta de opciones.

Para ayudarle a comenzar, puede descargar las definiciones de cinta predeterminadas para aplicaciones basadas en modelos desde Exportar ejemplo de definiciones de cinta. El archivo The ExportedRibbonXml incluye los archivos de salida que tendría para una organización.

En los archivos XML de cinta de opciones exportados, el archivo applicationRibbon.xml incluye todas las cintas de opciones que no se han definido para una tabla específica. Son las que corresponden al componente de la solución Cintas de opciones de la aplicación. Para cada tabla, encontrará un archivo nombre de la tablaribbon.xml. Este corresponde al RibbonDiffXml que se incluye en cada tabla. Si desea modificar la cinta de opciones para una tabla específica, debe buscar el archivo XML de cinta de opciones de esa tabla.

Cintas opciones de la tabla

Todas las tabla usan una definición de cinta de opciones común denominada plantilla de cinta de opciones de la tabla. La definición de la plantilla de tabla de opciones de la entidad se encuentra en el archivo applicationribbon.xml. Cuando cree una tabla personalizada, la cinta de opciones que verá es la cinta de opciones predeterminada especificada por la plantilla de cinta de opciones de la tabla. Cada tabla del sistema tiene su propia definición de <RibbonDiffXml> que modifica a la definición de la plantilla de cinta de opciones de la tabla.

En el archivo applicationribbon.xml, podrá ver las siguientes pestañas que se aplican a todas las tablas:

• Mscrm.Form.{!EntityLogicalName}.MainTab

  Esta pestaña muestra el nombre para mostrar de la tabla en la etiqueta.

• Mscrm.Form.{!EntityLogicalName}.Related

  Esta pestaña tiene la etiqueta Agregar.

• Mscrm.Form.{!EntityLogicalName}.Developer

  Esta pestaña tiene la etiqueta Personalizar.

• Mscrm.HomepageGrid.{!EntityLogicalName}.MainTab

  Esta pestaña muestra el nombre para mostrar de la tabla plural en la etiqueta.

• Mscrm.HomepageGrid.{!EntityLogicalName}.View

  Esta pestaña tiene la etiqueta Ver.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Related

  Esta pestaña tiene la etiqueta Agregar.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Developer

  Esta pestaña tiene la etiqueta Personalizar.

• Mscrm.SubGrid.{!EntityLogicalName}.ContextualTabs

  Cuando una subcuadrícula de un formulario o un gráfico tiene el foco, la pestaña contextual aparece con la etiqueta Herramientas de listas.

  • Mscrm.SubGrid.{!EntityLogicalName}.MainTab

    Esta pestaña muestra el nombre para mostrar de la tabla plural.

  Al ver las definiciones de la cinta de opciones de una tabla específica, verá que el nombre de la tabla normalmente reemplaza al símbolo {!EntityLogicalName}. Cuando se ve el símbolo {!EntityLogicalName} en la definición de la cinta de opciones de una tabla específica, significa que no hay una definición específica para esa tabla y simplemente usa la definición de la plantilla de cinta de opciones de la tabla. Cuando defina las cintas de una tabla específica, use siempre el nombre real de la tabla. Las modificaciones de la cinta de opciones de una tabla específica deben definirse en el nodo //ImportExportXml/Entities/Entity/RibbonDiffXml.

  Puede realizar cambios que se apliquen a todas las tabla definiendo los cambios en las cintas de opciones de la aplicación sustituyendo el símbolo {!EntityLogicalName} en lugar del nombre lógico de una tabla en el nodo RibbonDiffXml. Los cambios a las cintas de opciones de la aplicación que se definen para todas las tablas deben definirse en el nodo ImportExportXml/RibbonDiffXml. No pueden definirse en el nodo RibbonDiffXml de una tabla específica.

Cintas de opciones de cuadrícula

La cinta de opciones de cuadrícula de tabla es una recopilación de pestañas que tienen un valor de identificador que comienza por Mscrm.HomepageGrid.<entity logical name>. Por ejemplo, la pestaña con el texto "Cuentas" en una cuadrícula de tabla de cuenta es Mscrm.HomepageGrid.account.MainTab. Todas las pestañas que se muestren en la cuadrícula de tabla de cuenta tendrán un valor de identificador que comienza por Mscrm.HomepageGrid.account.

Cintas de opciones de subcuadrícula

La cinta de opciones de subcuadrícula de tabla es un grupo contextual con una recopilación de pestañas que tienen un valor de identificador que comienza por Mscrm.SubGrid.<entity logical name>. Por ejemplo, la pestaña con el texto "Cuentas" en una subcuadrícula de tabla de cuenta es Mscrm.SubGrid.account.MainTab.

Cuando se muestre una lista de registros de una tabla en una subcuadrícula en el formulario de otra tabla o en un gráfico, solo habrá tres controles disponibles directamente encima o dentro de la subcuadrícula. Los comportamientos de estos controles se pueden modificar cambiando los comandos que tienen asociados.

• Agregar: el comportamiento predeterminado del comando con el icono depende de si los registros de la subcuadrícula están relacionados con el registro actual.

  Si los registros están relacionados con el registro actual, el comportamiento predeterminado es buscar registros existentes. Si no se encuentra un registro existente, o si el usuario simplemente desea crear un nuevo registro, puede seleccionar Agregar nuevo.

  Si los registros no están relacionados con el registro actual, el comportamiento predeterminado es agregar un nuevo registro. Si la tabla tiene un formulario Creación rápida este se mostrará; si no lo tiene, se mostrará un nuevo formulario completo.

  Las actividades son la excepción a este patrón. El comando de agregar siempre preguntará primero el tipo de actividad.

  Nota

  El modo sin conexión en Dynamics 365 no admite relación de varios a varios en tablas personalizadas. Por este motivo, el botón Agregar nuevo en una subcuadrícula en Dynamics 365 en modo sin conexión no se mostrará.

• Mostrar lista: El comando con el icono abrirá la lista completa donde se pueden usar todos los comandos disponibles.

  Si la subcuadrícula está asociada con el registro actual, el comportamiento predeterminado de este comando es abrir la vista asociada.

  Si la subcuadrícula no está asociada con el registro actual, el comportamiento predeterminado de este comando es abrir la vista en la vista de la lista principal.

• Borrar: el se muestra en el lado derecho de la fila cuando las personas se desplazan sobre los registros de la lista.

  Para los registros con un una relación de 1:N o sin relación, el comportamiento predeterminado es eliminar el registro. La eliminación puede estar bloqueada si está prohibida debido a la configuración de la relación. Las actividades abiertas y las facturas son ejemplos comunes de registros que no pueden eliminarse debido a la configuración de la relación.

  Para las relaciones que muestran relaciones de N:N el comportamiento predeterminado consiste en quitar la relación que une los registros en lugar del registro propiamente dicho.

  Puede cambiar el comportamiento predeterminado cambiando las acciones asociadas con el comando mediante <CommandDefinition>, pero no puede cambiar el nombre del comando. Por ejemplo, puede cambiar la acción de eliminación de modo que desactive el registro en lugar de eliminarlo.

  No es posible cambiar los iconos que se muestran para estos comandos. Puede ocultar estos comandos mediante <HideCustomAction>.

Cintas de opciones de formulario

Nota

Esta característica no se admite en Interfaz unificada.

Cada tabla puede tener varios formularios. Puede definir cambios en la cinta de opciones de formulario para todos los formularios de una tabla agregando la definición en el nivel de tabla (//ImportExportXml/Entities/Entity/RibbonDiffXml).

Cada formulario de tabla puede tener una definición específica de la cinta de opciones. En el archivo customizations.xml exportado, deberá agregar el <RibbonDiffXml> modificado en esta ubicación: //ImportExportXml/Entities/Entity/FormXml/forms/systemform/form/RibbonDiffXml.

La cinta de opciones de formulario de tabla es una recopilación de pestañas que tienen un valor de identificador que comienza por Mscrm.Form.<entity logical name>. Por ejemplo, la pestaña con la etiqueta Cuenta en un formulario de tabla de cuenta es Mscrm.Form.account.MainTab. Todas las pestañas que se muestren en el formulario de cuenta tendrán un valor de identificador que comienza por Mscrm.Form.account.

Pestaña de inicio básica

La pestaña de inicio básica se muestra en la cinta de opciones principal de la aplicación siempre que no se haya definido una pestaña alternativa debido al contexto de la tabla o a una regla de visualización que la suprima para determinadas páginas. Por ejemplo, esta pestaña se muestra cuando se ve la Ayuda de las aplicaciones basadas en modelo. El id. de la pestaña de inicio básica es Mscrm.BasicHomeTab.

Personalización de la barra de comandos global

Puede personalizar la barra de comandos global (Mscrm.GlobalTab) agregando los botones a Mscrm.GlobalTab. Los botones listos para usar en la barra de comandos global actualmente no se pueden modificar, pero se pueden agregar nuevos botones.

Cuando la ubicación de CustomAction se establece en Location="Mscrm.GlobalTab.New.Controls._children, el botón personalizado se muestra en la barra de comandos global de la parte superior de la página.

Nota

Esta característica solo se admite en Interfaz unificada.

Otras cintas de opciones

Diversas cintas de opciones diferentes de propósito especial y un grupo contextual se definen mediante aplicaciones basadas en modelos. Cada pestaña está asociada a una <TabDisplayRule> específica que controla cuándo se muestra. La siguiente tabla muestra estas pestañas.

Pestaña	Identificador raíz	Descripción
Pestaña de la página Editar recurso web.	Mscrm.WebResourceEditTab	Se muestra cuando se editan recursos web dentro de una solución.
Pestana del Editor de formularios	Mscrm.FormEditorTab	Proporciona los grupos de acciones Guardar, Editar, Seleccionar y Ver para los formularios de tabla.
Pestaña Insertar del Editor de formularios	Mscrm.FormEditorInsertTab	Proporciona botones para insertar secciones, pestañas y controles en los formularios de tabla.
Pestaña de la página principal del panel	Mscrm.DashboardTab	Se muestra en el Área de trabajo.
Grupo contextual Herramientas de visualización	Mscrm.VisualizationTools	Se muestra cuando se hace clic en el botón Nuevo gráfico en la pestaña Gráficos que se muestra en la cinta de opciones de cuadrícula de tabla.
Ficha de la página principal de AptbookTab	Mscrm.AptbookTab	Se muestra cuando se visualiza el Calendario de servicios en el área Servicios.
Pestaña Búsqueda avanzada	Mscrm.AdvancedFind	Se muestra en la ventana Búsqueda avanzada.
Pestaña Editor de paneles	Mscrm.DashboardEditorTab	Se muestra cuando se edita un panel.
Pestaña Documentos	Mscrm.DocumentsTab	Se muestra si se ha habilitado la integración de SharePoint para la organización.
Pestaña Editor de gráficos	Mscrm.VisualizationDesignerTab	Se muestra cuando se edita un gráfico desde la ventana de soluciones.
Grupo contextual Herramientas de búsqueda	Mscrm.ArticleSearch	Se muestra cuando se ve la tabla KBarticle.

Cintas de opciones para las páginas personalizadas

Puede mostrar páginas personalizadas en la navegación de la aplicación mediante el mapa del sitio. Estas páginas siempre mostrarán la pestaña de inicio básica (Mscrm.BasicHomeTab).

No es posible usar una regla <PageRule> para habilitar o mostrar componentes de cinta de opciones personalizados en las páginas personalizadas.

Consultar también

Personalizar la cinta
Presentación de la barra de comandos o 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).