Izradite Power BI izvješća s podacima NowMetrix

Povezivanje ima dvije neobavezne faze:

NowMetrix REST API → Power Query → Power BI Desktop → optional Power BI Service

• Power BI Desktop izrađuje upit, podatkovni model i izvješće.
• Power BI Service objavljuje izvješće za pristup putem preglednika, dijeljenje i zakazano osvježavanje.

Pripremljeni primjer uvozi posljednjih 30 dostupnih dnevnih redaka iz endpointa /v1/overview. Svaki redak sadržava datum, tracker, vremensku zonu trackera, preglede stranica i posjete.

Potrebni su Vam:

• račun NowMetrix s pristupom REST API-ju,
• pristup trackeru za koji želite izraditi izvješće,
• Microsoft Power BI Desktop za izradu izvješća i
• odgovarajući račun i radni prostor Power BI-ja ako želite objaviti izvješće ili zakazati osvježavanja.

Licenciranje Power BI-ja, dopuštenja za radne prostore i dostupne učestalosti osvježavanja određuju Microsoft i administrator Vaše organizacije. Postavljanje u Desktopu možete dovršiti bez objavljivanja izvješća.

1. Prijavite se u NowMetrix.
2. Otvorite Postavke → API.
3. Izradite novi ključ s oznakom Microsoft Power BI.
4. Odmah kopirajte cijeli ključ. Prikazuje se samo jednom.
5. Zabilježite ID trackera za web-mjesto čije podatke želite uvesti.

1. Otvorite Power BI Desktop i izradite prazno izvješće.
2. Odaberite Početna → Dohvati podatke → Prazan upit. Ako ta mogućnost nije navedena, odaberite Dohvati podatke → Više i potražite Prazan upit.
3. Otvara se uređivač Power Query s novim upitom.
4. Odaberite Početna → Napredni uređivač.

Za ovaj primjer nemojte odabrati osnovni dijaloški okvir Web. Upotrebljava se napredni uređivač jer NowMetrix zahtijeva Bearer autorizacijsko zaglavlje, a odgovor se mora pretvoriti iz JSON-a u retke tablice.

1. Uklonite postojeći sadržaj iz naprednog uređivača.
2. Zalijepite cijeli upit u nastavku.
3. Zamijenite nm_YOUR_KEY i TRACKER_ID u prva dva retka.
4. Obje vrijednosti ostavite unutar navodnika.
5. Odaberite Gotovo.

let
    ApiKey = "nm_YOUR_KEY",
    TrackerId = "TRACKER_ID",

    Response = Json.Document(
        Web.Contents(
            "https://api.nowmetrix.com",
            [
                RelativePath = "v1/overview",
                Query = [
                    site = TrackerId,
                    days = "30"
                ],
                Headers = [
                    Authorization = "Bearer " & ApiKey,
                    Accept = "application/json"
                ],
                Timeout = #duration(0, 0, 0, 30)
            ]
        )
    ),

    DailyRows = if List.IsEmpty(Response[daily]) then
        #table(type table [date = text, pageviews = Int64.Type, visits = Int64.Type], {})
    else
        Table.FromRecords(Response[daily]),

    AddTracker = Table.AddColumn(
        DailyRows,
        "tracker",
        each Response[site],
        type text
    ),
    AddTimezone = Table.AddColumn(
        AddTracker,
        "timezone",
        each Response[timezone],
        type text
    ),
    ReorderedColumns = Table.ReorderColumns(
        AddTimezone,
        {"date", "tracker", "timezone", "pageviews", "visits"}
    ),
    TypedColumns = Table.TransformColumnTypes(
        ReorderedColumns,
        {
            {"date", type date},
            {"tracker", type text},
            {"timezone", type text},
            {"pageviews", Int64.Type},
            {"visits", Int64.Type}
        }
    )
in
    TypedColumns

Upit upotrebljava fiksni osnovni URL zajedno s parametrima RelativePath i Query. Time se izvor čini predvidljivim pri kasnijim osvježavanjima, a API ključ šalje se samo u HTTPS zaglavlju Authorization.

Power BI može zatražiti da odredite način povezivanja s adresom https://api.nowmetrix.com.

1. Odaberite Anonimno.
2. Postavku primijenite na https://api.nowmetrix.com.
3. Odaberite Poveži.
4. Ako se zatraži razina privatnosti, odaberite razinu koju zahtijeva Vaša organizacija. Privatno pruža najstrože odvajanje od drugih izvora podataka.

1. Pričekajte da se u pretpregledu upita prikažu date, tracker, timezone, pageviews i visits.
2. Preimenujte upit u NowMetrix Daily.
3. Odaberite Početna → Zatvori i primijeni.
4. Otvorite prikaz Podaci i provjerite jesu li retci i vrste stupaca točni.

