Power BI-vizualizációs projektstruktúra

Az új Power BI-vizualizációk létrehozásának legjobb módja a Power BI-vizualizációk pbiviz eszköz használata.

Új vizualizáció létrehozásához lépjen arra a könyvtárra, amelyben a Power BI-vizualizációt el szeretné helyezni, és futtassa a parancsot:

pbiviz new <visual project name>

A parancs futtatásakor létrejön egy Power BI-vizualizációs mappa, amely a következő fájlokat tartalmazza:

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

Mappa és fájl leírása

Ez a szakasz a Power BI-vizualizációk pbiviz eszköz által létrehozott könyvtár minden mappájának és fájljának adatait tartalmazza.

.vscode

Ez a mappa tartalmazza a VS Code-projekt beállításait.

A munkaterület konfigurálásához szerkessze a .vscode/settings.json fájlt.

További információ: Felhasználó és munkaterület beállításai.

kapcsolatobjektumok

Ez a mappa tartalmazza a icon.png fájlt.

A Power BI-vizualizációk eszköz ezt a fájlt használja a Power BI vizualizációs panel új Power BI-vizualizáció ikonjaként. Ennek az ikonnak 20 képpont és 20 képpont méretű PNG-fájlnak kell lennie.

src

Ez a mappa tartalmazza a vizualizáció forráskódját.

Ebben a mappában a Power BI vizualizációs eszköz a következő fájlokat hozza létre:

  • visual.ts - A vizualizáció fő forráskódja. További információ a Visual API-ról.
  • settings.ts - A vizualizáció beállításainak kódja. A fájl osztályai felületet biztosítanak a vizualizáció tulajdonságainak meghatározásához.

style

Ez a mappa tartalmazza a visual.less fájlt, amely a vizualizáció stílusát tartalmazza.

capabilities.json

Ez a fájl tartalmazza a vizualizáció fő tulajdonságait és beállításait (vagy képességeit). Lehetővé teszi, hogy a vizualizáció deklarálja a támogatott funkciókat, objektumokat, tulajdonságokat és adatnézet-leképezést.

package-lock.json

Ez a fájl automatikusan létrejön minden olyan művelethez, amelyben az npm módosítja a node_modules fát vagy a package.json fájlt.

A fájlról további információt a hivatalos npm-package-lock.json dokumentációjában talál.

package.json

Ez a fájl a projektcsomagot ismerteti. Információkat tartalmaz a projektről, például szerzőkről, leírásokról és projektfüggőségekről.

A fájlról további információt a hivatalos npm-package.json dokumentációjában talál.

pbiviz.json

Ez a fájl tartalmazza a vizualizáció metaadatait.

A metaadat-bejegyzéseket leíró megjegyzéseket tartalmazó példafájl pbiviz.json megtekintéséhez tekintse meg a metaadat-bejegyzések szakaszt .

tsconfig.json

A TypeScript konfigurációs fájlja.

A fájlnak tartalmaznia kell a *.ts fájl elérési útját, ahol a vizualizáció fő osztálya található, a visualClassName fájl tulajdonságában pbiviz.json megadott módon.

tslint.json

Ez a fájl tartalmazza a TSLint-konfigurációt.

Metaadat-bejegyzések

A fájl alábbi kódfeliratában szereplő megjegyzések a pbiviz.json metaadat-bejegyzéseket írják le. A vizualizáció csomagolásához bizonyos metaadatokra, például a szerző nevére és e-mail-címére van szükség.

Feljegyzés

{
  "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": []
}

Kapcsolódó tartalom

  • Last updated on