Periksa API izin
Sebagai pengembang visual Power BI, Anda dapat mengembangkan visual yang memerlukan izin untuk mengakses berbagai sumber daya. Anda meminta izin ini di bagian hak istimewa file capabilities.json . Hak istimewa ini mencakup kemampuan untuk mengakses:
- sumber daya jarak jauh atau situs web
- penyimpanan lokal untuk mengunduh data
Admin setiap organisasi dapat mengizinkan atau memblokir izin ini. API izin pemeriksaan memungkinkan Anda mengkueri host pada runtime untuk menentukan izin mana yang diberikan. Anda dapat menggunakan informasi ini untuk merancang visual yang akan berfungsi dengan berbagai pengaturan izin.
API izin pemeriksaan mengembalikan status setiap fungsi kueri izin:
/**
* 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,
}
Cara menggunakan API periksa izin
Setiap API hak istimewa memiliki metode kuerinya sendiri untuk memeriksa status izin. Status izin bisa menjadi salah satu hal berikut ini:
- Diizinkan
- Tidak dinyatakan
- Tidak didukung
- Dinonaktifkan oleh Admin
Akses 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>;
}
Ekspor konten
export interface IDownloadService {
/**
* Returns the availability status of the service.
*
* @returns the promise that resolves to privilege status of the service
*/
exportStatus(): IPromise<PrivilegeStatus>;
}