Пользовательские визуальные элементы в Power BICustom visuals in Power BI

При создании или редактировании отчета Power BI доступно множество различных визуальных элементов.When creating or editing a Power BI report, there are many different types of visuals available for you to use. Эти визуальные элементы отображаются в области Визуализации.These visuals display in the Visualizations pane. Когда вы скачиваете Power BI Desktop или открываете службу Power BI (app.powerbi.com), этот предварительно упакованный набор визуальных элементов поставляется в комплекте.When you download Power BI Desktop or open Power BI service (app.powerbi.com), this set of visuals comes "pre-packaged."

Но вам не обязательно использовать именно этот набор. Нажав кнопку с многоточием, можно открыть другой источник визуальных элементов для отчета: настраиваемые визуальные элементы.But you are not limited to this set of visuals, selecting the ellipses opens up another source of report visuals: custom visuals.

Разработчики создают пользовательские визуальные элементы с помощью пакета SDK для этих элементов, чтобы бизнес-пользователи могли просматривать свои данные в формате, который больше всего подходит для организации.Custom visuals are created by developers, using the custom visuals SDK, to enable business users to see their data in a way that fits the business best. В дальнейшем авторы отчетов смогут импортировать файлы пользовательских визуальных элементов в свои отчеты и использовать эти визуальные элементы как любые другие в Power BI.Report authors can then import the custom visuals files into their reports and use them as any other Power BI visuals. Пользовательские визуальные элементы в Power BI являются объектами высшего класса. Их можно фильтровать, выделять, изменять, совместно использовать и т. д.Custom visuals are 1st class citizens in Power BI and can be filtered, highlighted, edited, shared, etc.

Для пользовательских визуальных элементов используется один из трех форматов каналов развертывания:Custom visuals can be in the form of 3 deployment channels:

  • файлы пользовательских визуальных элементов;Custom visual files
  • визуальные элементы организации;Organization visuals
  • визуальные элементы из Marketplace.Marketplace visuals

Файлы пользовательских визуальных элементовCustom visual files

Пользовательские визуальные элементы представляют собой пакеты с кодом для отображения данных, предназначенных для этих элементов.Custom visuals are packages that include code for rendering the data that is served to them. Любой пользователь может создать пользовательский визуальный элемент и упаковать его в один PBIVIZ-файл, который можно импортировать в отчет Power BI.Anyone can create a custom visual and package it as a single .pbiviz file, that can be imported into a Power BI report.

Предупреждение

Пользовательский визуальный элемент может содержать код, угрожающий безопасности или конфиденциальности. Перед импортом в отчет убедитесь в надежности автора и источника пользовательского визуального элемента.A custom visual could contain code with security or privacy risks; Make sure you trust the author and the source of the custom visual before importing it to your report.

визуальные элементы организации;Organization visuals

Администраторы Power BI могут развернуть пользовательские визуальные элементы в своей организации, чтобы авторы отчетов могли легко найти и работать с ними, если администратор утвердил их для использования в организации.Power BI admins can deploy custom visuals into their organization, so that report authors can easily discover and use the custom visuals that the admin has approved to use inside of the organization. Таким образом, администратор может выбирать, какие пользовательские визуальные элементы будут развернуты в организации. Кроме того, упрощено управление (например, обновление версии, включение и отключение) этими элементами.This gives the admin the control to choose specific custom visuals to deploy in the organization, as well as an easy way to manage (i.e. update version, disable/enable) those visuals. Авторам отчетов предоставляется простой способ поиска уникальных для организации визуальных элементов и полная поддержка в их обновлении.For the report author, it is an easy way to discover visuals that are unique to the organization, as well as a seamless support for updating those visuals.

Дополнительные сведения о пользовательских визуальных элементах организации см. в этой статье.To get more information about organization custom visuals please read more about organizational visuals.

Визуальные элементы из MarketplaceMarketplace visuals

Члены сообщества и специалисты Майкрософт создали свои пользовательские визуальные элементы и опубликовали их в магазине AppSource, чтобы каждый мог работать с ними.Members of the community, as well as Microsoft, have contributed their custom visuals to the benefit of the public and published them to AppSource marketplace. Эти визуальные элементы можно загрузить и добавлять в отчеты Power BI.These visuals can be downloaded and added to Power BI reports. Все эти пользовательские визуальные элементы протестированы на предмет функциональности и качества и утверждены корпорацией Майкрософт.All of these custom visuals have been tested and approved by Microsoft for functionality and quality.

