Dodavanje Power BI izvješća ili nadzorne ploče na web-stranicu portala

Savjet

U ovom se članku objašnjava kako dodati Power BI izvješće ili nadzornu ploču pomoću oznake Powerbi Liquid. Da biste dodali Power BI komponentu na web-stranicu portala pomoću portala Studio, idite na Dodavanje komponente Power BI na web-stranicu pomoću portala Studio.

Izvješće o Power BI ili nadzornu ploču možete dodati na web-stranicu portala pomoću oznake powerbi Liquid. Upotrijebite oznaku powerbi u polju Kopiranje na web-stranici ili u polju Izvor u web-predlošku.

Ako dodajete Power BI izvješće ili nadzornu ploču stvorenu u novom radnom prostoru Power BI, morate navesti vrstu provjere autentičnosti kao powerbiembedded u powerbi liquid oznaci.

Napomena

  • Ako ste naveli AAD kao vrstu provjere autentičnosti u powerbi liquid oznaci, morate je zajednički koristiti s potrebnim korisnicima prije dodavanja izvješća o sigurnom Power BI ili nadzorne ploče na web-stranicu portala. Dodatne informacije: Zajedničko korištenje radnog prostora Power BI i zajedničko korištenje nadzorne ploče i izvješća Power BI.
  • powerbiembedded podržava Power BI nadzorne ploče i izvješća koja se povezuju sa servisom Azure Analysis Services. Također možete koristiti svojstvo "customdata" u liquid kodu za prosljeđivanje vrijednosti za svojstvo CustomData.

Na primjer:

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}

Da biste saznali kako doći do putanje nadzorne ploče i ID-a pločice nadzorne ploče, pogledajte odjeljke u nastavku ovog članka.

Korištenje nadzorne ploče ili izvješća za povezivanje sa uslugama Azure Analysis Services

Možete dodati oznaku powerbi Liquid s nadzornom pločom ili izvješćem koje se povezuje s uslugama Azure Analysis Services.

Da biste dodali nadzornu ploču ili izvješće koje se povezuje s uslugama Azure Analysis Services, upotrijebite parametar CustomData u nizu veze.

Na primjer:

{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/<GroupID>/reports/<ReportID>" roles:"<roles associated with report>" customdata:"<customdata>" %}

Neobavezna oznaka customdata se može konfigurirati kao niz ili generirati dinamički na temelju atributa objekta, koristeći tačku (".") ili uglate zagrade ("[]") za odvajanje između objekta i atributa, između dva para vitičastih zagrada.

Primjeri:

  • customdata: {{ object.attribute }}
  • customdata: {{ object[attribute] }}

Budući da oznaka customdata vraća niz, možda će biti potrebno pretvoriti ovaj niz u cijeli broj u DAX upitu.

Važno

Azure Analysis Services i uloge (RLS)

Oznaka uloge nije obavezna za izvješća i nadzorne ploče na temelju usluga Azure Analysis Services. Kad se ne koristi, uloga se vraća na zadanu ulogu kojoj je aplikacija dodijeljena u uslugama Azure Analysis Services.

Međutim, ova će oznaka možda biti neophodna za određivanje određene uloge (ili uloga) između nekoliko dostupnih uloga i možda će i dalje biti potrebna prilikom upotrebe zaštite na razini retka.

Uloge su sadržane u bazi podataka servisa Azure Analysis Services, a ne u samom izvješću, za razliku od drugih vrsta izvješća Power BI.

  • Nedodjeljivanje uloga u Liquid kodu.

    Ako u Liquid kodu nije navedena nijedna uloga, uloga usluga Azure Analysis Services određivat će se ulogama kojima aplikacija ima pristup i filtrirat će rezultate na temelju zadanih prilagođenih podataka prema DAX upitu u ulogama. Odnosno, sve dostupne uloge kombinirat će svoje pristupe, ali će i dalje filtrirati ako su navedeni prilagođeni podaci relevantni. Ovaj će scenarij najčešće biti slučaj s izvješćima usluga Azure Analysis Services ili nadzornim pločama s jednom pločicom.

  • Dodjela uloga u Liquid kodu.

    Uloge usluga Azure Analysis Services mogu se dodijeliti u Liquid kodu, slično RLS ulogama. Upotreba ovih uloga može biti potrebna kada je dostupno više uloga, ali želite koristiti određene uloge za stranicu. Kada koristite bilo koju ulogu u nizu veze, mora se navesti uloga usluga Azure Analysis Services. Na primjer, nadzorne ploče s više pločica koje koriste pločice usluga Azure Analysis Services s RLS pločicama.

    Prilikom upotrebe pločica usluga Azure Analysis Services na nadzornoj ploči važe sljedeća razmatranja:

    • Ako se pločica usluga Azure Analysis Services koristi na nadzornoj ploči s drugim pločicama koje zahtijevaju uloge, uloga usluga Azure Analysis Services mora se dodati na popis uloga.
    • Više pločica iz različitih izvora usluga Azure Analysis Services može se koristiti sa vlastitim ulogama, ali prilagođeni podaci moraju biti isti za svaku, a više vrijednosti prilagođenih podataka ne može se koristiti u Liquid kodu. Oznaka customdata i parametar customdata za EffectiveIdentity uzimaju samo vrijednost niza.

Dohvaćanje putanje nadzorne ploče ili izvješća

  1. Prijavite se u Power BI.

  2. Otvorite nadzornu ploču ili izvješće koji želite ugraditi u vaš portal.

  3. Kopirajte URL iz adresne trake.

    Nabavite put Power BI nadzorne ploče.

Dohvaćanje ID-ja pločice nadzorne ploče

  1. Prijavite se u Power BI.

  2. Otvorite nadzornu ploču iz koje želite ugraditi pločicu u vaš portal.

  3. Pokažite na pločicu, odaberite Više mogućnosti, a zatim odaberite Otvaranje u načinu fokusiranja.

    Otvorite Power BI pločicu nadzorne ploče u načinu fokusa.

  4. Kopirajte ID pločice iz URL-a na adresnoj traci. ID pločice je vrijednost nakon /pločice/.

    Power BI ID pločice nadzorne ploče.

Način upotrebe powerbi-client JavaScript biblioteku na portalima

JavaScript biblioteku powerbi klijenta možete koristiti prilikom ugrađivanja Power BI izvješća ili nadzornih ploča na portal. Dodatne informacije o JavaScript biblioteci powerbi-klijenta potražite na Power BI JavaScript wikiju.

U nastavku je uzorak značajke JavaScript za ažuriranje postavki izvješća ili za obradu događaja. Ovaj uzorak onemogućuje okno filtra, onemogućuje navigaciju stranicom i omogućuje događaj dataSelected.

Važno

Upotrijebite powerbi-client JavaScript biblioteku da biste onemogućili ili omogućili okno filtra. Međutim, ako želite ograničiti pristup podacima ili konfigurirati sigurnost, koristite sigurnost na razini retka (RLS) s Power BI. Onemogućivanje okna filtra ne ograničava pristup podacima i može se ponovno omogućiti pomoću koda JavaScript biblioteke.

$(document).ready(function () {
    var embedContainer = $(".powerbi")[0];
    if (embedContainer) {
        var report = powerbi.get(embedContainer);
        report.on("loaded", function () {
            report.updateSettings({
                panes: {
                    filters: {
                        visible: false
                    },
                    pageNavigation: {
                        visible: false
                    }
                }
            }).catch(function (errors) {
                console.log(errors);
            });
        })
    }
});

Za dodavanje prilagođenog jezika JavaScript na web-stranicu:

  1. Otvorite aplikaciju za upravljanje portalom.
  2. U lijevom oknu odaberite Web-stranice.
  3. Odaberite web-stranicu koja sadrži Power BI izvješće ili nadzornu ploču.
  4. Odaberite karticu Napredno.
  5. Kopirajte i zalijepite JavaScript u odjeljak Prilagođeni JavaScript.
  6. Odaberite Spremi i zatvori.

Pogledajmo sad primjere JavaScript operacija i različite mogućnosti.

Dohvaćanje reference na ugrađeno HTML izvješće

Dohvatite referencu na ugrađeno HTML izvješće.

var embedContainer = $(".powerbi")[0];

Dodatne informacije: Dobiti referencu na postojeću Power BI komponentu s obzirom na element koji sadrži

Dohvaćanje reference na ugrađeno HTML izvješće

var report = powerbi.get(embedContainer);

Rad s Power BI oknima

Postavke za okna možete koristiti za rad s Power BI oknima na web-stranici portala. Na primjer, možete upotrijebiti postavku filtara da biste sakrili ili prikazali okno ili raditi s postavkom navigacije po stranici.

U nastavku je primjer za uklanjanje okna filtara:

report.updateSettings({
            panes: {
                filters :{
                    visible: false
                }
            }
        }).catch(function (errors) {
            console.log(errors);
        });

U nastavku je primjer za rad i s navigacijom po stranici i s filtrima:

report.updateSettings({
            panes: {
                filters :{
                    visible: false
                },
                pageNavigation:{
                    visible: false
                }
            }
        }).catch(function (errors) {
            console.log(errors);
        });

Više informacija: Ažuriranje postavki i Ugrađivanje konfiguracije – Postavke

Obrada događaja

Ugrađena komponenta može emitirati događaje nakon pozivanja na završetak izvršene naredbe. Na primjer, u nastavku je uzorak za događaj dataSelected.

//Report.off removes a given event listener if it exists
    report.off("dataSelected");
//Report.on will add an event list
    report.on('dataSelected', function(event){
        console.log('Event - dataSelected:');
        console.log(event.detail);
    })

Više informacija: Obrada događaja

Pogledajte