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

Straipsnis
01/08/2024

Pastaba

Nuo 2022 m. spalio mėn. „Power Apps“ portalai tampa „Power Pages“.
Ši tema taikoma senesnėms galimybėms. Norėdami gauti naujausios informacijos, eikite į „Microsoft Power Pages“ instrukciją.

Patarimas

Š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 puslapyje naudodami „Studioׅ“ portalus, eikite į Įtraukti „Power BI“ komponentą prie žiniatinklio naudojant „Studio“ portalus.

Galite įtraukti „Power BI“ ataskaitą arba ataskaitų sritį į portalo tinklalapį 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 sritis „Power BI“ 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 customdata žymė grąžina eilutę, DAX užklausoje gali tekti konvertuoti šią eilutę į sveikąjį skaičių.

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ų portalo 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 būti reikalinga norint nurodyti tam tikrą vaidmenį (arba vaidmenis) tarp kelių galimų vaidmenų ir vis tiek gali būti reikalinga 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. Naudoti šiuos vaidmenis gali reikėti, kai galimi keli vaidmenys, bet puslapyje norite naudoti konkrečius 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ą

Prisijunkite prie Power BI.
Atidarykite ataskaitų sritį arba ataskaitą, kurią norite įdėti į savo portalą.
Nukopijuokite URL iš adresų juostos.

Gauti ataskaitų srities išklotinės ID

Prisijunkite prie Power BI.
Atidarykite ataskaitų sritį, iš kurios norite įdėti išklotinę į savo portalą.
Nurodykite išklotinę, pažymėkite Daugiau parinkčių ir Atidaryti fokusavimo režimu.
Nukopijuokite išklotinės ID iš URL adresų juostoje. Išklotinės ID yra vertė po /tiles/.

Kaip naudoti „Powerbi“ kliento „JavaScript“ biblioteką portaluose

Portalo ataskaitoms arba ataskaitų sritims galite naudoti powerbi-client JavaScript biblioteką Power BI Embedded . 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 naudojant "PowerBI Embedded" srautą.

$(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į:

Atidarykite Portalo valdymo programą.
Pasirinkite Žiniatinklio puslapiai kairėje juostoje.
Pažymėkite tinklalapį, kuriame yra „Power BI“ ataskaita arba ataskaitų sritis.
Pasirinkite Papildomi skirtuką.
Kopijuokite ir įkelkite „JavaScript“ į Tinkintas „JavaScript“ skyrių.
Pasirinkite Įrašyti 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 portalų 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.

Pastaba

Ar galite mums pranešti apie dokumentacijos kalbos nuostatas? Atlikite trumpą apklausą. (atkreipkite dėmesį, kad ši apklausa yra anglų kalba)

Apklausą atliksite per maždaug septynias minutes. Asmeniniai duomenys nėra renkami (privatumo nuostatos).

Bendrinti naudojant

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

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

„Azure Analysis Services" ir vaidmenys ( VAIDMENYS)

Gauti ataskaitų srities arba ataskaitos kelią

Gauti ataskaitų srities išklotinės ID

Kaip naudoti „Powerbi“ kliento „JavaScript“ biblioteką portaluose

Gaukite nuorodą į talpintą ataskaitą HTML

Gaukite nuorodą į talpintą ataskaitą

Darbas su „Power BI“ juostomis

Įvykių tvarkymas

Taip pat žr.

Papildomi ištekliai