在 Power BI 中建立範本應用程式需要注意工作區物流和測試以外的多個元件。 本文提供撰寫查詢、資料模型、報表和儀表板的秘訣，以協助您建置有效的範本應用程式，以提供絕佳的使用者體驗。
- 查詢。 透過查詢，您可以 連線 和 轉換 資料，並定義 參數。
- 資料模型。 在資料模型中，您可以建立 關聯性、 量值和 Q&A 改善。
- 報表頁面。 報表頁面 包含視覺效果和篩選器，以提供資料的深入解析。
- 儀表板 和 磚。 儀表板 和 磁磚 提供見解的概覽。
- 範例資料。 範例可讓您的應用程式在安裝後立即被發現。
您可能熟悉每個部分，因為它們類似於現有的 Power BI 功能。 當您建立範本應用程式時，每個部分都需要考慮其他事項。 本文說明這些考量事項，以及與撰寫範本應用程式相關的其他實用資訊。
Queries
針對範本應用程式，Power BI Desktop 中開發的查詢可用來連線到資料來源並匯入資料。 這些查詢需要傳回一致的結構描述，並支援排程資料重新整理。
連線到您的 API
若要開始使用，您必須從 Power BI Desktop 連線到 API，才能開始建置查詢。
您可以使用 Power BI Desktop 中可用的資料連接器來連線到 API。 您可以使用 Web 資料連接器 （取得資料>Web） 連線到 Rest API，或使用 OData 連接器 （取得資料>OData 摘要） 連線到 OData 摘要。
備註
目前，範本應用程式不支援自訂連接器。 建議您探索使用 Odatafeed 驗證 2.0 作為某些連線使用案例的緩解措施，或提交連接器以進行認證。 如需如何開發聯結器並認證聯結器的詳細資訊，請參閱 資料聯結器。
考慮來源
查詢會定義資料模型中包含的資料。 視系統的大小而定，這些查詢也應包含篩選器，以確保您的客戶處理的內容符合您業務情境的可管理大小。
Power BI 範本應用程式可以平行執行多個查詢，並同時針對多個使用者執行。 規劃您的節流和並行策略，並詢問我們如何讓您的範本應用程式容錯。
架構強制執行
確保您的查詢能夠適應系統中的變更。 結構描述中的變更可能會在重新整理期間中斷模型。 如果來源可以針對某些查詢傳回 Null 或缺少結構描述結果，請考慮傳回空資料表或有意義的自訂錯誤訊息。
參數
Power BI Desktop 中的參數可讓您的使用者提供輸入值，以自訂使用者擷取的資料。 預先考慮參數設定，以避免浪費時間投入於建立詳細查詢或報告後重新處理。
備註
範本應用程式支援除Any和Binary之外的所有參數。
其他查詢提示
- 請確定所有列的類型都正確。
- 指派資料行資訊名稱。 如需詳細資訊，請參閱 Q&A。
- 對於共享邏輯，請考慮使用函數或查詢。
- Power BI 服務目前不支援隱私權層級。 如果您收到有關隱私權層級的提示，您可能需要重寫查詢以使用相對路徑。
資料模型
定義明確的資料模型可確保您的客戶可以輕鬆直觀地與範本應用程式互動。 在 Power BI Desktop 中建立資料模型。
備註
您應該在 查詢中執行大部分基本建模，例如鍵入和資料行名稱。
問答
模型化也會影響 Q&A 為客戶提供結果的能力。 請務必將同義字新增至常用資料行，並在 查詢中正確命名資料行。
其他資料模型提示
確保您已經：
- 將格式套用至所有值欄。 在查詢中套用類型。
- 將格式套用至所有量值。
- 設定預設摘要。 特別是，在適用時設定 無計算 （例如，針對唯一值）。
- 設定資料類別 （如果適用）。
- 視需要設定關聯性。
報告
報表頁面可讓您深入瞭解範本應用程式中包含的資料。 使用報表頁面來回答範本應用程式嘗試解決的關鍵業務問題。 使用 Power BI Desktop 建立報表。
其他報表提示
- 每個頁面使用多個視覺效果進行交叉篩選。
- 仔細對齊視覺效果，不要重疊。
- 請確定頁面版面配置設定為 4：3 或 16：9 模式。
- 請確定所呈現的所有彙總都具有數值意義，例如平均值或唯一值。
- 檢查切片是否產生合理的結果。
- 至少在頂端報告中包含您的標誌。
- 確保元素盡可能在客戶的配色方案中。
備註
單一範本應用程式不能包含超過 20 個報表。
Dashboards
儀表板是客戶與範本應用程式互動的主要點。 它應該包括所包含內容的概述，尤其是業務場景的重要指標。
若要為您的範本應用程式建立儀錶板，只需透過 [取得資料>檔案] 上傳您的 PBIX 文件，或直接從 Power BI Desktop 發佈。
其他儀表板提示
- 釘選的時候請保持相同的主題，以確保儀表板上的磚塊保持一致。
- 將徽標固定到主題中，以便消費者知道包裝的來源。
- 適用於大多數螢幕解析度的建議佈局是五到六個小圖塊寬度。
- 所有儀表板磚都應該有適當的標題和副標題。
- 請考慮在儀表板中針對不同案例進行垂直或水平分組。
範例數據
範本應用程式在應用程式建立階段中，會將快取資料包裝在工作區中，做為應用程式的一部分，這具有下列優點：
- 允許安裝程式在連接資料之前了解應用程式的功能和用途。
- 建立一種體驗，驅動安裝程式進一步探索應用程式功能，從而連接應用程式語意模型。
建議您在建立應用程式之前先取得高品質的範例資料，以確保應用程式的報表和儀表板已填入資料。 盡量保持樣本資料大小盡可能小。
在 AppSource 上發佈
範本應用程式可以在 AppSource 上發佈。 在將應用程式提交至 AppSource 之前，請遵循下列指導方針：
- 請務必建立範本應用程式，其中包含引人入勝的範例資料，以協助安裝程式瞭解應用程式的功能。 空白的報表和儀表板將不會獲得核准。
- 範本應用程式支援僅限資料的範例應用程式。
- 提供驗證團隊要遵循的指示，其中包括可用於連線到資料的認證和參數。
- 您的應用程式必須在 Power BI 和雲端合作夥伴入口網站 （CPP） 供應專案中包含 應用程式標誌 。
- 設定 登陸頁面。
- 請務必遵循 Power BI 應用程式方案的相關文件。
- 如果儀表板是應用程式的一部分，請確定它不是空白的。
- 在提交應用程式之前，請使用應用程式連結安裝應用程式。 請確定您可以連線語意模型，而且應用程式體驗符合您的規劃。
- 將 PBIX 檔案上傳至範本工作區之前，請務必卸載任何不必要的連線。
- 遵循 報表和視覺效果的 Power BI 最佳設計做法 ，以對使用者產生最大影響，並獲得散發核准。
建立應用程式的下載連結
在 AppSource 上發佈範本應用程式之後，請考慮從您的網站建立下載連結，以下列其中一項：
- AppSource 下載頁面，可供公開檢視。 從您的 AppSource 頁面取得連結。
- Power BI，可供 Power BI 使用者檢視。
若要將使用者重新導向至 Power BI 中應用程式的下載連結，請參閱下列程式碼範例： GitHub 存放庫。
在安裝過程中自動配置參數
如果您是透過 Web 服務散發範本應用程式的 ISV，您可以建立自動化，以便在客戶在其 Power BI 帳戶中安裝應用程式時自動設定範本應用程式參數。 這種方法讓您的客戶更輕鬆。 它還增加了成功安裝的可能性，因為他們不必提供他們可能不知道的詳細信息。 如需詳細資訊，請參閱 範本應用程式安裝的自動設定。