--- schema_version: "1" id: 6c231b8515ff0cee3190004717e56da1647bb85ffc4a0b1b754bc868370f405b title: 在您的工作表中新增視覺效果擴充功能 collection: tableau version: current locale: zh-tw portal_url: https://docs.salesforce.com/tableau/current/zh-tw/pro/desktop/viz_extensions.md canonical_url: https://help.tableau.com/current/pro/desktop/zh-tw/viz_extensions.htm source_site: help.tableau.com content_type: documentation content_hash: 43c0dd6433030a8da761d95bf1c9428f7d54a60bd078850013a6af1fbb06656f description: Add Viz Extensions to a worksheet to extend visual capabilities. --- [跳至主要內容](#main-content) # 在您的工作表中新增視覺效果擴充功能 視覺效果擴充功能是可以擴充 Tableau 原生視覺功能的 Web 應用程式。視覺效果擴充功能讓使用者可以與工作表上的自訂視覺效果類型進行互動。 視覺效果擴充功能可憑藉 Tableau 和協力廠商開發人員建立的 Web 應用程式擴充工作表功能。如果您是開發者，並且要建立自己的擴充功能，請參閱 GitHub 上的 [Tableau 擴充功能](https://tableau.github.io/extensions-api/)文件。 視覺效果擴充功能與[儀表板擴充功能](https://help.tableau.com/current/pro/desktop/zh-tw/dashboard_extensions.htm?_gl=1*uu9rzu*_ga*MTY0NjQ4Mjc3NS4xNzA3NzcyMzUx*_ga_8YLN0SNXVS*MTcxMjE2NjcxNC41NC4xLjE3MTIxNzA1MzUuMC4wLjA.)類似，它是一個在 [Tableau Exchange](https://exchange.tableau.com/zh-tw/) 上託管的 Web 應用程式。它與儀表板擴充功能的不同之處在於，您可以在建立視覺效果時將其新增至工作表，而不是將其作為物件新增至儀表板。 ## 在工作表中新增視覺效果擴充功能 有兩種方法可以透過「標記」卡在工作表中新增視覺效果擴充功能。如果已透過 Tableau Exchange 下載該檔案，則可以將其新增為本機檔案。也可以在製作視覺效果流程中從 Tableau Exchange 下載該檔案。 ### 將視覺效果擴充功能新增為本機檔案 如果已從 Tableau Exchange 選擇並下載視覺效果擴充功能，它將作為 .trex 檔案儲存在您的電腦中。 1. 開啟 Tableau 工作表並連線到您的資料來源。 2. 在工作表中的「標記」卡上，展開「標記類型」下拉式功能表。 3. 在視覺效果擴充功能下選取「新增擴充功能」。 ![具有視覺效果擴充功能選項的標記卡下拉式功能表。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/viz_ext_marks_AddExt.png) 4. 在出現的「新增擴充功能」對話方塊中選取「存取本機視覺效果擴充功能」。 ![新增具有「存取本機視覺效果擴充功能」選項的「新增擴充功能」對話方塊。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/viz_ext_addlocal.png) 5. 導覽至並開啟已儲存的 .trex 檔案。 6. 如果出現提示，請允許或拒絕視覺效果擴充功能存取工作簿中的資料。 在該檢視中載入視覺效果擴充功能，並且標記類型變更為視覺效果擴充功能的名稱。 ### 製作視覺效果時新增視覺效果擴充功能 如果尚未選取並下載視覺效果擴充功能，則可以在製作視覺效果流程中執行此操作。 1. 開啟 Tableau 工作表並連線到您的資料來源。 2. 在工作表中的「標記」卡上，展開「標記類型」下拉式功能表。 3. 在視覺效果擴充功能下選取「新增擴充功能」。 ![具有視覺效果擴充功能選項的標記卡下拉式功能表。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/viz_ext_marks_AddExt.png) 4. 在出現的「新增擴充功能」對話方塊中，選擇您想要載入到工作表上的視覺化擴充功能。在此範例中，我們將載入由 Tableau 建構的 Sankey 圖表。 ![「新增擴充功能」對話方塊可從 Tableau Exchange 中搜尋並新增擴充功能。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/viz_ext_addext.png) 5. 如果出現提示，請允許或拒絕視覺效果擴充功能存取工作簿中的資料。有關詳情，請參閱《資料安全性、已啟用網路及沙箱化擴充功能 》。 6. 選取「開啟」。 ![由 Tableau 開發的 Sankey 圖表的 Tableau Exchange 描述頁面。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/viz_ext_exchange.png) 在該檢視中載入視覺效果擴充功能，並且標記類型變更為視覺效果擴充功能的名稱。 ![標記卡下拉功能表，其中 Sankey 擴充功能在視覺效果擴充功能部分中放大。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/viz_ext_add_sankey.png) ## 使用標記卡對您的標記進行編碼 將欄位拖曳到「標記」卡上的編碼方塊上以建立視覺效果。標記編碼方塊與格式選項由開發人員決定。查看 Tableau Exchange 上的擴充功能描述，了解您要載入的視覺效果擴充功能資訊。 要使用 Sankey 擴充功能，請遵循以下編碼說明： Sankey 擴充功能的建構是為了使用特定於擴充功能的編碼**等級**與**連結**。這些可以與內建的標記編碼方塊「工具提示」和「詳細資訊」一起使用，在工作表上建立 Sankey 圖表。 - **等級** - Sankey 等級代表與 Sankey 相關的分類維度。在此擴充功能中，最多可以包含 5 個離散維度作為層級。 - **連結** - Sankey 連結連接 Sankey 中的類別。此編碼將根據數字度量調整每個連結的寬度。 ## 管理工作簿擴充功能 從 Tableau 2026.2 開始，可以從一個位置檢視、刪除或取代工作簿中使用的所有擴充功能。 若要管理擴充功能： 1. 從工具列中，選取分析，然後選取管理工作簿擴充功能。 ![分析下拉式功能表，顯示各種設定和醒目提示的管理工作簿擴充功能選項。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/vizext_manageextensions.png) 2. 在管理工作簿擴充功能對話方塊中，選取要管理的擴充功能。 ![「管理工作簿擴充功能」對話方塊視窗，顯示選取的 Sankey 擴充功能詳細資訊。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/vizext_manageextension_dialog.png) 3. 選擇以下其中一個動作： **刪除擴充功能**：選取刪除，以從工作簿中移除擴充功能。可以在「工作簿擴充功能」對話方塊上查看擴充功能目前的使用位置。刪除擴充功能會將其從所有工作表、儀表板和故事中移除。使用擴充功能的視覺效果會在「標記」卡上變更為「自動」標記類型。 **取代擴充功能：**選取取代，以切換到不同的擴充功能。選擇要切換到擴充功能，並選取確認。取代擴充功能會取代整個工作簿中擴充功能的每個執行個體。Tableau 會盡可能嘗試保留設定，但擴充功能或版本之間的設定可能不同。 4. 完成更新後，選取確定。 附註：若工作簿不包含任何擴充功能，則對話方塊會顯示「此工作簿中沒有擴充功能」訊息。 ## 確保 Tableau Cloud 上允許使用這些擴充功能 如果無法新增視覺效果擴充功能，請檢查您的站台是否允許使用這些擴充功能。Tableau 管理員必須允許在某個站台上執行這些擴充功能，並將已啟用網路的擴充功能新增至允許清單。管理員只應允許您測試過並信任的擴充程式。 要了解在允許清單中新增已啟用網路的擴充功能的更多資訊，請參閱 [Tableau 說明：變更站台的預設設定。](https://help.tableau.com/current/server/zh-tw/dashboard_extensions_server.htm#change-the-default-settings-for-a-site) ### 資料安全性、Tableau 受信任的擴充功能與啟用網路的擴充功能 擴充功能是以兩種標準呈現的 Web 應用程式： - _Tableau 受信任的擴充功能_經過專門檢閱，並部署在 Tableau 管理的主機上。其中包括由 Tableau 開發和管理的擴充功能、由 Tableau Exchange 合作夥伴建立並使用 Tableau 的擴充功能檢閱和託管服務部署的擴充功能，以及我們舊版沙箱化擴充功能主機中的擴充功能。 - _已啟用網路的擴充功能_是由協力廠商主機託管。這些擴充功能可讓開發人員在無需 Tableau 介入的情況下管理其擴充功能的交付。其中包括合作夥伴直接管理以提供更佳生產支援的擴充功能、在本機網路中託管和部署的擴充功能，以及需要與 Tableau 外部的協力廠商服務通訊的擴充功能。 在允許已啟用網路的擴充功能之前，請務必確保您信任託管該擴充功能的開發人員和網站。可以在管理工作簿擴充功能對話方塊中找到有關託管擴充功能 的 URL 以及開發人員要求的資料存取類型的資訊。 ![「管理工作簿擴充功能」對話方塊視窗，顯示醒目提示的擴充功能詳細資訊區段。](/tableau/current/zh-tw/pro/desktop/zh-tw/Img/vizext_manageextension_dialog_magnified.png) 預設情況下，擴充功能使用 HTTPS 通訊協定，該通訊協定可確保加密傳送和接收資料的管道，從而保證一定的隱私權和安全性。有關使用擴充功能時資料安全性的更多資訊，請參閱[擴充功能安全性 - 部署的最佳做法](https://help.tableau.com/current/server/zh-tw/security_extensions.htm)。 ### 允許或拒絕已啟用網路的擴充功能 預設情況下，已啟用網路的擴充功能必須請求執行權限。此權限對話方塊將提供有關託管擴充功能的協力廠商伺服器以及擴充功能所需資料存取層級的資訊。我們建議在允許擴充功能執行之前檢閱此資訊。 擴充功能通常會存取檢視中的可見資料。擴充功能請求「完整資料存取」時，它可能會要求在工作簿中進行更深入的資料存取。這可能包括存取完整資料、資料來源中的資料表和欄位名稱，以及有關資料來源連線的資訊。在允許擴充功能在工作簿中執行之前，應檢閱擴充功能權限對話方塊中宣告的資訊，並決定是否允許或拒絕擴充功能執行並存取資料。 ### 為啟用網路的擴充功能重設資料存取 如果在擴充功能權限對話方塊上選擇「拒絕」而不是「允許」，則不會在您的工作簿上載入擴充功能。如果您信任擴充功能並希望允許存取，則可以透過再次將相同的視覺效果擴充功能新增到工作簿中重設權限，這將重新載入權限提示對話方塊。 ### 確保擴充功能有權限存取工作簿或檢視 若發佈的工作簿包含擴充功能，請確保該擴充功能有權存取檢視中的可見資料。可見資料也稱為摘要資料。若要在 Tableau Server 或 Tableau Cloud 上授與此存取權，請確保工作簿或檢視允許下載摘要資料權限。擴充功能不會下載您的資料。擴充功能只需要權限即可與檢視中的資料互動。 根據發佈工作簿時是否選取將工作表顯示為索引標籤，可以在工作簿或檢視層級設定下載摘要資料權限。若工作表未顯示為索引標籤，可以在檢視層級設定權限。 若將工作簿或檢視發佈到 Tableau Public，擴充功能也需要存取可見資料。若要授與權限，請開啟「設定」，並選取允許存取。 ## 確保在 Tableau Desktop 中已啟用 JavaScript 視覺效果擴充功能使用 Tableau Extensions API 庫（一個 JavaScript 庫）與資料互動。如果要使用擴充功能，請務必保在安全設定中啟用 JavaScript： 選擇「說明」\>「設定與效能」\>「設定儀表板窗格 Web 檢視安全性」\>「啟用 JavaScript」。 ## 取得對協力廠商和 Tableau 合作夥伴建置的視覺效果擴充功能的支援 Tableau 不直接支援協力廠商和 Tableau 合作夥伴建置的擴充功能。但如果需要幫助，某些擴充功能開發人員會提供指向開發人員網站的連結，供您尋求支援。 要獲得幫助，請： 1. 在「管理工作簿擴充功能」對話方塊或 Tableau Exchange 中的擴充功能描述頁面上尋找「開發人員網站」連結。 2. 在「管理工作簿擴充功能」對話方塊中尋找擴充功能的 ID 和版本。向開發人員提供這些詳細資料對於疑難排解至關重要，因為它可以確認是否正在使用過時的版本，並有助於查明問題的根源。 3. 透過開發人員網站直接與擴充功能的開發人員聯絡。 有關擴充功能 API 的問題，我們鼓勵開發人員透過 [DataDev Slack 管道](https://tableau-datadev.slack.com/archives/CHJ9BHKG9)或[在 GitHub 上提交問題](https://github.com/tableau/extensions-api/issues)來共用擴充功能 API 的問題並尋求協助。