Δομή έργου απεικόνισης Power BI

Ο καλύτερος τρόπος για να αρχίσετε να δημιουργείτε μια νέα απεικόνιση Power BI είναι να χρησιμοποιήσετε το εργαλείο απεικονίσεων pbiviz του Power BI.

Για να δημιουργήσετε μια νέα απεικόνιση, μεταβείτε στον κατάλογο στον οποίο θέλετε να βρίσκεται η απεικόνιση Power BI και εκτελέστε την εντολή:

pbiviz new <visual project name>

Η εκτέλεση αυτής της εντολής δημιουργεί έναν φάκελο απεικόνισης Power BI που περιέχει τα ακόλουθα αρχεία:

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

Περιγραφή φακέλων και αρχείων

Αυτή η ενότητα παρέχει πληροφορίες για κάθε φάκελο και αρχείο στον κατάλογο που δημιουργεί το εργαλείο απεικονίσεων pbiviz του Power BI.

.vscode

Αυτός ο φάκελος περιέχει τις ρυθμίσεις του έργου κώδικα VS.

Για να ρυθμίσετε τις παραμέτρους του χώρου εργασίας σας, επεξεργαστείτε το αρχείο .vscode/settings.json.

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Ρυθμίσεις χρήστη και χώρου εργασίας

assets

Αυτός ο φάκελος περιέχει το αρχείο icon.png.

Το εργαλείο απεικονίσεων Power BI απεικονίσεις χρησιμοποιεί αυτό το αρχείο ως το εικονίδιο της νέας απεικόνισης Power BI στο τμήμα παραθύρου απεικονίσεων Power BI. Αυτό το εικονίδιο πρέπει να είναι αρχείο PNG , διαστάσεων 20 pixel ή 20 pixel.

src

Αυτός ο φάκελος περιέχει τον πηγαίο κώδικα της απεικόνισης.

Σε αυτόν τον φάκελο, το εργαλείο απεικονίσεων Power BI δημιουργεί τα παρακάτω αρχεία:

  • visual.ts - Ο κύριος πηγαίος κώδικας της απεικόνισης.
  • settings.ts - Ο κώδικας των ρυθμίσεων της απεικόνισης. Οι κλάσεις στο αρχείο παρέχουν μια διασύνδεση για τον ορισμό των ιδιοτήτων της απεικόνισης.

στυλ

Αυτός ο φάκελος περιέχει το αρχείο visual.less, το οποίο περιέχει τα στυλ της απεικόνισης.

capabilities.json

Αυτό το αρχείο περιέχει τις κύριες ιδιότητες και ρυθμίσεις (ή δυνατότητες) για την απεικόνιση. Επιτρέπει στην απεικόνιση να δηλώνει υποστηριζόμενες δυνατότητες, αντικείμενα, ιδιότητες και αντιστοίχιση προβολής δεδομένων.

package-lock.json

Αυτό το αρχείο δημιουργείται αυτόματα για οποιεσδήποτε λειτουργίες όπου το npm τροποποιεί είτε το δέντρο node_modules είτε το αρχείο package.json.

Για περισσότερες πληροφορίες σχετικά με αυτό το αρχείο, ανατρέξτε στην επίσημη τεκμηρίωση του npm-package-lock.json.

package.json

Αυτό το αρχείο περιγράφει το πακέτο έργου. Συνήθως περιέχει πληροφορίες σχετικά με το έργο, τους συντάκτες, την περιγραφή και τις εξαρτήσεις του έργου.

Για περισσότερες πληροφορίες σχετικά με αυτό το αρχείο, ανατρέξτε στην επίσημη τεκμηρίωση του npm-package.json.

pbiviz.json

Αυτό το αρχείο περιέχει τα μετα-δεδομένα της απεικόνισης.

Για να δείτε ένα παράδειγμα ενός αρχείου pbiviz.json με σχόλια που περιγράφουν τις καταχωρήσεις μετα-δεδομένων, ανατρέξτε στην ενότητα Καταχωρήσεις μετα-δεδομένων.

tsconfig.json

Ένα αρχείο ρύθμισης παραμέτρων για την TypeScript.

Αυτό το αρχείο πρέπει να περιλαμβάνει τη διαδρομή προς το αρχείο *.ts στο οποίο βρίσκεται η κύρια κλάση της απεικόνισης, visualClassName όπως καθορίζεται στην ιδιότητα του pbiviz.json αρχείου .

tslint.json

Αυτό το αρχείο περιέχει τη ρύθμιση παραμέτρων TSLint.

Καταχωρήσεις μετα-δεδομένων

Τα σχόλια στην ακόλουθη λεζάντα κώδικα από το αρχείο pbiviz.json, περιγράφουν τις καταχωρήσεις μετα-δεδομένων. Ορισμένα μετα-δεδομένα (όπως το όνομα και η διεύθυνση ηλεκτρονικού ταχυδρομείου του συντάκτη) απαιτούνται για να είναι δυνατή η δημιουργία πακέτου με την απεικόνιση.

Σημείωση

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

Επόμενα βήματα