檢查權限 API
身為 Power BI 視覺效果的開發人員，您可以開發需要存取各種資源權限的視覺效果。 您可以在 capabilities.json 檔案的 privileges 區段中要求這些權限。 這些權限包括能夠存取：
- 遠端資源或網站
- 用於下載資料的本機記憶體
每個組織的系統管理員都可以允許或封鎖這些權限。 檢查權限 API 可讓您在執行階段查詢主機，以判斷授與哪些權限。 您可以使用這項資訊來設計將搭配各種權限設定使用的視覺效果。
檢查權限 API 會傳回每個權限查詢函式的狀態：
/**
* 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,
}
如何使用檢查權限 API
每個權限 API 都有自己的查詢方法來檢查權限狀態。 權限狀態可以是下列其中一項：
- 允許
- 未宣告
- 不支援
- 由系統管理員停用
Web 存取
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>;
}
匯出內容
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}