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

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

Aloittaminen

  1. 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
  2. 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.

  3. Vastikään luodun rVisualSample hakemiston suorittamisesta

    pbiviz start
    
  4. Valitse Power BI DesktopR-komentosarjavisualisointi:

    Screenshot shows the R script visual control in the Power BI Desktop.

  5. Määritä tiedot kehittäjävisualisointiin vetämällä Kuukauden nro ja Yksiköitä yhteensävisualisoinnin arvoihin .

    Add data to values

  6. Määritä Yksiköitä yhteensä -koostetyypiksi Älä tee yhteenvetoa.

    Don't summarize data

  7. Kirjoita Power BI Desktop R-komentosarjaeditorista seuraava:

    plot(dataset)
    

    Tämä komento luo pistekaavion käyttäen tietojoukon arvoja syötteenä.

  8. näet tuloksen valitsemalla Suorita komentosarja.

    R visual with data

R-komentosarjan muokkaaminen

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

  1. 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
    
  2. näet tuloksen valitsemalla Suorita komentosarja.

    Screenshot shows the result of running the script, which is a line plot.

  3. Kun R-komentosarja on valmis, kopioi se script.r tiedostoon, joka sijaitsee visualisointiprojektin päähakemistossa.

  4. 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": {}
                  }
                }
              }
            },
            ...
          }
        }
      ],
    }
    
  5. 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.

  1. 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/"
        }
      ]
    }
    
  2. 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:

    Screenshot shows the visualization pane with four ovals created by corrplot.

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.

  1. 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"
              }
            ]
          }
        }
      }
    }
    
  2. 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 visual settings

    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.

  3. 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.

  1. Täytä -, -displayName, -description, -, name - ja email-tiedot sekä muut tiedoston tärkeät pbivis.jsonsupportUrltiedot.

  2. Jos haluat muuttaa visualisoinnin kuvaketta visualisointiruudussa, korvaa icon.png -tiedosto assets-kansiossa .

  3. Suorita visualisoinnin päähakemistosta:

    pbiviz package
    

    Lisätietoja visualisoinnin pakkaamisesta on artikkelissa Mukautetun visualisoinnin pakkaaminen

  4. Tuo visualisoinnin pbiviz-tiedosto mihin tahansa Power BI raporttiin. Ohjeet ovat ohjeaiheessa Visualisointitiedoston tuominen paikallisesta tietokoneesta Power BI.

  5. Lopullinen visualisointi näyttää seuraavan esimerkin kaltaiselta:

R visual settings with changed value

Seuraavat vaiheet