Публикация настраиваемых визуальных элементов в AppSourcePublish custom visuals to AppSource

Узнайте, как опубликовать настраиваемые визуальные элементы в AppSource, чтобы они стали доступными для других пользователей.Learn how you can publish your custom visual to AppSource for others to discover and use. Officeoffice

Создав настраиваемый визуальный элемент, опубликуйте его в AppSource, чтобы он стал доступным для других пользователей.Once you have created your custom visual, you may want to publish it AppSource for others to discover and use. Перед публикацией необходимо выполнить некоторые подготовительные действия.There is some preperation that needs to be done before you can do that. Дополнительные сведения о том, как создать пользовательские визуализации, см. в статье Создание пользовательского визуального элемента с помощью средств разработчика.For more information on how to create a custom visual, see Use developer tools to create custom visuals.

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

Подготовка к отправке пользовательской визуализацииPreparing to submit your custom visual

Написав код, протестировав и упаковав пользовательскую визуализацию в файл PBIVIZ, вам необходимо подготовить к отправке следующие элементы:One you're done coding and testing your custom visual and have packaged it into a pbiviz file, you should also have the following ready for your submission.

ЭлементItem ТребуетсяRequired ОписаниеDescription
Пакет PBIVIZ со всеми необходимыми метаданнымиPbiviz package contains all the required metadata ДаYes Имя визуализацииVisual name
Отображаемое имяDisplay name
GUIDGUID
ВерсияVersion
ОписаниеDescription
Имя и электронная почта автораAuthor name and email
Пример отчета в файле PBIXSample .pbix report file ДаYes Чтобы правильно продемонстрировать свою визуализацию, помогите пользователям ознакомиться с ней.To showcase your visual, you should help users to get acquainted with the visual. Акцентируйте внимание на полезных для пользователей возможностях, приведите примеры использования, расскажите и возможностях форматирования и т. д. Кроме того, в конце можно добавить страницу с подсказками: некоторые советы и приемы, чего следует избегать и пр.You should emphasize on the value the visual brings to the user and give examples of usage, formatting options, etc. You can also add a "hints" page at the end with some tips and tricks, things to avoid and the like.
ЗначокIcon ДаYes Добавьте логотип пользовательской визуализации. Он будет отображаться в онлайн-магазине.You should include the custom visual logo that will appear in the store front. Допустимые форматы: PNG, JPG, JPEG или GIF.The format can be .png, .jpg, .jpeg or .gif. Изображение должно быть ровно 300 пикселей в ширину и 300 пикселей в высоту.It must be exactly 300px (width) x 300px (height). Размер файла не должен превышать 512 КБ.It can be no larger than 512kb for the file size.
Снимки экранаScreenshots ДаYes Необходимо предоставить хотя бы один снимок экрана.You must provide at least one screenshot. Допустимые форматы: PNG, JPG, JPEG или GIF.The format can be .png, .jpg, .jpeg or .gif. Изображение должно быть ровно 1366 пикселей в ширину и 768 пикселей в высоту.It must be exactly 1366px (width) x 768px (height). Размер файла не должен превышать 1024 КБ.It can be no larger than 1024kb for the file size. Для большей эффективности добавьте текстовые выноски, в которых сформулируйте преимущества основных функций, показанных на каждом снимке экрана.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
Ссылка на страницу поддержкиSupport download link ДаYes Укажите URL-адрес страницы, на которой пользователи визуализации смогут получить поддержку.Provide the URL to support customers who have issues with your visual. URL-адрес должен начинаться с https:// или http://.The format of your URL should include https:// or http://.
Ссылка на заявление о конфиденциальностиPrivacy document link ДаYes Укажите ссылку на заявление о конфиденциальности для пользователей визуализации.Provide a link to the privacy policy for customers who use your visual. Ссылка должна начинаться с https:// или http://.The format of your link should include https:// or http://.
Лицензионное соглашениеEnd user license agreement (EULA) ДаYes Необходимо отправить файл лицензионного соглашения.You must upload a EULA file. Можно использовать собственное лицензионное соглашение или стандартное лицензионное соглашение для пользовательских визуализаций Power BI в Магазине Office.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Чтобы использовать стандартное лицензионное соглашение, в диалоговом окне отправки файла лицензионного соглашения на панели мониторинга продавца вставьте следующий URL-адрес: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.
Ссылка на видеоVideo link НетNo Чтобы повысить интерес пользователей к визуализации, рекомендуем указать ссылку на видео о вашем продукте.To increase the interest of users for your custom visual, it is advised to provide a link to a video about your visual. URL-адрес должен начинаться с https:// или http://.The format of your URL should include https:// or http://.
Репозиторий GitHubGitHub repository НетNo Рекомендуем указать действительную общедоступную ссылку на репозиторий GitHub, где хранится исходный код вашей визуализации и пример данных. Это позволит другим разработчикам отправлять вам отзывы и предложения по улучшению кода.It is preferred to have a valid and public link to a GitHub repository with sources of your visual and sample data in it to allow other developers to provide feedback and propose improvements to your code.

