Opetusohjelma: R:ää hyödyntävän Power BI -visualisoinnin luominen

Artikkeli
05/04/2022
4 minuutin lukuaika

Kehittäjänä voit luoda omia Power BI -visualisointeja. Sinä, organisaatiosi ja kolmannet osapuolet voivat käyttää kyseisiä visualisointeja.

Tämä artikkeli on vaiheittainen opas R:ää hyödyntävän visualisoinnin luomiseen Power BI varten.

Tässä opetusohjelmassa opit:

Opit luomaan R:ään perustuvan visualisoinnin.
R-komentosarjan muokkaaminen Power BI Desktop
Kirjastojen lisääminen visualisoinnin riippuvuustiedostoon
Opit lisäämään staattisen ominaisuuden.

Edellytykset

Power BI Pro -tili. Rekisteröi ilmainen kokeiluversio ennen kuin aloitat.
R-moduuli. Voit ladata yhden useista eri paikoista, esimerkiksi Revolution Open -lataussivulta ja CRAN-säilöstä. Saat lisätietoja ohjeartikkelista Power BI -visualisointien luominen R:n avulla.
Sinulla täytyy olla Power BI Desktop.
Sinulla täytyy olla Windows PowerShellin versio 4 tai uudempi (jos käytät Windowsia) TAI Pääte (jos käytät OSX:ää).

Aloittaminen

Valmistele visualisoinnin mallitietoja. Voit tallentaa nämä arvot Excel tietokantaan tai .csv -tiedostoon ja tuoda sen Power BI Desktop.

Kuukauden nro Yksiköitä yhteensä

1 2303

2 2319

3 1732

4 1615

5 1427

6 2253

7 1147

8 1515

9 2516

10 3131

11 3170

12 2762
Jos haluat luoda visualisoinnin, avaa PowerShell tai Pääte ja suorita seuraava komento:
```
pbiviz new rVisualSample -t rvisual
```
Tämä komento luo uuden kansion rVisualSample-visualisoinnille . Rakenne perustuu malliin rvisual . Se luo visualisoinnin pääkansioon tiedoston nimeltä script.r . Tämä tiedosto sisältää R-komentosarjan, joka suoritetaan kuvan luomiseksi visualisoinnin hahmonnuksen yhteydessä. Voit luoda R-komentosarjan Power BI Desktop.
Vastikään luodun rVisualSample hakemiston suorittamisesta
```
pbiviz start
```
Valitse Power BI DesktopR-komentosarjavisualisointi:
Määritä tiedot kehittäjävisualisointiin vetämällä Kuukauden nro ja Yksiköitä yhteensävisualisoinnin arvoihin .
Määritä Yksiköitä yhteensä -koostetyypiksi Älä tee yhteenvetoa.
Kirjoita Power BI Desktop R-komentosarjaeditorista seuraava:
```
plot(dataset)
```
Tämä komento luo pistekaavion käyttäen tietojoukon arvoja syötteenä.
näet tuloksen valitsemalla Suorita komentosarja.

Kuukauden nro	Yksiköitä yhteensä
1	2303
2	2319
3	1732
4	1615
5	1427
6	2253
7	1147
8	1515
9	2516
10	3131
11	3170
12	2762

R-komentosarjan muokkaaminen

R-komentosarjaa voidaan muokata muuntyyppisten visualisointien luomiseksi. Luodaan seuraavaksi viivakaavio.

Liitä seuraava R-koodi R-komentosarjaeditoriin:

x <- dataset[,1] # get the first column from dataset
y <- dataset[,2] # get the second column from dataset

columnNames = colnames(dataset) # get column names

plot(x, y, type="n", xlab=columnNames[1], ylab=columnNames[2]) # draw empty plot with axis and labels only
lines(x, y, col="green") # draw line plot

näet tuloksen valitsemalla Suorita komentosarja.
Kun R-komentosarja on valmis, kopioi se script.r tiedostoon, joka sijaitsee visualisointiprojektin päähakemistossa.

Vaihda capabilities.json-tiedostossadataRoles: name-arvoksi tietojoukko ja määritä syötteeksi dataViewMappingstietojoukko.

{
  "dataRoles": [
    {
      "displayName": "Values",
      "kind": "GroupingOrMeasure",
      "name": "dataset"
    }
  ],
  "dataViewMappings": [
    {
      "scriptResult": {
        "dataInput": {
          "table": {
            "rows": {
              "select": [
                {
                  "for": {
                    "in": "dataset"
                  }
                }
              ],
              "dataReductionAlgorithm": {
                "top": {}
              }
            }
          }
        },
        ...
      }
    }
  ],
}

Lisää seuraava koodi, joka tukee kuvan koon muuttamista src/visual.ts-tiedostossa.

  public onResizing(finalViewport: IViewport): void {
      this.imageDiv.style.height = finalViewport.height + "px";
      this.imageDiv.style.width = finalViewport.width + "px";
      this.imageElement.style.height = finalViewport.height + "px";
      this.imageElement.style.width = finalViewport.width + "px";
  }

