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.
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 comoSupportedNoAction
ouSupportedInFocus
. - 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
.