Vdelava poročila storitve Power BI v glavni obrazec aplikacije, ki temelji na modelu

Članek
05/20/2022
6 min za branje

Poročila storitve Power BI lahko uporabite v aplikacijah Power Apps, ki temeljijo na modelu, ter v glavne obrazce vnesete obogateno poročanje in analizo, uporabnike pa spodbujate, da dosežejo več. Tako izkoristite vse prednosti za združevanje podatkov med sistemi in prilagajanje vse do konteksta posameznega zapisa.

Zahteve

Vdelava vsebine storitve Power BI je izbirna funkcija in je v vseh okoljih privzeto onemogočena. Če želite vdelati vsebino storitve Power BI, morate to funkcijo omogočiti. Več informacij Omogoči upodobitve storitve Power BI v organizaciji.

Ta funkcija zahteva izvoz rešitve, spreminjanje rešitve za dodajanje izrezka xml in nato uvoz nazaj v okolje. Poskrbite, da boste spremembe v ciljno okolje uvozili zgolj prek upravljane rešitve. Glejte Uvažanje, posodabljanje in izvažanje rešitev za navodila glede nameščanja posodobitve za obstoječo upravljano rešitev.

Vdelava brez filtriranja po kontekstu

Lahko uporabiš Power BI poročila tako, da jih preprosto vdelate, in dobite popolnoma enako poročilo. To ne vključuje njihove kontekstualizacije v trenutni obrazec, ki ga poganja model, in zato dobite enako poročilo za vse zapise tabele. Naslednje poročilo, na primer, kaže geografsko lokacijo vseh kupcev hkrati in je koristno za prikaz informacij o povzetku.

Vdelano poročilo Power BI brez filtriranja po kontekstu.

Če želite vozlišče XML glavnega obrazca sections prilagoditi tako, da bo lahko gostilo vdelano poročilo in ploščico storitve Power BI, upoštevajte naslednje korake:

V razvojnem okolju ustvarite rešitev in dodajte tabelo z glavnim obrazcem, za katerega želite, da se v njem prikaže vdelano poročilo storitve Power BI.
- Če takšna tabela v ciljnem okolju, v katerega boste uvozili rešitev, že obstaja, ob dodajanju tabele v rešitev izberite možnost Izbira komponent. Nato dodajte samo glavni obrazec tabele.
- Če tabela v ciljnem okolju, v katerega boste uvozili rešitev, ne obstaja, ob dodajanju tabele v rešitev izberite možnost Vključitev vseh komponent.
Izvozite rešitev kot upravljano rešitev.
Vse datoteke izvlecite v datoteko zip za paket rešitve. Nato uredite datoteko »customizations.xml« in dodajte kodo XML, ki je navedena spodaj, in sicer v bloku <sections>, ki se nahaja v vozlišču <forms type="main"> datoteke »customizations.xml«.

<section id="{d411658c-7450-e1e3-bc80-07021a04bcc2}" locklevel="0" showlabel="true" IsUserDefined="0" name="tab_4_section_1" labelwidth="115" columns="1" layout="varwidth" showbar="false">
    <labels>
        <label languagecode="1033" description="Unfiltered Power BI embedding demo"/>
    </labels>
    <rows>
        <row>
            <cell id="{7d18b61c-c588-136c-aee7-03e5e74a09a1}" showlabel="true" rowspan="20" colspan="1" auto="false" solutionaction="Added">
                <labels>
                    <label languagecode="1033" description="Accounts (Parent Account)"/>
                </labels>
                <control id="unfilteredreport" classid="{8C54228C-1B25-4909-A12A-F2B968BB0D62}">
                    <parameters>
                        <PowerBIGroupId>00000000-0000-0000-0000-000000000000</PowerBIGroupId>
                        <PowerBIReportId>544c4162-6773-4944-900c-abfd075f6081</PowerBIReportId>
                        <TileUrl>https://app.powerbi.com/reportEmbed?reportId=544c4162-6773-4944-900c-abfd075f6081</TileUrl>
                    </parameters>
                </control>
            </cell>
        </row>
        <row/>
    </rows>
</section>

Pomembno

Uporabite kontrolnik classid="{8C54228C-1B25-4909-A12A-F2B968BB0D62}", kot je navedeno v vzorcu XML-ja.

Za XML obrazca, ki ste ga kopirali v datoteko »customizations.xml« za poročilo storitve Power BI, uvedite naslednje spremembe. Ta tabela opisuje vrednosti, ki jih morate spremeniti za elemente v prejšnjem vzorcu XML.

