Faixas de opções disponíveis no Microsoft Dynamics CRM 2015

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Este tópico descreve onde as faixas de opções são definidas e modificadas no Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015.

Neste tópico

Definições da faixa de opções

Faixas de opções da entidade

Guia inicial básica

Faixas de opções do Microsoft Dynamics CRM para Microsoft Office Outlook

Outras faixas de opções

Faixas de opções para páginas personalizadas

Definições da faixa de opções

O Microsoft Dynamics 365 contém definições da <RibbonDiffXml> (RibbonDiffXml) padrões para todas as faixas de opções no aplicativo. Você pode exibir e exportar o XML atual que define a faixa de opções para sua organização, mas não pode atualizar diretamente o XML. Você personaliza a faixa de opções definindo como deseja que seja modificada. As definições de alterações especificadas por você são aplicadas no tempo de execução quando a faixa de opções for exibida no aplicativo. Todas as alterações estarão nos elementos <CustomAction> (RibbonDiffXml) ou <HideCustomAction> (RibbonDiffXml). Esses elementos são aplicados sobre as definições padrão da faixa de opções fornecidas pelo Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015.

Ao escrever suas definições de alteração, você deverá fazer referência com frequência às definições das faixas de opções padrão. Por exemplo, se deseja ocultar um elemento específico da faixa de opções, será necessário conhecer a ID exclusiva do elemento. Se deseja posicionar um novo elemento da faixa de opções dentro ou próximo ao elemento da faixa de opções existente, você precisará conhecer os valores de ID para os elementos, assim como a ordem de sequência que controlará a posição relativa dos elementos.

Por causa deste requisito para fazer referência às definições dos elementos da faixa de opções existentes, é muito importante entender as definições da faixa de opções atuais na sua organização. Há duas mensagens que você pode usar para exportar arquivos XML que representam o estado atual das faixas de opções. Estas definições incluem todas as personalizações que foram aplicadas ao seu sistema para que você possa personalizar qualquer faixa de opções personalizada que foram aplicadas anteriormente. Para obter mais informações, consulte Exportar definições de faixa de opções.

Para ajudá-lo a começar, as configurações das definições da faixa de opções padrão são incluídas nos arquivos para download do SDK do Microsoft Dynamics CRM. A pasta SDK\Resources\ExportedRibbonXml inclui os arquivos de saída que você tem para uma organização com uma faixa de opções que não foi personalizada. Não é necessário executar o aplicativo de exemplo para exportar os dados. Se você tiver personalizado uma faixa de opções, execute o aplicativo de exemplo para atualizar os arquivos nesta pasta com as personalizações aplicadas anteriormente para a organização.

Nos arquivos XML da faixa de opções exportada, o arquivo applicationRibbon.xml inclui todas as faixas de opções que não foram definidas para uma entidade específica. Eles correspondem ao componente de solução Faixas de Opções do Aplicativo. Para cada entidade, você verá um arquivo nome da entidaderibbon.xml. Isso corresponde ao RibbonDiffXml incluído em cada entidade. Para editar a faixa de opções para uma entidade específica, você deverá localizar o arquivo XML da faixa de opções para essa entidade.

Faixas de opções da entidade

Todas as entidades usam uma definição de faixa de opções comum chamada Modelo da Faixa de Opções da Entidade. A definição do modelo da faixa de opções da entidade está localizada no arquivo applicationribbon.xml. Quando você cria uma entidade personalizada, a faixa de opções é exibida na faixa de opções padrão definida no modelo da faixa de opções da entidade. Cada entidade de sistema tem uma definição <RibbonDiffXml> (RibbonDiffXml) separada que é criada pela definição do modelo da faixa de opções de entidade.

No arquivo applicationribbon.xml, você poderá ver as guias a seguir que são aplicadas a todas as entidades:

• Mscrm.Form.{!EntityLogicalName}.MainTab

  A guia exibe o nome de exibição da entidade na etiqueta.

• Mscrm.Form.{!EntityLogicalName}.Related

  A guia tem a etiqueta Adicionar.

• Mscrm.Form.{!EntityLogicalName}.Developer

  A guia tem a etiqueta Personalizar.

• Mscrm.HomepageGrid.{!EntityLogicalName}.MainTab

  A guia exibe o nome de exibição da entidade plural na etiqueta.

• Mscrm.HomepageGrid.{!EntityLogicalName}.View

  A guia tem a etiqueta Exibir.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Related

  A guia tem a etiqueta Adicionar.

• Mscrm.HomepageGrid.{!EntityLogicalName}.Developer

  A guia tem a etiqueta Personalizar.

• Mscrm.SubGrid.{!EntityLogicalName}.ContextualTabs

  Quando uma subgrade em um formulário ou gráfico tiver foco, a guia contextual será exibida com a etiqueta Ferramentas de Lista.

  • Mscrm.SubGrid.{!EntityLogicalName}.MainTab

    A guia exibe o nome de exibição da entidade plural.

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

