Сертификация пользовательских визуальных элементовCertified custom visuals

Были ли сведения на этой странице полезными?

Что такое сертифицированные пользовательские визуальные элементы?What are certified custom visuals?

Сертифицированными пользовательскими визуальными элементами называются визуальные элементы из магазина Marketplace, которые соответствуют определенным требованиям к коду и протестированы и одобрены командой Microsoft Power BI.Certified custom visuals are visuals in the Marketplace that meet certain specified code requirements that the Microsoft Power BI team has tested and approved. Сертифицированный пользовательский визуальный элемент обеспечивает дополнительные возможности.Once a custom visual is certified, it offers more features. Например, вы можете экспортировать его в PowerPoint и отображать в сообщениях электронной почты, получаемых при оформлении подписки на страницы отчета.Such as you can export to PowerPoint, and you can display the visual in emails received when a user subscribes to report pages.

Сертифицированные пользовательские визуальные элементы используются как стандартные пользовательские визуальные элементы.Certified custom visuals are used like standard custom visuals. Сертифицированные пользовательские визуальные элементы можно добавлять в службу Power BI, отчет Power BI Desktop и просматривать в Power BI Mobile и Power BI Embedded.Certified custom visuals can be added to the Power BI service, a Power BI Desktop report, and viewed with Power BI mobile and Power BI Embedded.

Выполняемые проверки гарантируют, что визуальный элемент не обращается к внешним службам и ресурсам.The tests performed are designed to check the visual does not access external services or resources. Корпорация Майкрософт не является автором сторонних пользовательских визуальных элементов, и мы рекомендуем клиентам обращаться к автору напрямую, чтобы проверить функциональные возможности такого визуального элемента.Microsoft is not the author of third-party custom visuals, and we advise customers to contact the author directly to verify the functionality of such visual.

Процесс сертификации — необязательный процесс, и разработчики самостоятельно решают, хотят ли они сертифицировать свои визуальные элементы.The certification process is an optional process, and it is up to the developers to decide if they want their visual in the marketplace to be certified.

Несертифицированные пользовательские визуальные элементы не обязательно являются небезопасными.Uncertified custom visuals do not necessarily mean unsafe visuals. Некоторые визуальные элементы не проходят сертификацию, так как не соответствуют одному или нескольким требованиям сертификации.Some visuals aren't certified because they don’t comply with one or more of the certification requirements. Например, визуальный элемент может подключаться к внешней службе, такой как визуальные элементы карты, или использовать коммерческие библиотеки.For example, connecting to an external service like map visuals, or visuals using commercial libraries.

Вы являетесь веб-разработчиком и заинтересованы в том, чтобы создавать собственные визуальные элементы и добавлять их в  Microsoft AppSource ?Are you a Web developer and interested in creating your own visualizations and adding them to Microsoft AppSource? Чтобы узнать, как это сделать, см. раздел  Разработка пользовательского визуального элемента Power BI .See Develop a Power BI custom visual to learn how.

Удаление сертифицированных пользовательских визуальных элементов Power BIRemoval of Power BI Certified custom visuals

Корпорация Майкрософт может удалять визуальные элементы из списка сертифицированных.Microsoft can remove a visual from the certified list at its discretion.

Получение сертификации для пользовательского визуального элементаGetting a custom visual certified

Требования к сертификацииCertification requirements

