Konfigurer miljøet for å utvikle et Power BI-visualobjekt

I denne artikkelen finner du ut hvordan du kan konfigurere miljøet ditt for å utvikle et Power BI-visualobjekt.

Før du begynner å utvikle, må du installere node.js og pbiviz-pakken. Du må også opprette og installere et sertifikat. Når det lokale miljøet er konfigurert, må du konfigurere Power BI-tjenesten for utvikling av et Power BI-visualobjekt.

I denne artikkelen finner du ut hvordan du:

Installer node.js

Node.js er en JavaScript-kjøretid som er bygget på Chromes V8 JavaScript-motor. Den gir utviklere mulighet til å kjøre alle apper som er opprettet på JavaScript.

Slik installerer du node.js:

  1. Naviger til node.jsi en nett leser.

  2. Last ned det nyeste anbefalte MSI-installasjonsprogrammet.

  3. Kjør installasjonsprogrammet, og følg deretter fremgangsmåten for installasjon. Godta vilkårene i lisensavtalen og alle standardverdier.

  4. Start datamaskinen på nytt.

Installer pbiviz

pbiviz-verktøyet, som er skrevet ved hjelp av JavaScript, kompilerer den visuelle kildekoden i pbiviz-pakken.

pbiviz-pakken er et komprimert prosjekt med Power BI-visualobjekter, med alle de nødvendige skriptene og ressursene.

hvis du vil installere pbiviz, åpner du Windows PowerShell og skriver inn følgende kommando.

npm i -g powerbi-visuals-tools

Obs!

Du kan få noen advarsler når du kjører denne kommandoen. De bør ikke hindre pbiviz i å installeres.

Opprett og installer et sertifikat

Det kreves et Secure Sockets Layer (SSL)-sertifikat for at en klient (datamaskinen) og en server (Power BI-tjenesten) skal samhandle sikkert. Uten et sertifikat som sikrer sikre samhandlinger, blir de blokkert av nettleseren.

Denne prosessen beskriver hvordan du kjører en PowerShell-kommando som starter importveiviseren for sertifikat. Følg trinnene nedenfor for å konfigurere sertifikatet i veiviseren.

Viktig!

Ikke lukk PowerShell-vinduet under denne prosedyren.

  1. Åpne Windows PowerShell, og skriv inn følgende kommando.

    pbiviz --install-cert
    

    Denne kommandoen gjør to ting:

    • Den returnerer en passfrase. I dette tilfellet er passfrasen 9765328806094.
    • Den starter også importveiviseren for sertifikat.

    Skjermbilde av kommandoen p b i v i z utført i Windows PowerShell

    Obs!

    • Hvis du ikke har tillatelse til å kjøre pbiviz, starter du PowerShell som administrator og kjører kommandoen Set-ExecutionPolicy RemoteSigned , og prøver deretter på nytt.
    • Hvis vei viseren for sertifikat import ikke åpnes automatisk, navigerer du til sertifikat plasseringen i fil Utforsker, høyre klikker på den og velger Installer.
  2. Kontroller at lagringsplasseringen er satt til Gjeldende bruker i importveiviseren for sertifikat, og klikk deretter på Neste.

    Skjermbilde av det første vinduet i importveiviseren for sertifikat, der alternativet for lagringsplassering er satt til gjeldende bruker.

  3. Velg Neste i vinduet Fil som skal importeres.

  4. Lim inn passfrasen du mottok da du utførte PowerShell-kommandoen (trinn 1) i Passord-tekstboksen i vinduet Privatnøkkelbeskyttelse, og velg Neste. I dette eksemplet er passfrasen 9765328806094.

    Skjermbilde av vinduet privatnøkkelbeskyttelse i importveiviseren for sertifikat, med passordboksen uthevet.

  5. Velg alternativet Plasser alle sertifikater i dette lageret i Sertifikatlager-vinduet, og velg Bla gjennom.

    Skjermbilde av sertifikatlagervinduet i importveiviseren for sertifikat, med Plasser alle sertifikater i følgende lager valgt.

  6. Velg Klarerte instanser for rotsertifisering i vinduet Velg sertifikatlager, og velg deretter OK.

    Skjermbilde av Velg sertifikatlager-vinduet, med mappen Klarerte rotsertifiseringsinstanser valgt.

  7. Velg Neste i Sertifikatlager-vinduet.

    Skjermbilde av sertifikatlagervinduet for importveiviseren for sertifikat, med mappen Klarerte rotsertifiseringsinstanser valgt og Neste-knappen uthevet.

  8. Bekreft innstillingene og velg Fullfør i vinduet Fullfør importveiviseren for sertifikat.

    Obs!

    Velg Ja hvis du får en sikkerhetsadvarsel.

