在 AppSource 上發佈自訂視覺效果Publish 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. 它必須剛好 300px (寬度) x 300px (高度)。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. 它必須剛好為 1366px (寬度) x 768px (高度)。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 或 Power BI Office 市集自訂視覺效果的預設 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.comYou 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.

注意

為改善品質並確保現有的報告不中斷,現有視覺效果的更新經市集核准後,要再 2 週才會投放到生產環境。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).

重要

您必須先將附有 .pbiviz 檔案和 .pbix 檔案的電子郵件傳送至 Power BI 小組,然後再提交至 AppSource。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.
    • 「類別」:第一個類別會自動填入 "Data Visualization + 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. 它必須剛好 300px (寬度) x 300px (高度),大小不能大於 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 或 Power BI Office 市集自訂視覺效果的預設 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. 它必須剛好為 1366px (寬度) x 768px (高度)。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