Machtigingen-API controleren

Als ontwikkelaar van Power BI-visuals kunt u visuals ontwikkelen die toegang nodig hebben tot verschillende resources. U vraagt deze machtigingen aan in de sectie bevoegdheden van het bestand capabilities.json . Deze bevoegdheden omvatten de mogelijkheid om toegang te krijgen tot:

• externe bronnen of websites
• lokale opslag voor het downloaden van gegevens

De beheerder van elke organisatie kan deze machtigingen toestaan of blokkeren. Met de API voor controlemachtigingen kunt u tijdens runtime een query uitvoeren op de host om te bepalen welke machtigingen worden verleend. U kunt deze informatie gebruiken om een visual te ontwerpen die werkt met verschillende machtigingsinstellingen.

De API voor controlemachtigingen retourneert de status van elke machtigingsqueryfunctie:

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

De API voor controlemachtigingen gebruiken

Elke privilege-API heeft een eigen querymethode om te controleren op de machtigingsstatus. De machtigingsstatus kan een van de volgende zijn:

• Toegestaan
• Niet gedeclareerd
• Niet ondersteund
• Uitgeschakeld door Beheer

Webtoegang

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

Inhoud exporteren

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

Gerelateerde inhoud

Aangepaste VISUELE API voor Power BI