在 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 租使用者,您必須在工作區中建立它。

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

    Screenshot that shows Develop a template app.

    重要

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

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

注意

您需要 Power BI 系統管理員的許可權,才能提升範本應用程式。

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

如同一般 Power BI 工作區,下一個步驟是將內容新增至工作區。 如果您在 Power Query 中使用參數,請確定它們具有妥善定義的型別,例如 Text。 不支援 型 Any 別和 Binary

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

定義範本應用程式的屬性

現在您的工作區中有內容,您可以在範本應用程式中封裝它。 第一個步驟是建立測試範本應用程式,此應用程式只能從您租使用者上的組織記憶體取。

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

    Screenshot that shows Create app.

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

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

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

    Screenshot that shows the Branding tab.

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

    Screenshot that shows the Navigation tab.

    如果您未開啟 [新增導覽產生器],您可以選擇選取應用程式登陸頁面。 定義報表或儀錶板,以成為您應用程式的登陸頁面。 使用提供您所需印象的登陸頁面。

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

    Screenshot that shows the Control tab.

    注意

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

    原因:

    此索引標籤上的檢視、編輯和導出控件僅適用於 Power BI 服務。 下載 .pbix 檔案之後,它就不再位於服務中。 它會在用戶選擇的位置中,放置一份數據複本,不受保護。 然後,您就不再控制使用者可以使用它做什麼。

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

  5. 參數是在原始 .pbix 檔案中建立的(深入瞭解 如何建立查詢參數)。 您可以使用此索引標籤上的功能,協助應用程式安裝程式在安裝之後設定應用程式,當他們連線到其數據時。

    Screenshot that shows the Parameters tab.

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

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

      在此情況下,您會提供使用者所取代的範例。 若要以這種方式設定參數,請選取 [必要 ] 複選框,然後在文本框中提供範例,向用戶顯示預期的值類型,如下列範例所示。

      Screenshot of a parameter value required from the user.

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

      以這種方式設定的參數會隱藏在安裝應用程式的使用者中。 只有當您確定預先填入的值對所有使用者都有效時,才應該使用這個方法。 如果沒有,請使用需要使用者輸入的第一個方法。

      若要以這種方式設定參數,請在 [值 ] 文本框中輸入值,然後選取鎖定圖示,以便無法變更值。 下列範例顯示此選項:

      Screenshot of an absolute parameter value.

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

      若要以這種方式設定參數,請在 [值] 文本框中輸入所需的預設值,並將鎖定圖示保持解除鎖定,如下列範例所示:

      Screenshot of a changeable default parameter value.

    在此索引標籤中,您也會提供應用程式檔案的連結。

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

    Screenshot that shows the Authentication tab.

    隱私權等級會自動設定:

    • 單一數據源會自動設定為私人。
    • 多重匿名數據源會自動設定為公用。
  7. 在測試階段中,在 [ 存取 ] 索引標籤上,決定組織中的其他人可以安裝及測試您的應用程式。 您稍後會回來變更這些設定。 此設定不會影響分散式範本應用程式的存取。

    Screenshot of the Access tab.

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

    您會看到一則訊息,指出測試應用程式已就緒,其中包含複製應用程式並與應用程式測試人員共用的連結。

    Screenshot of the message that the test app is ready.

    您也已完成下列發行管理程式的第一個步驟。

管理範本應用程式版本

在公開發行範本應用程式之前,您想要確定它已就緒。 在 Power BI 發行管理窗格中,您可以遵循並檢查完整的應用程式發行路徑。 您也可以觸發從階段到階段的轉換。 常見的階段如下:

  • 只產生測試應用程式以在組織內進行測試。
  • 將測試套件升階到生產階段前,並在組織外部進行測試。
  • 將生產階段前套件升階至生產環境中的生產版本。
  • 刪除任何套件,或從上一個階段開始。

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

若要完成發行階段:

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

    Screenshot that shows Release Management in the template workspace.

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

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

    Screenshot of the Release Management pane with Get link highlighted.

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

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

  4. 在對話框中,選取 [ 安裝]。

  5. 安裝成功之後,選取 [應用程式] 列表中的應用程式加以開啟。

  6. 確認測試應用程式具有範例數據。 若要進行任何變更,請返回原始工作區中的應用程式。 更新測試應用程式,直到您滿意為止。

  7. 當您準備好將應用程式升級至生產階段前,以在租使用者外部進行測試時,請返回 [ 發行管理 ] 窗格,然後選取 [升階應用程式]。

    Screenshot of the Release Management pane with Promote app highlighted.

    注意

    當您升階應用程式時,應用程式就會在組織外部公開提供。

    如果您沒有看到 [ 升階應用程式 ] 選項,請連絡 Power BI 系統管理員,以授與 系統管理員入口網站中範本應用程式開發 的許可權。

  8. 在對話框中,選取 [ 升級]。

  9. 複製新的 URL 以在租使用者外部共用以進行測試。 此連結也是您提交以開始透過建立 新的合作夥伴中心供應專案,在 AppSource 上散發應用程式的程式。

    只提交生產階段前連結至合作夥伴中心。 核准應用程式並收到在 AppSource 中發佈的通知之後,您可以將套件升級至 Power BI 中的生產環境。

  10. 當您的應用程式準備好透過AppSource進行生產或共用時,請返回 [發行管理] 窗格,然後選取 [生產前] 旁的 [升級應用程式]。

  11. 選取 [ 升階]。

    現在您的應用程式已投入生產環境,並已準備好進行散發。

    Screenshot of the Release Management pane with the app in production.

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

在安裝期間自動設定參數

如果您是獨立的軟體廠商,並透過 Web 服務散發範本應用程式,您可以在客戶在 Power BI 中安裝應用程式時自動建立自動化,以設定範本應用程式參數。 自動設定可讓客戶更輕鬆地進行,並增加成功安裝的可能性,因為客戶不需要提供可能不知道的詳細數據。 如需詳細資訊,請參閱 範本應用程式安裝的自動化設定。