Report class
Composant incorporé power BI Report
- S' étend
-
Embed
Propriétés
| bookmarks |
Méthode
| add |
Ajouter une commande d’extension de menu contextuel.
|
| add |
Commande Ajouter une extension de menu Options.
|
| add |
Ajouter une page vide au rapport
|
| apply |
Appliquer un thème au rapport
|
| are |
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.
|
| clear |
Efface les visuels sélectionnés et non extraits, si l’indicateur est passé, toutes les sélections de visuels seront effacées.
|
| close |
Ferme tous les menus contextuels ouverts et les info-bulles.
|
| config |
Gérer les modifications de configuration. |
| delete |
Supprimer une page d’un rapport
|
| get |
Obtient la page de rapport active.
|
| get |
Obtient les filtres appliqués au niveau du rapport.
|
| get |
Obtient l’ID de rapport à partir du premier emplacement disponible : options, attribut, URL incorporée. |
| get |
Obtient une page de rapport par son nom.
|
| get |
Obtient la liste des pages du rapport.
|
| get |
obtenir le thème du rapport
|
| get |
Retourne le niveau de zoom actuel du rapport. |
| is |
vérifie si le rapport est enregistré.
|
| move |
Met à jour la position d’un visuel dans une page.
|
| print() | Imprime la page active du rapport en appelant |
| refresh() | Actualise les sources de données du rapport.
|
| remove |
Supprimer la commande d’extension de menu contextuel.
|
| remove |
Supprime tous les filtres au niveau du rapport.
|
| remove |
Supprimer la commande d’extension de menu Options.
|
| rename |
Renommer une page à partir d’un rapport
|
| render(IReport |
Afficher un rapport préchargé à l’aide de l’API d’incorporation par phases
|
| reset |
Réinitialiser les filtres, segments et autres vues de données de l’utilisateur changent à l’état par défaut du rapport
|
| reset |
Réinitialiser et appliquer le thème par défaut du rapport
|
| resize |
Met à jour la taille de la page active dans le rapport.
|
| resize |
Redimensionnez un visuel dans une page.
|
| save |
Enregistrer les filtres, segments et autres modifications d’affichage des données de l’utilisateur du rapport
|
| set |
Définit des filtres au niveau du rapport.
|
| set |
Définit la page active du rapport.
|
| set |
Met à jour l’état d’affichage d’un visuel dans une page.
|
| set |
Définit le niveau de zoom du rapport. |
| switch |
Met à jour la disposition du rapport
|
| switch |
Changer le mode d’affichage Rapport. |
| update |
Mettez à jour les filtres au niveau du rapport en fonction de l’opération : Ajoutez, remplacez tout, remplacez par cible ou supprimez.
|
| update |
Met à jour les paramètres de visibilité pour le volet de filtre et le volet de navigation de page.
|
Méthodes héritées
| exit |
Demande au navigateur de quitter le mode plein écran. |
| fullscreen() | Demande au navigateur d’afficher l’iframe du composant en mode plein écran. |
| get |
Obtenez l’ID de corrélation pour la session incorporée actuelle.
|
| off<T>(string, IEvent |
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é.
|
| on<T>(string, IEvent |
Ajoute un gestionnaire d’événements pour un événement spécifique.
|
| 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é.
|
| remove |
Supprime l’attribut tabindex de l’élément |
| save() | Enregistre le rapport. |
| save |
Rapport SaveAs. |
| set |
Définissez accessToken. |
| set |
Définit l’attribut tabindex de l’élément |
| set |
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
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
- displayState
- VisualContainerDisplayMode
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