Lastnost	Opis
PowerBIGroupId	ID delovnega prostora storitve Power BI. Če je vaše poročilo vključeno v Moj delovni prostor, je ID vašega delovnega prostora 00000000-0000-0000-0000-000000000000. V nasprotnem primeru dodajte ID delovnega prostora. Nahaja se v URL-ju storitve Power BI. Več informacij: Poiščite delovni prostor storitve Power BI in ID-je poročila.
PowerBIReportId	ID poročila storitve Power BI. To nadomestite s poročilom, ki ga želite vdelati. ID vašega poročila se nahaja v URL-ju storitve Power BI. Več informacij: Poiščite delovni prostor storitve Power BI in ID-je poročila
TileUrl	The Power BI URL poročila, ki ga želite vdelati. Uporabite ustrezno ime poddomene storitve Power BI (morda boste morali »app.powerbi.com« zamenjati s svojim imenom) in ID poročila (zamenjajte reportId=544c4162-6773-4944-900c-abfd075f6081 s svojim). Na primer: `https://app.powerbi.com/reportEmbed?reportId=544c4162-6773-4944-900c-abfd075f6081`.
solutionaction = »Dodano«	Če tabela v ciljnem okolju že obstaja, ohranite parameter `solutionaction=Added` za element celice, kot je navedeno v vzorcu XML. Če tabela v ciljnem okolju ne obstaja, odstranite parameter `solutionaction=Added`.

Ustvarite datoteko zip za vse datoteke rešitve, ki ste jih v prejšnjih korakih izvlekli. Nato rešitev uvozite v ciljno okolje.

Vdelava s filtriranjem po kontekstu

Lahko narediš Power BI poročila so bolj smiselna z uporabo kontekstualnih filtrov za trenutni obrazec, ki ga poganja model, tako da se poročilo filtrira na podlagi atributov trenutne vrstice. Naslednje poročilo, na primer, kaže geografsko lokacijo kupca tako, da filtrira poročilo storitve Power BI z uporabo imena kupca. To omogoča, da posamezno poročilo prikaže kontekstualizirane podatke za vse vrstice tabele.

Vdelano poročilo Power BI s filtriranjem po kontekstu.

Filtriranje se izvede z dodajanjem elementa <PowerBIFilter> v bloku <parameter>, kot je prikazano tukaj. Za izdelavo izraza filtra lahko uporabite kateri koli atribut tabele obrazca. Več informacij: Izdelava filtrov – da boste razumeli, kako lahko ustvarite lastne filtre.

<control id="filteredreport" classid="{8C54228C-1B25-4909-A12A-F2B968BB0D62}">
    <parameters>
        <PowerBIGroupId>00000000-0000-0000-0000-000000000000</PowerBIGroupId>
        <PowerBIReportId>544c4162-6773-4944-900c-abfd075f6081</PowerBIReportId>
        <TileUrl>https://xyz.powerbi.com/reportEmbed?reportId=544c4162-6773-4944-900c-abfd075f6081</TileUrl>
        <PowerBIFilter>{"Filter": "[{\"$schema\":\"basic\",\"target\":{\"table\":\"My Active Accounts\",\"column\":\"Account Name\"},\"operator\":\"In\",\"values\":[$a],\"filterType\":1}]", "Alias": {"$a": "name"}}</PowerBIFilter>
    </parameters>
</control>

Upoštevajte, da ta postopek uporablja isti kontrolnik kot vdelava nefiltriranih poročil, zato ID razreda kontrolnika ostaja nespremenjen.

Ta tabela opisuje vsakršne dodatne lastnosti, uporabljene v prejšnjem vzorcu XML.

Lastnost	Opis
PowerBIFilter	Izraz filtra, ki kontekstualizira poročilo Power BI tako, da atribute obrazca posreduje kot parametre. Da bo bolj berljiv, je filter izdelan, kot je prikazano tukaj. Izraz filtra ne more biti z vejico ločen seznam vrednosti.

    {
            "Filter": "[{
                    \"$schema\":\"basic\",
                    \"target\":{
                            \"table\":\"My Active Accounts\",
                            \"column\":\"Account Name\"
                    },
                    \"operator\":\"In\",
                    \"values\":[$a, $b],
                    \"filterType\":1
            }]",
            "Alias": {
                    "$a": "firstname",
                    "$b":"lastname"
            }
    }

Ciljni del prejšnjega izraza določa tabelo in stolpec, za katerega je treba uporabiti filter. Operator določi logiko in vrednosti določijo podatke, ki jih posreduje aplikacija Power Apps na osnovi modela. Za določanje parametrov na splošen način so vrednosti izdelane z vzdevki. V prejšnjem izrazu sta posredovani vrednosti ime firstname in priimek lastname kupca in eno od teh vrednosti se išče v stolpcu Ime kupca v poročilu storitve Power BI. Upoštevajte, da so vrednosti ime in priimek enolična imena atributov tabele kupca, katerih vrednost bo posredovana tukaj.

