Κοινή χρήση μέσω

Δομή έργου απεικόνισης 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 Code.

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

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

assets

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

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

src

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

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

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

style

Αυτός ο φάκελος περιέχει το 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.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": []
}

Σχετικό περιεχόμενο