Mode d’édition avancé dans les visuels Power BI
Le mode d’édition avancé vous permet d’utiliser des contrôles d’interface utilisateur avancés dans votre visuel Power BI. Dans le mode d’édition de rapport, sélectionnez le bouton Modifier sur un visuel et définissez le mode d’édition sur avancé. Le visuel utilise l’indicateur EditMode
pour déterminer s’il doit afficher ce contrôle d’interface utilisateur.
Par défaut, le visuel ne prend pas en charge le mode d’édition avancé ("advancedEditModeSupport: 0"
). Pour activer le mode d’édition avancé, ajoutez une ligne au fichier capabilities.json du visuel en définissant la propriété advancedEditModeSupport
.
Les valeurs possibles sont les suivantes :
0
- NotSupported. Le visuel ne prend pas en charge le mode d’édition avancé. Le bouton Modifier n’est pas affiché sur ce visuel.1
- SupportedNoAction. Le visuel prend en charge le mode d’édition avancé et ne nécessite aucune autre modification. Power BI ne fait pas passer le visuel en mode Focus. Les développeurs peuvent utiliser ce paramètre comme bouton externe pour exécuter plusieurs processus dans la même fenêtre d’affichage.2
- SupportedInFocus. Le visuel prend en charge le mode d’édition avancé et nécessite que l’hôte entre en mode Focus lors de l’entrée en mode d’édition avancé.
Entrer le mode d’édition avancé
Un bouton Modifier s’affiche si :
- La propriété
advancedEditModeSupport
est définie dans le fichier capabilities.json surSupportedNoAction
ouSupportedInFocus
. - Le visuel est affiché en mode édition de rapport.
Si advancedEditModeSupport
propriété est manquante dans le fichier capabilities.json ou définie sur NotSupported
, le bouton Modifier n’apparaît pas.
Lorsque vous sélectionnez Modifier, le visuel obtient un appel update() avec EditMode défini sur Advanced
. Selon la valeur définie dans le fichier capabilities.json, les actions suivantes se produisent :
SupportedNoAction
: L’hôte ne nécessite pas d’action supplémentaire.SupportedInFocus
: l’hôte affiche le visuel en mode Focus.
Vous pouvez en savoir plus sur la configuration du fichier capabilities.json dans Fonctionnalités et propriétés des visuels Power BI.
Quitter le mode d’édition avancé
Le bouton Retour au rapport s’affiche si la propriété advancedEditModeSupport
est définie dans le fichier capabilities.json sur SupportedInFocus
.