Remover uma camada não gerenciada ativa da faixa de opções no Power Apps

2024-12-14

Este artigo fornece etapas para remover a camada não gerenciada de um componente da faixa de opções no Microsoft Power Apps.

Usar o verificador de comandos para remover uma camada não gerenciada de uma faixa de opções

As personalizações não gerenciadas residem na camada superior de um componente e, posteriormente, definem o comportamento de tempo de execução do componente. Na maioria das situações, você não deseja que personalizações não gerenciadas determinem o comportamento de seus componentes. Para remover a camada não gerenciada de um componente da faixa de opções, siga estas etapas:

Abra a ferramenta Verificador de comandos para excluir personalizações não gerenciadas para componentes da faixa de opções.

Para habilitar o Verificador de comandos, acrescente o &ribbondebug=true parâmetro à URL do seu aplicativo Dynamics 365. Por exemplo, https://yourorgname.crm.dynamics.com/main.aspx?appid=<ID>&ribbondebug=true.
Na caixa de diálogo Verificador de comandos, selecione um botão e, em seguida, selecione Exibir camadas de solução de botão para localizar uma personalização não gerenciada.

Por exemplo, o botão Novo mostrado na captura de tela a seguir tem uma personalização não gerenciada.
Selecione o link Remover personalização ativa ao lado da camada não gerenciada.
Gere novamente os metadados depois de excluir a camada não gerenciada.

Remover uma camada não gerenciada de uma faixa de opções (procedimento manual)

Você pode executar esse procedimento manual se a personalização da faixa de opções não gerenciada que você deseja remover não estiver visível no verificador de comandos.

Esse processo exige que você exporte uma solução não gerenciada que contém a faixa de opções da entidade ou do aplicativo, edite o <RibbonDiffXml> nó no arquivo customizations.xml e importe uma nova versão dessa solução em que esse componente foi removido para excluir o componente. Para obter mais informações, consulte Exportar, preparar para editar e importar a faixa de opções.

O componente da faixa de opções é específico da entidade

Siga estas etapas se o componente for declarado para uma entidade específica:

Abra Configurações avançadas.
Navegue até Configurações>Soluções.
Abra uma solução existente ou crie uma nova solução.

Para criar uma solução, siga estas etapas:
1. Selecione Novo para criar uma nova solução e definir o Publicador como seu editor preferido ou use o editor padrão da sua organização se não tiver certeza.
2. Selecione Entidades>Adicionar existente.
3. Selecione a entidade em que o componente da faixa de opções está definido e selecione OK.
4. Certifique-se de desmarcar as opções Incluir metadados da entidade e Adicionar todos os ativos antes de selecionar Concluir.
5. Selecione Salvar.
Selecione Exportar Solução e exporte a solução não gerenciada.
Extraia o arquivo .zip.
Abra o arquivo customizations.xml .
Localize o nó <Entity> filho do nó da entidade que você deseja editar e, em seguida, localize seu nó <RibbonDiffXml>filho.
Localize o nó a ser excluído.
- Para excluir um comando, você deve localizar o <CommandDefinition> nó com a ID do comando que deseja excluir.
- Para excluir um HideCustomAction, você deve localizar o <HideCustomAction> nó que contém a ID do item que deseja remover.
- Para excluir uma "Regra de Ativação" ou "Regra de Exibição", você deve localizar o <RuleDefinitions> nó e, em seguida, localizar o nó <EnableRule> filho ou <DisplayRule> com a ID do item que deseja excluir.
- Para excluir um botão, você deve localizar o <CustomAction> nó com a ID do CustomAction que deseja excluir. Ou localize e exclua o CustomAction nó que contém o <button>nó , <splitbutton>, <flyoutanchor>, ou <group> com a ID do controle que você deseja excluir.
- Para excluir um LocLabel, você deve localizar o <LocLabel> nó com a ID do LocLabel que deseja excluir.
- Para excluir todas as personalizações da faixa de opções para essa entidade, substitua o <RibbonDiffXml> nó pelo XML vazio padrão, conforme mostrado na seção Remover todas as personalizações da faixa de opções não gerenciadas deste artigo.
Edite o <RibbonDiffXml> nó e remova um ou mais nós apropriados, conforme descrito anteriormente. Certifique-se de não excluir acidentalmente outros nós que possam estar presentes.
Salve o arquivo customizations.xml .
Adicione o arquivo customizations.xml modificado de volta ao arquivo .zip solução.
Importe o arquivo de solução.
Selecione Publicar Todas as Personalizações.

