在 Power BI 中建立範本應用程式

本文包含建立 Power BI 範本應用程式的逐步指示。 Power BI 範本應用程式可讓 Power BI 合作夥伴以少量程式碼或不需撰寫程式碼即可建置 Power BI 應用程式，並將其部署至所有 Power BI 客戶。

如果您可建立 Power BI 報表及儀表板，即可成為範本應用程式產生器，且將分析內容建置並封裝在應用程式中。 接著，您可以透過任何可用的平台 (例如 AppSource 或或您自己的 Web 服務)，將應用程式部署至其他 Power BI 租用戶。 若要透過自己的 Web 服務散發您的範本應用程式，您可以將部分安裝程序自動化，以減輕客戶的負擔。

Power BI 管理員可管理並控制其組織中可建立及安裝範本應用程式的人員。 獲授權的人員可以安裝您的範本應用程式，修改它並散發給其組織中的 Power BI 使用者。

必要條件

以下為建立範本應用程式的需求：

• Power BI Pro 授權
• Power BI Desktop (選用)
• 熟悉基本 Power BI 概念
• 公開共用範本應用程式的權限，如範本應用程式租用戶設定所示

建立範本工作區

若要建立可以散發給其他 Power BI 租用戶的範本應用程式，您需要在工作區中建立範本應用程式。

1. 在 Power BI 服務中，如在 Power BI 中建立工作區所述建立工作區。 在 [進階] 區段，選取 [開發範本應用程式]。

   

   重要

   應用程式產生器工作區獲指派的容量，不會決定應用程式安裝程式安裝應用程式所在工作區的容量指派。 這表示在進階容量工作區中開發的應用程式，不一定會安裝在進階容量工作區上。 因此，不建議對產生器工作區使用進階容量，因為安裝程式工作區可能不是進階容量，除非安裝程式手動為已安裝的工作區重新指派進階容量，否則依賴於進階容量的功能將無法運作。

   重要

   只有在建立應用程式建立器工作區時，才能選取 [開發範本應用程式] 選項。 將工作區定義為應用程式建立器工作區之後，就無法從工作區中移除應用程式建立器功能。

2. 完成建立工作區時，請選取 [儲存]。

注意

您需要獲得 Power BI 系統管理員的權限，才能升階範本應用程式。

將內容新增至範本應用程式工作區

如同一般的 Power BI 工作區，下一個步驟是將內容新增至工作區。 如果您是在 Power Query 中使用參數，請確認這些參數已正確定義類型 (例如 Text)。 不支援類型 Any 和 Binary。

如需為您的範本應用程式建立報表和儀表板時要考量的建議，請參閱在 Power BI 中撰寫範本應用程式的提示。

定義範本應用程式的屬性

既然您的工作區中已有內容，您可以開始將它封裝至範本應用程式。 第一步為建立測試範本應用程式，您只能從您租用戶上的組織內存取。

1. 在範本應用程式工作區中，選取 [建立應用程式]。

   

   接下來，在六個索引標籤中填入範本應用程式的更多選項。

2. 在 [商標] 索引標籤上，完成下列欄位：

   • 應用程式名稱
   • 說明
   • 支援網站。 將範本應用程式重新發佈為組織應用程式之後，支援連結會出現在應用程式資訊下方。
   • 應用程式標誌。 標誌具有 45K 檔案大小限制，必須具有 1:1 外觀比例，且必須使用 .png、.jpg 或 .jpeg 檔案格式。
   • 應用程式佈景主題色彩

   

3. 在 [瀏覽] 索引標籤上，您可以開啟 [新的瀏覽產生器] 來定義應用程式的瀏覽窗格。

   

   如果您未開啟 [新的瀏覽產生器]，則會有選取應用程式登陸頁面的選項。 定義要作為應用程式登陸頁面的報表或儀表板。 使用提供您所需廣告閱聽的登陸頁面。

4. 在 [控制項] 索引標籤上，設定應用程式使用者對應用程式內容的限制。 您可以使用這項控制來保護應用程式中的智慧財產權。

   

   注意

   如果您想要保護您的資料，請停用 [下載報表至檔案] 選項，然後視需要設定其他兩個選項。

   原因：

   此索引標籤上的檢視、編輯和匯出控制項僅適用 Power BI 服務。 下載 .pbix 檔案之後，它就不再於服務中。 它會在使用者選擇的位置中，放置一份資料複本，未受保護。 然後，您就不再能夠控制使用者可以對它使用進行的動作。

   如果您想要限制對查詢和量值的存取，同時仍允許使用者新增自己的資料來源，請考慮只勾選 [匯出或從外部連線到資料] 選項。 這可讓使用者新增自己的資料來源，而無法編輯您的語意模型。 如需詳細資訊，請參閱在 Power BI Desktop 中使用複合模型。

