Power BI görsel proje yapısı

  • Makale

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

Yeni bir görsel oluşturmak için Power BI görselinin içinde olmasını istediğiniz dizine gidin ve komutunu çalıştırın:

pbiviz new <visual project name>

Bu komutu çalıştırmak, aşağıdaki dosyaları içeren bir Power BI görsel klasörü oluşturur:

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üm, Power BI görselleri pbiviz aracının oluşturduğu dizindeki her klasör ve dosya için bilgi sağlar.

.vscode

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

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

Daha fazla bilgi için bkz . Kullanıcı ve çalışma alanı ayarları.

varlıklar

Bu klasör dosyayı içerir icon.png .

Power BI görselleri aracı bu dosyayı Power BI görselleştirme bölmesindeki yeni Power BI görsel simgesi olarak kullanır. Bu simge, boyutları 20 piksel ile 20 piksel olan bir PNG dosyası olmalıdır.

src

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

Bu klasörde Power BI görselleri aracı aşağıdaki dosyaları oluşturur:

  • visual.ts - Görselin ana kaynak kodu. Visual API hakkında bilgi edinin.
  • settings.ts - Görselin ayarlarının kodu. Dosyadaki sınıflar, görselinizin özelliklerini tanımlamak için bir arabirim sağlar.

stili

Bu klasör, görselin visual.less stillerini barındıran dosyayı içerir.

capabilities.json

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

package-lock.json

Bu dosya npm'nin ağacı veya package.json dosyayı değiştirdiği node_modules 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ında yazarlar, açıklama ve proje bağımlılıkları gibi bilgiler 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 girişlerini açıklayan açıklamalarla örnek pbiviz.json bir dosyayı görüntülemek için meta veri girişleri bölümüne bakın.

tsconfig.json

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

Bu dosya, dosyadaki özelliğinde belirtildiği gibi görselin ana sınıfının bulunduğu *.ts dosyasının pbiviz.jsonvisualClassName yolunu içermelidir.

tslint.json

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

Meta veri girdileri

Dosyadan başlık aşağıdaki kodda yer alan pbiviz.json açıklamalar meta veri girdilerini açıklar. Görseli paketlemeden önce yazarın adı ve e-postası gibi bazı meta veriler gereklidir.

Dekont

  • Pbiviz aracının externalJS 3.x.x sürümünden desteklenmez.
  • Sürüm numaraları aşağıdaki biçimde x.x.x.xdört basamak içermelidir.
  • Yerelleştirme desteği için Power BI yerel ayarını görselinize ekleyin.
{
  "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": []
}

İlgili içerik