将自定义视觉对象发布到 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? 简而言之,可以在其中查找 Microsoft 产品和服务的 SaaS 应用与加载项。Simply put, it is the place to find SaaS apps and add-ins for your Microsoft products and service. AppSource 为 Office 365、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
示例 .pbix 报表文件Sample .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 像素(宽度)x 300 像素(高度)。It must be exactly 300px (width) x 300px (height). 文件大小不得超过 512 KB。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 像素(宽度)x 768 像素(高度)。It must be exactly 1366px (width) x 768px (height). 文件大小不能超过 1024 KB。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://.
最终用户许可协议 (EULA)End user license agreement (EULA) Yes 必须上载 EULA 文件。You must upload a EULA file. 这可以是你自己的 EULA,也可以使用 Office 应用商店中适用于 Power BI 自定义视觉对象的默认 EULA。This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. 若要使用默认 EULA,请将以下 URL 粘贴到卖家仪表板的“最终用户许可协议”文件上载对话框中:https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdfTo 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://.
GitHub 存储库GitHub 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

从 Power BI 团队获得应用包 XML 后,请转到开发人员中心,将视觉对象提交到 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 开发人员帐户必须是 Microsoft 帐户(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. 选择“应用包”下的 +,然后在打开文件对话框中选择从 Power BI 团队获得的应用包 XML 文件。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: 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.
    • 类别: 第一个类别将自动填充为“数据可视化效果 + BI”。Category: The first category will be auto populated as "Data Visualization + BI". 这就是标记所有 Power BI 自定义视觉对象的方法。可以最多提供 2 个其他类别,以帮助用户轻松地搜索你的视觉对象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
    • 测试说明: 可选,如果你想要为 Microsoft 测试人员提供一些说明,则可以填写此项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
    • 在 iPad 的 Office 外接程序目录中提供此外接程序: 保持未选中状态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 像素(宽度)x 300 像素(高度),且大小不得超过 512 KB。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
    • 最终用户许可协议 (EULA)End User License Agreement (EULA)

      必须上载 EULA 文件。You must upload a EULA file. 这可以是你自己的 EULA,也可以使用 Office 应用商店中适用于 Power BI 自定义视觉对象的默认 EULA。This can be either your own EULA or use the default EULA within the Office store for Power BI custom visuals. 若要使用默认 EULA,请将以下 URL 粘贴到卖家仪表板的“最终用户许可协议”文件上载对话框中:https://visuals.azureedge.net/app-store/Power BI - Default Custom Visual EULA.pdfTo 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 像素(宽度)x 768 像素(高度)。It must be exactly 1366px (width) x 768px (height). 文件大小不能超过 1024 KB。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 BI 中的可视化效果Visualizations in Power BI
Power BI 中的自定义可视化效果Custom Visualizations in Power BI
让自定义视觉对象取得认证Getting a custom visual certified

更多问题?More questions? 尝试咨询 Power BI 社区Try asking the Power BI Community