Отправка в Power BISubmitting to Power BI

В первую очередь вам нужно связаться по электронной почте с командой Power BI, которая занимается приемом пользовательских визуализаций.Submission starts with sending an email to the Power BI custom visuals submission team. Заявку можно отправить по адресу pbivizsubmit@microsoft.com.You can email pbivizsubmit@microsoft.com.

Вложите в сообщение PBIVIZ-файл и образец отчета в формате PBIX.Attach the .pbiviz file and the sample report .pbix file in your email. В ответ команда Power BI предоставит вам инструкции и XML-файл с пакетом приложения.The Power BI team will reply back with instructions and a app package XML file to upload. Этот XML-файл требуется для отправки визуального элемента через Центр разработчика Office.This XML app package is required in order to submit your visual through the Office developer center.

Примечание

После того как визуальный элемент пройдет процедуру утверждения в магазине, все его последующие обновления будут появляться в рабочей среде через две недели. Это сделано для того, чтобы повысить качество распространяемых материалов и проверить их на совместимость с существующими отчетами.To improve quality and assure that existing reports are not breaking, updates to existing visuals will take an additional two weeks to reach production environment after approval in the store.

Отправка в AppSourceSubmitting to AppSource

Получив XML-файл с пакетом приложения от команды Power BI, перейдите в центр для разработчиков, чтобы отправить визуальный элемент в AppSource.Once you get the app package XML from the Power BI team, navigate to the developer center to submit your visual to AppSource.

Примечание

Для входа в Центр разработчика Office требуется действительная учетная запись разработчика Office.You must have a valid Office developer account to log in to the Office developer center. Учетная запись разработчика Office должна быть учетной записью Майкрософт (Live ID, например, hotmail.com или outlook.com).An Office developer account must be a Microsoft Account (Live ID, e.g. hotmail.com or outlook.com).

Важно!

Прежде чем отправить визуальный элемент в AppSource, файлы PBIVIZ и PBIX необходимо отправить по электронной почте команде Power BI.You must send an email with the .pbiviz file and the .pbix file to the Power BI team before submitting to AppSource. Таким образом, команда Power BI передаст эти файлы на общедоступный сервер общих ресурсов.This allows the Power BI team to upload the files to the public share server. Другого способа передать эти файлы в магазин нет.Otherwise, the store will not be able to retrieve the files. Эти файлы нужно отправлять команде каждый раз, когда вы публикуете новый визуальный элемент, а также обновляете существующий или исправляете отклоненный визуальный элемент.You must send the files with each new visual submission, update to existing visual, and fixes to rejected submissions.

Процесс отправки визуализацииProcess to submit visual

