Power BI-jelentés vagy -irányítópult hozzáadása egy weboldalhoz

Power BI-jelentés vagy irányítópult hozzáadása weblaphoz a powerbi Liquid címke segítségével. A powerbi címke hozzáadható a Másolás mezőben a weboldalon, vagy a Forrás mezőben egy webes sablonban.

Ha az új Power BI-munkaterületen létrehozott Power BI-jelentést vagy -irányítópultot ad hozzá, akkor a powerbi Liquid címkében powerbiembedded-ként kell megadnia a hitelesítési típust.

Például:

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

Az irányítópult elérési útvonalának és a irányítópult-csempe azonosítójának lekérdezésével kapcsolatos tudnivalókat a cikk későbbi részeiben találja.

Az Azure Analysis Services-hez csatlakozó irányítópult vagy jelentés használata

Hozzáadhat powerbi Liquid címkét egy irányítópulthoz, vagy az Azure Analysis Services-hez csatlakozó jelentéshez.

Az Azure Analysis Services-hez csatlakozó irányítópult vagy jelentés hozzáadásához használja a CustomData paramétert a kapcsolati karakterláncban.

Például:

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

Az opcionális customdata címke beállítható karakterláncként, vagy dinamikusan generálható az objektum attribútuma alapján, az objektum és az attribútum elválasztására pont („.”) vagy szögletes zárójelek („[]”) használatával, két pár szögletes zárójel között.

Példák:

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

Mivel a customdata címke egy karakterláncot ad vissza, szükség lehet arra, hogy a DAX-lekérdezésben ezt a karakterláncot egész számmá alakítsuk.

Azure elemzési szolgáltatások és szerepkörök (RLS)

A szerepkörök címke opcionális az Azure Analysis Services alapú jelentések és irányítópultok esetében. Ha nem használják, a szerepkör alapértelmezés szerint az Azure Analysis Servicesben az alkalmazáshoz rendelt szerepkör lesz.

Ez a címke azonban szükségessé válhat egy bizonyos szerepkör (vagy szerepkörök) megadásához a rendelkezésre álló szerepkörök közül, és továbbra is szükséges lehet a sorszintű biztonság használata esetén.

A szerepkörök az Azure Analysis Services adatbázisában találhatók, nem pedig magában a jelentésben, ellentétben más Power BI-jelentéstípusokkal.

• A Liquid kódban nem biztosít szerepköröket.

  Ha a Liquid kódban nincs szerepkör megadva, az Azure Analysis Services szerepkörét az alkalmazás hozzáféréssel rendelkező szerepköre(ei) határozzák meg, és a megadott egyéni adatok alapján a DAX-lekérdezéssel szemben a szerepkör(ök)ben lévő eredmények szűrését végzi. Ez azt jelenti, hogy az összes rendelkezésre álló szerepkör egyesíti a hozzáféréseket, de továbbra is szűrni fogja, ha a megadott egyéni adatok relevánsak. Ez a forgatókönyv leggyakrabban az Azure Analysis Services jelentések vagy egycsempés irányítópultok esetében fordul elő.

• Szerepkörök biztosítása a Liquid kódban.

  Az Azure Analysis Services szerepkörök a Liquid kódban is megadhatók, hasonlóan az RLS szerepkörökhöz. Ezeknek a szerepköröknek a használata akkor lehet szükséges, ha több szerepkör is rendelkezésre áll, de az adott oldalhoz meghatározott szerepköröket szeretne használni. Ha bármilyen szerepet használ a kapcsolati karakterláncban, az Azure Analysis Services szerepkör megadása elengedhetetlen. Például az Azure Analysis Services-csempéket RLS-csempékkel használó, több csempéből álló irányítópultok.

  Az Azure Analysis Services-csempék irányítópulton való használatakor a következő megfontolások érvényesek:

  • Ha egy Azure Analysis Services-csempe más, szerepköröket igénylő csempékkel együtt kerül felhasználásra egy irányítópulton, az Azure Analysis Services-szerepkört hozzá kell adni a szerepkörök listájához.
  • Több, különböző Azure Analysis Services-forrásból származó csempe is használható saját szerepkörrel, de az egyéni adatoknak mindegyiknél azonosnak kell lenniük, és több egyéni adatérték nem használható a Liquid kódban. A customdata címke és az EffectiveIdentity customdata paramétere csak karakterlánc értéket fogad el.

Jelentés vagy irányítópult elérési útjához való hozzáférés.

1. Jelentkezzen be a Power BI rendszerbe.

2. Nyissa meg a a portálba beágyazni kívánt irányítópultot vagy jelentést.

3. Másolja ki az URL-címet a címsorból.

   

Irányítópultlap azonosító beszerzése

1. Jelentkezzen be a Power BI rendszerbe.

2. Nyissa meg az irányítópultot, amelyből be akarja ágyazni egy lapot a webhelyébe.

3. Mutasson a lapra, jelölje ki a További beállítások opciót, majd jelölje ki Nyissa meg a fókusz módot opciót.

   

4. A mozaik azonosító másolása az URL-címből a címsávba. A mozaik azonosító a /mozaikok/ utáni érték.

   

Hogyan lehet használni a powerbi-client JavaScript-könyvtárat a Power Pages-szolgáltatásban?

A powerbi-client JavaScript könyvtárat használhatja a Power BI Embedded-jelentések vagy irányítópultok webhelybe történő beágyazása során. A powerbi-client JavaScript könyvtárról további információkat a Power BI JavaScript wikiben talál.

Az alábbiakban található egy minta JavaScript a jelentés beállításainak frissítéséhez vagy az események kezeléséhez. Ez a minta letiltja a szűrőablakot, letiltja az oldalnavigációt, és engedélyezi a dataSelected eseményt.

$(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);
            });
        })
    }
});

Egyéni JavaScript hozzáadása egy weboldalhoz:

1. Nyissa meg a Portálfelügyelet alkalmazást.
2. Válassza ki a Weboldalakat a bal oldali ablaktáblában.
3. Válassza ki a Power BI-jelentést vagy -irányítópultot tartalmazó weboldalt.
4. Válassza a Speciális lapfület.
5. Másolja ki és illessze be a JavaScriptet az Egyéni JavaScript területen belül.
6. Válassza a Save &; Close lehetőséget.

Most pedig nézzük meg a minta JavaScript-műveleteket és a különböző lehetőségeket.

A beágyazott jelentés HTML-jére vonatkozó hivatkozás lekérése

A beágyazott jelentés HTML-jére vonatkozó hivatkozás lekérése.

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

További információ: Hivatkozás kérése meglévő Power BI-összetevőhöz a tartalmazó elem alapján

A beágyazott jelentésre mutató hivatkozás lekérése

var report = powerbi.get(embedContainer);

Power BI ablakkezelés

A panelek beállításait használhatja a weboldalán lévő Power BI-panelekhez. A szűrők beállításával például elrejtheti vagy megjelenítheti a panelt, vagy dolgozhat az oldalsó navigáció beállításával.

Az alábbiakban egy minta a szűrők ablaktábla eltávolítására:

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

Az alábbiakban egy minta látható, amely mind az oldalsó navigációval, mind a szűrőkkel működik:

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

További információ: Frissítési beállítások és Beágyazási konfiguráció: beállítások

Események kezelése

A beágyazott összetevő a futtatott parancs befejezésének aktiválásakor eseményeket tud indítani. Az alábbi példa például a dataSelectedeseményre vonatkozó példa.

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

További információk: Események kezelése

Kapcsolódó információk

• Power BI-komponens hozzáadása egy weboldalhoz
• A Power BI-integráció beállítása
• powerbi Liquid-címke