Compartilhar via


Um botão na barra de comandos está oculto quando deveria estar visível no Power Apps

Aplica-se a: Power Apps
Número original do KB: 4552163

Determinar por que um botão está oculto

Um botão pode ser ocultado devido a uma regra de habilitação ou regra de exibição no comando associado ao botão avaliado como false. Pode ser que o comando associado tenha uma regra de Mscrm.HideOnModern exibição que ocultaria o botão em aplicativos da Interface Unificada. Um HideCustomAction também poderia ter sido criado para forçar o botão a ser ocultado. Se o usuário estiver offline, os comandos personalizados e os comandos padrão sem a Mscrm.IsEntityAvailableForUserInMocaOffline regra de ativação não serão exibidos.

Aviso

  • Qualquer regra de exibição do tipo EntityPrivilegeRule com um valor PrivilegeType de um dos seguintes (Criar, Gravar, Excluir, Atribuir, Compartilhar) será avaliada como falsa se a entidade tiver a opção Somente Leitura em Dispositivos Móveis habilitada, o que forçará a entidade a permitir apenas o privilégio de Leitura. Exemplos de algumas das regras padrão do sistema mais comuns que serão avaliadas como falsas quando o sinalizador Somente leitura em dispositivos móveis estiver habilitado na entidade são os seguintes, mas não se limitam apenas a esta lista (Mscrm.CreateSelectedEntityPermission, Mscrm.CanSavePrimary, Mscrm.CanWritePrimary, Mscrm.CanWriteSelected, Mscrm.WritePrimaryEntityPermissionMscrm.DeleteSelectedEntityPermissionMscrm.WriteSelectedEntityPermissionMscrm.DeletePrimaryEntityPermissionMscrm.AssignSelectedEntityPermissionMscrm.CanDeletePrimaryMscrm.SharePrimaryPermission, , Mscrm.ShareSelectedEntityPermission Você pode editar a entidade e desmarcar a opção Somente leitura no celular para permitir que essas regras sejam avaliadas como verdadeiras, desde que o privilégio que está sendo testado pela regra também seja concedido ao usuário.
  • Não remova a Mscrm.HideOnModern regra de exibição de um comando para forçar a exibição de um botão na Interface Unificada. Os comandos que têm a Mscrm.HideOnModern regra de exibição destinam-se à interface herdada do Web Client e não têm suporte na Interface Unificada e podem não funcionar corretamente.
  1. Ative o verificador de comandos e selecione o botão de comando a ser inspecionado.

  2. O exemplo a seguir mostra que o botão Novo na página de grade da entidade de contato não está visível e é representado por um item rotulado Novo (oculto).

    Observação

    Se o botão não estiver listado, pode ser devido a uma personalização HideCustomAction que pode ter sido instalada ou o comando associado tem uma regra de Mscrm.HideOnModern exibição. No momento da redação deste guia, a ferramenta Verificador de Comandos não lista os botões que foram ocultados por uma HideCustomAction regra de exibição ou Mscrm.HideOnModern . No momento, estamos trabalhando para aumentar esta listagem para incluir essas informações em uma atualização futura.

    A captura de tela mostra que o botão Novo na página de grade da entidade de contato não está visível e é representado por um item rotulado Novo (oculto).

    Observação

    Se o botão ainda estiver oculto quando todas as regras forem avaliadas como True, pode ser devido a comandos sensíveis ao contexto em grades. Quando os registros são selecionados em uma grade, todos os botões sem um SelectionCountRule elemento serão considerados não relevantes para os registros selecionados. E eles estão ocultos mesmo que sua avaliação de regra seja True. Observe que os submenus não são afetados, pois os filhos do submenu ainda podem ter comandos baseados em registro.

  3. Selecione a guia Propriedades do Comando para exibir os detalhes do comando para este botão. Isso mostrará as regras de habilitação e as regras de exibição, juntamente com o resultado (Verdadeiro, Falso, Ignorado) de cada avaliação de regra. O exemplo a seguir mostra que o comando Mscrm.NewRecordFromGrid do botão Novo (oculto) é e há uma regra de habilitação chamada new.contact.EnableRule.EntityRule que foi avaliada como False, como resultado, o botão ficará oculto.

    A captura de tela mostra os detalhes das propriedades do comando do comando para o botão Novo (oculto).

  4. Expanda a new.contact.EnableRule.EntityRule regra de ativação, selecionando no ícone de divisa para exibir os detalhes da regra. Para entender por que uma regra é avaliada como Verdadeiro ou Falso, é necessário um pouco de compreensão do tipo de regra. Para obter detalhes sobre cada tipo de regra, consulte Definir regras de habilitação da faixa de opções e Definir regras de exibição da faixa de opções. O exemplo a seguir mostra que o tipo de regra é Entidade e o nome lógico da entidade é conta. Como a entidade atual é contato, que não é igual a conta, essa regra retorna False.

    A captura de tela mostra um exemplo para exibir os detalhes da regra.

  5. A abordagem necessária para corrigir a visibilidade de um botão dependerá das várias personalizações em seu cenário específico. Considerando nosso exemplo:

    • Se essa regra foi criada erroneamente, de modo que a entidade declarada na regra deveria ser contato , mas foi definida como conta, você poderá editar a new.contact.EnableRule.EntityRule regra de habilitação e fazer alterações que permitiriam que a regra fosse avaliada como verdadeira.
    • Se essa regra foi adicionada ao comando involuntariamente, você pode modificar o Mscrm.NewRecordFromGrid comando e remover a regra de habilitação new.contact.EnableRule.EntityRule da definição de comando.
    • Se o comando for uma substituição de uma definição publicada pela Microsoft, essa versão personalizada do comando poderá ser excluída para restaurar a funcionalidade padrão.

Opções de reparo

Selecione uma opção de reparo em uma das guias abaixo. A primeira guia é selecionada por padrão.

Como excluir um comando

Se houver outra camada de solução que contenha uma definição de trabalho do comando, você poderá excluir a definição para restaurar a definição de trabalho inativa.

Se esta for a única camada e você não precisar mais do comando, poderá removê-la da sua solução se nenhum outro botão estiver fazendo referência ao comando.

Para excluir um comando, precisamos determinar qual solução instalou a personalização:

  1. Selecione o link Exibir camadas de solução de definição de comando abaixo do nome do comando para exibir as soluções que instalaram uma definição do comando.

    Captura de tela do link Exibir camadas de solução de definição de comando sob um nome de comando.

  2. O painel Camadas de Solução exibirá as camadas de cada definição de componente da faixa de opções que uma solução específica instalou. A camada no topo da lista é a definição atual usada pelo aplicativo, as outras camadas estão inativas e não são usadas pelo aplicativo no momento. Se a solução superior for desinstalada ou uma versão atualizada for instalada que remova a definição, a próxima camada se tornará a definição ativa atual usada pelo aplicativo. Quando uma camada de solução ativa não gerenciada estiver presente, ela sempre será a definição que o aplicativo usa. Se não houver nenhuma solução ativa listada, a solução listada na parte superior da lista será a definição usada pelo aplicativo. Todas as soluções gerenciadas personalizadas que não são publicadas pela Microsoft também terão precedência sobre as camadas de solução publicadas pela Microsoft.

    O contexto Entidade indica o objeto em que a personalização da faixa de opções está, se "Todas as Entidades" estiver listado, a camada será das extensões de cliente da Faixa de Opções do Aplicativo e não específica da entidade, caso contrário, o nome lógico da entidade será listado.

    Quando há duas ou mais camadas, você pode selecionar duas linhas e selecionar Comparar para exibir uma comparação das definições trazidas por cada solução.

    Selecionar Voltar retornará à janela anterior do Verificador de Comandos.

    A imagem a seguir mostra as camadas de solução para o comando em nosso exemplo e indica que há uma camada de solução para a entidade de contato que é uma personalização não gerenciada, conforme indicado pela solução intitulada Ativo. Seu cenário real pode ser diferente, você pode não ter uma camada de solução ativa , pode ter uma solução gerenciada e o nome dessa solução será listado aqui.

    A captura de tela mostra um exemplo da camada de solução.

  3. Agora que revisamos as camadas da solução e identificamos a solução que instalou a personalização, devemos corrigir a definição na solução apropriada.

Selecione uma das seguintes opções que corresponda ao seu cenário específico:

O comando está na solução ativa não gerenciada

Para excluir um comando na camada de solução não gerenciada ativa, exportaremos uma solução não gerenciada que contém a entidade ou a Faixa de Opções do Aplicativo e editaremos o <RibbonDiffXml> nó no arquivo customizations.xml e, em seguida, importaremos uma nova versão dessa solução em que esse comando foi removido para excluir o componente. Consulte Exportar, preparar para editar e importar a faixa de opções.

O comando é específico da entidade

Com base em nosso cenário de exemplo, identificamos que a entidade é contato e o comando que precisa ser excluído é Mscrm.NewRecordFromGrid e é declarado na camada de solução não gerenciada ativa de um editor chamado DefaultPublisherCITTest.

  1. Abra Configurações avançadas.

  2. Navegue até Configurações>Soluções.

  3. Selecione Novo para criar uma nova solução, defina o Publicador como o valor mostrado na listagem de camadas de solução do Verificador de Comandos para o comando e a camada de solução Ativa. (Em nosso exemplo, isso é DefaultPublisherCITTest)

  4. Selecione Entidades>Adicionar existente.

  5. Selecione a entidade em que seu comando está definido (em nosso exemplo, isso é contato) e selecione OK.

  6. Desmarque as opções Incluir metadados da entidade e Adicionar todos os ativos antes de selecionar Concluir.

  7. Selecione Salvar.

  8. Selecione Exportar Solução e exporte a solução não gerenciada.

  9. Extraia o arquivo zip.

  10. Abra o arquivo customizations.xml .

  11. Localize o <Entity> nó filho do nó da entidade que você deseja editar e localize seu nó filho <RibbonDiffXml> .

  12. Localize o <CommandDefinition> nó. (Em nosso exemplo, o <CommandDefinition> ID do nó é Mscrm.NewRecordFromGrid, então localizaríamos o seguinte nó)

    A captura de tela mostra o local do nó CommandDefinition.

  13. Edite o <RibbonDiffXml> nó e remova o nó específico <CommandDefinition> que tem a ID do comando que você deseja excluir. Certifique-se de não excluir acidentalmente outros <CommandDefinition> nós que possam estar presentes. (Com base em nosso exemplo, excluiríamos o nó no qual o <CommandDefinition> ID é Mscrm.NewRecordFromGrid.)

    Captura de tela para excluir o nó CommandDefinition.

  14. Salve o arquivo customizations.xml .

  15. Adicione o arquivo customizations.xml modificado de volta ao arquivo de .zip solução.

  16. Importe o arquivo de solução.

  17. Selecione Publicar Todas as Personalizações.

O comando está na Faixa de Opções do Aplicativo (aplica-se a "Todas as entidades")

Se o comando não for específico da entidade, em vez disso, for aplicável a "Todas as Entidades" declaradas na Faixa de Opções do Aplicativo, as etapas serão ligeiramente diferentes da seguinte maneira:

  1. Abra Configurações avançadas.
  2. Navegue até Configurações>Soluções.
  3. Selecione Novo para criar uma nova solução, defina o Publicador como o valor mostrado na listagem de camadas de solução do Verificador de Comandos para o comando e a camada de solução Ativa.
  4. Selecione Extensões>de cliente Adicionar faixas de opções de aplicativos existentes.>
  5. Selecione Salvar.
  6. Selecione Exportar Solução e exporte a solução não gerenciada.
  7. Extraia o arquivo zip.
  8. Abra o arquivo customizations.xml .
  9. Localize o nó raiz <RibbonDiffXml> .
  10. Localize o <CommandDefinition> nó.
  11. Edite o <RibbonDiffXml> nó e remova o <CommandDefinition> nó que tem a ID do comando que você deseja excluir. Certifique-se de não excluir acidentalmente outros <CommandDefinitions> nós que possam estar presentes.
  12. Salve o arquivo customizations.xml .
  13. Adicione o arquivo customizations.xml modificado de volta à solução compactada .zip arquivo.
  14. Importe o arquivo de solução.
  15. Selecione Publicar Todas as Personalizações.
O comando é de uma solução gerenciada personalizada criada pela minha empresa

Para excluir um comando que foi instalado por uma solução gerenciada personalizada que você criou, siga estas etapas:

  1. Em sua organização de desenvolvimento separada que tem a versão de origem não gerenciada de sua solução personalizada, conclua as etapas listadas acima para a opção O comando está na solução ativa não gerenciada.
  2. Incremente a versão da sua solução personalizada.
  3. Exporte a solução como gerenciada.
  4. Em sua organização afetada separada, importe essa nova versão de sua solução gerenciada personalizada.
O comando é de uma solução gerenciada personalizada que minha empresa não criou (de terceiros/ISV)

Para excluir um comando que foi instalado por uma solução gerenciada personalizada criada por um ISV de terceiros, você precisará entrar em contato com o autor da solução e solicitar uma nova versão da solução que removeu a definição de comando específica e, em seguida, instalar essa nova solução em sua organização afetada.