Jaa

Power BI -raportin tai koontinäytön lisääminen verkkosivulle portaalissa

  • Artikkeli

Huomautus

Vihje

Tässä artikkelissa kerrotaan, miten Power BI -raportti tai -koontinäyttö lisätään käyttämällä powerbi-liquid-tunnistetta. Jos haluat lisätä Power BI -komponentin verkkosivulle portaalissa käyttämällä portaalistudiota, siirry kohtaan Lisää Power BI -komponentti verkkosivustolle käyttäen portaalistudiota.

Voit lisätä Power BI -raportin tai -koontinäytön portaalin verkkosivulle käyttämällä powerbi-Liquid-tunnistetta. Käytä powerbi-tunnistetta verkkosivun Kopioi-kentässä tai verkkomallin Lähde-kentässä.

Jos olet lisäämässä Power BI -raporttia tai -koontinäyttöä, joka on luotu Power BI:n uudessa työtilassa, sinun on määritettävä todentamistyypiksi powerbiembedded powerbi-liquid-tunnisteessa.

Huomautus

  • Jos olet määrittänyt powerbi-Liquid-tunnisteessa todennustyypiksi Microsoft Entra ID, jaa se vaadittujen käyttäjien kanssa, ennen kuin lisäät portaalin verkkosivulle suojatun Power BI -raportin tai koontinäytön. Lisätietoja: Power BI -työtilan jakaminen ja Power BI -koontinäytön ja -raportin jakaminen.
  • powerbiembedded tukee Power BI -koontinäyttöjä ja -raportteja, jotka luovat yhteyden Azure Analysis Servicesiin. Voit käyttää myös liquid-koodin "customdata"-ominaisuutta siirtääksesi arvon CustomData-ominaisuudelle.
  • Sivutettuja Power BI -raportteja ei tueta.

Esimerkki:

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

Lisätietoja koontinäytön polusta ja koontinäytön ruudun tunnuksesta on jäljempänä tässä artikkelissa.

Azure Analysis Servicesiin yhdistävän koontinäytön tai raportin käyttäminen

Voit lisätä powerbi-liquid-tunnisteen koontinäyttöön tai raporttiin, joka yhdistää Azure Analysis Servicesiin.

Jos haluat lisätä koontinäytön tai raportin, joka yhdistää Azure Analysis Servicesiin, käytä yhteysmerkkijonossa CustomData-parametria.

Esimerkki:

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

Valinnaisen customdata-tunnisteen voi määrittää merkkijonoksi tai sen voi luoda dynaamisesti objektin määritteen mukaan käyttämällä pistettä (".") tai hakasulkeita ("[]"), jotta objekti ja määritte erotellaan, kaksien aaltosulkeiden välissä.

Esimerkkejä:

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

Kun customdata-tunniste palauttaa merkkijonon, voi olla tarpeen muuntaa merkkijono kokonaisluvuksi DAX-kyselyssä.

Tärkeä

Azure Analysis Services ja roolit (Azure Analysis Services and Roles, RLS)

Tunniste roolit on valinnainen Azure Analysis Servicesiin pohjautuvissa raporteissa ja koontinäytöissä. Kun roolia ei käytetä, roolin oletusarvo on rooli, joka sovellukselle on määritetty Azure Analysis Servicesissä.

Tämä tunniste voi kuitenkin olla tarpeellinen tietyn roolin (tai roolien) määrittämisessä useiden käytössä olevien roolien joukosta, ja sitä saatetaan vaatia rivitason suojausta käytettäessä.

Roolit sisältyvät Azure Analysis Services -tietokantaan eivätkä itse raporttiin, toisin kuin muissa Power BI -raporttityypeissä.

  • Ei rooleja liquid-koodissa.

    Jos liquid-koodissa ei ole roolia, Azure Analysis Services -roolin määrittää rooli, jota sovellus voi käyttää, ja tulokset suodatetaan annettujen mukautettujen tietojen pohjalta roolissa (rooleissa) olevaa DAX-kyselyä vastaan. Tämä tarkoittaa, että kaikki käytössä olevat roolit yhdistävät käyttöoikeutensa, mutta ne suodatetaan, jos mukautetut tiedot ovat olennaisia. Tämä skenaario on yleisin Azure Analysis Services -raporttien ja yksiruutuisten koontinäyttöjen tapauksissa.

  • Roolien määrittäminen liquid-koodissa.

    Azure Analysis Services -roolit voi määrittää liquid-koodissa, samoin kuin RLS-roolit. Näiden roolien käyttäminen voi olla tarpeen silloin, kun käytettävissä on useita rooleja, mutta sivulla on syytä käyttää tiettyjä rooleja. Kun käytät yhteysmerkkijonon rooleja, Azure Analysis Services -rooli on määritettävä. Esimerkiksi moniruutuiset koontinäytöt, jotka käyttävät Azure Analysis Services -ruutuja ja RLS-ruutuja.

    Kun käytät Azure Analysis Services -ruutuja koontinäytössä, ota huomioon seuraavat seikat:

    • Jos Azure Analysis Services -ruutua käytetään koontinäytössä, joissa on muita rooleja vaativia ruutuja, Azure Analysis Services -rooli on lisättävä rooliluetteloon.
    • Azure Analysis Services -lähteiden eri ruutuja voi käyttää omilla rooleillaan, mutta mukautettujen tietojen on oltava kaikille samat, ja useita mukautettujen tietojen arvoja ei voi käyttää liquid-koodissa. EffectiveIdentityn customdata-tunniste ja customdata -parametri tarvitsevat vain merkkijonoarvon.

