Partager via


Report class

Composant incorporé power BI Report

S' étend

Embed

Propriétés

bookmarksManager

Méthode

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

Ajouter une commande d’extension de menu contextuel.

report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
 .catch(error => {
     ...
 });
addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

Commande Ajouter une extension de menu Options.

report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
 .catch(error => {
     ...
 });
addPage(string)

Ajouter une page vide au rapport

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
applyTheme(IReportTheme)

Appliquer un thème au rapport

report.applyTheme(theme);
arePersistentFiltersApplied()

Retourne s’il existe des filtres, des segments ou d’autres modifications de vue de données appliquées au rapport. Si les filtres persistants sont désactivés, retourne false.

report.arePersistentFiltersApplied();
clearSelectedVisuals(boolean)

Efface les visuels sélectionnés et non extraits, si l’indicateur est passé, toutes les sélections de visuels seront effacées.

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
closeAllOverlays()

Ferme tous les menus contextuels ouverts et les info-bulles.

report.closeAllOverlays()
 .then(() => {
     ...
 });
configChanged(boolean)

Gérer les modifications de configuration.

deletePage(string)

Supprimer une page d’un rapport

// Delete a page from a report by pageName (PageName is different than the display name and can be acquired from the getPages API)
report.deletePage("ReportSection145");
getActivePage()

Obtient la page de rapport active.

report.getActivePage()
 .then(activePage => {
     ...
 });
getFilters()

Obtient les filtres appliqués au niveau du rapport.

// Get filters applied at report level
report.getFilters()
  .then(filters => {
    ...
  });
getId()

Obtient l’ID de rapport à partir du premier emplacement disponible : options, attribut, URL incorporée.

getPageByName(string)

Obtient une page de rapport par son nom.

report.getPageByName(pageName)
 .then(page => {
     ...
 });
getPages()

Obtient la liste des pages du rapport.

report.getPages()
 .then(pages => {
     ...
 });
getTheme()

obtenir le thème du rapport

report.getTheme();
getZoom()

Retourne le niveau de zoom actuel du rapport.

isSaved()

vérifie si le rapport est enregistré.

report.isSaved()
moveVisual(string, string, number, number, number)

Met à jour la position d’un visuel dans une page.

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
print()

Imprime la page active du rapport en appelant window.print() sur le composant iframe incorporé.

refresh()

Actualise les sources de données du rapport.

report.refresh();
removeContextMenuCommand(string, string)

Supprimer la commande d’extension de menu contextuel.

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
removeFilters()

Supprime tous les filtres au niveau du rapport.

report.removeFilters();
removeOptionsMenuCommand(string, string)

Supprimer la commande d’extension de menu Options.

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
renamePage(string, string)

Renommer une page à partir d’un rapport

// Rename a page from a report by changing displayName (pageName is different from the display name and can be acquired from the getPages API)
report.renamePage("ReportSection145", "Sales");
render(IReportEmbedConfiguration | IReportLoadConfiguration)

Afficher un rapport préchargé à l’aide de l’API d’incorporation par phases

// Load report
var report = powerbi.load(element, config);

...

// Render report
report.render()
resetPersistentFilters()

Réinitialiser les filtres, segments et autres vues de données de l’utilisateur changent à l’état par défaut du rapport

report.resetPersistentFilters();
resetTheme()

Réinitialiser et appliquer le thème par défaut du rapport

report.resetTheme();
resizeActivePage(PageSizeType, number, number)

Met à jour la taille de la page active dans le rapport.

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
resizeVisual(string, string, number, number)

Redimensionnez un visuel dans une page.

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
savePersistentFilters()

Enregistrer les filtres, segments et autres modifications d’affichage des données de l’utilisateur du rapport

report.savePersistentFilters();
setFilters(IFilter[])

Définit des filtres au niveau du rapport.

const filters: [
   ...
];

report.setFilters(filters)
 .catch(errors => {
   ...
 });
setPage(string)

Définit la page active du rapport.

report.setPage("page2")
 .catch(error => { ... });
