Упаковка визуального элемента Power BI

Прежде чем загрузить пользовательский визуальный элемент в Power BI Desktop или поделиться им с сообществом в коллекции визуальных элементов Power BI, необходимо упаковать его. В этом руководстве описано следующее:

• Укажите значения свойств и метаданные для визуального элемента.
• Обновите значок.
• Упакуйте пользовательский визуальный элемент.

Ввод значений свойств

1. В PowerShell остановите визуальный элемент, если он запущен.

2. В VS Code перейдите в корневую папку визуального проекта и откройте файл pbiviz.json .

3. В объекте visual задайте displayName значение для отображаемого имени визуального элемента.

   

   Отображаемое имя визуального элемента отображается в области визуализаций Power BI при наведении курсора на значок визуального элемента.

4. Заполните или измените следующие поля в файле pbiviz.json :

   • visualClassName
   • description

   visualClassName является необязательным, но description должен быть заполнен для выполнения команды пакета.

5. Заполните supportUrl и gitHubUrl, указав URL-адреса, на которые пользователь может зайти, чтобы получить поддержку и просмотреть проект GitHub вашего визуального элемента.

   В следующем коде показаны supportUrl и gitHubUrl примеры:

   {
       "supportUrl": "https://community.powerbi.com",
       "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
   }
   

6. Введите имя и электронную author почту в объекте.

7. Сохраните файл pbiviz.json .

Обновление значка (необязательно)

1. В файлеpbiviz.json обратите внимание, что документ определяет путь к значку в объекте assets . Значок — это изображение, которое отображается в области визуализаций в Power BI. Он должен быть файлом формата PNG и 20 x 20 пикселей.

2. В проводнике Windows скопируйте файл icon.png, который вы хотите использовать, а затем вставьте его, чтобы заменить файл по умолчанию icon.png, расположенный в папке ресурсов.

3. В VS Code в области обозревателя разверните папку ресурсов и выберите файл icon.png .

4. Просмотрите значок.

   

Упаковка визуального элемента

1. В VS Code убедитесь, что все файлы сохранены.

2. В PowerShell введите следующую команду, чтобы создать PBIVIZ-файл :

   pbiviz package
   

   Эта команда создает pbiviz-файл в каталоге /dist/ визуального проекта и перезаписывает любой предыдущий pbiviz-файл , который может существовать.

   

Пакет выводится в папку /dist/ проекта. Пакет содержит все необходимые компоненты для импорта пользовательского визуального элемента в службу Power BI или отчет Power BI Desktop. Вы упаковали пользовательский визуальный элемент, и он готов к использованию.

Связанный контент

• Публикация визуальных элементов Power BI в Центре партнеров
• Импорт пользовательского визуального элемента