Um botão na barra de comandos fica visível quando deve ser oculto
Artigo
Aplica-se a: Power Apps Número de KB original: 4552163
Determinar por que um botão está visível
Um botão ficará visível se todas as regras de habilitação e as regras de exibição no comando associado ao botão forem avaliadas como true. Se isso for inesperado, é possível que a definição de comando tenha sido substituída e esteja ausente de regras de habilitação ou regras de exibição, ou as próprias definições de regra sejam substituídas e fazendo com que o botão fique visível quando você espera que ele fique oculto.
Não remova a Mscrm.HideOnModern regra de exibição de um comando para forçar um botão a aparecer na Interface Unificada. Os comandos que têm a Mscrm.HideOnModern regra de exibição são destinados à interface herdada do Cliente Web e não têm suporte na Interface Unificada e podem não funcionar corretamente.
O exemplo a seguir mostra dois botões de compromisso na página de grade de atividades e espera-se que um esteja oculto.
Selecione a guia Propriedades de Comando para exibir os detalhes do comando para este botão. Isso exibirá as ações, habilitará regras e exibirá regras, juntamente com o resultado (True, False, Skipped) de cada avaliação de regra. Examine as regras de habilitação e as regras de exibição, se você espera que uma regra específica esteja avaliando como false, então é possível que a regra seja personalizada incorretamente ou as circunstâncias necessárias para retornar um resultado falso não sejam atendidas. Se assim for, pule para a etapa 9, caso contrário, é possível que o comando esteja ausente de uma regra ou regras e exibiremos as camadas de solução de comando para análise posterior.
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.
O painel Camadas de Solução exibirá a camada de cada definição de componente de faixa de opções que uma solução específica instalou. A camada na parte superior da lista é a definição atual que é usada pelo aplicativo, as outras camadas estão inativas e não são usadas pelo aplicativo no momento. Se a solução superior estiver 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 Active não gerenciada estiver presente, 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 forem publicadas pela Microsoft também terão precedência sobre as camadas de solução publicadas pela Microsoft.
O contexto Entity indica o objeto em que a personalização da faixa de opções está, se "Todas as Entidades" estiver listada, a camada será das extensões de cliente da Application Ribbon e não da entidade específica, caso contrário, o nome lógico da entidade será listado.
Quando houver 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.
Se houver apenas uma camada de solução, pule para a etapa 9, caso contrário, selecione as duas principais camadas de solução (Se você tiver uma camada na solução Active, mas ela não estiver listada na parte superior, selecione a camada de solução Ativa e, em seguida, a linha superior) e selecione Comparar.
A comparação da definição ativa atual e da definição inativa anterior será exibida mostrando as diferenças, se houver. O exemplo a seguir mostra que a definição ativa não gerenciada foi personalizada com a remoção de uma regra Mscrm.HideOnModern de exibição incluída na camada de solução publicada pela Microsoft inativa msdynce_ActivitiesPatch .
A abordagem necessária para corrigir a visibilidade de um botão dependerá das várias personalizações em seu cenário específico. Se você determinou que uma regra está avaliando incorretamente como false, e se a definição de regra estiver definida incorretamente, você deverá modificar a definição da regra e fazer alterações que permitam que a regra seja avaliada como falsa sob as circunstâncias adequadas. Se a definição de regra estiver correta, é possível que os requisitos que fariam a regra retornar false não sejam atendidos, como um valor de campo ou privilégio de segurança não é atribuído corretamente. Dependendo da definição de regra, os requisitos podem variar muito, consulte Definir regras de habilitação de faixa de opções e Definir regras de exibição de faixa de opções. Considerando nosso exemplo, o comando foi personalizado com a remoção de uma Mscrm.HideOnModern regra de exibição. Essa regra de exibição destina-se a ocultar esse botão específico de ser exibido em aplicativos de Interface Unificada e ficar visível apenas na interface herdada do Cliente Web. Podemos modificar a versão personalizada do comando e adicionar a regra de exibição ausente Mscrm.HideOnModern à definição de comando. Como essa é uma substituição personalizada de uma definição publicada pela Microsoft e não há outras modificações intencionais, é recomendável que essa versão personalizada do comando seja 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.
Se houver outra camada de solução que contenha uma definição de trabalho desse comando, você poderá excluir essa definição para restaurar a próxima definição de trabalho inativa.
Se essa for a única camada e você não precisar mais do comando, poderá removê-la de sua solução se nenhum outro botão estiver fazendo referência ao comando.
Selecione uma das seguintes opções que correspondem ao seu cenário específico:
O comando está na solução Active não gerenciada
Para excluir um comando na camada de solução não gerenciada do Active , exportaremos uma solução não gerenciada contendo a entidade ou o Application Ribbon e editaremos o <RibbonDiffXml> nó no arquivo customizations.xml e 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 é activitypointer e o comando que precisa ser excluído é Mscrm.CreateAppointment e é declarado na camada de solução não gerenciada ativa de um editor chamado DefaultPublisherCITest.
Abra Configurações Avançadas.
Navegue até Configurações ->Soluções.
Selecione Novo para criar uma nova solução, defina Publisher como o valor mostrado na lista de camadas de solução do Verificador de Comando para o comando e a camada de solução Ativa. (Em nosso exemplo, este é DefaultPublisherCITTest).
Selecione Entidades>adicionar existentes.
Selecione a entidade em que seu comando está definido (em nosso exemplo, este é o ponto de atividade) e selecione OK.
Desmarque os metadados Incluir entidade e desmarque Adicionar todas as opções de ativos antes de selecionar Concluir.
Selecione Salvar.
Selecione Exportar solução e exportar a solução não gerenciada.
Extraia o arquivo .zip.
Abra o arquivo customizations.xml .
Localize o <Entity> nó filho do nó da entidade que você deseja editar e localizar seu nó filho <RibbonDiffXml> .
Localize o <CommandDefinition> nó (Em nosso exemplo, a ID do <CommandDefinition> nó é Mscrm.CreateAppointment, portanto, localizaríamos o nó a seguir).
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 involuntariamente outros <CommandDefinition> nós que possam estar presentes. (Com base em nosso exemplo, excluiríamos o nó no qual a <CommandDefinition> ID é Mscrm.CreateAppointment.)
Salve o arquivo customizations.xml .
Adicione o arquivo decustomizations.xml modificado de volta ao arquivo .zip da solução.
Importe o arquivo da solução.
Selecione Publicar Todas as Personalizações.
O comando está na Faixa de Opções de Aplicativo (se aplica a "Todas as entidades")
Se o comando não for específico da entidade, em vez disso, ele será aplicável a "Todas as Entidades" declaradas na Faixa de Opções de Aplicativo, as etapas serão ligeiramente diferentes da seguinte maneira:
Abra Configurações Avançadas.
Navegar até Soluções de Configurações>
Selecione Novo para criar uma nova solução, defina Publisher como o valor mostrado na lista de camadas de solução do Verificador de Comando para o comando e a camada de solução Ativa.
Selecione Extensões de Cliente Adicionar Faixas>de Opções de Aplicativo Existentes>.
Selecione Salvar.
Selecione Exportar solução e exportar a solução não gerenciada.
Extraia o arquivo .zip.
Abra o arquivo customizations.xml .
Localize o nó raiz <RibbonDiffXml> .
Localize o <CommandDefinition>.
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 involuntariamente outros <CommandDefinition> nós que possam estar presentes.
Salve o arquivo customizations.xml .
Adicione o arquivo decustomizations.xml modificado de volta ao arquivo de .zip de solução compactada.
Importe o arquivo da solução.
Selecione Publicar Todas as Personalizações.
O comando é de uma solução gerenciada personalizada que minha empresa criou
Para excluir um comando instalado por uma solução gerenciada personalizada que você criou, siga estas etapas:
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 o comando está na opção de solução Active não gerenciada .
Incremente a versão da solução personalizada.
Exportar solução como gerenciada.
Em sua organização afetada separada, importe esta nova versão da sua solução gerenciada sob medida.
O comando é de uma solução gerenciada personalizada que minha empresa não criou (de terceiros/ISV)
Para excluir um comando instalado por uma solução gerenciada personalizada que foi criada por terceiros/ISV, 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 instalar essa nova solução em sua organização afetada.
Como adicionar regras de habilitação/exibição ausentes ao comando
Se houver modificações no comando que você precisa reter, mas ainda quiser que o botão fique oculto sob as circunstâncias apropriadas, você poderá adicionar as regras de habilitação/exibição ausentes ao comando em vez de excluir a definição personalizada.
Selecione uma das seguintes opções que correspondem ao seu cenário específico:
O comando está na solução Active não gerenciada
Se você determinou que as regras de habilitação/exibição estão ausentes da definição de comando, você poderá modificar o <CommandDefinition> nó e adicionar as regras para alcançar o comportamento desejado. Para corrigir um comando na camada de solução não gerenciada do Active , exportaremos uma solução não gerenciada contendo a entidade ou o Application Ribbon e editaremos o <RibbonDiffXml> nó no arquivo customizations.xml e importaremos uma nova versão dessa solução que contém a definição de comando fixa. 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 é activitypointer e o comando que precisa ser corrigido é Mscrm.CreateAppointment e é declarado na camada de solução não gerenciada ativa de um editor chamado DefaultPublisherCITTest.
Abra Configurações Avançadas.
Navegue até Soluções de Configurações>.
Selecione Novo para criar uma nova solução, defina Publisher como o valor mostrado na lista de camadas de solução do Verificador de Comando para o comando e a camada de solução Ativa. (Em nosso exemplo, este é DefaultPublisherCITTest)
Selecione Entidades>adicionar existentes.
Selecione a entidade em que seu comando está definido (em nosso exemplo, este é o ponto de atividade) e selecione OK.
Desmarque os metadados Incluir entidade e Adicione todas as opções de ativos antes de selecionar Concluir.
Selecione Salvar.
Selecione Exportar solução e exportar a solução não gerenciada.
Extraia o arquivo .zip.
Abra o arquivo customizations.xml .
Localize o <Entity> nó filho do nó de entidade que você deseja editar e localize seu nó filho <RibbonDiffXml> .
Localize o <CommandDefinition> nó. No exemplo, a ID do <CommandDefinition> nó é Mscrm.CreateAppointment. Portanto, você localizaria o seguinte nó:
Edite o <RibbonDiffXml> nó e faça as alterações necessárias no <CommandDefinition> nó que permitirá que o comando funcione corretamente sob as circunstâncias corretas para corrigir o comando. Para obter mais informações sobre como declarar comandos, consulte Definir comandos de faixa de opções. (Com base em nosso exemplo, modificaríamos o <CommandDefinition> nó adicionando a regra de Mscrm.HideOnModern exibição que ocultará corretamente este botão.)
Restaure o arquivo decustomizations.xml modificado para o arquivo de .zip da solução.
Importe o arquivo da solução.
Selecione Publicar Todas as Personalizações.
O comando está na Faixa de Opções de Aplicativo (se aplica a "Todas as entidades")
Se o comando não for específico da entidade, em vez disso, ele será aplicável a "Todas as entidades" declaradas na Faixa de Opções de Aplicativo, as etapas serão ligeiramente diferentes da seguinte maneira:
Abra Configurações Avançadas.
Navegue até Soluções de Configurações>.
Selecione Novo para criar uma nova solução, defina Publisher como o valor mostrado na lista de camadas de solução do Verificador de Comando para o comando e a camada de solução Ativa.
Selecione Extensões de Cliente Adicionar Faixas>de Opções de Aplicativo Existentes>.
Selecione Salvar.
Selecione Exportar solução e exportar a solução não gerenciada.
Extraia o arquivo .zip.
Abra o arquivo customizations.xml .
Localize o nó raiz <RibbonDiffXml> .
Localize o <CommandDefinition>.
Edite <RibbonDiffXml> e faça as alterações necessárias no <CommandDefinition> nó que permitirá que o comando funcione corretamente sob as circunstâncias corretas para corrigir o comando. Para obter mais informações sobre como declarar comandos, consulte Definir comandos de faixa de opções.
Adicione o arquivo decustomizations.xml modificado de volta ao arquivo .zip da solução.
Importe o arquivo da solução.
Selecione Publicar Todas as Personalizações.
O comando é de uma solução gerenciada personalizada que eu criei
Para corrigir um comando instalado por uma solução gerenciada personalizada que você criou, siga estas etapas:
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 o comando está na opção de solução Active não gerenciada .
Incremente a versão da solução personalizada.
Exportar solução como gerenciada.
Em sua organização afetada separada, importe esta nova versão da sua solução gerenciada sob medida.
O comando é de uma solução gerenciada personalizada que eu não criei ou minha organização não possui (ou seja, de terceiros/ISV)
Para corrigir um comando instalado por uma solução gerenciada personalizada que foi criada por terceiros/ISV, você precisará entrar em contato com o autor da solução e solicitar uma nova versão da solução que contém a definição de comando fixa e instalar essa nova solução em sua organização afetada.
O comando está em uma solução gerenciada publicada pela Microsoft
Para corrigir um comando instalado por uma solução gerenciada publicada pela Microsoft, você pode precisar de uma versão mais recente da solução a ser instalada, o que normalmente seria feito durante uma atualização de versão. É possível que você tenha identificado um bug que ainda precisa ser corrigido. Entre em contato com o suporte ao cliente para obter assistência.
Como corrigir uma regra de habilitação/exibição
Selecione o link Exibir camadas de solução de definição de regra abaixo do nome da regra para exibir as soluções que instalaram uma definição da regra.
O painel Camadas de Solução exibirá a camada de cada definição de componente de faixa de opções que uma solução específica instalou. A camada na parte superior da lista é a definição atual que é usada pelo aplicativo, as outras camadas estão inativas e não são usadas pelo aplicativo no momento. Se a solução superior estiver 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 Active não gerenciada estiver presente, 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 forem publicadas pela Microsoft também terão precedência sobre as camadas de solução publicadas pela Microsoft.
O contexto Entity indica o objeto em que a personalização da faixa de opções está, se "Todas as Entidades" estiver listada, a camada será das extensões de cliente da Application Ribbon e não da entidade específica, caso contrário, o nome lógico da entidade será listado.
Quando houver 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 a regra de habilitação em nosso exemplo e indica que há uma camada de solução nesse caso e que é uma personalização não gerenciada, conforme indicado pela solução intitulada Active. Seu cenário real pode ser diferente, você pode não ser uma camada de solução Ativa, você pode ter uma solução gerenciada e o nome dessa solução será listado aqui.
Agora que revisamos as camadas de 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 correspondem ao seu cenário específico:
A regra habilitar/exibir está na solução Ativa não gerenciada
Para corrigir uma regra de habilitação/exibição na camada de solução não gerenciada do Active , exportaremos uma solução não gerenciada contendo a entidade ou o Application Ribbon e editaremos o <RibbonDiffXml> nó no arquivo customizations.xml e importaremos a nova versão dessa solução que contém a definição de regra de habilitação/exibição fixa. Consulte Exportar, preparar para editar e importar a faixa de opções.
A regra habilitar/exibir é específica da entidade
Com base em nosso cenário de exemplo, identificamos que a entidade é contato e a regra de habilitação que precisa ser corrigida é new.contact.EnableRule.EntityRule e é declarada na camada de solução não gerenciada ativa de um editor chamado DefaultPublisherCITTest.
Abra Configurações Avançadas.
Navegue até Soluções de Configurações>.
Selecione Novo para criar uma nova solução, defina Publisher como o valor mostrado na lista de camadas de solução do Verificador de Comando para a regra de habilitação e a camada de solução Ativa. (Em nosso exemplo, este é DefaultPublisherCITTest)
Selecione Entidades>adicionar existentes.
Selecione a entidade em que sua regra de habilitação/exibição está definida (em nosso exemplo, este é o contato) e selecione OK.
Desmarque os metadados Incluir entidade e Adicione todas as opções de ativos antes de selecionar Concluir.
Selecione Salvar.
Selecione Exportar solução e exportar a solução não gerenciada.
Extraia o arquivo .zip.
Abra o arquivo customizations.xml .
Localize o <Entity> nó filho do nó da entidade que você deseja editar e localizar seu nó filho <RibbonDiffXml> .
Localize a regra habilitar/exibir. No exemplo, a ID da regra de habilitação é new.contact.EnableRule.EntityRule. Portanto, você localizaria o seguinte nó:
Edite o <RibbonDiffXml> nó e faça as alterações necessárias na regra de habilitação/exibição que permitirá que a regra seja avaliada como True sob as circunstâncias corretas para corrigir a regra. Para obter mais informações sobre como declarar regras, consulte Definir regras de habilitação de faixa de opções e Definir regras de exibição de faixa de opções. (Com base em nosso exemplo, alteraríamos a definição de regra para o seguinte)
Adicione o arquivo decustomizations.xml modificado de volta ao arquivo .zip da solução.
Importe o arquivo da solução.
Selecione Publicar Todas as Personalizações.
A regra habilitar/exibir está na Faixa de Opções de Aplicativo (aplica-se a "Todas as entidades")
Se a regra habilitar/exibir não for específica da entidade, ela será aplicável a "Todas as Entidades" declaradas na Faixa de Opções de Aplicativo, as etapas serão ligeiramente diferentes da seguinte maneira:
Abra Configurações Avançadas.
Navegue até Soluções de Configurações>.
Selecione Novo para criar uma nova solução, defina Publisher como o valor mostrado na lista de camadas de solução do Verificador de Comando para a regra habilitar/exibir e a camada de solução Ativa.
Selecione Extensões de Cliente Adicionar Faixas>de Opções de Aplicativo Existentes>.
Selecione Salvar.
Selecione Exportar solução e exportar a solução não gerenciada.
Adicione o arquivo decustomizations.xml modificado de volta ao arquivo .zip da solução.
Importe o arquivo da solução.
Selecione Publicar Todas as Personalizações.
A regra habilitar/exibir é de uma solução gerenciada personalizada que criei
Para corrigir uma regra de habilitação/exibição instalada por uma solução gerenciada personalizada que você criou, siga estas etapas:
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 regra habilitar/exibir está na opção de solução Ativa não gerenciada .
Incremente a versão da solução personalizada.
Exportar solução como gerenciada.
Em sua organização afetada separada, importe esta nova versão da sua solução gerenciada sob medida.
A regra habilitar/exibir é de uma solução gerenciada personalizada que eu não criei ou minha organização não possui (de terceiros/ISV)
Para corrigir uma regra de habilitação/exibição instalada por uma solução gerenciada personalizada que foi criada por terceiros/ISV, você precisará entrar em contato com o autor da solução e solicitar uma nova versão da solução que contém a definição de regra de habilitação/exibição fixa e instalar essa nova solução em sua organização afetada.
A regra habilitar/exibir está em uma solução gerenciada publicada pela Microsoft
Para corrigir uma regra de habilitação/exibição instalada por uma solução gerenciada publicada pela Microsoft, você pode precisar de uma versão mais recente da solução a ser instalada, o que normalmente seria feito durante uma atualização de versão. É possível que você tenha identificado um bug que ainda precisa ser corrigido. Entre em contato com o suporte ao cliente para obter assistência.