Bolj zapletene izraze filtra lahko ustvarite tako, da si ogledate primere iz članka Izdelava filtrov in zagotovite ustrezne vrednosti za »$schema« in »filterType«. Izognite se vsem nizom v delu filtra, ki uporabljajo ", tako da se oblika zapisa JSON ustrezno ustvari.

Pred uvozom odstranite nespremenjeni atribut

Preden uvozite rešitev v ciljno okolje, se prepričajte, da nespremenjeni atribut ni vključen v razdelek formXml datoteke customizations.xml. Če je nespremenjeni atribut prisoten v XML, ki vključuje kontrolnik XML storitve Power BI, odstranite atribut, preden uvozite rešitev v ciljno okolje. Na primer: zamenjajte <systemform unmodified="1"> s <systemform>.

Iskanje delovnega prostora storitve Power BI in ID-jev poročila

ID delovnega prostora za ta primer je efc85277-2bdb-47bc-9762-363f64335108.
ID poročila za ta primer je 643ab643-7126-4a57-bd82-ca8f1fb676fc.

Znane težave in omejitve

Ta integracija je na voljo samo v odjemalcu poenotenega vmesnika, v podprtih spletnih brskalnikih in mobilnih napravah.
Če ta obrazec odprete v oblikovalniku obrazcev Power Apps, kontrolnik ne bo prikazan na smiseln način. To je zato, ker je kontrolnik prilagojen izven oblikovalnika obrazcev.
Pristnost uporabnikov za dostop do storitve Power BI bo samodejno preverjana prek uporabniškega imena in gesla za Power Apps. Če kupec v storitvi Power BI z ujemajočimi se poverilnicami ne obstaja, se prikaže poziv za vpis, kot je prikazano tukaj.

Če se za vpis v storitev Power BI uporabi nepravilen račun, podatki ne bodo prikazani. Za vpis z ustreznimi poverilnicami se najprej izpišite in se nato znova vpišite.
Pogled podatkov poročila, ki so prikazani znotraj storitve Power Apps, je enak kot v storitvi Power BI, varnostne vloge in pravice storitve Power Apps pa ne vplivajo na podatke, ki so prikazani. Zato so podatki v osnovi enaki kot v prikazu, ki ga vidi ustvarjalec nabora podatkov v storitvi Power BI. Če želite uporabiti omejitve za dostop do podatkov, ki so podobne varnostnim vlogam in ekipam storitve Power Apps, uporabite Varnost na ravni vrstic s storitvijo Power BI.
Če obrazec po uvozu rešitve in objavi prilagajanj ne prikaže poročila storitve Power BI, ga odprite v urejevalniku obrazcev na osnovi modela in ga shranite, da se obrazec JSON znova ustvari.
Vdelava a Power BI ploščica na obrazcu je podprta samo brez kontekstualnega filtriranja.

Pogoste težave

ID skupine ni določen v vozlišču TileUrl parametrov kontrolnika, ko bi moral biti. Ta primer vključuje ID skupine.

<parameters>
    <PowerBIGroupId>fd266a4c-9a02-4553-9310-80e05ee844f3</PowerBIGroupId>
    <PowerBIReportId>544c4162-6773-4944-900c-abfd075f6081</PowerBIReportId>
    <TileUrl>https://xyz.powerbi.com/reportEmbed?reportId=544c4162-6773-4944-900c-abfd075f6081&amp;groupId=fd266a4c-9a02-4553-9310-80e05ee844f3</TileUrl>
</parameters>

Polja imajo različne vrste podatkov v PowerBI in Dataverse. Biti morajo iste vrste, kot je niz v Power BI in niz v Dataverse.
Polja z nizi nimajo ubežnih narekovajev v filtru Power BI. Spodaj lahko opazite, da values ima [\"$a\"] in ne [$a].

    {
            "Filter": "[{
                    \"$schema\":\"basic\",
                    \"target\":{
                            \"table\":\"My Active Accounts\",
                            \"column\":\"Account Name\"
                    },
                    \"operator\":\"In\",
                    \"values\":[\"$a\"],
                    \"filterType\":1
            }]",
            "Alias": {
                    "$a": "name",
            }
    }

Glejte tudi

Vdelava nadzorne plošče Power BI v osebno nadzorno ploščo na osnovi modela storitve Power Apps

Uporaba storitve Power BI z aplikacijami Dynamics 365

Opomba

Ali nam lahko poveste, kateri je vaš prednostni jezik za dokumentacijo? Izpolnite kratko anketo. (upoštevajte, da je v angleščini)

Z anketo boste porabili približno sedem minut. Ne zbiramo nobenih osebnih podatkov (izjava o zasebnosti).