Поделиться через

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

  • Статья

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

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

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

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

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

    Screenshot of VS Code, which shows the display name value is set to Circle Card.

    Отображаемое имя визуального элемента отображается в области визуализаций 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-файл , который может существовать.

    Screenshot of Windows Explorer, which shows the folder hierarchy of the Power BI visual project. The dist folder is highlighted.

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

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