Faixas de opções em aplicativos controlados por modelos: definições e tipos

Este artigo explica onde definir e modificar faixas de opções em aplicativos controlados por modelos. Use-o para identificar o local XML para alterações de tabela, grade, subgrid, formulário, faixa de opções de página global e personalizada.

Definições da faixa de opções

Os aplicativos controlados por modelos contêm definições padrão <RibbonDiffXml> para todas as faixas de opções no aplicativo. Você pode exportar e exibir o XML atual definindo a faixa de opções para sua organização, mas não é possível atualizar o XML diretamente. Você personaliza a faixa de opções definindo como deseja que ela seja alterada. As definições de alteração especificadas são aplicadas no runtime quando a faixa de opções é exibida no aplicativo. Todas as suas alterações estarão nos elementos ou <HideCustomAction> nos <CustomAction> elementos. Esses elementos são aplicados sobre as definições de faixa de opções padrão fornecidas por aplicativos controlados por modelos.

Ao escrever suas definições de alteração, você precisará referenciar com frequência as definições das faixas de opções padrão. Por exemplo, se você quiser ocultar um elemento de faixa de opções específico, precisará saber a ID exclusiva desse elemento. Se você quiser posicionar um novo elemento de faixa de opções dentro ou ao lado de um elemento de faixa de opções existente, precisará saber os valores de ID desses elementos, bem como a ordem de sequência que controlará a posição relativa dos elementos.

Devido a esse requisito para fazer referência às definições de elementos de faixa de opções existentes, é importante entender as definições atuais da faixa de opções em sua organização. Há duas mensagens que você pode usar para exportar arquivos XML que representam o estado atual das faixas de opções. Essas definições incluem todas as personalizações que já foram aplicadas ao seu sistema para que você possa personalizar todas as faixas de opções personalizadas que foram aplicadas anteriormente. Para obter mais informações, consulte Exportar Definições da Faixa de Opções.

Para ajudá-lo a começar, você pode baixar as definições de faixa de opções padrão para aplicativos controlados por modelos do exemplo Exportar Definições da Faixa de Opções. The ExportedRibbonXml o arquivo inclui os arquivos de saída que você teria para uma organização.

Dentro dos arquivos XML da faixa de opções exportados, o arquivo applicationRibbon.xml inclui todas as faixas de opções que não estão definidas para uma tabela específica. Elas correspondem ao componente da solução Application Ribbons . Para cada tabela, você encontrará um nome de tabelaribbon.xml arquivo. Isso corresponde ao RibbonDiffXml que está incluído em cada tabela. Se você quiser editar a faixa de opções de uma tabela específica, localize o arquivo XML da faixa de opções para essa tabela.

Faixas de opções de tabela

Todas as tabelas usam uma definição de faixa de opções comum chamada Modelo da Faixa de Opções de Tabela. A definição do modelo da faixa de opções da tabela está localizada no applicationribbon.xml arquivo. Quando você cria uma tabela personalizada, a faixa de opções que você vê é a faixa de opções padrão definida pelo modelo de faixa de opções da tabela. Cada tabela do sistema tem uma definição separada <RibbonDiffXml> que se baseia na definição do modelo da faixa de opções da tabela.

No arquivo applicationribbon.xml, você pode ver as seguintes guias que se aplicam a todas as tabelas:

• Mscrm.Form.{!EntityLogicalName}.MainTab

  Tab exibe o nome de exibição da tabela no rótulo.

• Mscrm.Form.{!EntityLogicalName}.Related

  Tab tem o rótulo Adicionar.

• Mscrm.Form.{!EntityLogicalName}.Developer

  Tab tem o rótulo Personalizar.

• Mscrm.HomepageGrid.{!EntityLogicalName}.MainTab

  Tab exibe o nome de exibição da tabela plural no rótulo.

• Mscrm.HomepageGrid.{!EntityLogicalName}.View

  Tab tem o modo de exibição de rótulo.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Related

  Tab tem o rótulo Adicionar.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Developer

  Tab tem o rótulo Personalizar.

• Mscrm.SubGrid.{!EntityLogicalName}.ContextualTabs

  Quando uma sub-grade em um formulário ou gráfico tem foco, a guia contextual é exibida com as Ferramentas de Lista de rótulos.

  • Mscrm.SubGrid.{!EntityLogicalName}.MainTab

    Tab exibe o nome de exibição da tabela plural.

  Ao exibir as definições da faixa de opções para uma tabela específica, você verá que o nome da tabela geralmente substitui o {!EntityLogicalName} token. Quando você vê o {!EntityLogicalName} token na definição da faixa de opções para uma tabela específica, isso significa que não há uma definição específica para essa tabela e ela simplesmente usa a definição do modelo de faixa de opções da tabela. Quando você define faixas de opções para uma tabela específica, sempre use o nome da tabela real. As modificações da faixa de opções para uma tabela específica devem ser definidas no //ImportExportXml/Entities/Entity/RibbonDiffXml nó.

  Você pode fazer alterações que se aplicam a todas as tabelas definindo as alterações nas faixas de opções do aplicativo substituindo o token {!EntityLogicalName} no lugar de um nome lógico de tabela no nó RibbonDiffXml. As alterações nas faixas de opções de aplicativo definidas para todas as tabelas devem ser definidas no ImportExportXml/RibbonDiffXml nó. Eles não podem ser definidos no nó RibbonDiffXml para uma tabela específica.

Faixas de opções de grade

