Partilhar via

Definir as ações personalizadas para modificar a 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

O padrão, uma barra comandos de aplicativo ou faixa de opções são definidos pelos metadados do Microsoft Dynamics 365. Esses dados padrões não podem ser alterados, mas você pode incluir definições de ações específicas que irão substituir a faixa de opções padrão.

Tipos de ações personalizadas

Há dois tipos de ações personalizadas para faixas de opções:

Ações personalizadas

Uma ação personalizada é uma declaração de como você deseja alterar a definição da faixa de opções padrão. É avaliada e aplicada à faixa de opções no tempo de execução. Para definir o contexto de uma ação personalizada, você deve incluir informações sobre o local dos itens que deseja alterar. Use o atributo Location para especificar onde a alteração se aplica.

Quando você adiciona um novo elemento da faixa de opções, consulte do elemento contido, por exemplo, uma guia ou um grupo existente. Você inclui no sufixo ._children para indicar que esta ação personalizada adicionará algo a um item existente.

Quando você altera a definição de um item existente, o valor Location corresponderá à ID do item.

Você também deve especificar um identificador exclusivo para a ação personalizada. Use o atributo ID para definir para esse valor. É altamente recomendável usar a convenção de nomenclatura que garanta um valor exclusivo. Para consistência e legibilidade, recomendamos usar um ponto para separar componentes consistentes. O primeiro item na convenção de nomenclatura deve ser algo relacionado ao fornecedor de soluções ou à solução, por exemplo, Contoso.contact.form.CustomButton.CustomAction.

Dica

Aplicar de forma consistente suas convenções de nomenclatura do atributo Id aumentará muito sua produtividade ao editar o RibbonDiffXml.

Com base nas informações fornecidas sobre local, o valor de atributo Sequence determina a ordem na qual renderizar itens. Se deseja que um controle personalizado apareça entre dois controles existentes, selecione um valor de sequência que está entre os valores de sequência dos itens existentes.

Ocultar ações personalizadas

Um <HideCustomAction> (RibbonDiffXml) é uma declaração usada quando quiser remover um elemento da faixa de opções existente para que não seja renderizado. Isso não oculta o elemento da faixa de opções, realmente remove um elemento da faixa de opções no tempo de execução de forma que não exista na faixa de opções.

Observação

Como o elemento HideCustomAction remove um nó específico da faixa de opções, remover os elementos da faixa desta maneira não poderá ser a melhor opção para cada situação.

  • Para remover um botão que esteja associado a um privilégio específico, você deve ajustar os privilégios para a entidade nos direitos de acesso da sua implementação. Isso permitirá que a faixa de opções padrão exiba e habilite regras para ocultar ou desabilitar elementos da faixa de opções de usuários que não têm os privilégios necessários para executar as ações.

  • Se desejar substituir um elemento da faixa de opções existente com um elemento da faixa de opções personalizado, substitua o elemento especificando um valor CustomAction.Location idêntico ao elemento existente.

O elemento HideActionId fornece uma ID exclusiva para a ação. Para consistência e legibilidade, execute a mesma convenção de nomenclatura descrita para os elementos <CustomAction>. O atributo Location precisa corresponder à ID do elemento da faixa de opções que deseja remover.

Confira Também

Personalizar os comandos e a faixa de opções
Transmitir dados do Microsoft Dynamics 365 de uma página como parâmetro para as Ações da Faixa de Opções
Definir dimensionamento para os elementos da faixa de opções

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais