Verificar permissões API
Como desenvolvedor de visuais do Power BI, você pode desenvolver elementos visuais que precisam de permissão para acessar vários recursos. Você solicita essas permissões na seção de privilégios do arquivo capabilities.json . Esses privilégios incluem a capacidade de acessar:
- Recursos remotos ou sites
- armazenamento local para download de dados
O administrador de cada organização pode permitir ou bloquear essas permissões. A API de permissões de verificação permite que você consulte o host em tempo de execução para determinar quais permissões são concedidas. Você pode usar essas informações para criar um visual que funcionará com várias configurações de permissão.
A API de permissões de verificação retorna o status de cada função de consulta de permissão:
/**
* 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,
}
Como usar a API de permissões de verificação
Cada API de privilégio tem seu próprio método de consulta para verificar o status de permissão. O status da permissão pode ser um dos seguintes:
- Permitido
- Não declarado
- Não suportado
- Desativado pelo administrador
Acesso à 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>;
}
Exportar conteúdo
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}