Kontrola rozhrania API povolení
Ako vývojár vizuálov služby Power BI môžete vyvíjať vizuály, ktoré potrebujú povolenie na prístup k rôznym zdrojom. Tieto povolenia si vyžiadate v sekcii oprávnení capabilities.json súboru. Tieto oprávnenia zahŕňajú možnosť prístupu:
- vzdialené zdroje alebo webové lokality
- lokálny ukladací priestor na sťahovanie údajov
Správca každej organizácie môže tieto povolenia povoliť alebo zablokovať. Rozhranie API na kontrolu povolení umožňuje dotazovať hostiteľa v režime runtime a určiť, ktoré povolenia sa udeľujú. Tieto informácie môžete použiť na navrhnutie vizuálu, ktorý bude fungovať s rôznymi nastaveniami povolení.
Rozhranie API na kontrolu povolení vráti stav každej funkcie dotazu povolenia:
/**
* 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,
}
Používanie rozhrania API na kontrolu povolení
Každé oprávnenie rozhrania API má svoju vlastnú metódu dotazu na kontrolu stavu povolenia. Stav povolenia môže byť niektorý z týchto stavov:
- Povolený
- Nie je deklarované
- Nepodporované
- Zakázané správcom
Webový prístup
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>;
}
Exportovanie obsahu
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}