(Valgfritt) Bekreft at miljøet er konfigurert

Bekreft at verktøypakken for Power BI-visualobjekter er installert. Kjør kommandoen pbiviz i PowerShell, og se gjennom resultatet, inkludert listen over støttede kommandoer.

Skjermbilde av utdataene for utføring av kommandoen p b i v i z i PowerShell.

Konfigurer Power BI-tjenesten for utvikling av et visualobjekt

Hvis du vil utvikle et Power BI-visualobjekt, må du aktivere egendefinert feilsøking av visualobjekt i Power BI-tjenesten. Følg instruksjonene i denne delen for å aktivere dette alternativet.

  1. Logg deg på PowerBI.com.

  2. Gå til Innstillinger > Innstillinger > Innstillinger.

    Skjermbilde av menyalternativet innstillinger, innstillinger, innstillinger i Power BI-tjenesten.

  3. Velg Utvikler fra Generelt-fanen. Merk av for Aktiver egendefinert feilsøking av visualobjekt ved hjelp av utviklervisualobjektet i Utviklerinnstillinger, og velg Bruk.

    skjerm bilde av aktiverings modus, i kategorien Power BI innstillinger, generelt.

Installer utviklingsbiblioteker

Hvis du vil utvikle ditt eget Power BI-visualobjekt, må du installere flere biblioteker. Denne delen beskriver hvordan du installerer disse bibliotekene og bekrefter at installasjonen er vellykket.

Hvis du vil installere bibliotekene som er oppført i denne artikkelen, kan du åpne PowerShell og skrive inn installasjonskommandoen for hver komponent.

Obs!

Når disse bibliotekene er installert på datamaskinen, kan du bruke dem i alle prosjekter med Power BI-visualobjekter. Dette er en installasjonsprosedyre som utføres én gang per maskin.

D3 JavaScript-bibliotek

D3 er et JavaScript-bibliotek for produksjon av dynamiske, interaktive datavisualiseringer i nettlesere. Den er avhengig av Scalable Vector Graphics (SVG)-, HTML5- og CSS-standardene, som er implementert i stor skala.

npm i d3@^5.0.0 --save

TypeScript-definisjoner

Installer TypeScript-definisjoner slik at du kan utvikle Power BI-visualobjektet i TypeScript, et supersett av JavaScript.

npm i @types/d3@^5.0.0 --save

core-js

core-js er et modulært standardbibliotek for JavaScript som inkluderer polyfills for ECMAScript.

npm i core-js@3.2.1 --save

powerbi-visual-api

Installer API-definisjonene for Power BI-visualobjekter.

npm i powerbi-visuals-api --save-dev

(Valgfritt) Bekreft at D3-biblioteket er installert

Visual Studio Code (VS Code) er et ideelt integrert utviklingsmiljø for utvikling av TypeScript-programmer. I denne inndelingen bruker vi VS Code til å bekrefte at D3-biblioteket du trenger for å utvikle Power BI-visualobjektet, er riktig installert.

Obs!

Bekreftelsesprosessen som er beskrevet i denne delen, forutsetter at du har et eksisterende prosjekt for Power BI-visualobjekter. Hvis du ikke har et prosjekt for Power BI-visualobjekter, kan du opprette et ved å følge instruksjonene for opprettelse av sirkelkortprosjekter.

  1. Åpne VS Code.

    Tips!

    Du kan åpne VS Code fra PowerShell ved å kjøre følgende kommando fra prosjektmappen:

    code .
    
  2. Åpne Fil-menyen i VS Code, og velg Åpne mappe.

    Skjermbilde av alternativet for åpen mappe i VS Studio i Fil-menyen.

  3. Velg mappen som inneholder prosjektet for Power BI-visualobjektet i Åpne mappe-vinduet, og velg Velg mappe.

    Skjermbilde av velging av prosjektmappen for Power BI-visualobjekter i Åpen mappe-vinduet for VS Studio.

  4. Utvid node_modules-mappen i Utforsker-fanen, og bekreft at d3-biblioteket er installert.

    Skjermbilde av 3D-mappen i et prosjekt med Power BI-visualobjekt, slik det vises i VS Code.

  5. Utvid node_modules > @types > d3 i Utforsker-fanen, og bekreft at filen index.t.ds er installert.

    Skjermbilde av filen index.t.ds i et prosjekt med Power BI-visualobjekter, slik det vises i VS Code.

Neste trinn