setVisualDisplayState(string, string, VisualContainerDisplayMode)

Met à jour l’état d’affichage d’un visuel dans une page.

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
setZoom(number)

Définit le niveau de zoom du rapport.

switchLayout(LayoutType)

Met à jour la disposition du rapport

report.switchLayout(layoutType);
switchMode(string | ViewMode)

Changer le mode d’affichage Rapport.

updateFilters(FiltersOperations, IFilter[])

Mettez à jour les filtres au niveau du rapport en fonction de l’opération : Ajoutez, remplacez tout, remplacez par cible ou supprimez.

report.updateFilters(FiltersOperations.Add, filters)
  .catch(errors => { ... });
updateSettings(ISettings)

Met à jour les paramètres de visibilité pour le volet de filtre et le volet de navigation de page.

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });

Méthodes héritées

exitFullscreen()

Demande au navigateur de quitter le mode plein écran.

fullscreen()

Demande au navigateur d’afficher l’iframe du composant en mode plein écran.

getCorrelationId()

Obtenez l’ID de corrélation pour la session incorporée actuelle.

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
off<T>(string, IEventHandler<T>)

Supprime un ou plusieurs gestionnaires d’événements de la liste des gestionnaires. Si une référence à la fonction de handle existante est spécifiée, supprimez le gestionnaire spécifique. Si le gestionnaire n’est pas spécifié, supprimez tous les gestionnaires pour le nom d’événement spécifié.

report.off('pageChanged')

or

const logHandler = function (event) {
   console.log(event);
};

report.off('pageChanged', logHandler);
on<T>(string, IEventHandler<T>)

Ajoute un gestionnaire d’événements pour un événement spécifique.

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
reload()

Recharge l’incorporation à l’aide de la configuration existante. Par exemple, pour les rapports, cela efface efficacement tous les filtres et active la première page qui simule la réinitialisation d’un rapport à l’état chargé.

report.reload();
removeComponentTabIndex(number)

Supprime l’attribut tabindex de l’élément

save()

Enregistre le rapport.

saveAs(ISaveAsParameters)

Rapport SaveAs.

setAccessToken(string)

Définissez accessToken.

setComponentTabIndex(number)

Définit l’attribut tabindex de l’élément

setComponentTitle(string)

Définissez le titre du composant pour l’accessibilité. En cas d’iframes, cette méthode modifie le titre de l’iframe.

Détails de la propriété

bookmarksManager

bookmarksManager: BookmarksManager

Valeur de la propriété

Détails de la méthode

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

Ajouter une commande d’extension de menu contextuel.

report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
 .catch(error => {
     ...
 });
function addContextMenuCommand(commandName: string, commandTitle: string, contextMenuTitle: string, menuLocation: MenuLocation, visualName: string, visualType: string, groupName?: string): Promise<IHttpPostMessageResponse<void>>

Paramètres

commandName

string

commandTitle

string

contextMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

Retourne

Promise<IHttpPostMessageResponse<void>>

addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

Commande Ajouter une extension de menu Options.

report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
 .catch(error => {
     ...
 });
function addOptionsMenuCommand(commandName: string, commandTitle: string, optionsMenuTitle?: string, menuLocation?: MenuLocation, visualName?: string, visualType?: string, groupName?: string, commandIcon?: string): Promise<IHttpPostMessageResponse<void>>

Paramètres

commandName

string

commandTitle

string

optionsMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

commandIcon

string

Retourne

Promise<IHttpPostMessageResponse<void>>

addPage(string)

Ajouter une page vide au rapport

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
function addPage(displayName?: string): Promise<Page>

Paramètres

displayName

string

Retourne

Promise<Page>

applyTheme(IReportTheme)

Appliquer un thème au rapport

report.applyTheme(theme);
function applyTheme(theme: IReportTheme): Promise<void>

Paramètres

theme
IReportTheme

Retourne

Promise<void>

arePersistentFiltersApplied()

Retourne s’il existe des filtres, des segments ou d’autres modifications de vue de données appliquées au rapport. Si les filtres persistants sont désactivés, retourne false.

