Compartilhar via


Modo de edição avançado em visuais do Power BI

O modo de edição avançado permite que você use controles avançados de interface do usuário em seu visual do Power BI. No modo de edição de relatório, selecione o botão Editar em um visual e defina o modo de edição como Advanced. O visual usa o sinalizador EditMode para determinar se deve exibir esse controle da interface.

Captura de tela que mostra como abrir o Modo de Edição.

Por padrão, o visual não dá suporte ao modo de edição avançado ("advancedEditModeSupport: 0"). Para habilitar o modo de edição avançado, adicione uma linha ao arquivo capabilities.json do visual definindo a propriedade advancedEditModeSupport.

Os valores possíveis são:

  • 0 - NotSupported. O visual não dá suporte ao modo de edição avançado. O botão Editar não é exibido neste visual.
  • 1 - SupportedNoAction. O visual dá suporte ao modo de edição avançado e não requer mais alterações. O Power BI não alterna o visual para o Modo de Foco. Os desenvolvedores podem usar essa configuração como um botão externo para executar vários processos no mesmo visor.
  • 2 - SupportedInFocus. O visual dá suporte ao modo de edição avançado e requer que o host insira o modo de foco ao entrar no modo de edição avançado.

Insira o modo de edição avançado

Um botão Edit será exibido se:

  • A propriedade advancedEditModeSupport é definida no arquivo capabilities.json como SupportedNoAction ou SupportedInFocus.
  • O visual é exibido no modo de edição de relatório.

Se advancedEditModeSupport propriedade estiver ausente do arquivo capabilities.json ou definida como NotSupported, o botão editar do não aparecerá.

Quando você seleciona Editar, o visual recebe uma chamada update() com EditMode definido como Advanced. Dependendo do valor definido no arquivo capabilities.json, as seguintes ações ocorrem:

  • SupportedNoAction: o host não requer mais ações.
  • SupportedInFocus: O apresentador exibe o visual no modo Foco.

Você pode ler mais sobre como configurar o arquivo capabilities.json em Recursos e propriedades de elementos visuais do Power BI.

Sair do modo de edição avançado

O botão Voltar ao relatório será exibido se a propriedade advancedEditModeSupport estiver definida no arquivo capabilities.json como SupportedInFocus.

Adicionar formatação condicional