Power BI есебін немесе бақылау тақтасын порталдағы веб-бетке қосу

Мақала
03/14/2023

Ескерім

2022 жылдың қазанынан бастап күшіне енеді, Power Apps порталдары — Power Pages.
Бұл тақырып бұрынғы мүмкіндіктерге қолданылады. Соңғы ақпарат алу үшін Microsoft Power Pages құжаттамасына өтіңіз.

Кеңес

Бұл мақалада Power BI есебін немесе бақылау тақтасын powerbi Liquid тегі арқылы қосу әдісі түсіндіріледі. Power BI құрамдасын порталдар студиясы арқылы порталдағы веб-бетке қосу үшін, Power BI құрамдасын веб-бетке порталдар студиясы арқылы қосу тармағына өтіңіз.

Power BI есебін немесе бақылау тақтасын порталдағы веб-бетке powerbi Liquid тегі арқылы қосуға болады. Веб-беттегі Көшіру өрісіндегі немесе веб-үлгідегі Деректер көзі өрісіндегі powerbi тегін пайдаланыңыз.

Power BI ішіндегі жаңа жұмыс орнында жасалған Power BI есебін немесе бақылау тақтасын қоссаңыз, powerbi Liquid тегіндегі powerbiembedded ретінде аутентификация түрін көрсетуіңіз қажет.

Ескерім

Powerbi Liquid тегінде аутентификация түрі ретінде Microsoft Entra ID көрсеткен болсаңыз, порталдағы веб-бетке қауіпсіз Power BI есепті немесе бақылау тақтасын қоспас бұрын оны қажетті пайдаланушылармен бөлісуіңіз керек. Қосымша ақпарат: Power BI жұмыс кеңістігін ортақ пайдалану және Power BI бақылау тақтасын және есебін ортақ пайдалану.
powerbiembedded Azure талдау қызметтеріне қосылатын Power BI бақылау тақталары мен есептеріне қолдау көрсетеді. Сонымен қатар CustomData сипаты үшін мәнді жіберу мақсатында Liquid кодында "customdata" сипатын пайдалануға болады.
Беттерге бөлінген Power BI есептеріне қолдау көрсетілмейді.

Мысалы:

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

Бақылау тақтасының жолын және бақылау тақтасының идентификаторын қалай алу керектігі туралы осы мақаланың кейінгі бөлімдерін қараңыз.

Azure талдау қызметтеріне қосылатын бақылау тақтасы мен есепті пайдалану

Azure талдау қызметтеріне қосылатын бақылау тақтасы мен есеппен powerbi Liquid тегін қосуға болады.

Azure талдау қызметтеріне қосылатын бақылау тақтасын немесе есепті қосу үшін қосылу жолындағы CustomData параметрін пайдаланыңыз.

Мысалы:

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

Қосымша customdata тегі объекті мен төлсипат арасында екі жақша немесе өрнек жақшамен бөлу үшін, нүкте (".") немесе тік жақша ("[]") арқылы жол ретінде конфигурациялануы немесе объектінің төлсипатының негізінде динамикалық түрде жасалуы мүмкін.

Мысалдар:

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

customdata тегі жолды қайтаратындықтан, бұл жолды DAX сұрауындағы бүтін санға түрлендіру қажет болуы мүмкін.

Маңызды

Порталдар жергілікті деректер көзіне қосылу үшін деректер шлюзін пайдаланатын Azure талдау қызметтеріне қосылатын Power BI бақылау тақтасы мен есебіне қолдау көрсетпейді.
Осы функцияның жұмыс істеуі үшін портал нұсқасы 9.3.4.x немесе кейінірек нұсқа болуы тиіс.

Azure талдау қызметтері мен рөлдері (RLS)

рөлдер тегі Azure талдау қызметтеріне негізделген есептер мен бақылау тақталары үшін міндетті емес болып табылады. Пайдаланылмаған кезде, рөл әдепкі бойынша Azure талдау қызметтеріндегі бағдарлама тағайындалған рөлге орнатылады.

