Tableau 雷达图扩展使用指南

Tableau雷达图扩展的完整使用指南,涵盖安装配置、数据格式与样式自定义。

适用于 Tableau Desktop 2024.2 及以上版本 · 2026-05-09

📌 ➊ 下载与加载:下载 radar-chart.trex 清单文件,在 Tableau Desktop 中通过 Marks 卡片→扩展→访问本地扩展进行加载
➋ 编码槽位设计:雷达图提供轴(Axis)、值(Value)和分类(Category)三个数据槽位,拖入字段即可渲染
➌ 样式配置:右键进入设置,可调整颜色调色板、透明度、边框、网格形状、刻度层级和标签样式
➍ Server 发布:管理员需启用扩展程序功能并添加可信 URL(正则通配),发布工作簿后自动加载扩展
➎ 本地开发:修改 .trex 中 URL 指向 localhost,通过 python3 http.server 调试,生产环境需 HTTPS

一、下载扩展文件

.trex 清单文件: radar-chart.trex

下载后保存到本地,Tableau Desktop 加载时使用。

二、在 Tableau Desktop 中使用

2.1 加载扩展

  1. 打开 Tableau Desktop,连接数据源,新建工作表
  2. 在 Marks 卡片 上,将标记类型下拉切换为 「扩展」(Add Extension)
  3. 点击 「访问本地扩展」(Access Local Extensions)
  4. 选择下载好的 radar-chart.trex 文件

2.2 拖入数据

雷达图有三个编码槽位:

槽位

操作

说明

Axis

拖入维度字段

雷达图的各个轴(如指标名称、类别)

Value

拖入度量字段

每个轴上的数值(如销售额、评分)

Series

可选,拖入维度字段

多系列叠加对比(如不同地区、年份)

扩展2.png

2.3 配置样式

右键点击雷达图 → 「设置」,可调整:

  • 颜色调色板、填充透明度、边框宽度
  • 网格形状(多边形 / 圆形)、刻度层级
  • 轴标签字体、大小、颜色
  • 数据点显示、数值标签
未命名2.png

三、发布到 Tableau Server

3.1 管理员配置(一次性)

以服务器管理员身份登录:

  1. 启用扩展:「管理所有站点」→「设置」→「扩展程序」,勾选 「允许扩展程序在此服务器上运行」
  2. 添加可信 URL:在「启用特定扩展程序」中添加:
   https://oss.vizwise.online/.*
正则通配符一次性允许该域名下所有扩展。
扩展3.png

3.2 发布工作簿

  1. 在 Tableau Desktop 中将工作簿发布到 Server
  2. Server 打开时自动从 COS 加载扩展
  3. 首次加载可能提示权限,点击允许即可

四、本地开发(可选)

如需在本机调试扩展,修改 .trex 中的 <source-location> URL,指向本地服务器:

<source-location>
  <url>http://localhost:8765/extensions/radar-chart/radar-chart.html</url>
</source-location>

然后启动本地服务:

cd tableau-viz-extensions/
python3 -m http.server 8765

五、常见问题

问题

原因

解决

扩展一直 loading

lib/ 依赖文件缺失

确认 COS 中 lib/ 下两个 JS 文件存在

"不在此站点的安全列表上"

Server 未添加可信 URL

添加 https://oss.vizwise.online/.*

"internal-error"

bridge 文件版本不匹配

使用最新版 tableau.extensions.1.latest.js(>1.8MB)

生产环境加载失败

HTTP/HTTPS 混合内容

.trex 的 URL 必须使用 https://

作者:姜斌 · v1.0 · 2026-05-09

📖 相关文章
● Tableau 可视化项扩展开发指南 —— 以雷达图为例
● Tableau MCP 深度介绍:让 AI 真正"看懂"你的数据
● 用Tableau画分段雷达图
● Tableau LangChain:VizQL Data Service 集成详解
● 用Tableau画漏斗图的4种方法
——————————————————————————————

No comments yet