Kontrollera behörighets-API
Som utvecklare av visuella Power BI-objekt kan du utveckla visuella objekt som behöver behörighet att komma åt olika resurser. Du begär dessa behörigheter i behörighetsavsnittet i capabilities.json-filen . Dessa behörigheter omfattar möjligheten att komma åt:
- fjärrresurser eller webbplatser
- lokal lagring för nedladdning av data
Varje organisations administratör kan tillåta eller blockera dessa behörigheter. Med API :et för kontrollbehörigheter kan du fråga värden vid körning för att avgöra vilka behörigheter som beviljas. Du kan använda den här informationen för att utforma ett visuellt objekt som fungerar med olika behörighetsinställningar.
API:et för kontrollbehörigheter returnerar status för varje behörighetsfrågasfunktion:
/**
* 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å här använder du API:et för kontrollbehörigheter
Varje behörighets-API har en egen frågemetod för att söka efter behörighetsstatus. Behörighetsstatusen kan vara något av följande:
- Tillåtet
- Inte deklarerad
- Stöds inte
- Inaktiverad av administratör
Webbåtkomst
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>;
}
Exportera innehåll
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}