Käyttöoikeuksien myöntäminen ja transaktivoinnin pakottaminen (julkinen esikatselu)

Kun luot Power BI -visualisointeja ladattavaksi AppSourceen, voit nyt hallita ja valvoa niiden käyttöoikeuksia Microsoftin järjestelmien avulla. Loppukäyttäjä määrittää ja hallitsee käyttöoikeuksia tutuilla työkaluilla, kuten Microsoft 365 -hallintakeskuksella, ja käyttöoikeuksien ohjelmointirajapinnan avulla voit valvoa näitä käyttöoikeuksia ja varmistaa, että vain lisensoidut käyttäjät voivat hahmontaa visualisoinnit.

Käyttöoikeuksien pakottamisprosessi

Seuraavassa taulukossa esitetään visualisointien käyttöoikeuksien hallintaan liittyvät vaiheet Microsoftin kautta:

Osa	Tietoja
Tarjouksen luominen kumppanikeskuksessa	Valitse transakti Microsoftin kauppajärjestelmän kautta. Salli Microsoftin hallita käyttöoikeuksia. Määritä hinnoittelu ja saatavuus.
Käyttöoikeuksien valvonnan lisääminen Power BI -visualisointipakettiin	Luo paketti tai määritä se uudelleen käyttämään Power BI:n suorituksenaikaista käyttöoikeutta, joka pakottaa käyttöoikeudet kunkin käyttäjän käyttöoikeuksien mukaan.
Asiakkaat löytävät tarjouksesi AppSourcesta ja ostavat tilauksen	Kun asiakkaat ostavat tarjouksesi AppSourcessa, he saavat myös Power BI -visualisoinnin käyttöoikeudet.
Asiakkaat voivat hallita tilauksiaan ja määrittää tai poistaa käyttöoikeuksia.	Asiakkaat hallitsevat näiden visualisointien tilauksia ja määrittävät käyttöoikeuksia Microsoft 365 -hallintakeskuksessa samalla tavalla kuin muissakin tilauksessaan, kuten missä tahansa muussakin tilauksessaan, kuten Officessa tai Power BI:ssä.
Suorituksenaikaisen tarkistuksen pakottaminen	Anna asiakkaillesi yhtenäinen käyttökokemus, kun suoritat suorituksenaikaisia käyttöoikeustarkistuksia valmiiden ohjelmointirajapintojen avulla.
Näytä raportit kasvun vauhdittamiseksi	Hanki tietoja tuotosta, maksutiedoista sekä tilaus- ja käyttöoikeustiedoista. Tarkastele tietoja käyttöoikeuksista ja tilauksista, jotka on ostettu, uusittu ja peruutettu ajan kuluessa ja maantieteellisen sijainnin mukaan.

Käyttöoikeuksien ohjelmointirajapinta

Käyttöoikeuksien ohjelmointirajapinnan avulla Power BI -visualisointien kehittäjät voivat pakottaa Power BI -visualisointien käyttöoikeuksia. -ohjelmointirajapinta tukee Power BI -visualisointien käyttöoikeuksien tietojen noutamista, jotka on määritetty Power BI -käyttäjälle. Sen avulla voidaan myös käynnistää Power BI -visualisoinnissa näkyvät käyttöoikeuksiin liittyvät ilmoitukset ja ilmoittaa käyttäjälle, että hänen on ostettava puuttuvat käyttöoikeudet. Visualisoinnin ei pitäisi näyttää omaa käyttöoikeuskokemustaan, vaan se käyttää yhtä Power BI:n tukemista ennalta määritetyistä ilmoituksista seuraavissa osissa esitetyllä tavalla.

Lisätietoja Power BI -käyttöoikeuksista on artikkelissa Käyttöoikeuksien pakottaminen.

Muistiinpano

Käyttöoikeuksien ohjelmointirajapinta on saatavilla versiosta 4.7 alkaen. Jos haluat tietää, mitä versiota käytät, tarkista apiVersion pbiviz.json .

Nouda aktiiviselle käyttäjälle määritetyt visualisoinnin palvelusopimukset

Jos haluat määrittää palvelusopimukset, lisää kutsu kohteeseen getAvailableServicePlans (käytettävissä :n kautta IVisualLicenseManager). Yritä suorituskyvyn näkökulmasta hakea käyttöoikeudet kerran, mieluiten - constructor sovelluksessa tai init -kutsuissa, ja tallenna tulos.
Kun käyttöoikeudet on noudettu, ne tallennetaan Power BI -isäntäpuolen välimuistiin Power BI -istunnon aikana, ja kaikki muut samaan kutsut palauttavat välimuistiin tallennetut tiedot.

export interface IVisualLicenseManager {
        getAvailableServicePlans(): IPromise<powerbi.extensibility.visual.LicenseInfoResult>;
    }

Käyttöoikeuksien noutaminen voi olla pitkä toiminto, joten getAvailableServicePlans kutsu on asynkroninen kutsu, ja sitä tulee käsitellä sellaisenaan koodissasi.
Vastauksena -menetelmän LicenseInfoResult kutsumiseen palautetaan -objekti.

export interface LicenseInfoResult {
        plans: ServicePlan[] | undefined;
        isLicenseUnsupportedEnv: boolean; 
        isLicenseInfoAvailable: boolean; 
    }

• plans– aktiivisen käyttäjän tätä visualisointia varten ostamien palvelupakettien matriisi. (Muita visualisointeja varten ostetut käyttöoikeudet eivät sisälly vastaukseen.)
  ServicePlan sisältää palvelun tunnuksen (spIdentifier) ja sen tilan (ServicePlanState).

  • spIdentifier: palvelutunnuksen merkkijonoarvo, joka luodaan, kun määrität tarjouksen palvelupaketteja kumppanikeskuksessa (katso seuraava esimerkki)

  • state – enum (ServicePlanState), joka edustaa määritettyjen palvelupakettien tilaa.
    Tuetut palvelusuunnitelman tilat:

    Vaihe	kuvaus
    Passiivinen	Ilmaisee, että käyttöoikeus ei ole aktiivinen eikä sitä tule käyttää etujen valmisteluun.
    Aktiivinen	Ilmaisee, että käyttöoikeus on aktiivinen ja että sitä voidaan käyttää etujen valmisteluun.
    Varoitus	Ilmaisee, että käyttöoikeus on lisäaika, joka todennäköisesti johtuu maksurikkomuksesta.
    Keskeytetty	Ilmaisee, että käyttöoikeus keskeytetään todennäköisesti maksurikkomuksen vuoksi.
    Tuntematon	Microsoft Sentinel -arvo.

    Vain aktiiviset ja varoitusosat toimivat käyttökelpoisella käyttöoikeudella. Kaikkia muita osavaltioita tulee kohdella niin, että niiden käyttöoikeutta ei saada.

• isLicenseUnsupportedEnv – ilmaisee, että visualisointia hahmonnetaan Power BI -ympäristössä, joka ei tue käyttöoikeuksien hallintaa tai pakottamista. Tällä hetkellä seuraavat Power BI -ympäristöt eivät tue käyttöoikeuksien hallintaa tai käyttöoikeuksien pakottamista:

  • Embedded – Julkaise verkkoon, PaaS embed
  • Kansalliset/alueelliset pilvipalvelut (riippuu kansallisesta tai alueellisesta pilvipalvelusta, jonka tapauksessa niiden toimivuus on yleisesti tuettu)
  • RS-palvelin (ei suunniteltua tukea)
  • Vienti (PDF\PPT) REST-ohjelmointirajapinnan avulla

• isLicenseInfoAvailable - Ilmaisee, voidaanko käyttöoikeustiedot noutaa. Virhe käyttöoikeuksien noutamisessa voi ilmetä, jos Power BI Desktopin käyttäjä ei ole kirjautunut sisään tai häntä ei ole yhdistetty Internetiin (offline-tilassa). Verkossa käyttöoikeuksien nouto voi epäonnistua tilapäisen palvelukatkon vuoksi.

Esimerkki kutsusta getAvailableServicePlans hakea käyttäjän palvelusopimukset tälle visualisoinnille:

private currentUserValidPlans: ServicePlan[] | undefined;
private hasServicePlans: boolean | undefined;
private isLicenseUnsupportedEnv: boolean | undefined;

this.licenseManager.getAvailableServicePlans()
 .then(({ plans, isLicenseUnsupportedEnv, isLicenseInfoAvailable }: LicenseInfoResult) => {
  if (isLicenseInfoAvailable && !isLicenseUnsupportedEnv) {
   this.currentUserValidPlans = plans?.filter(({ spIdentifier, state }) => 
    (state === powerbi.ServicePlanState.Active || state === powerbi.ServicePlanState.Warning)
   );
   this.hasServicePlans = !!currentUserValidPlans?.length;
  }
  this.isLicenseUnsupportedEnv = isLicenseUnsupportedEnv;
 }).catch((err) => {
  this.currentUserValidPlans = undefined;
  this.hasServicePlans = undefined;
  console.log(err);
 });

Muistiinpano

Tässä esimerkissä näytetään vain, miten voit tarkistaa, onko käyttäjällä kelvollisia suunnitelmia tälle visualisoinnille. - plans matriisi voi sisältää eri spIdentifier arvoja, ja kukin tunniste voi esiintyä useita kertoja eri tiloissa.

Ilmoita käyttäjälle, että tarvittavat käyttöoikeudet puuttuvat

Power BI -ympäristö tarjoaa useita käyttökokemuksia, joista voidaan ilmoittaa:

• Käyttöoikeudet tulee ostaa, jotta voit nauttia visualisoinnin toiminnoista
• Tietyn visualisoinnin ominaisuus on estetty puuttuvien käyttöoikeuksien vuoksi
• Koko visualisointi on estetty puuttuvien käyttöoikeuksien vuoksi
• Koko visualisointi on estetty, koska käytössä oleva Power BI -ympäristö ei tue käyttöoikeuksien hallintaa\pakottamista

export interface IVisualLicenseManager {
        notifyLicenseRequired(notificationType: LicenseNotificationType): IPromise<boolean>;
        notifyFeatureBlocked(tooltip: string): IPromise<boolean>;
        clearLicenseNotification(): IPromise<boolean>;
    }

Esimerkki kutsumisesta notifyLicenseRequired:

private defaultNotificationType: powerbi.LicenseNotificationType = powerbi.LicenseNotificationType.General;
private isNotificaitonDisplayed: boolean = false;

if (!this.isNotificaitonDisplayed) {
    const notificationType = this.isLicenseUnsupportedEnv ? powerbi.LicenseNotificationType.UnsupportedEnv : this.defaultNotificationType
    this.licenseManager.notifyLicenseRequired(this.getNotificationType())
        .then((value) => {
            this.isNotificaitonDisplayed = value;
        }).catch((err) => {
            console.log(err);
        });
}

Yleinen kuvake, joka ilmaisee, että pakollinen käyttöoikeus puuttuu

-kutsun LicenseNotificationType.General avulla voit notifyLicenseRequired näyttää kuvakkeen osana visualisoinnin säilöä.
Kun kuvake on käynnistetty, sitä säilytetään koko visualisoinnin elinkaaren ajan, kunnes clearLicenseNotification sitä notifyLicenseRequired kutsutaan.

Muistiinpano

Ilmoitus LicenseNotificationType.General pakotetaan käyttöön vain ympäristöstä, joka tukee käyttöoikeuksien hallintaa ja Power BI:n muokkausskenaarioita. Tämän kutsuminen ympäristössä, jota ei tueta tai kun raportti on lukutilassa tai koontinäytössä, ei käytä kuvaketta ja palauttaa false kutsun vastauksessa.

Esimerkki visualisointinäytöstä, joka sisältää "käyttöoikeudet tarvitaan" -yleisen kuvakkeen:

Peitä visualisoinnin näyttö puuttuvalla käyttöoikeusilmoituksella

-kutsun LicenseNotificationType.VisualIsBlocked avulla voit notifyLicenseRequired peittää visualisoinnin näytön ilmoituksella, että visualisointi on estetty, koska tarvittavat käyttöoikeudet löydettiin puuttumasta.
Kun tämä ilmoitus on käynnistetty, se säilytetään koko visualisoinnin elinkaaren ajan, kunnes clearLicenseNotification sitä notifyLicenseRequired kutsutaan.

Esimerkki visualisointinäytöstä, joka sisältää visualisoinnin estämän ilmoituksen. Power BI Desktop näyttää vain Hanki käyttöoikeus -vaihtoehdon:

Peitä visualisoinnin näyttö ympäristöilmoituksella, jota ei tueta

-kutsun LicenseNotificationType.UnsupportedEnv avulla voit notifyLicenseRequired peittää visualisoinnin näytön ilmoituksella, että visualisointi on estetty, koska käytössä oleva Power BI ei tue käyttöoikeuksien hallintaa\pakottamista.
Kun kuvake on käynnistetty, sitä säilytetään koko visualisoinnin elinkaaren ajan, kunnes clearLicenseNotification sitä notifyLicenseRequired kutsutaan.

Muistiinpano

Ilmoitus LicenseNotificationType.UnsupportedEnv pakotetaan käyttöön vain, kun se kutsutaan kontekstissa, jossa käyttöoikeusympäristöä ei tueta. Tämän kutsuminen muussa ympäristössä ei käytä ilmoitusta ja palauttaa false kutsun vastauksessa.

Esimerkki visualisointinäytöstä, joka sisältää tukemattoman ympäristön ilmoituksen:

Ilmoituspalkki, jossa ilmoitetaan, että tietyn visualisoinnin toimintoja ei voi käyttää

Kun tietyn visualisoinnin toiminto edellyttää käyttöoikeuksia, jotka löytyivät puuttuviksi, voit käyttää notifyFeatureBlocked kutsua, joka näyttää ponnahdusikkunan osana visualisoinnin säilöä. Palkki tukee myös mukautettua työkaluvihjettä, jonka voit määrittää ja jonka avulla voit antaa lisätietoja ilmoituksen käynnistävästä ominaisuudesta.

Muistiinpano

Ominaisuus on estetty ilmoitus pakotetaan käyttöön vain, kun molemmat seuraavat ehdot täyttyvät:

• Sitä kutsutaan tuetuista käyttöoikeusympäristöistä
• Peitteiden estämistä ei käytetä (LicenseNotificationType.UnsupportedEnv, LicenseNotificationType.VisualIsBlocked).

Tämän ilmoituksen kutsuminen ei-tuettuun ympäristöön ei käytä ilmoitusta eikä palauta false kutsun vastauksessa.

Muistiinpano

Jotta voit tukea lokalisoitua Power BI -ympäristöä, suosittelemme, että säilytät käytössä olevien työkaluvihjeiden lokalisoidut versiot. Nouda Power BI:n kieli lokalisointi-ohjelmointirajapinnan avulla.

Kun palkki on käynnistetty, se näytetään 10 sekunnin ajan tai kunnes toinen estetty ominaisuuspalkki käynnistyy tai kunnes clearLicenseNotification kutsutaan (mikä tulee ensin).

Esimerkki visualisointinäytöstä, joka sisältää "ominaisuus estetty" -ilmoituspalkin ilmoituksen:

Lisensoidun visualisoinnin testaaminen

Lisensoidun visualisoinnin testaaminen loppuun ennen sen julkistamista:

• Jos olet luomassa täysin uutta tarjousta, lisää visualisointi testiasiakkaan tilin yksityiseksi palvelusopimukseksi. Tarjous näkyy vain tälle testitilille ostettaessa. Vahvista tarjous ennen sen julkistamista tämän tilin avulla.
• Jos visualisointi on jo käytettävissä AppSourcessa ja haluat päivittää sen lisensoiduksi visualisoinnille, et voi tehdä siitä yksityistä palvelupakettia , koska se piilottaa visualisoinnin AppSourcesta, eivätkä olemassa olevat käyttäjäsi voi käyttää sitä. Tällä hetkellä julkaistun visualisoinnin loppumista ei voi testata millään tavalla. Testaa sitä samalla tavalla kuin testasit alkuperäistä visualisointia AppSourcessa pilkkaamalla käyttöoikeuksien ohjelmointirajapinnan arvoa, jotta voit tarkistaa eri mahdollisuudet.

Huomioitavat asiat ja rajoitukset

• Ominaisuuspalkin työkaluvihje on rajoitettu 500 char:lla.
• Ominaisuuden työkaluvihje edellyttää lokalisointia.
• Käyttöoikeuksien niputtamista (eli yhtä käyttöoikeutta, joka kattaa useita saman julkaisijan tarjouksia) ei vielä tueta.

Liittyvä sisältö

Power BI:n mukautetun visualisoinnin julkaiseminen

Onko sinulla lisää kysymyksiä? Voit esittää kysymyksiä Power BI -yhteisössä