Power BI atskaites vai informācijas paneļa pievienošana tīmekļa lapai portālā
Piezīme
- Sākot ar 2022. gada oktobri, Power Apps portāli ir Power Pages.
- Šī tēma attiecas uz mantotajām iespējām. Lai skatītu jaunāko informāciju, dodieties uz sadaļu Microsoft Power Pages dokumentācija.
Padoms
Šajā rakstā ir paskaidrots, kā pievienot Power BI atskaiti vai informācijas paneli, izmantojot powerbi Liquid atzīmi. Lai portāla vietnē pievienotu Power BI komponentu, izmantojot portālu Studio, apmeklējiet Pievienot Power BI komponentu tīmekļa lapai, izmantojot portālu Studio.
Power BI atskaiti vai informācijas paneli varat pievienot tīmekļa lapai portālā, izmantojot powerbi Liquid atzīmi. Izmantojiet atzīmi powerbi
tīmekļa lapas laukā Kopija vai tīmekļa veidlapas laukā Avots.
Ja pievienojat Power BI atskaiti vai informācijas paneli, kas izveidots jaunajā Power BI darbvietā, kā autentifikācijas tips powerbi Liquid atzīmē jānorāda powerbiembedded.
Piezīme
- Ja esat norādījis Microsoft Entra ID kā autentifikācijas tipu Powerbi Liquid tagā, pirms drošās Power BI atskaites vai informācijas paneļa pievienošanas portāla tīmekļa lapai tas ir jākopīgo ar nepieciešamajiem lietotājiem. Papildinformācija: Power BI darbvietas koplietošana un Power BI informācijas paneļa un atskaites koplietošana.
- powerbiembedded atbalsta Power BI informācijas paneļus un atskaites, kas veido savienojumu ar Azure Analysis Services. Jūs varat arī izmantot rekvizītu "customdata" Liquid kodā, lai nodotu rekvizīta CustomData vērtību.
- Dalītie Power BI ziņojumi netiek atbalstīti.
Piemēram:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/00000000-0000-0000-0000-000000000000/reports/00000000-0000-0000-0000-000000000001/ReportSection01" %}
Lai uzzinātu, kā iegūt informācijas paneļa ceļu un informācijas paneļa elementa ID, skatiet šī raksta sadaļas.
Informācijas paneļa vai atskaites izmantošana savienojuma ar Azure Analysis Services izmantošana
Varat pievienot powerbi Liquid atzīmi, izmantojot informācijas paneli vai atskaiti, kas veido savienojumu ar Azure Analysis Services.
Lai pievienotu informācijas paneli vai atskaiti, kas veido savienojumu ar Azure Analysis Services, izmantojiet parametru CustomData savienojumu virknē.
Piemēram:
{% powerbi authentication_type:"powerbiembedded" path:"https://app.powerbi.com/groups/<GroupID>/reports/<ReportID>" roles:"<roles associated with report>" customdata:"<customdata>" %}
Neobligāto customdata atzīmi var konfigurēt kā virkni, vai arī ģenerēt dinamiski, pamatojoties uz objekta atribūtu, izmantojot punktu ("."), vai kvadrāta apsvīdņus ("[]"), lai atdalītu starp objektu un atribūtu, kas atrodas starp diviem lokainajiem apslēpšanas pāriem.
Piemēri:
customdata: {{ object.attribute }}
customdata: {{ object[attribute] }}
Tā kā pielāgoto datu tags atgriež virkni, iespējams, DAX vaicājumā šī virkne ir jāpārvērš par veselu skaitli.
Svarīgi
- Portāli neatbalsta Power BI informācijas paneli vai atskaiti, kas veido savienojumu ar Azure Analysis Services, kas izmanto datu krātuvi, lai izveidotu savienojumu ar lokālo datu avotu.
- Lai šis līdzeklis darbotos, jūsu portāla versijai ir jābūt 9.3.4.x vai jaunākai.
Azure Analysis Services un lomas (RLS)
Lomu atzīme nav obligāta Azure Analysis Services atskaitēm un informācijas paneļiem. Neizmantojot lomas noklusējumus, lietotne tiek piešķirta Azure Analysis Services lomai.
Tomēr šis tags var būt nepieciešams, lai norādītu noteiktu lomu (vai lomas) starp vairākām pieejamām lomām, un tas joprojām var būt nepieciešams, izmantojot rindas līmeņa drošību.
Lomas tiek iekļautas Azure Analysis Services datu bāzē, nevis pašā atskaitē, atšķirībā no citiem Power BI atskaišu tipiem.
Lomu nenodrošināšana Liquid kodā.
Ja nevienam lomam netiek piešķirta nekāda loma Liquid kodā, Azure Analysis Services lomu nosaka lomas, kurām Lietojumprogrammai ir piekļuve, un rezultāti tiek filtrēti, pamatojoties uz sniegtajiem pielāgotajiem datiem, salīdzinot tos ar DAX vaicājumu lomās. Tas nozīmē, ka visas pieejamās lomas apvienos to piekļuves iespējas, bet joprojām filtrēs, ja nodrošinātie pielāgotie dati ir svarīgi. Šis scenārijs visbiežāk attiecas uz Azure Analysis Services atskaitēm vai atsevišķa elementa informācijas paneļiem.
Lomu nodrošināšana Liquid kodā.
Azure Analysis Services lomas var tikt nodrošinātas Liquid kodā līdzīgi kā RLS lomas. Šo lomu izmantošana var būt nepieciešama, ja ir pieejamas vairākas lomas, taču lapai vēlaties izmantot noteiktas lomas. Ja savienojuma virknē izmantojat kādu lomu, jānorāda Azure Analysis Services loma. Piemēram, vairāku elementu informācijas paneļi, kuros tiek lietoti Azure Analysis Services elementi ar RLS elementiem.
Izmantojot Azure Analysis Services elementus informācijas panelī, ir spēkā tālāk sniegtie apsvērumi:
- Ja Azure Analysis Services elements tiek izmantots informācijas panelī ar citiem elementiem, kam ir nepieciešamas lomas, Azure Analysis Services loma ir jāpievieno lomu sarakstam.
- Vairākus elementus no dažādiem Azure Analysis Services avotiem var izmantot ar savām lomām, taču pielāgotajiem datiem ir jābūt vienādiem katram un vairākām pielāgotām datu vērtībām nevar tikt izmantotas Liquid kodā. Efektīvai identifikācijai pielāgotajai atzīmei customdata un parametram customdata ir tikai virknes vērtība.
Informācijas paneļa vai atskaites ceļa iegūšana
Pierakstieties programmatūrā Power BI.
Atveriet informācijas paneli vai atskaiti, kuru vēlaties iegult savā portālā.
Kopējiet vietrādi URL no adreses joslas.
Informācijas paneļa elementa ID iegūšana
Pierakstieties programmatūrā Power BI.
Atveriet informācijas paneli, no kura savā portālā vēlaties iegult kādu elementu.
Norādiet uz attiecīgo elementu, atlasiet Citas opcijas un pēc tam atlasiet Atvērt fokusa režīmā.
Adreses joslā iekopējiet elementa ID no vietrāža URL. Elementa ID ir vērtība pēc elementa /tiles/.
Kā portālos izmantot powerbi klienta JavaScript bibliotēku
Powerbi klienta JavaScript bibliotēku varat izmantot Power BI Embedded atskaitēm vai informācijas paneļiem savā portālā. Papildinformāciju par Powerbi klienta JavaScript bibliotēku skatiet Power BI JavaScript vikivietne.
Tālāk ir JavaScript paraugs, lai atjauninātu atskaites iestatījumus vai apstrādātu notikumus. Šajā paraugā tiek atspējota filtrēšanas rūts, atspējota lapu navigācija un iespējots notikums dataSelected.
Svarīgi
- Lai atspējotu vai iespējotu filtrēšanas rūti, izmantojiet Powerbi klienta JavaScript bibliotēku. Tomēr, ja vēlaties ierobežot piekļuvi datiem vai konfigurēt drošību, izmantojiet Rindas līmeņa drošību (RLS) ar Power BI. Atspējojot filtrēšanas rūti, netiek ierobežota piekļuve datiem, un to var no jauna iespējot, izmantojot JavaScript bibliotēkas kodu.
- Powerbi klienta JavaScript bibliotēka tiek atbalstīta tikai PowerBI iegultajai plūsmai .
$(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);
});
})
}
});
Pievienot pielāgotu JavaScript tīmekļa lapai:
- Atveriet Portāla pārvaldības programmu.
- Kreisajā rūtī atlasiet Tīmekļa lapas.
- Atlasiet tīmekļa lapu, kurā ir Power BI atskaite vai informācijas panelis.
- Atlasiet cilni Detalizēti.
- Kopējiet un ielīmējiet JavaScript sadaļā Pielāgots JavaScript.
- Atlasiet vienumu Saglabāt un aizvērt.
Tagad, pieņemsim izprast JavaScript operāciju paraugu un dažādas opcijas.
Iegūt atsauci uz iegultās atskaites HTML
Iegūt atsauci uz iegultās atskaites HTML.
var embedContainer = $(".powerbi")[0];
Papildinformācija: Iegūstiet atsauci uz esošu Power BI komponentu, ja ir norādīts ietverošais elements
Iegūt atsauci uz iegultu atskaiti
var report = powerbi.get(embedContainer);
Darbs ar Power BI rūtīm
Varat izmantot paneņu iestatījumus, lai strādātu ar Power BI rūtīm portālu tīmekļa lapā. Piemēram, var lietot filtru iestatījumu, lai paslēptu vai rādītu rūti, vai strādātu ar lapu navigācijas iestatījumu.
Tālāk ir iekļauts filtru rūts noņemšanas paraugs:
report.updateSettings({
panes: {
filters :{
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
Tālāk ir iekļauts piemērs darbam ar lapu navigāciju un filtriem:
report.updateSettings({
panes: {
filters :{
visible: false
},
pageNavigation:{
visible: false
}
}
}).catch(function (errors) {
console.log(errors);
});
Papildinformācija: Iestatījumu atjaunināšana un Konfigurācijas iegulšana — iestatījumi
Notikumu apdarināšana
Iegultais komponents var izsniegt notikumus, izsaucot izpildītās komandas pabeigšanu. Piemēram, tālāk ir dataSelected
notikuma paraugs.
//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);
})
Papildinformācija: Notikumu apdare
Skatiet arī
- Komponenta pievienošana Power BI tīmekļa lapai, izmantojot portālu Studio
- Iestatīt Power BI integrāciju
- powerbi Liquid atzīme
Piezīme
Kādas ir jūsu dokumentācijas valodas preferences? Aizpildiet īsu aptauju. (ņemiet vērā, ka aptauja ir angļu valodā)
Aptaujai būs nepieciešamas aptuveni septiņas minūtes. Nekādi personas dati netiks vākti (paziņojums par konfidencialitāti).