Дегенмен, бұл тег бірнеше қолжетімді рөлдер арасында белгілі бір рөлді (немесе рөлдерді) көрсету үшін қажет болуы мүмкін және жол деңгейі қауіпсіздігін пайдалану кезінде әлі де қажет болуы мүмкін.

Басқа Power BI есеп түрлерінен өзгеше, рөлдер Azure талдау қызметтерінің дерекқорында қамтылған, бірақ есептің өзінде жоқ.

Liquid кодында ешқандай рөл бермеу.

Егер Liquid кодында ешқандай рөл болмаса, Azure талдау қызметтерінің рөлі бағдарлама қол жеткізе алатын рөл(дер)мен анықталады және берілген реттелетін деректерге негізделген нәтижелерді рөл(дер)дегі DAX сұранысы бойынша сүзгілейді. Яғни, барлық қолжетімді рөлдер олардың қолжетімділіктерін біріктіреді, бірақ берілген реттелетін деректер сәйкес болған жағдайда сүзгіленеді. Бұл сценарий көбінесе Azure талдау қызметтерінің есептерінде немесе бір тақталы бақылау тақталарында болады.
Liquid кодында рөл беру.

Azure талдау қызметтерінің рөлдерін RLS рөлдеріне ұқсас Liquid кодында беруге болады. Бұл рөлдерді пайдалану бірнеше рөлдер қол жетімді болғанда қажет болуы мүмкін, бірақ бет үшін арнайы рөлдерді пайдаланғыңыз келеді. Қосылым жолында кез келген рөлдерді пайдалану кезінде Azure талдау қызметтерінің рөлін көрсету міндетті болып табылады. Мысалы, RLS тақталарымен Azure талдау қызметтерінің тақталарын пайдаланатын бірнеше тақталы бақылау тақталары.

Бақылау тақтасында Azure талдау қызметтерінің қатарларын пайдалану кезінде келесі мәселелер қолданылады:
- Егер Azure талдау қызметтерінің тақтасы бақылау тақтасында рөлдерді қажет ететін басқа тақталармен бірге пайдаланылса, Azure талдау қызметтерінің рөлін рөлдер тізіміне қосу керек.
- Әртүрлі Azure талдау қызметтерінің көздерінен алынған бірнеше тақтаны өздерінің рөлдерімен пайдалануға болады, бірақ реттелетін деректер әрқайсысы үшін бірдей болуы керек, және Liquid кодында бірнеше реттелетін деректер мәндерін қолдану мүмкін емес. customdata тегі мен customdata параметрі EffectiveIdentity үшін тек жол мәнін қабылдайды.

Бақылау тақтасының немесе есептің жолын алу

Power BI жүйесіне кіріңіз.
Порталға ендіру керек бақылау тақтасын немесе есепті ашыңыз.
Мекенжай жолағынан URL-мекенжайын көшіріңіз.

Бақылау тақтасы қатарының идентификаторын алу

Power BI жүйесіне кіріңіз.
Порталға қатар ендіру керек бақылау тақтасын ашыңыз.
Қатарға бағыттап, Қосымша параметрлер опциясын, одан кейін Фокус режимінде ашу пәрменін таңдаңыз.
Мекенжай жолағындағы URL-мекенжайынан қатар идентификаторын көшіру. Қатар идентификаторы /tiles/ cөзінен кейінгі мән.

Порталдардағы powerbi-client JavaScript кітапханасын пайдалану әдісі

Порталдағы powerbi-client JavaScript кітапханасын үшін Power BI Embedded есептерді немесе бақылау тақталарын пайдалана аласыз. Powerbi клиентінің JavaScript каталогы туралы қосымша ақпарат алу үшін Power BI JavaScript вики бетін қараңыз.

