Kontroller tillatelses-API-en
Som utvikler av Power BI-visualobjekter kan du utvikle visualobjekter som trenger tillatelse til å få tilgang til ulike ressurser. Du ber om disse tillatelsene i rettigheter-delen av capabilities.json-filen . Disse rettighetene inkluderer muligheten til å få tilgang til:
- eksterne ressurser eller nettsteder
- lokal lagringsplass for nedlasting av data
Hver organisasjons administrator kan tillate eller blokkere disse tillatelsene. Med API-en for kontrolltillatelser kan du spørre verten ved kjøretid for å finne ut hvilke tillatelser som gis. Du kan bruke denne informasjonen til å utforme et visualobjekt som fungerer med ulike tillatelsesinnstillinger.
API-en for kontrolltillatelser returnerer statusen for hver tillatelsesspørringsfunksjon:
/**
* 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,
}
Slik bruker du API-en for kontrolltillatelser
Hver rettighets-API har sin egen spørringsmetode for å se etter tillatelsesstatusen. Tillatelsesstatusen kan være ett av følgende:
- Tillatt
- Ikke deklarert
- Støttes ikke
- Deaktivert av administrator
Webtilgang
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>;
}
Eksporter innhold
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}