Для получения сертификации для пользовательского визуального элемента убедитесь, что он соответствует следующим требованиям.To get your custom visual certified, make sure your custom visual complies with the below:

  • Элемент утвержден Microsoft AppSource.Microsoft AppSource approved. Пользовательский визуальный элемент должен быть в нашем магазине.Your custom visual should be in our marketplace.

  • Пользовательский визуальный элемент создан с версиями API версии 2.5 или более поздней версии.Custom visual is written with versioned API v2.5 or higher.

  • Репозиторий кода — доступны для просмотра, команда Power BI (экземпляр, исходный код (JavaScript или TypeScript), в читаемом формате доступен для нас через GitHub).Code repository is available for review by Power BI team (for instance, source code (JavaScript or TypeScript) in human readable format is available to us, through GitHub).

    Примечание

    Предоставлять код для общего доступа в Github не нужно.You don’t have to publicly share your code in Github.

  • Требования к репозиторий кода:Code repository requirements:

    • Необходимо включить необходимый минимальный набор файлов:Must include the minimal required set of files:
      • .gitignore.gitignore
      • capabilities.jsoncapabilities.json
      • pbiviz.jsonpbiviz.json
      • package.jsonpackage.json
      • пакет lock.jsonpackage-lock.json
      • tsconfig.jsontsconfig.json
    • Не должна содержать папку node_modules (Добавьте файл .gitingore node_modules)Must not include node_modules folder (add node_modules to .gitingore file)
    • Установите npm команды не должен возвращать все ошибки.npm install command must not return any errors.
    • npm аудита команды не должен возвращать все предупреждения с высокой или средний уровень.npm audit command must not return any warnings with high or moderate level.
    • пакет pbiviz команды не должен возвращать все ошибки.pbiviz package command must not return any errors.
    • Необходимо включить TSlint от корпорации Майкрософт переопределенный без дополнительной настройки, и эта команда не должен возвращать все lint ошибки.Must include TSlint from Microsoft with no overridden configuration, and this command must not return any lint errors.
    • Скомпилированный пакет пользовательского визуального элемента должно соответствовать отправленного пакета (хэш md5 оба файла должны быть равны).The compiled package of the Custom Visual must match submitted package (md5 hash of both files should be equal).
  • Требования к исходной код:Source Code requirements:

    • Визуальный элемент должен поддерживать визуализации API событий.The visual must support Rendering Events API.
    • Убедитесь, что выполняется код не произвольных или динамическое (неверный: eval(), небезопасно использовать settimeout(), requestAnimationFrame(), setinterval (некоторые функции участия пользователя), работающей входные данные и данные пользователя).Ensure no arbitrary/dynamic code is run (bad: eval(), unsafe to use of settimeout(), requestAnimationFrame(), setinterval(some function with user input), running user input/data).
    • Убедитесь, безопасно обрабатывается DOM (неверный: innerHTML D3.html (< некоторых пользователей/входных данных >), используйте очистки для входных данных и данных пользователя перед его добавлением в модели DOM.Ensure DOM is manipulated safely (bad: innerHTML, D3.html(<some user/data input>), use sanitization for user input/data before adding it to the DOM.
    • Убедитесь, что нет ошибок и исключений javascript в консоли браузера для любых входных данных.Ensure there are no javascript errors/exceptions in the browser console for any input data. Пользователи могут использовать визуального с другим диапазоном непредвиденные данные, поэтому визуальный элемент не должен возвращать ошибку.Users might use your visual with a different range of unexpected data, so the visual must not fail. Можно использовать данный образец отчета как проверочный набор данных.You can use this sample report as a test dataset.
  • Если изменяются любые свойства в capabilities.json, убедитесь, что они не нарушают существующие пользовательские отчеты.If any properties in capabilities.json are changed, make sure that they do not break existing user's reports.

  • Убедитесь, что визуальный элемент соответствует визуальных элементов Power BI, касающиеся.Make sure the visual complies with the guidelines for Power BI visuals. Водяные знаки не разрешены.No watermarks are allowed.

  • Используются только открытые, доступные для просмотра компоненты OSS (общедоступные библиотеки JS или TypeScript;Uses only public reviewable OSS components (JS libraries or TypeScript that are public. исходный код доступен для просмотра и не содержит известных уязвимостей).The source code is available for reviewing and doesn't have known vulnerabilities). Мы не можем проверить пользовательский визуальный элемент, использующий коммерческие компоненты.We can't verify a custom visual using a commercial component.

  • Отсутствует доступ к внешним службам и ресурсам, в том числе запросы HTTP/S или WebSocket не выходят за пределы Power BI и не обращаются к службам.Does not access external services or resources, including but not limited to, no HTTP/S or WebSocket requests go out of Power BI to any services.

Совет

Мы рекомендуем использовать EsLint с набором правил безопасности по умолчанию для предварительной проверки кода перед отправкой.We recommend that you use EsLint with default security ruleset, to pre-validate your code before submission.

Порядок отправки пользовательских визуальных элементов для сертификацииProcess for submitting a custom visual for certification

Чтобы отправить пользовательский визуальный элемент для сертификации, сделайте следующее.To submit a custom visual for certification:

  1. Отправьте сообщение электронной почты в службу поддержки пользовательских визуальных элементов Power BI (pbicvsupport@microsoft.com).Send an email to Power BI Custom Visuals Support team (pbicvsupport@microsoft.com). В сообщение электронной почты включите следующие сведения.In the email, include the following information:

    • Заголовок: запрос сертификации визуального элементаTitle: Visual Certification Request
    • Ссылка на репозиторий GitHub, где размещается исходный код в читаемом форматеLink to GitHub repository where the human readable source code is hosted
    • Подтверждение соответствия требованиямAdhere to the requirements
    • Подтверждение прохождения проверки кодаPass the code review
  2. Рабочая группа по пользовательским визуальным элементам корпорации Майкрософт уведомит вас о получении сертификации для пользовательского визуального элемента и добавлении его в список сертифицированных визуальных элементов или об отклонении запроса сертификации с отчетом о проблемах, которые должны быть исправлены.The Microsoft Custom Visuals team notifies you when your custom visual is certified and added to the certified list, or is rejected with a report of the issues that need to be fixed. Разработчик несет ответственность за обеспечение открытого канала взаимодействия с корпорацией Майкрософт и за обновление визуальных элементов, включенных в список сертифицированных, если это необходимо.It is the developer’s responsibility to maintain an open line of communication with Microsoft and to update their certified visuals as needed.

Список пользовательских визуальных элементов, которые прошли сертификациюList of custom visuals that have been certified

Ссылка на AppSourceLink to AppSource Ссылка на видеоLink to video
3AG Systems — линейчатая диаграмма относительного расхождения3AG Systems - Bar Chart With Relative Variance
3AG Systems — гистограмма относительного расхождения3AG Systems - Column Chart With Relative Variance
Изображение расширенного кольцевого графикаAdvanced Donut Visual
Расширенная визуализация сетиAdvanced Network Visualization
Расширенная визуализация TimeSeriesAdvanced TimeSeries Visual
Изображение расширенной смешанной диаграммыAdvanced Combo Visual
Круговая диаграмма с индивидуальным радиусом срезовAster Plot
Календарь BeyondsoftBeyondsoft Calendar
Петлеобразная диаграмма от MAQ SoftwareBowtie Chart by MAQ Software ВидеоVideo
Диаграмма "Ящик с усами"Box and Whisker chart
Диаграмма "ящик с усами" от MAQ SoftwareBox and Whisker chart by MAQ Software ВидеоVideo
Клетчатая диаграмма от MAQ SoftwareBrick Chart by MAQ Software ВидеоVideo
Пузырьковая диаграмма от AkvelonBubble Chart by Akvelon
Диаграмма с маркерамиBullet Chart ВидеоVideo
Диаграмма с маркерами от OKVizBullet Chart by OKViz ВидеоVideo
Календарь от TallanCalendar by Tallan
Диаграмма "японские свечи" от OKVizCandlestick by OKViz ВидеоVideo
Карточки с состояниями от OKVizCard with States by OKViz
Срез ChicletChiclet Slicer
Хордовая диаграммаChord ВидеоVideo
Круговой датчик от MAQ SoftwareCircular Gauge by MAQ Software ВидеоVideo
Таблица кластеровCluster Map
Цилиндрический датчик от MAQ SoftwareCylindrical Gauge by MAQ Software ВидеоVideo
Датчик с циферблатомDial Gauge
Точечная диаграммаDot Plot
Точечная диаграмма от OKVizDot Plot by OKViz ВидеоVideo
Детализированная картограммаDrilldown Cartogram
Детализированная фоновая картограммаDrilldown Choropleth
Детализированная гистограммаDrill-down column chart ВидеоVideo
Детализированная гистограмма временных данныхDrill-down column chart for time based data ВидеоVideo
Детализированная кольцевая диаграммаDrill-down donut chart ВидеоVideo
Dual KPIDual KPI
Динамическая подсказка от MAQ SoftwareDynamic Tooltip by MAQ Software ВидеоVideo
Расширенная точечная диаграммаEnhanced Scatter ВидеоVideo
Enlighten AquariumEnlighten Aquarium
Enlighten SlicerEnlighten Slicer
Enlighten Stack ShuffleEnlighten Stack Shuffle
Вафельная диаграмма EnlightenEnlighten Waffle Chart
Filter by List от DevscopeFilter by List by Devscope ВидеоVideo
График с направленной силойForce-Directed Graph ВидеоVideo
Воронка с источником от MAQ SoftwareFunnel with Source by MAQ Software ВидеоVideo
Диаграмма ГантаGantt ВидеоVideo
Ганта диаграмма от MAQ SoftwareGantt Chart by MAQ Software ВидеоVideo
Гистограммы "Земной шар"Globe Data Bars
Сетка от MAQ SoftwareGrid by MAQ Software ВидеоVideo
Иерархическая диаграмма от AkvelonHierarchy Chart by Akvelon ВидеоVideo
ГистограммаHistogram Chart
Гистограмма с точками от MAQ SoftwareHistogram with points by MAQ Software ВидеоVideo
Горизонтальная воронка от MAQ SoftwareHorizontal Funnel by MAQ Software ВидеоVideo
Изображение от CloudScopeImage by CloudScope
Сетка изображенияImage Grid
Конструктор инфографикиInfographic Designer
Диаграмма с ключевыми показателями эффективности от AkvelonKPI Chart by Akvelon
Столбец КПЭ от MAQ SoftwareKPI Column by MAQ Software ВидеоVideo
Сетка ключевых показателей эффективности от MAQ SoftwareKPI Grid by MAQ Software ВидеоVideo
Индикатор ключевого показателя эффективностиKPI Indicator
Область КПЭ от MAQ SoftwareKPI Ticker by MAQ Software ВидеоVideo
Линейный датчик от MAQ SoftwareLinear Gauge by MAQ Software ВидеоVideo
Линейно-точечная диаграммаLineDot Chart
Диаграмма MekkoMekko Chart ВидеоVideo
Несколько КПЭMulti KPI
Обзор от CloudScopeOverview by CloudScope
Ось воспроизведения (динамический срез)Play Axis (Dynamic Slicer)
Ключевой показатель эффективности производительностиPower KPI ВидеоVideo
Матрица КПЭ производительностиPower KPI Matrix ВидеоVideo
Диаграмма "Пульс"Pulse Chart ВидеоVideo
Диаграмма с квадрантами от MAQ SoftwareQuadrant Chart by MAQ Software ВидеоVideo
Лепестковая диаграммаRadar Chart
Кольцевая диаграмма от MAQ SoftwareRing Chart by MAQ Software ВидеоVideo
Поворотная диаграмма от MAQ SoftwareRotating Chart by MAQ Software ВидеоVideo
Диаграмма SankeySankey Chart ВидеоVideo
Точечная диаграмма от AkvelonScatter Chart by Akvelon
Полоса прокруткиScroller
Смарт-фильтр от OKVizSmart Filter by OKViz ВидеоVideo
Спарклайн от OKVizSparkline by OKViz ВидеоVideo
График потокаStream Graph
Диаграмма "Солнечные лучи"Sunburst
Synoptic Panel от OKVizSynoptic Panel by OKViz
Диаграмма "Тепловая карта"Table Heatmap
ТахометрTachometer ВидеоVideo
Фильтрация текстаText Filter
Текстовая оболочка от MAQ SoftwareText Wrapper by MAQ Software
Thermometer от MAQ SoftwareThermometer by MAQ Software ВидеоVideo
Срез Time BrushTime Brush Slicer
Срез временной шкалыTimeline Slicer ВидеоVideo
Временная шкала от CloudScopeTimeline by CloudScope ВидеоVideo
Диаграмма-торнадоTornado chart ВидеоVideo
Диаграмма продаж от MAQ SoftwareTrading Chart by MAQ Software ВидеоVideo
Диаграмма отклонений UltimateUltimate Variance ВидеоVideo
Каскадная диаграмма UltimateUltimate Waterfall ВидеоVideo
Список пользователей от CloudScopeUser List by CloudScope
Вафельная диаграммаWaffle Chart ВидеоVideo
Облако WordWord Cloud ВидеоVideo

ВОПРОСЫ И ОТВЕТЫFAQ

Дополнительные сведения о визуальных элементах см. в разделе Часто задаваемые вопросы о сертифицированных визуальных элементах.For more information about visuals, see Frequently asked questions about certified visuals.

Дальнейшие действияNext steps

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