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

  • Artigo

 

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

  • Use o elemento /RuleDefinitions/DisplayRules/<DisplayRule> (RibbonDiffXml) para definir as regras que determinam quando o elemento da faixa de opções deve ser exibido.

  • Use o elemento /CommandDefinitions/CommandDefinition/DisplayRules/<DisplayRule> (RibbonDiffXml) para associar as regras de exibição específicas para uma definição de comando.

Controle quando os elementos da faixa de opções são exibidos

Ao definir regras de exibição em definições de regra, você pode usar a mesma regra de exibição para muitas definições de comando. Quando mais de uma regra de exibição for definida para uma definição de comando, todas as regras de exibição devem avaliar como verdadeiro para que o elemento de faixa de opções seja exibido.

Todas as regras de exibiçã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/DisplayRules/DisplayRule 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. São opções do Type:

    • Web

    • Outlook

  • <CrmOfflineAccessStateRule> (RibbonDiffXml)
    Use este critério para exibir 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. São opções do Type:

    • CrmForOutlook

    • CrmForOutlookOfflineAccess

  • <CrmOutlookClientVersionRule> (RibbonDiffXml)
    Detecta a versão do Microsoft Dynamics 365 para Microsoft Office Outlook.

    Valores válidos:

    • 2003

    • 2007

    • 2010

  • <EntityPrivilegeRule> (RibbonDiffXml)
    Use esse tipo de regra para exibir os elementos de faixa de opções quando um usuário tem privilégios específicos de uma entidade. Você deve especificar a profundidade do privilégio e o privilégio específico que deseja verificar.

  • <EntityPropertyRule> (RibbonDiffXml)
    Permite a definição das regras que dependem dos valores boolianos das propriedades da entidade específica. São opções do PropertyName:

    • DuplicateDetectionEnabled

    • GridFiltersEnabled

    • HasStateCode

    • IsConnectionsEnabled

    • MailMergeEnabled

    • WorksWithQueue

    • HasActivities

    • IsActivity

    • HasNotes

  • <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 algumas 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 de contexto 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.

  • <FormEntityContextRule> (RibbonDiffXml)
    Especifica uma regra que pode detectar se uma faixa de opções de formulário é exibida no contexto de uma entidade específica.

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

    • Create

    • Existing

    • ReadOnly

    • Disabled

    • BulkEdit

  • <FormTypeRule> (RibbonDiffXml)
    Especifica uma função que detecta o tipo do formulário do Microsoft Dynamics 365.

    Os valores Type correspondem ao seguinte:

    Valor

    Apresentação

    Main

    Um formulário de entidade exibido no aplicativo.

    Preview

    O formulário de visualização de entidade exibido como um elemento expandindo na grade.

    AppointmentBook

    Usado com entidades de compromisso, equipamento, serviceappointment e systemuser para a interface do usuário de Agendamento de serviços.

    Dashboard

    O formulário define um painel.

    Quick

    Um formulário de visualização rápida.

    QuickCreate

    Um formulário de criação rápida.

  • <HideForTabletExperienceRule> (RibbonDiffXml)
    Especifica uma regra que retornará false quando o aplicativo Web for exibido em um navegador móvel em um tablet.

  • <MiscellaneousPrivilegeRule> (RibbonDiffXml)
    Use esse tipo de regra para verificar se há privilégios que não se aplicam a uma entidade específica, como ExportToExcel, MailMerge ou GoOffline.

  • <OrganizationSettingRule> (RibbonDiffXml)
    Use isto para exibir um elemento da faixa de opções se as configurações de organização específicas estiverem habilitadas. As opções de configuração são as seguintes:

    • IsSharepointEnabled

    • IsSOPIntegrationEnabled

    • IsFiscalCalendarDefined

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

  • <OutlookRenderTypeRule> (RibbonDiffXml)
    Use essa opção para exibir um elemento se a faixa for exibida no Microsoft Outlook de uma forma específica. São opções do Type:

    • Web

    • Outlook

  • <OutlookVersionRule> (RibbonDiffXml)
    Use para exibir um elemento da faixa para uma versão específica do Microsoft Outlook. São opções do Version:

    • 2003

    • 2007

    • 2010

  • <PageRule> (RibbonDiffXml)
    Esse tipo de regra verifica se a URL da página está sendo exibida. Ela retorna verdadeiro se o endereço correspondente.

  • <RelationshipTypeRule> (RibbonDiffXml)
    Esse tipo de regra é aplicada aos registros selecionados em uma grade. Ela permite determinar o tipo de relacionamento, como a seguir:

    • OneToMany

    • ManyToMany

    • NoRelationship

  • <SkuRule> (RibbonDiffXml)
    Use esse tipo de regra para exibir 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.

    Observação

    Para os comandos definidos para a subgrade em formulários com a experiência do usuário atualizada, as regras de valores não podem ser usadas em regras de exibição. Use este elemento em um <EnableRule> (RibbonDiffXml) para ocultar um elemento.

Confira Também

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

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais