Share via

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

  • Artikkeli

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 -hallintakeskus. 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
Tarjouksenluominen 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 -hallintakeskus samalla tavalla kuin muissakin 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 alla kuvatulla 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 apiVersionpbiviz.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 se tulee käsitellä samalla tavalla 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) Screenshot showing an example of a Service ID string.

    • 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 Sentinelertiarvo.

      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 (yllä olevan kuvan palvelutunnuksella):

this.licenseManager.getAvailableServicePlans().then((result: LicenseInfoResult) => {
            this.notificationType = result.isLicenseUnsupportedEnv ?  powerbi.LicenseNotificationType.UnsupportedEnv : powerbi.LicenseNotificationType.General;
            this.hasServicePlans = !!(result.plans && result.plans.length && result.plans[0].spIdentifier == "test_isvconnect1599092224747.powerbivisualtransact.plan1" && 
                ( result.plans[0].state == powerbi.ServicePlanState.Active ||  result.plans[0].state == powerbi.ServicePlanState.Warning));
            
            // display notification if the user doesn't have licenses
            if (!this.hasServicePlans) {
                this.licenseManager.notifyLicenseRequired(this.notificationType).then((value) => {
                    if (value) {
                        this.isIconDisplayed = true;
                    }
                }).catch((err) => {
                    console.log('ERROR', err);
                })
            }
        }).catch((err) => {
            this.hasServicePlans = undefined;
            console.log(err);
        });

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

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, se säilytetään koko visualisoinnin elinkaaren ajan, kunnes clearLicenseNotification sitä notifyLicenseRequired kutsutaan.

Muistiinpano

Ilmoitus LicenseNotificationType.General pakotetaan käyttöön vain, kun molemmat otetaan käyttöön: sitä tuetaan käyttöoikeusympäristössä ja Power BI:n Muokkaa-skenaarioissa. Tämän kutsuminen ympäristössä, jota ei tueta tai kun raportti on lukutilassa tai koontinäytössä, ei käytä kuvaketta ja se palauttaa false kutsun vastauksen.

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

visual display containing the

visual display containing the

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 se kutsutaan.notifyLicenseRequired

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

Visual display containing the *visual blocked* notification.

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, se 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 missä tahansa muussa ympäristössä ei ota ilmoitusta käyttöön, ja se palaa false kutsun vastaukseksi.

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

visual display containing the

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 avautuu palkkiin 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 kutsutaan käyttöoikeusympäristön tuetun kontekstin yhteydessä, eikä estä suojausta käytetä (LicenseNotificationType.UnsupportedEnv, LicenseNotificationType.VisualIsBlocked). Tämän ilmoituksen kutsuminen ympäristössä, jota ei tueta, ei ota ilmoitusta käyttöön ja se palaa false kutsun vastaukseksi.

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 "ominaisuus estetty" -banneri käynnistyy tai kunnes clearLicenseNotification sitä kutsutaan (mikä tulee ensin).

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

visual display containing the

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 ostettavaksi. Vahvista tarjous ennen sen julkistamista tämän tilin avulla.
  • Jos visualisointi on jo käytettävissä AppSourcessa ja haluat päivittää sen lisensoituun visualisointiin, 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 saman julkaisijan useita tarjouksia) ei vielä tueta.

Liittyvä sisältö

Power BI:n mukautetun visualisoinnin julkaiseminen

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