Sdílet prostřednictvím

Kurz: Vytvoření vizuálu Power BI využívajícího jazyk R

  • Článek

Jako vývojář můžete vytvářet vlastní vizuály Power BI. Tyto vizuály můžou používat vy, vaše organizace nebo třetí strany.

Tento článek je podrobný průvodce pro vytvoření vizuálu R pro Power BI.

V tomto kurzu se naučíte:

  • Vytvoření vizuálu R
  • Úprava skriptu R v Power BI Desktopu
  • Přidání knihoven do souboru závislostí vizuálu
  • Přidání statické vlastnosti

Požadavky

Začínáme

  1. Připravte pro vizuál ukázková data. Tyto hodnoty můžete uložit do excelové databáze nebo souboru .csv a importovat je do Power BI Desktopu.

    ČísloMěsíce Total Units
    0 2303
    2 2319
    3 1732
    4 1 615
    5 1427
    6 2253
    7 1147
    8 1515
    9 2516
    10 3131
    11 3170
    12 2762

  2. Pokud chcete vytvořit vizuál, otevřete PowerShell nebo Terminál a spusťte následující příkaz:

    pbiviz new rVisualSample -t rvisual

    Tento příkaz vytvoří novou složku pro vizuál rVisualSample . Struktura je založená na šabloně rvisual . Vytvoří soubor s názvem script.r v kořenové složce vizuálu. Tento soubor obsahuje skript R,který se spustí pro vygenerování obrázku při vykreslení vizuálu. Skript jazyka R můžete vytvořit v Power BI Desktopu.

  3. Z nově vytvořeného rVisualSample adresáře spusťte následující příkaz:

    pbiviz start

  4. V Power BI Desktopu vyberte vizuál skriptu jazyka R:

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

  5. Přiřaďte data vývojářskému vizuálu přetažením monthNo a total units (Celkem) do hodnot vizuálu.

    Screenshot showing where to add data to values.

  6. Nastavte typ agregace celkových jednotek na nevystihovejte souhrny.

    Screenshot of menu with option for not summarizing data.

  7. V editoru skriptů jazyka R v Power BI Desktopu zadejte následující:

    plot(dataset)

    Tento příkaz vytvoří bodový graf pomocí hodnot v sémantickém modelu jako vstup.

  8. Výběrem ikony Spustit skript zobrazíte výsledek.

    Screenshot of R visual chart with data.

Úprava skriptu jazyka R

Skript jazyka R lze upravit tak, aby vytvořil další typy vizuálů. Teď vytvoříme spojnicový graf.

  1. Do editoru skriptů jazyka R vložte následující kód R.

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

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. Výběrem ikony Spustit skript zobrazíte výsledek.

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

  3. Až bude skript jazyka R připravený, zkopírujte ho do script.r souboru umístěného v kořenovém adresáři projektu vizuálu.

  4. V souboru capabilities.json změňte dataRoleshodnotu : name na datovou sadu a nastavte dataViewMappings vstup na datovou sadu.

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

  5. Přidejte následující kód, který podporuje změnu velikosti obrázku v souboru src/visual.ts .

      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";
  }

Přidání knihoven do balíčku vizuálů

Balíček corrplot vytvoří grafické zobrazení korelační matice. Další informace o corrplotproduktu naleznete v tématu Úvod k corrplot Package.

  1. corrplot Přidejte do dependencies.json souboru závislost knihovny. Tady je příklad obsahu souboru:

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

  2. Teď můžete začít používat balíček corrplot v script.r souboru.

    library(corrplot)
corr <- cor(dataset)
corrplot(corr, method="circle", order = "hclust")

    Výsledek použití corrplot balíčku vypadá jako v tomto příkladu:

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

Přidání statické vlastnosti do podokna vlastností

Teď, když máme základní corrplot vizuál, přidáme do podokna vlastností vlastnosti vlastnosti, které uživateli umožní změnit vzhled a chování vizuálu.

Tento argument používáme method ke konfiguraci tvaru datových bodů. Výchozí skript používá kruh. Upravte vizuál tak, aby si uživatel vybral mezi několika možnostmi.

  1. Definujte v souboru capabilities.json volaná object nastavení a přidělte jí následující vlastnosti.

    "settings": {
  "properties": {
    "method": {
      "type": {
        "enumeration": [
          { "value": "circle" },
          { "value": "square" },
          { "value": "ellipse" },
          { "value": "number" },
          { "value": "shade" },
          { "value": "color" },
          { "value": "pie" }
        ]
      }
    }
  }
}

  2. Otevřete soubor src/settings.ts. Vytvořte VisualCardSettings třídu s veřejnými vlastnostmi method, namedisplayName a slices jak je znázorněno v textovém poli kódu.

    import ItemDropdown = formattingSettings.ItemDropdown;

const methodOptions = [
    {
        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"
    }
]

class VisualCardSettings extends FormattingSettingsCard {
    method: FormattingSettingsSlice = new ItemDropdown({
        name: "method",
        displayName: "Method",
        items: methodOptions,
        value: methodOptions[0]
    });

    name: string = "settings";
    displayName: string = "Settings";
    slices: Array<FormattingSettingsSlice> = [this.method];
}

    Po provedení těchto kroků můžete změnit vlastnost vizuálu.

    Screenshot of R visual settings.

    Nakonec musí mít skript jazyka R výchozí vlastnost. Pokud uživatel nezmění hodnotu vlastnosti (v tomto případě nastavení obrazce), vizuál tuto hodnotu použije.

    Pro proměnné modulu runtime jazyka R pro vlastnosti je <objectname>_<propertyname>v tomto případě settings_methodkonvence pojmenování .

  3. Spusťte následující skript R:

    library(corrplot)
corr <- cor(dataset)

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

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

Zabalení a import vizuálu

Teď můžete vizuál zabalit a importovat ho do libovolné sestavy Power BI.

  1. displayNameVyplňte soubor , , , descriptionsupportUrlautor name a emaila všechny další důležité informace v pbivis.json souboru.

  2. Pokud chcete změnit ikonu vizuálu v podokně vizualizace, nahraďte icon.png soubor ve složce assets .

  3. Z kořenového adresáře vizuálu spusťte:

    pbiviz package

    Další informace o balení vizuálu najdete v tématu Balení vlastního vizuálu.

  4. Importujte soubor pbiviz vizuálu do libovolné sestavy Power BI. Pokyny k tomu, jak to udělat, najdete v tématu Import vizuálního souboru z místního počítače do Power BI .

  5. Konečný vizuál vypadá jako v následujícím příkladu:

Screenshot of R visual settings with changed value.

Související obsah