Чтобы отправить визуализацию, выполните приведенные ниже действия.Follow the below steps to complete the submission.

  1. Выберите Добавить новое приложение.Select Add a new app.

  2. Последовательно щелкните Настраиваемый визуальный элемент Power BI и Далее.Select Power BI custom visual and then Next.
  3. Под надписью Пакет приложения щелкните + и в диалоговом окне открытия файла выберите XML-файл с пакетом приложения, полученный от команды Power BI.Select the + under App package and select the app package XML file that you received from the Power BI team from the open file dialog.

  4. Должно появиться подтверждение, что вы используете правильный пакет приложения Power BI.You should receive an approval that this is a valid Power BI app package.

  5. Укажите необходимую информацию в разделе Общие сведения.Fill out the General info details.

    • Submission title (Название отправки). Имя, которое будет использоваться в центре разработчика.Submission title: How your submission will be named in the developer center
    • Версия. Номер версии автоматически подставляется из файла с пакетом приложения.Version: Your version number is auto-populated from your add-in app package.
    • Дата выпуска (UTC). Выберите дату добавления приложения в магазин.Release Date (UTC): Select a date for your app to release to the store. Если указать дату в будущем, приложение будет недоступно в магазине до наступления указанной даты.If a future date is chosen, your app will not be available in the store until that date is reached.
    • Категория. В качестве первой категории автоматически будет указано "Визуализация данных и бизнес-аналитика".Category: The first category will be auto populated as "Data Visualization + BI". Так обозначаются все пользовательские визуализации Power BI. Чтобы пользователи могли быстрее находить вашу визуализацию, можно указать две дополнительные категории.That's how all Power BI custom visuals will be tagged.You may provide up to 2 additional categories, for help users easily search for your visual
    • Примечания по тестированию (необязательно). Поле, в котором можно указать специальные инструкции для тест-инженеров Майкрософт.Testing notes: optional, if you'd like to provide some instructions for the testers at Microsoft
    • Мое приложение вызывает, поддерживает, содержит или использует криптографию или шифрование. Не устанавливайте этот флажок.My app calls, supports, contains, or uses cryptography or encryption: leave unchecked
    • Включить эту надстройку в каталог надстроек Office для iPad. Не устанавливайте этот флажок.Make this add-in available in the Office add-in catalog on iPad: leave unchecked
  6. Под надписью Логотип приложения нажмите кнопку +, чтобы отправить логотип вашей визуализации.Upload your visual's logo by selecting the + under App logo. В диалоговом окне открытия файла выберите файл значка.Then select the icon file in the open file dialog. Файл должен быть в формате PNG, JPG, JPEG или GIF.The file must be .png, .jpg, .jpeg or .gif. Изображение должно быть ровно 300 пикселей в ширину и 300 пикселей в высоту, а размер файла не должен превышать 512 КБ.It must be exactly 300px (width) x 300px (height) and no larger than 512kb in size.

  7. Укажите необходимую информацию в разделе Документы по поддержке:Fill out the Support documents details.

    • ссылку на справочные материалы;Support document link
    • ссылку на заявление о конфиденциальности;Privacy document link
    • ссылку на видео;Video link
    • лицензионное соглашение:End User License Agreement (EULA)

      Необходимо отправить файл лицензионного соглашения.You must upload a EULA file. Можно использовать собственное лицензионное соглашение или стандартное лицензионное соглашение для пользовательских визуализаций Power BI в Магазине Office.This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. Чтобы использовать стандартное лицензионное соглашение, в диалоговом окне отправки файла лицензионного соглашения на панели мониторинга продавца вставьте следующий URL-адрес: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.To use the default EULA, paste the following URL in the seller dashboard's "End User License Agreement" file upload dialog: https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdf.

  8. Нажмите кнопку Далее, чтобы перейти на страницу Сведения.Select Next to proceed to the Details page.
  9. Щелкните Язык и выберите в списке нужный язык.Select Language and pick a language from the list.

  10. Заполните поля в разделе "Описание".Fill out the "Description" details.

    • Имя приложения (для этого языка). Введите название приложения, которое должно отображаться в онлайн-магазине.App name (for this language): Enter the title of your app as it should appear in the storefront.
    • Краткое описание. Введите краткое описание своего приложения (до 100 символов), которое должно отображаться в онлайн-магазине.Short description: Enter the short description of your app, up to 100 characters, as it should appear in the storefront. Это описание будет отображаться на страницах верхнего уровня вместе с логотипом.This description will show up in the top level pages along with the logo. Можно использовать описание из пакета PBIVIZ.You can use the description from the pbiviz package.
    • Подробное описание. Укажите более подробное описание приложения, которое пользователи будут видеть на странице сведений о приложении.Long description: Provide a more detailed description of your app that customers will see on your app details page. Если вы хотите, чтобы сообщество улучшило ваш визуальный элемент, сделав его код открытым, оставьте здесь ссылку на общедоступный репозиторий, например GitHub.If you'd like to let the community improve your visual by making it open source, provide the link to the public repository, such as GitHub, here.
  11. Отправьте хотя бы один снимок экрана.Upload at least one screenshot. Допустимые форматы: PNG, JPG, JPEG или GIF.The format can be .png, .jpg, .jpeg or .gif. Изображение должно быть ровно 1366 пикселей в ширину и 768 пикселей в высоту.It must be exactly 1366px (width) x 768px (height). Размер файла не должен превышать 1024 КБ.It can be no larger than 1024kb for the file size. Для большей эффективности добавьте текстовые выноски, в которых сформулируйте преимущества основных функций, показанных на каждом снимке экрана.For greater usage, add text bubbles to articulate the value proposition of key features shown in each screenshot.
  12. Чтобы добавить дополнительные языки, щелкните Добавить язык и повторите шаги 10 и 11.If you'd like to add more languages, select Add a language and repeat steps 10 and 11. Дополнительные языки позволят пользователям просматривать сведения о визуализации на их родном языке.Adding more languages will help your users view the custom visual details in their own language. Если какой-то язык не указан, вместо него используется первый выбранный язык.Languages that will not be listed will default to the first language selected.
  13. Добавив языки, щелкните Далее, чтобы перейти на страницу Блокировка доступа.When you are done adding languages, select Next to proceed to the Block access page.
  14. Если вы не хотите, чтобы пользователи из определенных стран или регионов могли покупать или использовать ваше приложение, установите соответствующий флажок и выберите в списке нужные элементы.If you want to prevent customers in specific countries or regions from using or purchasing your app, check the box and select from the list.
  15. Нажмите кнопку Далее, чтобы перейти на страницу Цены.Select Next to proceed to the Pricing page.
  16. Сейчас поддерживаются только бесплатные визуальные элементы, и возможность покупки в приложении (в визуальном элементе) отключена.Currently, only free visuals are supported and additional purchases inside the visual (In-App purchase) are not allowed. Установите флажок Это приложение бесплатно.Select This app is free.

    Примечание

    Если вы укажете, что приложение не бесплатное или включите в него платное содержимое, отправляемый визуальный элемент будет отклонен.If you select any other option other than free, or have an In-App purchase content in the submitted visual, the submission will be rejected.

  17. Теперь можно щелкнуть "Сохранить как черновик", чтобы отправить пользовательский визуальный элемент позже, или **Отправить на утверждение, чтобы отправить его в Магазин Office.You can now select Save as draft" and submit later, or select **Submit for approval to submit the custom visual to the Office store.

Отслеживание состояния отправки и использованияTracking submission status and usage

Просмотрите политики проверки.You can review the validation policies.

После отправки состояние отправленного приложения можно будет просматривать на панели мониторинга приложения.After submission, you will be able to view the submission status in the app dashboard.

Сертификация визуального элементаCertify your visual

После создания визуального элемента при необходимости можно выполнить его сертификацию.Once your visual is created, you can optionally get your visual certified. Это означает, что его можно запустить в службе Power BI и использовать с другими компонентами службы, например экспортировать в PowerPoint.This means it can run within the Power BI service and be used with other features of the service such as exporting to PowerPoint. Дополнительные сведения см. в статье Получение сертификации для пользовательского визуального элемента.For more information, see Getting a custom visual certified.

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

Создание пользовательского визуального элемента с помощью средств разработчикаUse developer tools to create custom visuals
Визуализации в Power BIVisualizations in Power BI
Пользовательские визуализации в Power BICustom Visualizations in Power BI
Получение сертификации для пользовательского визуального элементаGetting a custom visual certified

Появились дополнительные вопросы?More questions? Попробуйте задать вопрос в сообществе Power BI.Try asking the Power BI Community