Что такое AppSource?What is AppSource? Говоря простым языком, это место, где можно найти приложения, надстройки и расширения для программного обеспечения корпорации Майкрософт.Simply put, it is the place to find apps, add-ins, and extensions for your Microsoft software. AppSource позволяет миллионам пользователей таких продуктов, как Office 365, Azure, Dynamics 365, Cortana и Power BI, находить решения, с помощью которых можно выполнять работу более эффективно, продуманно или элегантно.AppSource connects millions of users of products like Office 365, Azure, Dynamics 365, Cortana, and Power BI to solutions that help them get work done more efficiently, more insightfully, or more beautifully than before.

Сертифицированные визуальные элементыCertified visuals

Сертифицированные визуальные элементы Power BI — это визуальные элементы из Marketplace, которые прошли дополнительную тщательную проверку качества. Все они поддерживаются в дополнительных сценариях, таких как подписка по электронной почте и экспорт в PowerPoint.Power BI certified visuals are marketplace visuals that have passed additional rigorous testing for quality, and are supported in additional scenarios, such as email subscriptions, and export to PowerPoint. Просмотреть список сертифицированных пользовательских визуальных элементов или отправить свои визуальные элементы можно здесь.To see the list of certified custom visuals or to submit your own, see Certified custom visuals.

Вы являетесь веб-разработчиком и заинтересованы в том, чтобы создавать собственные визуальные элементы и добавлять их в AppSource?Are you a Web developer and interested in creating your own visualizations and adding them to AppSource? См. статью о начале работы с использованием средств для разработчиков и узнайте, как публиковать настраиваемые визуальные элементы в AppSource.See Get started with Developer Tools and learn how to publish custom visuals to AppSource.

Импорт пользовательских визуальных элементов из файлаImport a custom visuals from a file

  1. В нижней части панели "Визуализации" нажмите кнопку с многоточием.Select the ellipses from the bottom of the Visualizations pane.

  2. В раскрывающемся списке выберите Импортировать из файла.From the dropdown, select Import from file.

  3. В меню "Открыть файл" выберите PBIVIZ-файл для импорта и нажмите кнопку "Открыть".From the Open file menu, select the .pbiviz file that you want to import and then select Open. В нижнюю часть области "Визуализации" добавляется значок настраиваемого визуального элемента, а это значит, что теперь он доступен для использования в отчете.The icon for the custom visual is added to the bottom of your Visualizations pane and is now available for use in your report.

Импорт визуальных элементов организацииImport organization visuals

  1. В нижней части панели "Визуализации" нажмите кнопку с многоточием.Select the ellipses from the bottom of the Visualizations pane.

  2. В раскрывающемся списке выберите "Импорт из магазина".From the dropdown, select Import from marketplace.

  3. Выберите MY ORGANIZATION (Моя организация) в верхней части меню вкладки.Select MY ORGANIZATION from the top tab menu.

  4. Прокрутите список и найдите визуальный элемент для импорта.Scroll through the list to find the visual to import.

  5. Импортируйте настраиваемый визуальный элемент, выбрав Добавить.Import the custom visual by selecting Add. В нижнюю часть области "Визуализации" добавляется значок настраиваемого визуального элемента, а это значит, что теперь он доступен для использования в отчете.The icon for the custom visual is added to the bottom of your Visualizations pane and is now available for use in your report.

Скачать или импортировать настраиваемые визуальные элементы из Microsoft AppSourceDownload or import custom visuals from Microsoft AppSource

Вы можете скачать и импортировать настраиваемые визуальные элементы двумя способами: из Power BI и с веб-сайта AppSource.You have two options for downloading and importing custom visuals; from within Power BI and from the AppSource website.

