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

  • Artigo

O modo de edição avançada 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 sinalizador EditMode 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 é compatível com o modo de edição avançada ("advancedEditModeSupport: 0"). Para habilitar o modo de Edição avançada, 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çada. O botão Editar não é exibido neste visual.
  • 1 - SupportedNoAction. O visual dá suporte ao modo de Edição avançada 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çada e exige que o host entre no modo de Foco ao entrar no modo de Edição avançada.

Entrar no modo de edição avançada

Um botão Editar será exibido se:

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

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

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

  • SupportedNoAction: o host não requer mais ações.
  • SupportedInFocus: o host abre o visual no modo de Foco.

Sair do modo de edição avançada

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

Próximas etapas

Adicionar formatação condicional