Jednostavno izvješće potvrđuje da uvezena polja ispravno funkcioniraju:

1. Vratite se u prikaz Izvješće.
2. Dodajte Linijski grafikon.
3. Postavite date na os X.
4. Postavite pageviews i visits na os Y.
5. Dodajte dva vizualna elementa Kartica za zbrojeve polja pageviews i visits.
6. Po želji dodajte tracker kao rezač kada model poslije bude sadržavao više trackera.

Odaberite Početna → Osvježi kako biste testirali potpuno osvježavanje u Desktopu. Postojeći se vizualni elementi ažuriraju kada upit završi.

1. Spremite datoteku PBIX na zaštićeno mjesto.
2. U alatu Power BI Desktop odaberite Početna → Objavi.
3. Prijavite se računom Power BI-ja svoje organizacije.
4. Odaberite željeni radni prostor.
5. Otvorite objavljeno izvješće iz dijaloškog okvira za potvrdu.

Objavljivanjem se izrađuju izvješće i povezani semantički model. Zakazano osvježavanje konfigurira se na semantičkom modelu, a ne na pojedinačnom grafikonu ili stranici izvješća.

1. Otvorite radni prostor u usluzi Power BI.
2. Pronađite semantički model izrađen objavljenom datotekom PBIX.
3. Otvorite Postavke ili odaberite Osvježi → Zakaži osvježavanje.
4. U odjeljku Vjerodajnice izvora podataka uredite vjerodajnice za https://api.nowmetrix.com.
5. Odaberite Anonimno kao način provjere autentičnosti i razinu privatnosti koju zahtijeva Vaša organizacija.
6. Uključite raspored osvježavanja i odaberite odgovarajuću učestalost i vremensku zonu.
7. Uključite obavijesti o neuspjelom osvježavanju za vlasnika semantičkog modela ili drugu odgovornu osobu.
8. Spremite postavke, odaberite Osvježi sada i pregledajte Povijest osvježavanja.

Dostupne učestalosti osvježavanja ovise o licenci Power BI-ja i kapacitetu radnog prostora. Microsoft u svojem vodiču za zakazano osvježavanje opisuje trenutačne kontrole, ograničenja, ponašanje pri pogreškama i povijest osvježavanja.

Parametri Power Queryja olakšavaju promjenu trackera ili zamjenu ključa bez uređivanja cijelog upita. Olakšavaju održavanje, ali nisu spremnik za tajne podatke.

1. U uređivaču Power Query odaberite Početna → Upravljanje parametrima → Novi parametar.
2. Izradite obavezni tekstni parametar naziva pNowMetrixApiKey i unesite API ključ kao njegovu trenutačnu vrijednost.
3. Izradite još jedan obavezni tekstni parametar naziva pNowMetrixTrackerId i unesite ID trackera.
4. Prva dva retka upita zamijenite recima u nastavku.

    ApiKey = pNowMetrixApiKey,
    TrackerId = pNowMetrixTrackerId,

Nakon objavljivanja parametri koji se mogu uređivati mogu se pojaviti u postavkama semantičkog modela. Pristup radnom prostoru i dalje mora biti ograničen jer korisnici s dovoljnim dopuštenjima mogu pregledati ili promijeniti te parametre.

Za svaki skup podataka izradite zaseban Power Query i prema potrebi upotrijebite relacije u modelu:

• Za svaki semantički model Power BI-ja upotrijebite zaseban API ključ NowMetrix.
• Korisniku NowMetrix dodijelite samo pristup trackerima koji su potrebni za izvješće.
• Datoteku PBIX pohranite na zaštićeno mjesto i nikada je nemojte objaviti za javno preuzimanje.
• Urednike datoteka PBIX i vlasnike semantičkih modela smatrajte pouzdanim korisnicima koji mogu pregledati upit.
• Ključ nemojte unositi u vizualne elemente, filtre izvješća, URL-ove, snimke zaslona ili dokumentaciju.
• Upotrijebite najmanju publiku radnog prostora Power BI-ja koja zadovoljava potrebe izvješćivanja.
• Prije distribucije provjerite dopuštenja za izvješće, radni prostor, aplikaciju, izgradnju, ponovno dijeljenje i preuzimanje.
• Odmah opozovite ključ ako postoji mogućnost da su datoteka PBIX, radni prostor ili račun vlasnika ugroženi.
• Kada se promijeni vlasništvo, provjerite rade li vjerodajnice za osvježavanje i obavijesti o pogreškama i dalje.