Power BI görseli proje yapısı

Yeni bir Power BI görseli oluşturmaya başlamanın en iyi yolu Power BI görselleri pbiviz aracını kullanmaktır.

Yeni görsel oluşturmak için, Power BI görselinin yerleştirilmesini istediğiniz dizine gidin ve şu komutu çalıştırın:

pbiviz new <visual project name>

Bu komut çalıştırıldığında aşağıdaki dosyaları içeren bir Power BI görseli klasörü oluşturulur:

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

Klasör ve dosya açıklaması

Bu bölümde, Power BI görselleri pbiviz aracının oluşturduğu dizindeki klasör ve dosyaların her biri hakkında bilgi sağlanır.

.vscode

Bu klasör VS kodu proje ayarlarını içerir.

Çalışma alanınızı yapılandırmak için .vscode/settings.json dosyasını düzenleyin.

Daha fazla bilgi için bkz. Kullanıcı ve Çalışma Alanı Ayarları

varlıklar

Bu klasör icon.png dosyasını içerir.

Power BI görselleri aracı bu dosyayı Power BI görselleştirme bölmesinde yeni Power BI görselinin simgesi olarak kullanır. Bu simge, 20 piksel ile 20 piksel arasında bir PNG dosyası olmalıdır.

src

Bu klasör görselin kaynak kodunu içerir.

Bu klasörde Power BI görselleri aracı şu dosyaları oluşturur:

• visual.ts - Görselin ana kaynak kodu.
• settings.ts - Görselin ayarlarının kodu. Dosyadaki sınıflar görselinizin özelliklerini tanımlamaya yönelik bir arabirim sağlar.

stil

Bu klasör, içinde görselin stillerinin bulunduğu visual.less dosyasını içerir.

capabilities.json

Bu dosya görselin ana özelliklerini ve ayarlarını (veya becerilerini) içerir. Görselin desteklenen özellikleri, nesneleri ve veri görünümü eşlemesini bildirmesine olanak tanır.

package-lock.json

Bu dosya npm’nin node_modules ağacını veya package.json dosyasını değiştirdiği tüm işlemler için otomatik olarak oluşturulur.

Bu dosya hakkında daha fazla bilgi için resmi npm-package-lock.json belgelerine bakın.

package.json

Bu dosya proje paketini açıklar. Proje hakkındaki bilgileri, örneğin yazarlarını, açıklamasını ve proje bağımlılıklarını içerir.

Bu dosya hakkında daha fazla bilgi için resmi npm-package.json belgelerine bakın.

pbiviz.json

Bu dosya görsel meta verilerini içerir.

Meta veri girdilerinin anlatıldığı açıklamalarla örnek bir pbiviz.json dosyası görmek için meta veri girdileri bölümüne bakın.

tsconfig.json

TypeScript için yapılandırma dosyası.

Bu dosya, pbiviz.json dosyasındaki visualClassName özelliğinde belirtildiği gibi görselin ana sınıfının yer aldığı *.ts dosyasının yolunu içermelidir.

tslint.json

Bu dosya TSLint yapılandırmasını içerir.

Meta veri girdileri

pbiviz.json dosyasından alınan aşağıdaki kod parçasındaki açıklamalar, meta veri girdilerini anlatır. Görseli paketleyemeden önce belirli meta veriler (yazarın adı ve e-postası gibi) gereklidir.

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

Sonraki adımlar