Kontrola rozhrania API povolení

Ako vývojár vizuálov služby Power BI môžete vyvíjať vizuály, ktoré potrebujú povolenie na prístup k rôznym zdrojom. Tieto povolenia si vyžiadate v časti oprávnení v súbore capabilities.json . Tieto oprávnenia zahŕňajú možnosť prístupu:

• vzdialené zdroje alebo webové lokality
• lokálny ukladací priestor na sťahovanie údajov

Správca každej organizácie môže tieto povolenia povoliť alebo zablokovať. Rozhranie API na kontrolu povolení umožňuje dotazovať hostiteľa v režime runtime a určiť, ktoré povolenia sa udeľujú. Tieto informácie môžete použiť na navrhnutie vizuálu, ktorý bude fungovať s rôznymi nastaveniami povolení.

Rozhranie API na kontrolu povolení vráti stav každej funkcie dotazu povolenia:

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

Používanie rozhrania API na kontrolu povolení

Každé oprávnenie rozhrania API má svoju vlastnú metódu dotazu na kontrolu stavu povolenia. Stav povolenia môže byť niektorý z týchto stavov:

• Povolené
• Nie je deklarované
• Nie je podporované
• Zakázané Spravovanie

Webový prístup

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

Exportovanie obsahu

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

Súvisiaci obsah

Rozhranie API vlastných vizuálov služby Power BI