Comprobación de la API de permisos
Como desarrollador de objetos visuales de Power BI, puede desarrollar objetos visuales que necesiten permiso para acceder a varios recursos. Estos permisos se solicitan en la sección de privilegios del archivo capabilities.json. Estos privilegios incluyen la capacidad de acceder a lo siguiente:
- recursos remotos o sitios web
- almacenamiento local para descarga de datos
El administrador de cada organización puede permitir o bloquear estos permisos. La API de comprobación de permisos permite consultar el host en tiempo de ejecución para determinar qué permisos se conceden. Puede usar esta información para diseñar un objeto visual que funcione con varias opciones de configuración de permisos.
La API de comprobación de permisos devuelve el estado de cada función de consulta de permisos:
/**
* 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,
}
Uso de la API de comprobación de permisos
Cada API de privilegios tiene su propio método de consulta para comprobar el estado del permiso. El estado del permiso puede ser uno de los siguientes:
- Permitida
- No declarado
- No compatible
- Deshabilitado por el administrador
Acceso 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 contenido
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}