report.arePersistentFiltersApplied();
function arePersistentFiltersApplied(): Promise<boolean>

Retourne

Promise<boolean>

clearSelectedVisuals(boolean)

Efface les visuels sélectionnés et non extraits, si l’indicateur est passé, toutes les sélections de visuels seront effacées.

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
function clearSelectedVisuals(clearPopOutState?: boolean): Promise<void>

Paramètres

clearPopOutState

boolean

Si la sélection des visuels faux /non définis ne sera pas effacée si l’un des visuels est en état de sortie (en focus, afficher sous forme de table, à la une des lumières...)

Retourne

Promise<void>

closeAllOverlays()

Ferme tous les menus contextuels ouverts et les info-bulles.

report.closeAllOverlays()
 .then(() => {
     ...
 });
function closeAllOverlays(): Promise<void>

Retourne

Promise<void>

configChanged(boolean)

Gérer les modifications de configuration.

function configChanged(isBootstrap: boolean)

Paramètres

isBootstrap

boolean

deletePage(string)

Supprimer une page d’un rapport

// Delete a page from a report by pageName (PageName is different than the display name and can be acquired from the getPages API)
report.deletePage("ReportSection145");
function deletePage(pageName: string): Promise<void>

Paramètres

pageName

string

Retourne

Promise<void>

getActivePage()

Obtient la page de rapport active.

report.getActivePage()
 .then(activePage => {
     ...
 });
function getActivePage(): Promise<Page>

Retourne

Promise<Page>

getFilters()

Obtient les filtres appliqués au niveau du rapport.

// Get filters applied at report level
report.getFilters()
  .then(filters => {
    ...
  });
function getFilters(): Promise<IFilter[]>

Retourne

Promise<IFilter[]>

getId()

Obtient l’ID de rapport à partir du premier emplacement disponible : options, attribut, URL incorporée.

function getId(): string

Retourne

string

getPageByName(string)

Obtient une page de rapport par son nom.

report.getPageByName(pageName)
 .then(page => {
     ...
 });
function getPageByName(pageName: string): Promise<Page>

Paramètres

pageName

string

Retourne

Promise<Page>

getPages()

Obtient la liste des pages du rapport.

report.getPages()
 .then(pages => {
     ...
 });
function getPages(): Promise<Page[]>

Retourne

Promise<Page[]>

getTheme()

obtenir le thème du rapport

report.getTheme();
function getTheme(): Promise<IReportTheme>

Retourne

Promise<IReportTheme>

getZoom()

Retourne le niveau de zoom actuel du rapport.

function getZoom(): Promise<number>

Retourne

Promise<number>

isSaved()

vérifie si le rapport est enregistré.

report.isSaved()
function isSaved(): Promise<boolean>

Retourne

Promise<boolean>

moveVisual(string, string, number, number, number)

Met à jour la position d’un visuel dans une page.

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
function moveVisual(pageName: string, visualName: string, x: number, y: number, z?: number): Promise<IHttpPostMessageResponse<void>>

Paramètres

pageName

string

visualName

string

x

number

y

number

z

number

Retourne

Promise<IHttpPostMessageResponse<void>>

print()

Imprime la page active du rapport en appelant window.print() sur le composant iframe incorporé.

function print(): Promise<void>

Retourne

Promise<void>

refresh()

Actualise les sources de données du rapport.

report.refresh();
function refresh(): Promise<void>

Retourne

Promise<void>

removeContextMenuCommand(string, string)