5. 參數會在原始 .pbix 檔案中建立 (深入了解建立查詢參數)。 您可使用此索引標籤上的功能，在應用程式安裝程式連線到其資料時，協助進行設定。

   

   每個參數都有名稱，其來自查詢，以及 [值] 欄位。 在安裝期間，您有三個選項可以取得參數的值：

   • 您可以要求安裝應用程式的使用者輸入值。

     在此情況下，您需要提供使用者取代的範例。 若要以此方式設定參數，請選取 [必要] 核取方塊，然後在文字方塊中提供範例，其告知使用者應預期的值種類，如下列範例所示。

     

   • 您可提供預先填入的值，讓安裝應用程式的使用者無法加以變更。

     以此方式設定的參數會向安裝應用程式的人員隱藏。 只有當您確定預先填入的值對所有使用者都有效時，才應該使用此方法。 如果無法確定，請使用需要使用者輸入的第一個方法。

     若要以此方式設定參數，請在 [值] 文字方塊中輸入值，然後選取鎖定圖示，使得值無法變更。 下列範例顯示此選項：

     

   • 您可提供使用者在安裝期間可以變更的預設值。

     若要以這種方式設定參數，請在 [值] 文字方塊中輸入想要的預設值，且保持鎖定圖示未鎖定，如下列範例所示：

     

   在此索引標籤中，您也可以提供應用程式文件的連結。

6. 在 [驗證] 索引標籤上，選取要使用的驗證方法。 可用的選項取決於所使用的資料來源類型。

   

   隱私權等級會自動設定：

   • 單一資料來源會自動設定為私人。
   • 多個匿名資料來源會自動設定為公用。

7. 在測試階段中，在 [存取] 索引標籤上，決定組織內哪些其他人員可安裝並測試應用程式。 您之後會回來變更這些設定。 此設定不會影響分散式範本應用程式的存取。

   

8. 選取 [建立應用程式]。

   您會看到測試應用程式已就緒的訊息，還有供您複製並分享給應用程式測試者的連結。

   

   您也已經完成接下來的發行管理程序的第一步。

管理範本應用程式發行

在公開發行該範本應用程式前，您會確認其已準備就緒。 在 Power BI [發行管理] 窗格中，您可以遵循並檢查完整的應用程式發行路徑。 您也可以觸發階段之間的轉換。 常見的階段有：

• 產生測試應用程式：僅供組織內的測試使用。
• 將測試套件升階至生產前階段，並在您的組織外部測試。
• 將生產前套件升階至生產環境中的生產版本。
• 刪除任何套件，或從先前的階段重新開始。

當您在發行階段之間移動時，URL 不會變更。 升階不會影響 URL 本身。

若要完成發行階段：

1. 在範本工作區中，選取 [發行管理]。

   

2. 如果您遵循本文中的步驟來建立測試應用程式，則 [測試] 旁的點會已填入。 選取 [取得連結]。

   如果您尚未建立應用程式，請選取 [建立應用程式] 以啟動範本應用程式建立程序。

   

3. 若要測試應用程式安裝體驗，請複製視窗中的連結，並貼到新的瀏覽器視窗。

   從這裡，您會遵循應用程式安裝程式將遵循的相同程序。 如需詳細資訊，請參閱在組織中安裝和散發範本應用程式。

4. 在對話方塊中，選取 [安裝]。

5. 安裝成功之後，選取 [應用程式] 清單中的應用程式加以開啟。

6. 驗證測試應用程式具有範例資料。 若要進行任何變更，請返回原始工作區中的應用程式。 並將測試應用程式更新到您滿意為止。

7. 當您準備好要將應用程式升階至生產階段前，以在租用戶外部測試時，請返回 [發行管理] 窗格，並選取 [升階應用程式]。

   

   注意

   將應用程式升階時，它會變得可在組織外部公開取得。

   如果您未看到 [升階應用程式] 選項，請連絡 Power BI 系統管理員，要求其授與您管理入口網站中的範本應用程式開發權限。

8. 在對話方塊中，選取 [升階]。

9. 複製該新 URL 來與租用戶外部共用，以進行測試。 此連結也是您在建立新的合作夥伴中心供應項目時所提交，用以開始在 AppSource 上散發您應用程式之程序的 URL。

   您只需要將生產前的連結提交給合作夥伴中心。 在應用程式通過核准，您也收到其在 AppSource 中發佈的通知之後，您才可以將該套件升階到 Power BI 中的生產環境。

10. 當您的應用程式已準備好進入生產階段或透過 AppSource 分享時，請返回 [發行管理] 窗格，並選取 [生產階段前] 旁邊的 [升階應用程式]。

11. 選取 [升階]。

    現在您的應用程式已經進入生產階段，並準備好散發。

    

若要將您的應用程式廣泛提供給世界各地的 Power BI 使用者，請將其提交至 AppSource。 如需詳細資訊，請參閱建立 Power BI 應用程式供應項目。

在安裝期間將參數設定自動化

若您是獨立軟體廠商並透過 Web 服務散發您的範本應用程式，可以建立自動化作業，以便在客戶在 Power BI 安裝應用程式時，自動設定範本應用程式參數。 因為客戶不需要提供自己可能不知道的詳細資料，所以這麼做能夠減輕您客戶的負擔，自動設定可增加成功安裝的可能性。 如需詳細資訊，請參閱自動設定範本應用程式安裝。

相關內容

• 若要了解客戶如何與範本應用程式互動，請參閱在您的組織中安裝、自訂及散發範本應用程式。
• 如需散發應用程式的詳細資料，請參閱建立 Power BI 應用程式供應項目。