Kirjastojen lisääminen visualisointipakettiin

Paketti corrplot luo graafisen näytön korrelaatiomatriisista. Jos haluat lisätietoja kohteesta corrplot, siirry ohjeartikkeliin Corrplot-paketin esittely.

Lisää kirjaston corrplot riippuvuus tiedostoon dependencies.json . Tässä on esimerkki tiedoston sisällöstä:

{
  "cranPackages": [
    {
      "name": "corrplot",
      "displayName": "corrplot",
      "url": "https://cran.r-project.org/web/packages/corrplot/"
    }
  ]
}

Nyt voit aloittaa corrplot-paketin käytön tiedostossasi script.r .
```
library(corrplot)
corr <- cor(dataset)
corrplot(corr, method="circle", order = "hclust")
```
corrplot-paketin käytön tulos näyttää tämän esimerkin kaltaiselta:

Staattisen ominaisuuden lisääminen ominaisuusruutuun

Nyt kun meillä on perusvisualisointi corrplot , lisätään ominaisuusruutuun ominaisuuksia, joiden avulla käyttäjä voi muuttaa visualisoinnin ulkoasua.

Arvopisteiden muoto määritetään argumentin method avulla. Oletuskomentosarja käyttää ympyrää. Muokkaa visualisointia siten, että käyttäjällä on mahdollisuus valita useista vaihtoehdoista.

Määritä kutsutun objectasetuksetcapabilities.json-tiedostossa ja anna sille alla näkyvät ominaisuudet. Käytä sitten tämän objektin nimeä luettelointimenetelmässä, jotta saat arvot ominaisuusruudusta.

{
  "settings": {
  "displayName": "Visual Settings",
  "description": "Settings to control the look and feel of the visual",
  "properties": {
    "method": {
      "displayName": "Data Look",
      "description": "Control the look and feel of the data points in the visual",
      "type": {
        "enumeration": [
          {
            "displayName": "Circle",
            "value": "circle"
          },
          {
            "displayName": "Square",
            "value": "square"
          },
          {
            "displayName": "Ellipse",
            "value": "ellipse"
          },
          {
            "displayName": "Number",
            "value": "number"
          },
          {
            "displayName": "Shade",
            "value": "shade"
          },
          {
            "displayName": "Color",
            "value": "color"
          },
          {
            "displayName": "Pie",
            "value": "pie"
          }
        ]
      }
    }
  }
}

Avaa src/settings.ts-tiedosto. Luo luokka CorrPlotSettings julkisella ominaisuudella method. Tyyppi on string ja oletusarvo on circle. Lisää ominaisuus settings luokkaan VisualSettings oletusarvolla:
```
"use strict";

import { dataViewObjectsParser } from "powerbi-visuals-utils-dataviewutils";
import DataViewObjectsParser = dataViewObjectsParser.DataViewObjectsParser;

export class VisualSettings extends DataViewObjectsParser {
  public rcv_script: rcv_scriptSettings = new rcv_scriptSettings();
  public settings: CorrPlotSettings = new CorrPlotSettings();
}

export class CorrPlotSettings {
  public method: string = "circle";
}

export class rcv_scriptSettings {
  public provider;
  public source;
}
```
Tämän jälkeen voit muokata visualisoinnin ominaisuutta.

R-komentosarjalla on lopuksi oltava oletusominaisuus. Jos käyttäjä ei muuta ominaisuuden arvoa (tässä tapauksessa muotoasetusta), visualisointi käyttää tätä arvoa.

Ominaisuuksien suorituksenaikaisten R-muuttujien nimeämiskäytäntö on <objectname>_<propertyname>, tässä tapauksessa settings_method.

Suorita seuraava R-komentosarja:

library(corrplot)
corr <- cor(dataset)

if (!exists("settings_method"))
{
    settings_method = "circle";
}

corrplot(corr, method=settings_method, order = "hclust")

Visualisoinnin pakkaaminen ja tuominen

Nyt voit pakata visualisoinnin ja tuoda sen mihin tahansa Power BI raporttiin.

Täytä -, -displayName, -description, -, name - ja email-tiedot sekä muut tiedoston tärkeät pbivis.jsonsupportUrltiedot.
Jos haluat muuttaa visualisoinnin kuvaketta visualisointiruudussa, korvaa icon.png -tiedosto assets-kansiossa .
Suorita visualisoinnin päähakemistosta:
```
pbiviz package
```
Lisätietoja visualisoinnin pakkaamisesta on artikkelissa Mukautetun visualisoinnin pakkaaminen
Tuo visualisoinnin pbiviz-tiedosto mihin tahansa Power BI raporttiin. Ohjeet ovat ohjeaiheessa Visualisointitiedoston tuominen paikallisesta tietokoneesta Power BI.
Lopullinen visualisointi näyttää seuraavan esimerkin kaltaiselta:

R visual settings with changed value

Seuraavat vaiheet

Käytä R:ää hyödyntäviä Power BI visualisointeja Power BI.

Palkkikaavion rakentaminen