Supprimer la commande d’extension de menu contextuel.

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
function removeContextMenuCommand(commandName: string, contextMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

Paramètres

commandName

string

contextMenuTitle

string

Retourne

Promise<IHttpPostMessageResponse<void>>

removeFilters()

Supprime tous les filtres au niveau du rapport.

report.removeFilters();
function removeFilters(): Promise<IHttpPostMessageResponse<void>>

Retourne

Promise<IHttpPostMessageResponse<void>>

removeOptionsMenuCommand(string, string)

Supprimer la commande d’extension de menu Options.

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
function removeOptionsMenuCommand(commandName: string, optionsMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

Paramètres

commandName

string

optionsMenuTitle

string

Retourne

Promise<IHttpPostMessageResponse<void>>

renamePage(string, string)

Renommer une page à partir d’un rapport

// Rename a page from a report by changing displayName (pageName is different from the display name and can be acquired from the getPages API)
report.renamePage("ReportSection145", "Sales");
function renamePage(pageName: string, displayName: string): Promise<void>

Paramètres

pageName

string

displayName

string

Retourne

Promise<void>

render(IReportEmbedConfiguration | IReportLoadConfiguration)

Afficher un rapport préchargé à l’aide de l’API d’incorporation par phases

// Load report
var report = powerbi.load(element, config);

...

// Render report
report.render()
function render(config?: IReportEmbedConfiguration | IReportLoadConfiguration): Promise<void>

Paramètres

Retourne

Promise<void>

resetPersistentFilters()

Réinitialiser les filtres, segments et autres vues de données de l’utilisateur changent à l’état par défaut du rapport

report.resetPersistentFilters();
function resetPersistentFilters(): Promise<IHttpPostMessageResponse<void>>

Retourne

Promise<IHttpPostMessageResponse<void>>

resetTheme()

Réinitialiser et appliquer le thème par défaut du rapport

report.resetTheme();
function resetTheme(): Promise<void>

Retourne

Promise<void>

resizeActivePage(PageSizeType, number, number)

Met à jour la taille de la page active dans le rapport.

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
function resizeActivePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>

Paramètres

pageSizeType
PageSizeType
width

number

height

number

Retourne

Promise<IHttpPostMessageResponse<void>>

resizeVisual(string, string, number, number)

Redimensionnez un visuel dans une page.

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
function resizeVisual(pageName: string, visualName: string, width: number, height: number): Promise<IHttpPostMessageResponse<void>>

Paramètres

pageName

string

visualName

string

width

number

height

number

Retourne

Promise<IHttpPostMessageResponse<void>>

savePersistentFilters()

Enregistrer les filtres, segments et autres modifications d’affichage des données de l’utilisateur du rapport

report.savePersistentFilters();
function savePersistentFilters(): Promise<IHttpPostMessageResponse<void>>

Retourne

Promise<IHttpPostMessageResponse<void>>

setFilters(IFilter[])

Définit des filtres au niveau du rapport.

const filters: [
   ...
];

report.setFilters(filters)
 .catch(errors => {
   ...
 });
function setFilters(filters: IFilter[]): Promise<IHttpPostMessageResponse<void>>

Paramètres

filters

IFilter[]

Retourne

Promise<IHttpPostMessageResponse<void>>

setPage(string)

Définit la page active du rapport.

report.setPage("page2")
 .catch(error => { ... });
function setPage(pageName: string): Promise<IHttpPostMessageResponse<void>>

Paramètres

pageName

string

Retourne

Promise<IHttpPostMessageResponse<void>>

setVisualDisplayState(string, string, VisualContainerDisplayMode)

Met à jour l’état d’affichage d’un visuel dans une page.

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
function setVisualDisplayState(pageName: string, visualName: string, displayState: VisualContainerDisplayMode): Promise<IHttpPostMessageResponse<void>>

Paramètres

pageName

string

visualName

string

Retourne

Promise<IHttpPostMessageResponse<void>>

setZoom(number)

Définit le niveau de zoom du rapport.

function setZoom(zoomLevel: number): Promise<void>

Paramètres

zoomLevel

number

niveau de zoom à définir

Retourne

Promise<void>

switchLayout(LayoutType)

Met à jour la disposition du rapport

report.switchLayout(layoutType);
function switchLayout(layoutType: LayoutType): Promise<IHttpPostMessageResponse<void>>

Paramètres

layoutType
LayoutType

Retourne

Promise<IHttpPostMessageResponse<void>>

switchMode(string | ViewMode)

Changer le mode d’affichage Rapport.

function switchMode(viewMode: string | ViewMode): Promise<void>

Paramètres

viewMode

string | ViewMode

Retourne

Promise<void>

updateFilters(FiltersOperations, IFilter[])

Mettez à jour les filtres au niveau du rapport en fonction de l’opération : Ajoutez, remplacez tout, remplacez par cible ou supprimez.

report.updateFilters(FiltersOperations.Add, filters)
  .catch(errors => { ... });
function updateFilters(operation: FiltersOperations, filters?: IFilter[]): Promise<IHttpPostMessageResponse<void>>

Paramètres

operation
FiltersOperations
filters

IFilter[]

Retourne

Promise<IHttpPostMessageResponse<void>>

updateSettings(ISettings)

Met à jour les paramètres de visibilité pour le volet de filtre et le volet de navigation de page.

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });
function updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>

