Bendrinti naudojant


„Power BI“ ataskaitos arba ataskaitų srities įtraukimas į žiniatinklio puslapį

Arbatpinigiai

Šis straipsnis paaiškina, kaip įtraukti „Power BI“ ataskaitą ar ataskaitų sritį „powerbi „Liquid“ žymėje. Tam, kad įtrauktumėte „Power BI“ komponentą į savo žiniatinklio svetainės tinklalapį naudodami dizaino studiją, eikite į Įtraukti „Power BI“ komponentą.

Galite įtraukti „Power BI“ ataskaitą arba ataskaitų sritį į žiniatinklio puslapį naudodami powerbi „Liquid“ žymę. Naudokite powerbi skirtuką Kopijuoti laukelyje žiniatinklio puslapyje arba Šaltiniolaukelyje žiniatinklio šablone

Jei norite įtraukti „Power BI“ ataskaitą arba ataskaitų sritį, sukurtą naujoje„ Power BI“, darbo srityje, turite nurodyti powerbiembedded autentifikavimo tipą powerbi „Liquid“ žymėje.

Pastaba.

  • Jei "powerbi Liquid" žymėje kaip autentifikavimo tipą nurodėte Microsoft Entra ID, prieš įtraukdami saugią Power BI ataskaitą arba ataskaitų sritį į portalo tinklalapį, turite bendrinti jį su reikiamais vartotojais. Daugiau informacijos: Bendrinti „Power BI“ darbo sritį ir Bendrinti „Power BI“ ataskaitų sritį bei ataskaitą.
  • powerbiembedded palaiko „Power BI“ ataskaitų sritis ir ataskaitas, prisijungiamas prie „Azure Analysis Services". Taip pat, norėdami perduoti CustomData ypatybės reikšmę, galite naudoti papildomo kodo ypatybę Pasirinktiniai duomenys.
  • Puslapiuose paskirstytos Power BI ataskaitos nepalaikomos.

Pavyzdys.

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

Jei norite sužinoti, kaip gauti ataskaitų srities kelią ir ataskaitų srities plytelės ID, žr. šio straipsnio skyrius vėliau.

Ataskaitų srities arba ataskaitos naudojimas jungiantis prie „Azure Analysis Services"

Naudodami ataskaitų sritį galite įtraukti "Liquid" žymę išsiejiklų žymę arba ataskaitą, prijungtą prie „Azure Analysis Services" tarnybų.

Norėdami įtraukti ataskaitų sritį arba ataskaitą, jungiantis prie „Azure Analysis Services" analizės tarnybų, ryšio eilutėje naudokite tinkintų duomenų parametrą.

Pavyzdžiui:

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

Pasirinktinę pasirinktinių duomenų žymą galima sukonfigūruoti kaip eilutę arba generuoti dinamiškai pagal objekto atributą naudojant periodą (".") arba kvadratinį suskirstytus ("[]"), atskiriant objektą ir atributą tarp dviejų kursto ieškų porų.

Pavyzdžiai:

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

Kadangi pasirinktinių duomenų žyma pateikia eilutę, gali prireikti konvertuoti šią eilutę į sąskaitinį skaičių DAX užklausoje.

Svarbu

  • Portalai nepalaiko ataskaitų srities arba „Power BI“ ataskaitos, jungiatės prie „Azure Analysis Services", kurios naudoja duomenų sąsają, kad prisijungtų prie vietinis duomenų šaltinis.
  • Kad veiktų ši funkcija, jūsų žiniatinklio svetainės nuomotojo versija turi būti 9.3.4.x arba naujesnė.

„Azure Analysis Services" ir vaidmenys ( VAIDMENYS)

Vaidmenų žyma yra pasirinktinė „Azure Analysis Services" pagrįstoms ataskaitoms ir ataskaitų sritims. Kai naudojama, vaidmenys pagal numatytuosius nustatymus priskiriami programos vaidmeniui „Azure Analysis Services".

Tačiau šią žymę gali prireikti nurodyti tam tikrą vaidmenį (ar vaidmenis) tarp kelių galimų vaidmenų, to gali vis tiek prireikti naudojant eilutės lygio saugą.

Vaidmenys yra „Azure Analysis Services" duomenų bazėje, o ne pačioje ataskaitoje, skirtingai nei kitų „Power BI“ tipų ataskaitos.

  • Liquid kodas neturi vaidmenų.

    Jei "Azure" analizės tarnybų vaidmuo nėra išsekęs, „Azure Analysis Services" analizės tarnybų vaidmuo bus nustatomas pagal vaidmenis, prie kurių programa turi prieigą, ir rezultatai bus filtruoti pagal duotus pasirinktinius duomenis pagal DAX užklausą vaidmenyse. T. y. visi galimi vaidmenys sujungs jų prieigas, tačiau, jei pateikiami pasirinktiniai duomenys bus svarbūs, vis tiek filtruojami. Šis scenarijus dažniausiai pasitaikys su "Azure Analysis Services" ataskaitomis arba viena plytelių ataskaitų sritimis.

  • Liquid kodas neturi vaidmenų.

    "Azure Analysis Services" vaidmenys gali būti pateikiami "Liquid" kodas, panašiai kaip ir IEJIS vaidmenys. Naudojant šiuos vaidmenis gali reikėti, kai yra keli vaidmenys, tačiau norite naudoti konkrečius puslapio vaidmenis. Naudojant bet kokius vaidmenis ryšio eilutėje reikia nurodyti "Azure Analysis Services" analizės tarnybų vaidmenį. Pvz., kelių plytelių ataskaitų sritys, kurios naudoja "Azure Analysis Services" plyteles su IEJIL plytele.

    Toliau nurodyti aspektai taikomi naudojant "Azure Analysis Services" analizės tarnybų plyteles ataskaitų srityje:

    • Jei „Azure Analysis Services" analizės tarnybų plytelė naudojama ataskaitų srityje su kitomis plytelmis, kurioms reikia vaidmenų, „Azure Analysis Services" analizės tarnybų vaidmuo turi būti įtrauktas į vaidmenų sąrašą.
    • Kelios plytelės iš skirtingų „Azure Analysis Services" šaltinių gali būti naudojamos su savais vaidmenimis, tačiau pasirinktiniai duomenys turi būti vienodi, o kelių pasirinktinių duomenų reikšmių negalima naudoti „Liquid“ kode. customdata žyma ir customdata parametras turi tik eilutės reikšmę.

