Modalità di modifica avanzata negli oggetti visivi di Power BIAdvanced edit mode in Power BI visuals

Se sono necessari controlli dell'interfaccia utente avanzati nell'oggetto visivo di Power BI, è possibile sfruttare la modalità di modifica avanzata.If you require advanced UI controls in your Power BI visual, you can take advantage of advanced edit mode. In modalità di modifica report si seleziona un pulsante Modifica per impostare la modalità di modifica su Avanzata.When you're in report editing mode, you select an Edit button to set the edit mode to Advanced. L'oggetto visivo può usare il flag EditMode per determinare se visualizzare questo controllo dell'interfaccia utente.The visual can use the EditMode flag to determine whether it should display this UI control.

Per impostazione predefinita, l'oggetto visivo non supporta la modalità di modifica avanzata.By default, the visual doesn't support advanced edit mode. Se è necessario un comportamento diverso, è possibile dichiararlo in modo esplicito nel file capabilities.json dell'oggetto visivo, impostando la proprietà advancedEditModeSupport.If a different behavior is required, you can explicitly state this in the visual's capabilities.json file by setting the advancedEditModeSupport property.

I valori possibili sono:The possible values are:

  • 0: NotSupported0 - NotSupported

  • 1: SupportedNoAction1 - SupportedNoAction

  • 2: SupportedInFocus2 - SupportedInFocus

Attivare la modalità di modifica avanzataEnter advanced edit mode

Un pulsante Modifica viene visualizzato se:An Edit button is displayed if:

  • La proprietà advancedEditModeSupport è impostata nel file capabilities.json su SupportedNoAction o SupportedInFocus.The advancedEditModeSupport property is set in the capabilities.json file to either SupportedNoAction or SupportedInFocus.

  • L'oggetto visivo viene visualizzato in modalità di modifica report.The visual is viewed in report editing mode.

Se la proprietà advancedEditModeSupport non è presente nel file capabilities.json o è impostata su NotSupported, il pulsante Modifica non viene visualizzato.If advancedEditModeSupport property is missing from the capabilities.json file or set to NotSupported, the Edit button is not displayed.

Attivare la modalità di modifica

Quando si seleziona Modifica, l'oggetto visivo ottiene una chiamata a update() con EditMode impostato su Advanced.When you select Edit, the visual gets an update() call with EditMode set to Advanced. A seconda del valore impostato nel file capabilities.json, vengono eseguite le azioni seguenti:Depending on the value that's set in the capabilities.json file, the following actions occur:

  • SupportedNoAction: nessun'altra azione richiesta da parte dell'host.SupportedNoAction: No further action is required by the host.
  • SupportedInFocus: l'host espande l'oggetto visivo in modalità messa a fuoco.SupportedInFocus: The host pops out the visual into in focus mode.

Disattivare la modalità di modifica avanzataExit advanced edit mode

Il pulsante Torna al report viene visualizzato se:The Back to report button is displayed if:

  • La proprietà advancedEditModeSupport è impostata nel file capabilities.json su SupportedInFocus.The advancedEditModeSupport property is set in the capabilities.json file to SupportedInFocus.