A faixa de opções da grade da tabela é uma coleção de guias que têm um valor de ID começando com Mscrm.HomepageGrid.<entity logical name>. Por exemplo, a guia com o texto "Contas" em uma grade de tabela de conta é Mscrm.HomepageGrid.account.MainTab. Todas as guias exibidas na grade da tabela da conta terão um valor de ID que começa com Mscrm.HomepageGrid.account.

Faixas de opções de subgrid

A faixa de opções de subgrid da tabela é um grupo contextual com uma coleção de guias que têm um valor de ID começando com Mscrm.SubGrid.<entity logical name>. Por exemplo, a guia com o texto "Contas" na sub-grade da tabela de conta é Mscrm.SubGrid.account.MainTab.

Quando uma lista de registros de uma tabela é exibida dentro de uma sub-grade na forma de outra tabela ou em um gráfico, haverá apenas três controles disponíveis diretamente acima ou dentro da subgrid. Os comportamentos desses controles podem ser modificados alterando os comandos aos quais estão associados.

• Adicionar: o comportamento padrão do comando com o ícone depende se os registros na subgrid estão relacionados ao registro atual.

  Se os registros estiverem relacionados ao registro atual, o comportamento padrão será procurar registros existentes. Se um registro existente não puder ser encontrado ou se o usuário simplesmente quiser criar um novo registro, ele poderá selecionar Adicionar Novo.

  Se os registros não estiverem relacionados ao registro atual, o comportamento padrão será adicionar um novo registro. Se a tabela tiver um formulário de Criação Rápida, isso será exibido, caso contrário, um novo formulário completo será mostrado.

  As atividades são a exceção a esse padrão. O comando adicionar sempre solicitará o tipo de atividade primeiro.

  Note

  O modo offline no Dynamics 365 não dá suporte à relação muitos para muitos em tabelas personalizadas. Devido a isso, o botão Adicionar Novo em uma sub-grade em Dynamics 365 modo offline não será exibido.

• Mostrar Lista: o comando com o ícone abre a lista completa em que você pode usar todos os comandos disponíveis.

  Se a subgrid estiver associada ao registro atual, o comportamento padrão desse comando será abrir a exibição associada.

  Se a subgrid não estiver associada ao registro atual, o comportamento padrão desse comando será abrir a exibição no modo de exibição de lista principal.

• Excluir: o ícone aparece no lado direito da linha quando você passa o mouse sobre os registros na lista.

  Para registros com uma relação 1:N ou nenhuma relação, o comportamento padrão é excluir o registro. A exclusão poderá ser bloqueada se não for permitida devido a configurações de relação. Atividades abertas e faturas são exemplos comuns de registros que podem não ser excluídos devido a configurações de relação.

  Para relações que exibem relações N:N, o comportamento padrão é remover a relação que une os registros em vez do próprio registro.

  Você pode alterar o comportamento padrão alterando as ações associadas ao comando usando <CommandDefinition>, mas não pode alterar o nome do comando. Por exemplo, você pode alterar a ação de exclusão para que ela desative o registro em vez de excluí-lo.

  Não é possível alterar os ícones exibidos para esses comandos. Você pode ocultar esses comandos usando <HideCustomAction>.

Faixas de opções de formulário

Cada tabela pode ter vários formulários. Você pode definir alterações na faixa de opções de formulário para todos os formulários para essa tabela adicionando sua definição no nível da tabela (//ImportExportXml/Entities/Entity/RibbonDiffXml).

Cada formulário de tabela pode ter uma definição de faixa de opções específica. No arquivo de customizations.xml exportado, você deve adicionar sua modificação <RibbonDiffXml> a este local://ImportExportXml/Entities/Entity/FormXml/forms/systemform/form/RibbonDiffXml.

A faixa de opções de formulário é uma coleção de guias que têm um valor de ID começando com Mscrm.Form.<entity logical name>. Por exemplo, a guia com o rótulo Conta no formulário de conta é Mscrm.Form.account.MainTab. Todas as guias exibidas no formulário da conta terão um valor de ID que começa com Mscrm.Form.account.

Guia base básica

A guia inicial básica é exibida na faixa de opções do aplicativo principal sempre que uma guia alternativa não é definida devido ao contexto da tabela ou a uma regra de exibição que a suprime para páginas específicas. Por exemplo, essa guia é exibida quando você exibe a Ajuda de aplicativos controlados por modelos. A ID da guia inicial básica é Mscrm.BasicHomeTab.

Personalizar a barra de comandos global

Você pode personalizar a barra de comandos global (Mscrm.GlobalTab) adicionando os botões a Mscrm.GlobalTab. Os botões prontos para uso na barra de comandos global atualmente não podem ser modificados, mas novos botões podem ser adicionados.

Quando o local do está definido comoLocation="Mscrm.GlobalTab.New.Controls._children, o CustomAction botão personalizado é exibido na barra de comandos global na parte superior da página.

Outras faixas de opções

Várias outras guias de faixa de opções de finalidade especial e um grupo contextual são definidos por aplicativos controlados por modelos. Cada guia é associada a um específico <TabDisplayRule> que controla quando eles serão exibidos. A tabela a seguir lista essas guias.

Faixas de opções para páginas personalizadas

Você pode exibir páginas personalizadas na navegação do aplicativo usando o SiteMap. Essas páginas sempre exibirão a guia Página Inicial Básica (Mscrm.BasicHomeTab).

Não é possível usar um <PageRule> para habilitar ou exibir componentes personalizados da faixa de opções em páginas personalizadas.

Consulte também

Personalizar a faixa de opções
Barra de comandos ou apresentação da faixa de opções