I denne blogartikel vil vi vise dig en simpel guide til, hvordan du henter alle tilgængelige data i Gluu via vores API og bruger dem i PowerBI. Du behøver ingen erfaring med kodning for at få succes.
Før du går i gang #
- Plan: API-browseren kræver tilføjelsen API og integrationer – den er ikke inkluderet i Core-, Essential- eller Advanced-planen i sig selv.
- Rolle: Du skal have tilladelsen Administrer konto i Gluu for at åbne API-browseren og generere et query-token.
- Opsætning: Brug Windows-desktopversionen af Power BI – den rene onlineversion kan ikke gennemføre denne trin-for-trin-guide.
Lad os starte med en grundlæggende adgang #
Trin 1: Find de ønskede data i Gluu #
I nederste venstre hjørne af din Gluu skærm finder du en “Administrer konto” knap, der fører dig til Gluus mere avancerede funktioner.
Hvis du ikke har denne knap, skal du få “Administrer konto” lige i Gluu.
Under menupunktet “API browser“ finder De alle de tilgængelige forespørgsler, som Gluu har gjort tilgængelige.
Bemærk, at vi vil udvikle dette område over tid, så næste gang du besøger vil der sandsynligvis være flere forespørgsler tilgængelige.
What is a query? #
En “forespørgsel” er dybest set et teknisk spørgsmål til en server eller maskine. En forespørgsel vil blive besvaret med de ønskede data i et format (i Gluus tilfælde JSON).
What is the output format #
Gluu eksporterer alle data i JSON-formatet. JSON (JavaScript Object Notation) er et letvægts dataudvekslingsformat. Det er let for mennesker at læse og skrive. Det er let for maskiner at analysere og generere. Gode tider 🙂
Du er færdig, når du har fundet den forespørgsel, der matcher de data, du vil hente ind i Power BI.
Trin 2: Få de rigtige data #
Tryk på knappen “Hent forespørgsel” i den grå menulinje, og du åbner en popup med URL og et adgangstoken.
Hvis PowerBI skal hente dataene til dine aktuelle kørselssager, skal du bruge både URL-adressen (hvor dataene kan hentes) og et token (adgangsidentifikation).
Hvis De har brug for et skræddersyet datasæt, som ikke er tilgængeligt blandt standardforespørgslerne, er De velkommen til at kontakte helpdesk.
Vi opretter den ønskede forespørgsel for Dem, som leverer præcis de data, De har brug for.
What is a token? #
Grundlæggende er et token en lang tekststreng med bogstaver og tal, der er meget svære at gætte.
Gluu bruger et token til autentificering for at give et program (f.eks. PowerBI, R eller lignende) adgang til dataene. Tokenet bruges også til entydigt at identificere din konto, så vi ved, hvilke data vi skal sende, og derfor tilføjede vi det røde felt til skærmbilledet.
Bemærk venligst, at denne token kan ændre sig (mest af sikkerhedsmæssige årsager), og når den gør det, vil dit PowerBI-dashboard ikke længere modtage data.
Du er færdig, når du både har kopieret URL’en og adgangstokenet fra pop op-vinduet Get Query.
Trin 3: Hent dataene fra PowerBI #
Startende med et tomt dashboard i PowerBI, trykker du på “Hent data” i topmenuen og vælger webindstillingen.
Hvis du ikke kan se “Hent data”, er det højst sandsynligt, fordi du er i et andet område end “Rapportér”. Tjek i den lille menu til venstre.
I pop op-vinduet skal De vælge indstillingen “Advanced”, da De skal sammenkæde en URL-streng for at kunne bruge adgangstokenet.
Vi har matchet popup’en i PowerBI med popup’en i Gluu.
Den første linje i afsnittet “URL-dele” i PowerBI matcher URL-linjen i Gluu (popup-vinduet indsættes i billedet til højre).
Den anden linje i PowerBI skal starte med
?=access_token=[access token], hvor De erstatter [access token] med tekststrengen fra den anden linje (Authorization header) i Gluu.
Husk, at PowerBI tilføjer strengen “Bærer” alene, når du henter data, så kopier ikke det ord.
Kontroller “URL-forhåndsvisning” i PowerBI, før du trykker på knappen “OK”.
Der skal stå noget i retning af:
https://api.gluu.biz/cases/running?access_token=25dbokasfda
, hvor den akavede streng “25dbokasfda” erstattes af din.
Alt OK? Fantastisk 🙂
Tryk på knappen “OK” (og vent …)
Du er færdig, når Power Query Editor åbner med dine Gluu-data i en tabelvisning.
Trin 4: Power-forespørgselseditoren #
Bemærk, at PowerBI åbnede et nyt vindue med Power Query-editoren .
I dette vindue kan du se de data, der er hentet fra Gluu i en tabelvisning.
For nemheds skyld og din egen fornuft skal du ændre navnet på din Gluu-forespørgsel til “Alle sager” under Egenskaber i højre side af skærmen. Det vil gøre det meget lettere at identificere senere.
Når du har omdøbt forespørgslen, skal du trykke på knappen “Luk og anvend” for at vende tilbage til PowerBI.
Tillykke! Du har nu importeret Gluu-data i PowerBI.
Hvis du også vil visualisere det, skal du se trin 5.
Du er færdig, når dine Gluu-data er importeret til Power BI og tilgængelige under Data.
Trin 5: Visualisering af dataene #
Tilbage i PowerBI har du nu Gluu-dataene tilgængelige. Du kan se det ved at trykke på knappen “Data” til venstre eller sammenføje dataene med andre Gluu eller andre organisationsdata i afsnittet “Model”.
Bemærk: Du skal muligvis trykke på “Anvend ændringer” i den gule bjælke i PowerBI-grænsefladen.
Lad os starte med at visualisere dataene “Alle sager”:
- Tryk på “Anmeld” i menuen til venstre
- Vælg “Tabel” i ruden Visualisering til højre
Når du har et tabelikon i rapportområdet (se billede), skal du åbne datasættet “Alle sager” i ruden Felter og markere feltet “caseName”.
Du har nu listet alle aktive Gluu-sager i PowerBI.
Du er færdig, når din tabelvisualisering viser sagsnavnene fra Gluu.
Relateret: Grundlæggende om API og integration
FAQ – Visualisering af Gluu-data i Power BI #
Nej. Denne trin-for-trin-guide bruger kun indstillingen Hent data > Web i Power BI’s Advanced-tilstand, hvor du indsætter en URL og et adgangstoken – der kræves ingen kodning.
API-browseren kræver tilføjelsen API og integrationer. Den er ikke inkluderet i Core-, Essential- eller Advanced-planen i sig selv, så tjek med din kontoadministrator, hvis du ikke kan se den.
Der mangler typisk to ting: tilføjelsen API og integrationer på din konto eller tilladelsen Administrer konto på din bruger. Begge dele er nødvendige for at åbne API-browseren og generere et query-token.
Nej, du skal bruge Windows-desktopversionen af Power BI. Den rene onlineversion kan ikke gennemføre det avancerede Hent data-flow, som denne trin-for-trin-guide bygger på.
Hvis tokenet ændrer sig, typisk af sikkerhedsmæssige årsager, stopper dit Power BI-dashboard med at modtage data, indtil du opdaterer forespørgslen med det nye token.
Ja. Hvis du har brug for et skræddersyet datasæt, som ikke er blandt standardforespørgslerne, så kontakt Gluu help desk, og de opretter den specifikke forespørgsel, du har brug for.