Paramètres

settings
ISettings

Retourne

Promise<IHttpPostMessageResponse<void>>

Détails de la méthode héritée

exitFullscreen()

Demande au navigateur de quitter le mode plein écran.

function exitFullscreen()

héritée de Embed.exitFullscreen

fullscreen()

Demande au navigateur d’afficher l’iframe du composant en mode plein écran.

function fullscreen()

héritée de Embed.fullscreen

getCorrelationId()

Obtenez l’ID de corrélation pour la session incorporée actuelle.

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
function getCorrelationId(): Promise<string>

Retourne

Promise<string>

héritée de Embed.getCorrelationId

off<T>(string, IEventHandler<T>)

Supprime un ou plusieurs gestionnaires d’événements de la liste des gestionnaires. Si une référence à la fonction de handle existante est spécifiée, supprimez le gestionnaire spécifique. Si le gestionnaire n’est pas spécifié, supprimez tous les gestionnaires pour le nom d’événement spécifié.

report.off('pageChanged')

or

const logHandler = function (event) {
   console.log(event);
};

report.off('pageChanged', logHandler);
function off<T>(eventName: string, handler?: IEventHandler<T>)

Paramètres

eventName

string

handler

IEventHandler<T>

héritée de Embed.off

on<T>(string, IEventHandler<T>)

Ajoute un gestionnaire d’événements pour un événement spécifique.

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
function on<T>(eventName: string, handler: IEventHandler<T>)

Paramètres

eventName

string

handler

IEventHandler<T>

héritée de Embed.on

reload()

Recharge l’incorporation à l’aide de la configuration existante. Par exemple, pour les rapports, cela efface efficacement tous les filtres et active la première page qui simule la réinitialisation d’un rapport à l’état chargé.

report.reload();
function reload(): Promise<void>

Retourne

Promise<void>

héritée de Embed.reload

removeComponentTabIndex(number)

Supprime l’attribut tabindex de l’élément

function removeComponentTabIndex(_tabIndex?: number)

Paramètres

_tabIndex

number

héritée de Embed.removeComponentTabIndex

save()

Enregistre le rapport.

function save(): Promise<void>

Retourne

Promise<void>

héritée de Embed.save

saveAs(ISaveAsParameters)

Rapport SaveAs.

function saveAs(saveAsParameters: ISaveAsParameters): Promise<void>

Paramètres

saveAsParameters
ISaveAsParameters

Retourne

Promise<void>

héritée de Embed.saveAs

setAccessToken(string)

Définissez accessToken.

function setAccessToken(accessToken: string): Promise<void>

Paramètres

accessToken

string

Retourne

Promise<void>

héritée de Embed.setAccessToken

setComponentTabIndex(number)

Définit l’attribut tabindex de l’élément

function setComponentTabIndex(tabIndex?: number)

Paramètres

tabIndex

number

héritée de Embed.setComponentTabIndex

setComponentTitle(string)

Définissez le titre du composant pour l’accessibilité. En cas d’iframes, cette méthode modifie le titre de l’iframe.

function setComponentTitle(title: string)

Paramètres

title

string

héritée de Embed.setComponentTitle