Machtigingen-API controleren
Als ontwikkelaar van Power BI-visuals kunt u visuals ontwikkelen die toegang nodig hebben tot verschillende resources. U vraagt deze machtigingen aan in de sectie bevoegdheden van het capabilities.json-bestand . Deze bevoegdheden omvatten de mogelijkheid om toegang te krijgen tot:
- externe bronnen of websites
- lokale opslag voor het downloaden van gegevens
De beheerder van elke organisatie kan deze machtigingen toestaan of blokkeren. Met de API voor controlemachtigingen kunt u tijdens runtime een query uitvoeren op de host om te bepalen welke machtigingen worden verleend. U kunt deze informatie gebruiken om een visual te ontwerpen die werkt met verschillende machtigingsinstellingen.
De API voor controlemachtigingen retourneert de status van elke machtigingsqueryfunctie:
/**
* Represents a return type for privilege status query methods
*/
export const enum PrivilegeStatus {
/**
* The privilege is allowed in the current environment
*/
Allowed,
/**
* The privilege declaration is missing in visual capabilities section
*/
NotDeclared,
/**
* The privilege is not supported in the current environment
*/
NotSupported,
/**
* The privilege usage was denied by tenant administrator
*/
DisabledByAdmin,
}
De API voor controlemachtigingen gebruiken
Elke privilege-API heeft een eigen querymethode om te controleren op de machtigingsstatus. De machtigingsstatus kan een van de volgende zijn:
- Toegestaan
- Niet gedeclareerd
- Niet ondersteund
- Uitgeschakeld door beheerder
Webtoegang
export interface IWebAccessService {
/**
* Returns the availability status of the service for specified url.
*
* @param url - the URL to check status for
* @returns the promise that resolves to privilege status of the service
*/
webAccessStatus(url: string): IPromise<PrivilegeStatus>;
}
Inhoud exporteren
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}