Microsoft Power BI（以下簡稱Power BI）是Microsoft Corporation提供的BI工具，透過資料的視覺化與共享，協助使用者進行決策。
本文將說明如何使用Power BI的自訂連接器（Custom Connector）來取得並視覺化kintone的資料。

Power BI是一個商業分析平台，有助於將資料轉換為有效的分析資訊。
您可以整形並視覺化所取得的資料，並在組織內進行共享。

Power BI主要由以下服務構成：

詳情請參閱以下頁面。
什麼是PowerBI？

自訂連接器是用來連接Power BI未原生支援的資料來源之擴充功能。
若要將kintone的資料匯入Power BI，需使用kintone專用的自訂連接器（以下稱為kintone連接器）。

kintone連接器由Cybozu公司開發並提供，預期可用於正式運行環境。
關於kintone連接器的規格確認或故障疑問，可諮詢API支援窗口。

有關如何聯繫我們的資訊，請參閱以下頁面。
有關API、自訂、外掛程式和整合的資訊

透過在Power BI Desktop中設定kintone連接器，即可將kintone應用程式的記錄資料匯入Power BI。

使用Power BI Service，則能發布並共享在Power BI Desktop中建立的報表。
並支援依設定的時間間隔自動更新。

1. 安裝 PowerBIDesktop 。
2. 下載 kintone連接器（MEZ檔案）

此設定將允許載入未驗證的自訂連接器。

1. 將kintone連接器（mez檔案）放置於「文件/Power BI Desktop/Custom Connectors」資料夾中。

   • 若無此資料夾，請自行建立。
   • 雖然 官方文件 中記載為「Microsoft Power BI Desktop」，但已確認在「Power BI Desktop」上可正常運作。

2. 啟動Power BI Desktop，並修改安全性設定。

   • 從PowerBIDesktop檔案中，選擇[選項和設定]。
   • 選擇“選項”，然後從畫面左側選擇“安全”。
   • 在「資料延伸模組」項目中勾選「（非建議）允許載入任何延伸模組而不驗證或警告」
   • 點擊「確定」後重新啟動Power BI Desktop。

     

3. 選擇「取得資料」→「kintone（自訂）」→「連線」。

4. 即使出現關於連接器的警告，也請點擊「連線」。

5. 輸入 連接所需信息 後按下「確定」。

6. 確認要取得的資料後，選擇「載入」。

詳情請參閱以下頁面。
PowerBI中的連接器增強功能

從Power BI Desktop選擇「發佈」，將報表上傳至Power BI Service。

安裝與設定內部部署資料閘道

若要更新資料，需啟動內部部署資料閘道。
請選擇在希望的更新時段可運行的環境。
不一定要與安裝Power BI Desktop的環境相同。相關考量請參考官方文件。

1. 安裝 內部部署資料閘道 。
   使用與Power BI Service相同的帳號登入。
   記下回覆鍵，後續步驟會使用。

2. 將kintone連接器（mez檔案）存放於安裝內部部署資料閘道的環境中。

3. 開啟閘道的Connector標籤，指定存放kintone連接器的目錄。

4. 設定資料夾存取權限。
   在放置kintone連接器（mez檔案）的資料夾中，執行下列操作。

   • 右鍵點擊該資料夾→選擇「屬性」。
   • 打開「安全性」標籤。
   • 確認「群組名稱或使用者名稱」中包含PBIEgwService。
   • 若未包含，請按「編輯」→「新增」，在「物件名稱」中輸入NT SERVICE\PBIEgwService後按「確定」。
   • 勾選「讀取與執行」及「讀取」權限，然後「套用」。
   

   謹慎

   此操作需具備系統管理員權限。以管理員身分執行。

5. 重新啟動內部部署資料閘道。
   若數秒後顯示kintone，即表示設定成功。

   

詳情請參閱以下頁面。
在內部部署資料閘道中使用自訂資料連接器

Power BI Service端的閘道連線設定

1. 登入Power BI Service，點擊右上角齒輪圖示→選擇「連線與閘道管理」。

2. 打開「內部部署資料閘道」標籤，確認剛剛設定的閘道名稱是否顯示。

3. 選擇閘道→點擊上方「設定」。

4. 勾選「允許使用者透過此閘道叢集更新其自訂資料連接器」→點擊「儲存」。

5. 打開要更新的報表語意模型。

   

6. 從左上角「更新」→「設定排程更新」。

7. 點擊畫面頂部的「探索資料來源」

   

8. 單擊畫面上的「閘道與雲端連線」。

   

9. 從內部部署資料閘道清單中，選擇設定了kintone連接器的閘道→按「手動新增閘道」。

10. 將顯示新增畫面，輸入與Power BI Desktop里設置的 連接所需信息 ，然後點擊「建立」。
    

    

11. 成功連線後，回到設定畫面→再次點擊「閘道與雲端連線」。

12. 從下拉選單選擇剛設定的連線名稱→按「套用」。

開啟要更新的語意模型→「更新」→「立即更新」，即可將目前kintone應用的資料反映到報表中。

若要設定自動更新，選擇「更新」→「設定排程更新」→「最新資訊更新」。
建議設定於夜間等使用者較少的時段，以減輕kintone負載。

當kintone應用的紀錄數為0時會出現此現象。
請先在應用中新增紀錄。
若仍無法解決，請參考以下頁面刪除快取資料：
Power BI Desktop的發布相關疑難排解

本文說明了如何透過Power BI自訂連接器取得與視覺化kintone資料。
善用kintone連接器，能有效分析與可視化kintone中累積的資料，協助組織做出更佳決策。

若對kintone連接器的使用有任何疑問，請隨時聯繫Cybozu的API支援窗口。
有關API、自訂、外掛程式和整合的資訊

kintone連接器（mez檔案）的更新記錄。

• 2025年9月15日
  v1.0.0發布

本文於2025年8月，在kintone、MicrosoftPowerBI和kintoneConnectorv1.0.0中完成測試。