Импорт настраиваемых визуальных элементов из Power BIImport custom visuals from within Power BI

  1. В нижней части панели "Визуализации" нажмите кнопку с многоточием.Select the ellipses from the bottom of the Visualizations pane.

  2. В раскрывающемся списке выберите Импорт из магазина.From the dropdown, select Import from marketplace.

  3. Прокрутите список и найдите визуальный элемент для импорта.Scroll through the list to find the visual to import.

  4. Чтобы получить дополнительные сведения об одном из визуальных элементов, выделите и выберите его.To learn more about one of the visuals, highlight and select it.

  5. На странице сведений могут быть представлены снимки экрана, видео, подробное описание и многое другое.On the detail page you can view screenshots, videos, detailed description and more.

  6. Прокрутите вниз, чтобы просмотреть обзоры.Scroll to the bottom to see reviews.

  7. Импортируйте пользовательский визуальный элемент, нажав "Добавить".Import the custom visual by selecting Add. В нижнюю часть области "Визуализации" добавляется значок настраиваемого визуального элемента, а это значит, что теперь он доступен для использования в отчете.The icon for the custom visual is added to the bottom of your Visualizations pane and is now available for use in your report.

Скачивание и импорт настраиваемых визуальных элементов из Microsoft AppSourceDownload and import custom visuals from Microsoft AppSource

  1. Войдите в Microsoft AppSource и выберите вкладку Приложения.Start at Microsoft AppSource and select the tab for Apps.

  2. Откроется страница с результатами для приложений, где можно просмотреть основные приложения в каждой категории, включая приложения Power BI.This takes you to the Apps results page where you can view top apps in each category, including Power BI Apps. Но мы ищем настраиваемые визуальные элементы, так что давайте конкретизируем результаты, выбрав Power BI visuals (Визуальные элементы Power BI) в списке на панели навигации слева.But we're looking for custom visuals, so let's narrow down the results by selecting Power BI visuals from the left navigation list.

  3. В AppSource отобразится плитка для каждого настраиваемого визуального элемента.AppSource displays a tile for each custom visual. Каждая плитка содержит моментальный снимок настраиваемого визуального элемента, краткое описание и ссылку для скачивания.Each tile has a snapshot of the custom visual and gives a brief description and a download link. Выберите плитку, чтобы получить дополнительные сведения.To see more details, select the tile.

  4. На странице сведений могут быть представлены снимки экрана, видео, подробное описание и многое другое.On the detail page you can view screenshots, videos, detailed description and more. Чтобы скачать настраиваемый визуальный элемент, выберите Get it now (Получить) и примите условия использования.Dowload the custom visual by selecting Get it now and then agreeing to the Terms of use.

  5. Перейдите по этой ссылке для скачивания настраиваемого визуального элемента.Select the link to download the custom visual.

    На странице для скачивания также приведены инструкции по импорту настраиваемого визуального элемента в приложение Power BI Desktop и службу Power BI.The download page also include instructions on how to import the custom visual into Power BI Desktop and Power BI service.

    Вы также можете скачать пример отчета, в котором используется этот пользовательский визуальный элемент и демонстрируются его возможности.You can also download a sample report that includes the custom visual and showcases its capabilities.

  6. Сохраните PBIVIZ-файл и откройте Power BI.Save the .pbiviz file and then open Power BI.

  7. Импортируйте PBIVIZ-файл в отчет. (См. раздел Импорт пользовательских визуальных элементов из файла выше.)Import the .pbiviz file into your report (See Import a custom visual from a file section above)

Рекомендации и устранение неполадокConsiderations and troubleshooting

  • При импорте пользовательский визуальный элемент добавляется в определенный отчет.A custom visual is added to a specific report when imported. Если вы хотите использовать этот визуальный элемент в другом отчете, необходимо также импортировать его в этот отчет.If you'd like to use the visual in another report, you need to import it into that report as well. При сохранении отчета с пользовательским визуальным элементом с помощью параметра Сохранить как вместе с новым отчетом сохраняется копия пользовательского визуального элемента.When a report with a custom visual is saved using the Save As option, a copy of the custom visual is saved with the new report.

  • Если область Визуализации не отображается, значит, вы не изменили разрешения для отчета.If you don't see a Visualizations pane, that means you do not have edit permissions for the report. Чтобы добавить настраиваемые визуальные элементы в отчеты, необходимо обладать правами на внесение изменений. Вы не можете добавлять их в отчеты, к которым предоставлен общий доступ.You can only add custom visuals to reports you can edit, not to reports that have been shared with you.

Появились дополнительные вопросы?More questions? Ответы на них см. в сообществе Power BI.Try the Power BI Community