O componente da faixa de opções está na faixa de opções do aplicativo (aplica-se a "Todas as entidades")

Se o componente não for específico da entidade, mas se aplicar a "Todas as Entidades" declaradas na faixa de opções do aplicativo, as etapas serão ligeiramente diferentes:

Abra Configurações avançadas.
Navegue até Configurações>Soluções.
Abra uma solução existente ou crie uma nova solução.

Para criar uma solução, siga estas etapas:
1. Selecione Novo para criar uma nova solução e definir o Publicador como seu editor preferido ou use o editor padrão da sua organização se não tiver certeza.
2. Selecione Extensões>de cliente Adicionar faixas de opções de aplicativos existentes.>
3. Selecione Salvar.
Selecione Exportar Solução e exporte a solução não gerenciada.
Extraia o arquivo .zip.
Abra o arquivo customizations.xml .
Localize o nó <RibbonDiffXml>raiz .
Localize o nó a ser excluído.
- Para excluir um comando, você deve localizar o <CommandDefinition> nó com a ID do comando que deseja excluir.
- Para excluir um HideCustomAction, você deve localizar o <HideCustomAction> nó que contém a ID do item que deseja remover.
- Para excluir uma "Regra de Ativação" ou "Regra de Exibição", você deve localizar o <RuleDefinitions> nó e, em seguida, localizar o nó <EnableRule> filho ou <DisplayRule> com a ID do item que deseja excluir.
- Para excluir um botão, você deve localizar o <CustomAction> nó com a ID do CustomAction que deseja excluir. Ou localize e exclua o CustomAction que contém o <button>nó , <splitbutton>, <flyoutanchor>, ou <group> com a ID do controle que você deseja excluir.
- Para excluir um LocLabel, você deve localizar o <LocLabel> nó com a ID do LocLabel que deseja excluir.
- Para excluir todas as personalizações da faixa de opções do aplicativo, substitua o <RibbonDiffXml> nó pelo XML vazio padrão, conforme mostrado na seção Remover todas as personalizações não gerenciadas da faixa de opções deste artigo.
Edite o <RibbonDiffXml> nó e remova o nó apropriado, conforme descrito anteriormente. Certifique-se de não excluir acidentalmente outros nós que possam estar presentes.
Salve o arquivo customizations.xml .
Adicione o arquivo customizations.xml modificado de volta à solução compactada .zip arquivo.
Importe o arquivo de solução.
Selecione Publicar Todas as Personalizações.

Remover todas as personalizações de faixa de opções não gerenciadas

Para remover todas as personalizações de faixa de opções não gerenciadas para uma entidade específica ou faixa de opções de aplicativo, siga as etapas anteriores e substitua o <RibbonDiffXml> nó no arquivo customizations.xml da solução pela seguinte declaração XML vazia padrão:

<RibbonDiffXml>
   <CustomActions />
   <Templates>
      <RibbonTemplates Id="Mscrm.Templates"></RibbonTemplates>
   </Templates>
   <CommandDefinitions />
   <RuleDefinitions>
      <TabDisplayRules />
      <DisplayRules />
      <EnableRules />
   </RuleDefinitions>
   <LocLabels />
   </RibbonDiffXml>

Referência

Verificador de comandos