Modalità di modifica avanzata negli oggetti visivi di Power BI

La modalità di modifica avanzata consente di usare controlli avanzati dell'interfaccia utente nell'oggetto visivo di Power BI. Dalla modalità di modifica del report selezionare il pulsante Modifica in un oggetto visivo e impostare la modalità di modifica su Avanzate. L'oggetto visivo usa il EditMode flag per determinare se deve visualizzare questo controllo dell'interfaccia utente.

Screenshot that shows how to open Edit Mode.

Per impostazione predefinita, l'oggetto visivo non supporta la modalità di modifica avanzata ("advancedEditModeSupport: 0"). Per abilitare la modalità di modifica avanzata, aggiungere una riga al file capabilities.json dell'oggetto visivo impostando la advancedEditModeSupport proprietà .

I valori possibili sono:

  • 0 - NotSupported. L'oggetto visivo non supporta la modalità di modifica avanzata. Il pulsante Modifica non viene visualizzato in questo oggetto visivo.
  • 1 - SupportedNoAction. L'oggetto visivo supporta la modalità di modifica avanzata e non richiede ulteriori modifiche. Power BI non passa alla modalità messa a fuoco dell'oggetto visivo. Gli sviluppatori possono usare questa impostazione come pulsante esterno per eseguire diversi processi nello stesso riquadro di visualizzazione.
  • 2 - SupportedInFocus. L'oggetto visivo supporta la modalità di modifica avanzata e richiede che l'host entri in modalità messa a fuoco quando si attiva la modalità di modifica avanzata.

Attivare la modalità di modifica avanzata

Se viene visualizzato un pulsante Modifica :

  • La advancedEditModeSupport proprietà viene impostata nel file capabilities.json su SupportedNoAction o SupportedInFocus.
  • L'oggetto visivo viene visualizzato in modalità di modifica del report.

Se advancedEditModeSupport la proprietà non è presente nel file capabilities.json o impostata su NotSupported, il pulsante Modifica non viene visualizzato.

Quando si seleziona Modifica, l'oggetto visivo ottiene una chiamata update() con EditMode impostato su Advanced. A seconda del valore impostato nel file capabilities.json , vengono eseguite le azioni seguenti:

  • SupportedNoAction: l'host non richiede ulteriori azioni.
  • SupportedInFocus: l'host visualizza l'oggetto visivo in modalità Messa a fuoco.

Uscire dalla modalità di modifica avanzata

Il pulsante Torna al report viene visualizzato se la advancedEditModeSupport proprietà è impostata nel file capabilities.json su SupportedInFocus.