Käyttöoikeuksien tarkistusten ohjelmointirajapinta
Power BI -visualisointien kehittäjänä voit kehittää visualisointeja, jotka tarvitsevat käyttöoikeuden eri resursseihin. Voit pyytää näitä käyttöoikeuksia capabilities.json-tiedoston Käyttöoikeudet-osassa. Näitä oikeuksia ovat esimerkiksi mahdollisuus käyttää:
- etäresurssit tai verkkosivustot
- paikallinen tallennustila tietojen lataamista varten
Kunkin organisaation järjestelmänvalvoja voi sallia tai estää nämä oikeudet. Tarkistusoikeuksien ohjelmointirajapinnan avulla voit tehdä kyselyn isännälle suorituksen aikana ja määrittää, mitkä käyttöoikeudet on myönnetty. Näiden tietojen avulla voit suunnitella visualisoinnin, joka toimii eri käyttöoikeusasetusten kanssa.
Tarkistusoikeuksien ohjelmointirajapinta palauttaa jokaisen käyttöoikeuskyselyfunktion tilan:
/**
* 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,
}
Tarkistusoikeuksien ohjelmointirajapinnan käyttäminen
Jokaisella oikeuden ohjelmointirajapinnalla on oma kyselymenetelmänsä käyttöoikeuksien tilan tarkistamista varten. Käyttöoikeuden tila voi olla jokin seuraavista:
- Sallittu
- Ei esimääritetä
- Ei tueta
- Järjestelmänvalvojan käytöstä poistama
Verkkokäyttö
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>;
}
Sisällön vieminen
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}