检查权限 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>;
}