Definir regras de habilitação da faixa de opções

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Ao configurar os elementos da faixa de opções, você pode definir regras específicas para acompanhar quando os elementos da faixa de opções serão habilitados. O elemento <EnableRule> (RibbonDiffXml) é usado como a seguir:

• Use o elemento /RuleDefinitions/EnableRules/EnableRule para definir as regras que determinam quando o elemento da faixa de opções deve ser habilitado.

• Use o elemento /CommandDefinitions/CommandDefinition/EnableRules/EnableRule para associar as regras de habilitação específicas para uma definição de comando.

O que habilitado significa?

Na barra de comandos, os comandos que estão desabilitados são ocultado. Com a faixa de opções, os comandos que são desabilitados estão visíveis, mas não respondem a eventos.

Controle quando os elementos da faixa de opções estão habilitados

Habilite regras destinadas a serem reutilizadas. Ao definir com definições de regra, você pode usar a mesma regra de habilitação para muitas definições de comando. Quando mais de uma regra de habilitação for definida para uma definição de comando, todas as regras de habilitação devem avaliar como verdadeiro para que o elemento de faixa de opções seja habilitado.

Todas as regras de habilitação fornecem um atributo opcional para especificar se o valor padrão das regras é verdadeiro ou falso e um atributo InvertResult opcional para permitir o retorno de um resultado negativo quando o item que está sendo testado retornar verdadeiro.

O elemento /RuleDefinitions/EnableRules/EnableRule suporta os seguintes tipos de regras:

• <CommandClientTypeRule> (RibbonDiffXml)
  Especifica uma regra que detecta o tipo de apresentação que está sendo usado.

  Os valores Type correspondem ao seguinte:

  Valor	Apresentação
  Modern	A barra de comando é apresentada usando Microsoft Dynamics 365 para Tablets.
  Refresh	A barra de comandos é apresentada usando a interface do usuário atualizada.
  Legacy	A faixa de opções é apresentada nos formulários de entidades que ainda não foram atualizadas ou em uma exibição de lista em Microsoft Dynamics 365 para Outlook.

• <CrmClientTypeRule> (RibbonDiffXml)
  Permite a definição de regras, dependendo do tipo do cliente usado. As opções de tipo são as seguintes:

  • Web

  • Outlook

• <CrmOfflineAccessStateRule> (RibbonDiffXml)
  Use este critério para habilitar um elemento de faixa de opções com base em se Microsoft Dynamics 365 para Microsoft Office Outlook com Acesso Offline está atualmente off-line.

• <CrmOutlookClientTypeRule> (RibbonDiffXml)
  Use esta regra se você quiser exibir apenas um botão para um tipo específico de Microsoft Dynamics 365 para Outlook. As opções de tipo são as seguintes:

  • CrmForOutlook

  • CrmForOutlookOfflineAccess

• <CustomRule> (RibbonDiffXml)
  Use esse tipo de regra para chamar uma função em uma Biblioteca Javascript que retorna um valor booleano.

  Observação

  Regras fiscais que não retornam um valor rapidamente podem afetar o desempenho da faixa de opções. Se você precisa realizar a lógica que pode demorar um pouco de tempo para concluir, use a seguinte estratégia para tornar sua regra personalizada assíncrona:

  1. Defina uma regra que verifica um objeto personalizado. Você pode verificar um objeto como Window.ContosoCustomObject.RuleIsTrue que você acabou de anexar à janela.

  2. Se esse objeto existir, devolva.

  3. Se esse objeto não existir, defina o objeto e defina o valor como false.

  4. Antes de retornar um valor, use settimeout para executar uma função de retorno assíncrono para redefinir o objeto. Retorne false.

  5. Depois que a função de retorno de chamada tiver realizado as operações necessárias para determinar o resultado correto, defina o valor do objeto e use o método refreshRibbon para atualizar a faixa de opções.

  6. Quando a faixa de opções for atualizada, detecta o objeto junto com o valor preciso definido e a regra é avaliada.

• <EntityRule> (RibbonDiffXml)
  As regras da entidade permitem a avaliação da entidade atual. Isso é útil quando você define ações personalizadas que se aplicam ao Modelo de Entidade, em vez de entidades específicas. Por exemplo, talvez você queira adicionar um elemento de faixa de opções para todas as entidades, exceto para várias entidades específicas. É mais fácil definir a ação personalizada do Modelo de Entidade que se aplica a todas as entidades e depois utilizar uma Regra de Entidade para filtrar aquelas que devem ser excluídas.

  A regra da entidade também inclui um atributo Context opcional para especificar se a entidade está sendo exibida no formulário ou em uma lista (HomePageGrid). O atributo AppliesTo opcional pode ser definido como PrimaryEntity ou SelectedEntity para fazer distinção se a entidade está sendo exibida em uma subgrade.

• <FormStateRule> (RibbonDiffXml)
  Use a regra FormState para determinar o tipo atual do formulário que está exibindo um registro. As opções de estado são as seguintes:

  • Create

  • Existing

  • ReadOnly

  • Disabled

  • BulkEdit

• <OrRule> (RibbonDiffXml)
  A OrRule permite que você substitua o padrão E a comparação de vários tipos de regras de habilitação. Use o elemento OrRule para definir várias combinações válidas possíveis para verificar.

• <OutlookItemTrackingRule> (RibbonDiffXml)
  Use o atributo TrackedInCrm para esse elemento para determinar se o registro está sendo acompanhado no Microsoft Dynamics 365.

• <OutlookVersionRule> (RibbonDiffXml)
  Use essa opção para habilitar um elemento da faixa de opções para uma versão específica do Microsoft Office Outlook.

  • 2003

  • 2007

  • 2010

• <PageRule> (RibbonDiffXml)
  Esse tipo de regra verifica se a URL da página está sendo exibida. Retorna returns se o Address corresponder.

• <RecordPrivilegeRule> (RibbonDiffXml)
  Use esta regra para determinar se o usuário atual tem privilégios em um registro específico. Esses privilégios são diferentes do privilégio de entidade porque os privilégios podem incluir ganhos por outro usuário que compartilha o registro com o usuário atual.

• <SelectionCountRule> (RibbonDiffXml)
  Use esse tipo de regras com uma faixa de opções exibida para uma lista que habilita um botão ao especificar os números máximo e mínimo de registros na grade selecionados. Por exemplo, se o botão mescla registros, você deve garantir que pelo menos dois registros estão selecionados antes de habilitar o controle da faixa de opções.

• <SkuRule> (RibbonDiffXml)
  Use esse tipo de regra para habilitar um elemento de faixa de opções para uma versão SKU específica de Microsoft Dynamics 365, como segue:

  • OnPremise

  • Online

  • Spla

• <ValueRule> (RibbonDiffXml)
  Use esta regra para verificar o valor de um campo específico do registro que está sendo exibido no formulário. Você deve especificar Field e Value para verificar.

Confira Também

Personalizar os comandos e a faixa de opções
Definir comandos da faixa de opções
Definir regras de exibição da faixa de opções

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais