Kontrollér API'en for tilladelser
Som udvikler af Power BI-visualiseringer kan du udvikle visualiseringer, der skal have tilladelse til at få adgang til forskellige ressourcer. Du anmoder om disse tilladelser i afsnittet rettigheder i filen capabilities.json . Disse rettigheder omfatter muligheden for at få adgang til:
- fjernressourcer eller websteder
- lokalt lager til download af data
Hver organisations administrator kan tillade eller blokere disse tilladelser. Api'en til kontroltilladelser giver dig mulighed for at forespørge værten på kørselstidspunktet for at bestemme, hvilke tilladelser der tildeles. Du kan bruge disse oplysninger til at designe en visualisering, der fungerer med forskellige tilladelsesindstillinger.
API'en til kontroltilladelser returnerer status for hver tilladelsesforespørgselsfunktion:
/**
* 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,
}
Sådan bruger du API'en til kontrol af tilladelser
Alle rettigheds-API'er har sin egen forespørgselsmetode til at kontrollere tilladelsesstatussen. Tilladelsesstatussen kan være en af følgende:
- Tilladt
- Ikke erklæret
- Ikke understøttet
- Deaktiveret af administrator
Webadgang
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>;
}
Eksportér indhold
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}