Você pode fazer as alterações que se aplicam a todas as entidades definindo as alterações às faixas de opções do aplicativo que substituem o token {!EntityLogicalName} no lugar de um nome lógico da entidade no nó RibbonDiffXml. Alterações nas faixas de opções do aplicativo que são definidas para todas as entidades devem ser definidas no nó ImportExportXml/RibbonDiffXml. Elas não podem ser definidas no nó RibbonDiffXml para uma entidade específica.

Faixas de opções de grade

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

Faixas de opções de subgrade

A faixa de opções de subgrade de entidade é um grupo contextual com uma coleção de guias com um valor de atributo de ID começando com Mscrm.SubGrid.<entity logical name>. Por exemplo, a guia com o texto "Contas" na subgrade da entidade da conta é Mscrm.SubGrid.account.MainTab.

Quando uma lista de registros de uma entidade for exibida dentro de uma grade no formulário de outra entidade ou em um gráfico, haverá somente três controles disponíveis diretamente acima ou dentro da subgrade. Os comportamentos destes controles podem ser alterados alterando os comandos com os quais estão associados.

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

  Se os registros estão relacionados ao registro atual, o comportamento padrão é procurar por registros existentes. Se um registro existente não pode ser encontrado ou se o usuário deseja apenas criar um novo registro, é possível clicar em Adicionar Novo.

  Se os registros não estão relacionados ao registro atual, o comportamento padrão é adicionar um novo registro. Se a entidade tem um o formulário de Criação Rápida, ele será exibido. Caso contrário, um novo formulário completo será mostrado.

  Atividades são uma exceção a este padrão. O comando adicionar sempre solicitará pelo tipo de atividade primeiro.

• Mostrar Lista O comando com o ícone abrirá a lista completa onde todos os comandos disponíveis podem ser usados.

  Se a subgrade estiver associada ao registro atual, o comportamento padrão é abrir a exibição associada.

  Se a subgrade não estiver associada ao registro atual, o comportamento padrão é abrir a exibição na exibição de lista principal.

• Excluir O ícone é exibido no lado direito da linha quando as pessoas passarem sobre os registros na lista.

  Para registros com um relacionamento 1:N ou nenhum relacionamento, o comportamento padrão é excluir o registro. A exclusão pode ser bloqueada caso não seja permitida devido às configurações de relacionamento. As atividades abrir e faturas são exemplos comuns de registros que não podem ser excluídos por causa das configurações de relacionamento.

  Para relacionamentos exibindo relações N:N, o comportamento padrão é remover o relacionamento que usará os registros em vez do seu registro.

Você pode alterar o comportamento padrão alterando as ações associadas com o comando usando <CommandDefinition> (RibbonDiffXml), mas não pode alterar o nome de comando. Por exemplo, você pode alterar as ações de exclusão para que desative o registro em vez de excluir.

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

Faixas de opções de formulário

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

Cada formulário de entidade pode ter uma definição da faixa de opções específica. No arquivo customizations.xml exportado, você deve adicionar o <RibbonDiffXml> (FormXml) modificado para esse local://ImportExportXml/Entities/Entity/FormXml/forms/systemform/form/RibbonDiffXml.

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

Guia inicial básica

A guia de início básica é exibida na faixa de opções do aplicativo principal sempre que uma guia alternativa não for definido porque o contexto da entidade ou uma regra de exibição que suprime para páginas específicas. Por exemplo, esta guia é exibida quando você visualiza Microsoft Dynamics 365Ajuda. A ID da guia de início básica é Mscrm.BasicHomeTab.

Faixas de opções do Microsoft Dynamics CRM para Microsoft Office Outlook

Microsoft Office Outlook 2007 não exibe uma faixa.Microsoft Office Outlook 2010 usa a faixa. Você pode usar definições da faixa de opções do Microsoft Dynamics 365 para adicionar controles em todos eles.

Microsoft Office Outlook 2007

Os controles do Microsoft Dynamics CRM para Outlook para oferecer suporte às versões anteriores das barras de ferramentas e menus do Microsoft Office Outlook são definidos como guias com os valores de ID de Mscrm.LegacyOfficeToolbar e Mscrm.LegacyOfficeMenubar, respectivamente.

Microsoft Office Outlook 2010

Os controles do Microsoft Dynamics CRM para Outlook para suportar as barras de ferramentas e menus do Microsoft Office Outlook 2010 são definidos como guias com os valores de ID de Mscrm.Outlook14GlobalToolbar e Mscrm.Outlook14GlobalMenubar, respectivamente.

Outras faixas de opções

Várias outras guias da faixa de opções de objetivo especial e um grupo contextual são definidos pelo Microsoft Dynamics 365. Cada guia é associada a um <TabDisplayRule> (RibbonDiffXml) específico que controla quando serão exibidas. A tabela a seguir alista essas guias.

Faixas de opções para páginas personalizadas

É possível exibir páginas personalizadas na navegação do aplicativo usando o mapa do site. Essas páginas sempre exibirão o Guia inicial básica (Mscrm.BasicHomeTab). Não é possível usar um <PageRule> (RibbonDiffXml) para habilitar ou exibir componentes da faixa de opções personalizados em páginas personalizadas.

Confira Também

Personalizar os comandos e a faixa de opções
Apresentação de comandos em barra ou em faixa de opções

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais