Partilhar 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 Avançado. O visual usa o EditMode sinalizador para determinar se ele deve exibir esse controle de interface do usuário.

Screenshot that shows how to open Edit Mode.

Por padrão, o visual não suporta o 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 advancedEditModeSupport propriedade.

Os valores possíveis são:

  • 0 - Não suportado. O visual não suporta o modo de edição Avançado. O botão Editar não é exibido neste visual.
  • 1 - SupportedNoAction. O visual suporta o 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 suporta o modo de edição Avançado e requer que o host entre no modo de Foco ao entrar no modo de edição Avançado.

Entre no modo de edição avançado

Um botão Editar será exibido se:

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

Se advancedEditModeSupport a propriedade estiver ausente do arquivo capabilities.json ou definida como NotSupported, o botão Editar não será exibido.

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 anfitrião não necessita de mais ação.
  • SupportedInFocus: O host exibe o visual no modo Foco.

Sair do modo de edição avançado

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