Gauti ataskaitų srities arba ataskaitos kelią

  1. Prisijunkite prie Power BI.

  2. Atidarykite ataskaitų sritį arba ataskaitą, kurią norite įdėti į savo portalą.

  3. Nukopijuokite URL iš adresų juostos.

    „Power BI“ ataskaitų srities kelio gavimas.

Gauti ataskaitų srities išklotinės ID

  1. Prisijunkite prie Power BI.

  2. Atidarykite ataskaitų sritį, iš kurios norite įdėti išklotinę į savo žiniatinklio svetainę.

  3. Nurodykite išklotinę, pažymėkite Daugiau parinkčių ir Atidaryti fokusavimo režimu.

    „Power BI“ ataskaitų srities plytelės atidarymas naudojant fokusavimo režimą.

  4. Nukopijuokite išklotinės ID iš URL adresų juostoje. Išklotinės ID yra vertė po /tiles/.

    „Power BI“ ataskaitų srities plytelės ID.

Kaip naudoti „Powerbi“ kliento „JavaScript“ biblioteką „Power Pages“

„Power BI Embedded“ ataskaitoms arba ataskaitų sritims savo žiniatinklio svetainėje galite naudoti „Powerbi“ kliento „JavaScript“ biblioteką. Daugiau informacijos apie "powerbi-client" „JavaScript" biblioteką žr .„Power BI“ „JavaScript" regione.

Toliau pateiktas „JavaScript“ pavyzdys, skirtas naujinti ataskaitos nustatymus ar tvarkyti įvykius. Šis pavyzdys išjungia filtrų sritį, išjungia puslapių naršymą ir įjungia dataSelected.

Svarbu

  • Naudodami „Powerbi" kliento „JavaScript" biblioteką, išjunkite arba įjunkite filtrų sritį. Tačiau jei norite apriboti prieigą prie duomenų arba konfigūruoti saugą, naudokite eilutės lygio saugą (JUMIS) su „Power BI“. Išjungus filtravimo sritį neribojama prieiga prie duomenų, todėl naudojant "JavaScript" bibliotekos kodą ją galima įjungti iš naujo.
  • „Powerbi“ kliento „JavaScript“ biblioteka palaikoma tik PowerBI Embedded" eigai.
$(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);
            });
        })
    }
});

„JavaScript“tinkintas kaip komponento įtraukimas į tinklalapį:

  1. Atidarykite Portalo valdymo programą.
  2. Pasirinkite Žiniatinklio puslapiai kairėje juostoje.
  3. Pažymėkite tinklalapį, kuriame yra „Power BI“ ataskaita arba ataskaitų sritis.
  4. Pasirinkite Papildomi skirtuką.
  5. Kopijuokite ir įkelkite „JavaScript“ į Tinkintas „JavaScript“ skyrių.
  6. Pasirinkite Išsaugoti ir uždaryti.

Dabar geriau suprasti „JavaScript" operacijų pavyzdžius ir skirtingas parinktis.

Gaukite nuorodą į talpintą ataskaitą HTML

Gaukite nuorodą į talpintą ataskaitą HTML.

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

Daugiau informacijos: Gauti nuorotą į esantį „Power BI“ komponentą pagal turimą elementą

Gaukite nuorodą į talpintą ataskaitą

var report = powerbi.get(embedContainer);

Darbas su „Power BI“ juostomis

Galite naudoti skydų parametrus darbui su „Power BI“ sritimis tinklalapyje. Pavyzdžiui, galite naudoti filtrų parametrą, kad slėptumėte ar rodytumėte sritį, arba dirbti su puslapio naršymo parametru.

Toliau pateikiamas filtrų srities šalinimo pavyzdys:

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

Toliau pateikiamas pavyzdys, skirtas darbui su puslapių naršymu ir filtrais:

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

Daugiau informacijos: Nustatymų naujinimas ir Talpinimo konfigūravimas - Nustatymai

Įvykių tvarkymas

Talpintas komponentas gali išmesti įvykius pasikliaudamas atliktos komandos užbaigimu. Pavyzdžiui, toliau yra pateiktas dataSelected įvykio pavyzdys.

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

Daugiau informacijos: Įvykių tvarkymas

Taip pat žr.