Koontinäytön tai raportin polun hakeminen

  1. Kirjaudu Power BI -palveluun

  2. Avaa portaaliin upotettava koontinäyttö tai raportti.

  3. Kopioi URL-osoite osoiteriviltä.

    Hanki Power BI koontinäytön polku.

Koontinäyttöruudun tunnuksen hakeminen

  1. Kirjaudu Power BI -palveluun

  2. Avaa koontinäyttö, josta haluat upottaa ruudun portaaliin.

  3. Osoita ruutuun, valitse Lisää vaihtoehtoja ja valitse sitten Avaa kohdistustilassa.

    Avaa Power BI koontinäytön ruutu tarkennustilassa.

  4. Kopioi ruudun tunnus osoiterivin URL-osoitteesta. Ruudun tunnus on arvo, joka on merkkijonon /tiles/ jälkeen.

    Power BI koontinäytön ruudun tunnus.

powerbi-client-JavaScript-kirjaston käyttäminen portaaleissa

Voit käyttää powerbi-asiakkaan JavaScript-kirjastoa, kun upotat Power BI Embedded -raportteja tai koontinäyttöjä portaalissasi. Lisätietoja powerbi-asiakkaan JavaScript-kirjastosta löytyy kohteesta Power BI JavaScript wiki.

Seuraavassa on JavaScript-esimerkki raportin asetusten päivittämiseen tai tapahtumien käsittelyyn. Tämä esimerkki poistaa suodatinruudun käytöstä, poistaa käytöstä sivun siirtymisruudun ja ottaa käyttöön dataSelected-tapahtuman.

Tärkeä

  • Käytä JavaScriptin powerbi-client-kirjastoa suodatusruudun poistamiseksi käytöstä tai ottamiseksi käyttöön. Jos kuitenkin haluat rajoittaa tietojen käyttöä tai määrittää suojauksen, käytä rivitason suojausta (RLS) Power BI:ssä. Suodatinruudun poistaminen käytöstä ei rajoita tietojen käyttöä, ja se voidaan ottaa uudelleen käyttöön JavaScript-kirjastokoodilla.
  • Powerbi-client-JavaScript-kirjastoa tuetaan vain PowerBI Embedded -työnkulussa.
$(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);
            });
        })
    }
});

Mukautetun JavaScriptin lisääminen verkkosivulle:

  1. Avaa Portaalinhallinta -sovellus.
  2. Valitse vasemmassa ruudussa Verkkosivut.
  3. Valitse verkkosivu, joka sisältää Power BI -raportin tai -koontinäytön.
  4. Valitse Lisäasetukset-välilehti.
  5. Kopioi ja liitä JavaScript Mukautettu JavaScript -osassa.
  6. Valitse Tallenna ja sulje.

Nyt on hyvä ymmärtää JavaScript-esimerkkitoiminnot ja eri vaihtoehdot.

Viittauksen hakeminen upotetun raportin HTML-koodiin

Hae viittaus upotetun raportin HTML-koodiin.

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

Lisätietoja: Viittauksen hakeminen aiemmin luotuun Power BI -komponenttiin annetulla sisältävällä elementillä

Viittauksen hakeminen upotettuun raporttiin

var report = powerbi.get(embedContainer);

Power BI:n ruutujen käyttäminen

Ruutujen asetusten avulla voit käyttää Power BI -ruutuja portaalin verkkosivulla. Suodatinasetuksen avulla voit esimerkiksi piilottaa tai näyttää ruudun tai käyttää sivun siirtymisasetusta.

Alla on esimerkki suodatinruudun poistamisesta:

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

Alla on esimerkki sekä sivussa siirtymisen että suodattimien käytöstä:

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

Lisätietoja: Asetusten päivittäminen ja Määrityksen upottaminen – asetukset

Tapahtumien käsittely

Upotettu komponentti lähettää tapahtumat, kun suoritetun komennon valmistuminen kutsutaan. Esimerkiksi seuraava dataSelected-tapahtuman näyte.

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

Lisätietoja: Tapahtumien käsittely

Katso myös

Huomautus

Voitko kertoa meille dokumentaatiota koskevan kielimäärityksesi? Vastaa lyhyeen kyselyyn. (Huomaa, että tämä kysely on englanninkielinen.)

Kyselyyn vastaaminen kestää noin seitsemän minuuttia. Henkilökohtaisia tietoja ei kerätä (tietosuojatiedot).