Share via


İzinleri denetleme API'si

Power BI görsellerinin geliştiricisi olarak, çeşitli kaynaklara erişmek için izin gerektiren görseller geliştirebilirsiniz. Capabilities.json dosyasının privileges bölümünde bu izinleri istiyorsunuz. Bu ayrıcalıklar şunlara erişme olanağını içerir:

  • uzak kaynaklar veya web siteleri
  • verileri indirmek için yerel depolama alanı

Her kuruluşun yöneticisi bu izinlere izin verebilir veya bunları engelleyebilir. İzinleri denetleme API'si, hangi izinlerin verildiğini belirlemek için çalışma zamanında konağı sorgulamanıza olanak tanır. Çeşitli izin ayarlarıyla çalışacak bir görsel tasarlamak için bu bilgileri kullanabilirsiniz.

İzinleri denetleme API'si her izin sorgusu işlevinin durumunu döndürür:

/**
 * 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,
}

Denetim izinleri API'sini kullanma

Her ayrıcalık API'sinin izin durumunu denetlemek için kendi sorgu yöntemi vardır. İzin durumu aşağıdakilerden biri olabilir:

  • İzin Verilir
  • Bildirilmemiş
  • Desteklenmez
  • Yönetici tarafından devre dışı bırakıldı

Web erişimi

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

İçeriği dışarı aktarma

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

Power BI özel görsel API'si