检查权限 API

作为 Power BI 视觉对象的开发人员，可以开发需要访问各种资源的权限的视觉对象。 需要在 capabilities.json 文件的 privileges 部分请求这些权限。 这些特权包括访问以下内容的能力：

• 远程资源或网站

• 用于下载数据的本地存储

每个组织的管理员都可以允许或阻止这些权限。 通过检查权限 API，可以在运行时查询主机，确定授予哪些权限。 使用此信息，可以设计一个将处理各种权限设置的视觉对象。

检查权限 API 返回每个权限查询函数的状态：

TypeScript复制

/**
 * 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 访问

TypeScript复制

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;
}

导出内容

TypeScript复制

export interface IDownloadService {    /**
     * Returns the availability status of the service.
     * 
     * @returns the promise that resolves to privilege status of the service
     */
    exportStatus(): IPromise;
}