Power BI -visualisoinnin projektirakenne

  • Artikkeli

Paras tapa aloittaa uuden Power BI -visualisoinnin luominen on käyttää Power BI -visualisointien pbiviz-työkalua .

Jos haluat luoda uuden visualisoinnin, siirry siihen hakemistoon, jossa haluat Power BI -visualisoinnin sijainneen, ja suorita komento:

pbiviz new <visual project name>

Tämän komennon suorittaminen luo Power BI -visualisointikansion, joka sisältää seuraavat tiedostot:

project
├───.vscode
│   ├───launch.json
│   └───settings.json
├───assets
│   └───icon.png
├───node_modules
├───src
│   ├───settings.ts
│   └───visual.ts
├───style
│   └───visual.less
├───capabilities.json
├───package-lock.json
├───package.json
├───pbiviz.json
├───tsconfig.json
└───tslint.json

Kansion ja tiedoston kuvaus

Tämä osa sisältää tietoja kaikista kansioista ja tiedostoista, jotka Power BI -visualisoinnin pbiviz-työkalu luo.

.vscode

Tämä kansio sisältää VS Code -projektiasetukset.

Jos haluat määrittää työtilan, muokkaa tiedostoa .vscode/settings.json .

Lisätietoja on kohdassa Käyttäjän ja työtilan asetukset.

assets

Tämä kansio sisältää icon.png -tiedoston.

Power BI -visualisointityökalu käyttää tätä uuden Power BI -visualisoinnin kuvakkeena Power BI -visualisointiruudussa. Tämän kuvakkeen on oltava PNG-tiedosto , jonka mitat ovat 20 kuvapistettä ja 20 kuvapistettä.

src

Tämä kansio sisältää visualisoinnin lähdekoodin.

Tähän kansioon Power BI -visualisointityökalu luo seuraavat tiedostot:

  • visual.ts – Visualisoinnin päälähdekoodi. Lue visualisoinnin ohjelmointirajapinnasta.
  • settings.ts – Visualisoinnin asetusten koodi. Tiedoston luokat tarjoavat käyttöliittymän visualisoinnin ominaisuuksien määrittämiseen.

style

Tämä kansio sisältää visual.less -tiedoston, joka sisältää visualisoinnin tyylit.

capabilities.json

Tämä tiedosto sisältää visualisoinnin tärkeimmät ominaisuudet ja asetukset ( ominaisuudet). Sen avulla visualisointi voi esitellä tuetut ominaisuudet, objektit, ominaisuudet ja tietonäkymän yhdistämismääritykset.

package-lock.json

Tämä tiedosto luodaan automaattisesti kaikille toiminnoille, joissa npm muokkaa joko puuta node_modules tai tiedostoa package.json .

Lisätietoja tästä tiedostosta saat virallisesta npm-package-lock.json-dokumentaatiosta .

package.json

Tämä tiedosto kuvaa projektipakettia. Se sisältää sellaista projektia koskevia tietoja kuin tekijät, kuvauksen ja projektin riippuvuudet.

Lisätietoja tästä tiedostosta saat virallisesta npm-package.json-dokumentaatiosta .

pbiviz.json

Tämä tiedosto sisältää visualisoinnin metatiedot.

Jos haluat tarkastella esimerkkitiedostoa pbiviz.json , jonka kommentit kuvaavat metatietojen merkintöjä, katso osaa metatietojen merkinnät .

tsconfig.json

Määritystiedosto TypeScriptille.

Tämän tiedoston on sisällettävä polku *.ts-tiedostoon , jossa visualisoinnin pääluokka sijaitsee, kuten -ominaisuudessa visualClassName tiedostossa pbiviz.json on määritetty.

tslint.json

Tämä tiedosto sisältää TSLint-määrityksen.

Metatietomerkinnät

Seuraavan koodiotsikon pbiviz.json kommentit tiedostosta kuvaavat metatietomerkintöjä. Tiettyjä metatietoja, kuten tekijän nimi ja sähköpostiosoite, tarvitaan, ennen kuin visualisoinnin voi pakata.

Muistiinpano

{
  "visual": {
     // The visual's internal name.
    "name": "<visual project name>",

    // The visual's display name.
    "displayName": "<visual project name>",

    // The visual's unique ID.
    "guid": "<visual project name>23D8B823CF134D3AA7CC0A5D63B20B7F",

    // The name of the visual's main class. Power BI creates the instance of this class to start using the visual in a Power BI report.
    "visualClassName": "Visual",

    // The visual's version number.
    "version": "1.0.0.0",
    
    // The visual's description (optional)
    "description": "",

    // A URL linking to the visual's support page (optional).
    "supportUrl": "",

    // A link to the source code available from GitHub (optional).
    "gitHubUrl": ""
  },
  // The version of the Power BI API the visual is using.
  "apiVersion": "2.6.0",

  // The name of the visual's author and email.
  "author": { "name": "", "email": "" },

  // 'icon' holds the path to the icon file in the assets folder; the visual's display icon.
  "assets": { "icon": "assets/icon.png" },

  // Contains the paths for JS libraries used in the visual.
  // Note: externalJS' isn't used in the Power BI visuals tool version 3.x.x or higher.
  "externalJS": null,

  // The path to the 'visual.less' style file.
  "style": "style/visual.less",

  // The path to the `capabilities.json` file.
  "capabilities": "capabilities.json",

  // The path to the `dependencies.json` file which contains information about R packages used in R based visuals.
  "dependencies": null,

  // An array of paths to files with localizations.
  "stringResources": []
}

Liittyvä sisältö