Төменде есеп параметрлерін жаңарту немесе оқиғаларды өңдеу үшін JavaScript үлгісі келтірілген. Бұл үлгі сүзгі тақтасын ажыратады, бетті шарлауды өшіреді және dataSelected оқиғасын іске қосады.

Маңызды

Сүзгі тақтасын өшіру немесе қосу үшін powerbi-client JavaScript кітапханасын пайдаланыңыз. Алайда, егер деректерге қатынасуды шектеу керек болса немесе қауіпсіздікті конфигурациялау керек келсе, Power BI бағдарламасы бар жол деңгейіндегі қауіпсіздік (RLS) параметрін пайдаланыңыз. Сүзгі тақтасын өшіру деректерге қолжеткізуді шектемейді және оны JavaScript каталогының кодын пайдаланып қайта қосуға болады.
Powerbi-клиент JavaScript кітапханасына тек PowerBI Embedded ағыны үшін қолдау көрсетіледі.

$(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 сценарийін қосу үшін:

Порталды басқару бағдарламасын ашыңыз.
Сол жақ тақтадан Веб-беттер тармағын таңдаңыз.
Power BI есебі немесе бақылау тақтасы бар веб-бетті таңдаңыз.
Кеңейтілген қойыншасын таңдаңыз.
Реттелетін JavaScript бөліміндегі JavaScript көшіріп, қойыңыз.
Сақтау және жабу пәрменін таңдаңыз.

Енді JavaScript амалдарының үлгісімен және әртүрлі опцияларымен танысайық.

Ендірілген есеп HTML сілтемесін алу

Ендірілген есеп HTML сілтемесін алыңыз.

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

Қосымша ақпарат: Элементті қамтитын бұрыннан бар Power BI құрамдасы сілтемесін алу

Ендірілген есеп сілтемесін алу

var report = powerbi.get(embedContainer);

Power BI тақталарымен жұмыс істеу

Порталдар веб-беттерінде Power BI тақталарымен жұмыс істеу үшін қажет тақта параметрлерін пайдалануға болады. Мысалы, тақтаны жасыру немесе көрсету үшін сүзгілер параметрін пайдалануға немесе беттің шарлау параметрімен жұмыс істеуге болады.

Төменде сүзгілер тақтасын жою үлгісі келтірілген:

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

Төменде бет шарлауымен де, сүзгілерімен де жұмыс істеу үлгісі келтірілген:

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

Қосымша ақпарат: Параметрлерді жаңарту және Ендірілген конфигурация - Параметрлер

Оқиғаларды өңдеу

Ендірілген құрамдас орындалған пәрменнің аяқталуын шақырған кезде оқиғаларды шығара алады. Мысалы, төменде dataSelected оқиғасы келтірілген.

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

Қосымша ақпарат: Оқиғаларды өңдеу

Сондай-ақ келесіні қараңыз

Ескерім

Сіз құжат тіліңіздің артықшылықтары туралы айта аласыз ба? Қысқа сауалнамаға қатысыңыз. (бұл сауалнама ағылшын тілінде екеніне назар аударыңыз)

Сауалнама шамамен жеті минут уақытыңызды алады. Жеке деректер жиналмайды (құпиялылық туралы мәлімдеме).

Бөлісу құралы:

Power BI есебін немесе бақылау тақтасын порталдағы веб-бетке қосу

Azure талдау қызметтеріне қосылатын бақылау тақтасы мен есепті пайдалану

Azure талдау қызметтері мен рөлдері (RLS)

Бақылау тақтасының немесе есептің жолын алу

Бақылау тақтасы қатарының идентификаторын алу

Порталдардағы powerbi-client JavaScript кітапханасын пайдалану әдісі

Ендірілген есеп HTML сілтемесін алу

Ендірілген есеп сілтемесін алу

Power BI тақталарымен жұмыс істеу

Оқиғаларды өңдеу

Сондай-ақ келесіні қараңыз

Қосымша ресурстар