Kontrola rozhraní API pro oprávnění

Jako vývojář vizuálů Power BI můžete vyvíjet vizuály, které potřebují oprávnění pro přístup k různým prostředkům. Tato oprávnění si vyžádáte v části oprávnění souboru capabilities.json . Mezi tato oprávnění patří možnost přístupu:

• vzdálené prostředky nebo weby
• místní úložiště pro stahování dat

Správce každé organizace může tato oprávnění povolit nebo zablokovat. Rozhraní API pro kontrolu oprávnění umožňuje dotazovat se hostitele za běhu, abyste zjistili, která oprávnění jsou udělena. Tyto informace můžete použít k návrhu vizuálu, který bude pracovat s různými nastaveními oprávnění.

Rozhraní API pro kontrolu oprávnění vrátí stav každé funkce dotazu na oprávnění:

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

Jak používat rozhraní API pro kontrolu oprávnění

Každé rozhraní API oprávnění má vlastní metodu dotazu, která kontroluje stav oprávnění. Stav oprávnění může být jeden z následujících:

• Povoleno
• Není deklarováno
• Nepodporováno
• Zakázáno službou Správa

Webový pří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>;
}

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

Související obsah

Rozhraní API vlastních vizuálů Power BI