---
schema_version: "1"
id: cf55c96d83e6dbc577ed385282c95e4fab25f81cb602e722b31e4e08d55938b3
title: 将 Web 图像动态添加到工作表
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/server-linux/image_role.md
canonical_url: https://help.tableau.com/current/server-linux/zh-cn/image_role.htm
source_site: help.tableau.com
content_type: documentation
content_hash: afbd452f23cc9e653f008396d233b0006dad48ddffa4c4800f4352a8cbceeeb1
description: Assign an image role to URL fields to add web images dynamically to worksheets.
---
[跳转到主要内容](#main-content)

# 将 Web 图像动态添加到工作表

在 Tableau，我们知道图像是分析数据的有力工具。想象一下，您正在查看每月鞋子销售额的可视化项。数据告诉您，您卖出的高跟鞋比坡跟鞋多，但您无法想象这两种鞋的区别。这就是图像角色的用武之地。您可以将 Web 图像动态添加到工作表中，并在标题中使用它们来添加视觉细节。  
  
![包含鞋子图像以及鞋子类型和销售情况的可视化项](/tableau/current/zh-cn/server-linux/zh-cn/Img/imagerole_1.png)  

## 准备数据源

可以将图像角色分配给离散维度字段，其中包含指向 Web 图像的 URL。若要准备您的数据，请确保您的图像字段符合 Tableau 为分配图像角色而设置的要求:

- 确保您的 URL 导航到 .png、.jpeg、.jpg、.svg、.webp、.jfif、.ico 或 .gif 图像文件。
- 验证每个 URL 是否以 http 或 https 开头。如果没有包含传输协议，Tableau 将采用 https。
- 优化数据集中使用的图像数量。通常，每个字段最多可以加载 500 个图像。
- 确保每个图像文件小于 200 kb。

**注意：**如果您使用的是 Tableau 23.1 或更低版本，您的 URL 必须导航到具有 .jpg、.jpeg 或 .png 文件扩展名的图像文件。  
  
在 Tableau 23.2 及更高版本中，支持 .gif 文件，但 .gif **动画**将仅在具有客户端渲染的 Tableau Cloud 和 Tableau Server 上显示。在具有服务器端渲染的 Tableau Desktop 和 Tableau Server 中，.gif 文件将显示为静态图像。  
  
根据可视化项的复杂程度，Tableau 可能默认使用服务器端渲染，这会将图像数量限制为每个字段 100 个。若要了解有关复杂性设置和服务器端渲染的详细信息，请参见[配置客户端渲染](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

### 示例数据集：

<table style="mc-table-style: url('Resources/TableStyles/Basic-Border.css');" class="TableStyle-Basic-Border" cellspacing="0"><colgroup><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1"><col class="TableStyle-Basic-Border-Column-Column1" style="width: -1788px;"></colgroup><tbody><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">产品名称</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">产品图像 URL</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">产品销售额</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">平面</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/flats.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">12,118</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">高跟鞋</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/highheels.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">15,865</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">跑步鞋</td><td class="TableStyle-Basic-Border-BodyE-Column1-Body1">https://img.example.com/runningshoes.png</td><td class="TableStyle-Basic-Border-BodyD-Column1-Body1">14,200</td></tr><tr class="TableStyle-Basic-Border-Body-Body1"><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">坡跟鞋</td><td class="TableStyle-Basic-Border-BodyB-Column1-Body1">https://img.example.com/wedges.png</td><td class="TableStyle-Basic-Border-BodyA-Column1-Body1">8,665</td></tr></tbody></table>

## 为您的 URL 分配图像角色

连接到数据源后，可以从“数据源”页面或工作表的“数据”窗格中为 URL 分配图像角色。

### 从“数据源”页面中：

1. 找到包含图像 URL 的列。
2. 右键单击（在 Mac 上按住 control 键单击）列左上角的图标，然后选择“图像角色”\>“URL”。  
    图标变成图像图标，您的图像就可以使用了。  
      
    ![用于将图像角色分配给 URL 的数据源选项](/tableau/current/zh-cn/server-linux/zh-cn/Img/imagerole_3.png)

### 从工作表中：

1. 打开新工作表。
2. 找到包含图像 URL 的离散维度字段。
3. 右键单击（在 Mac 上按住 control 键单击）维度字段，并选择“图像角色”\>“URL”。  
    图标变成图像图标，您的图像就可以使用了。  
      
    ![用于将图像角色分配给数据的“数据”窗格选项](/tableau/current/zh-cn/server-linux/zh-cn/Img/imagerole_2.png)

## 将图像添加到可视化项

从工作表中，将“图像角色”字段拖到“行”或“列”功能区上。现在，您可以在可视化项上看到图像及其相关数据。  
  
![在数据窗格中创建图像角色。](/tableau/current/zh-cn/server-linux/zh-cn/Img/imagerole_addtoviz2.gif)

## 共享可视化项

您可以导出带有图像的工作簿并共享它们。确保您的可视化项中使用的图像可供与您共享可视化项的每个人查看。举例来说，如果您使用的图像托管在防火墙后的内部服务器上，请确保与您共享可视化项的每个人都有足够的权限访问这些图像。在本例中，在连接到同一服务器时查看可视化项的用户应该不会出现任何查看图像的问题。但是在 Tableau Cloud 服务器上将可视化项导出为 pdf 的用户可能看不到图像。

如果您导出工作簿，并且查看者试图在 Tableau 2022.3 或更低版本中打开它，查看者将看不到图像。

**注意：**最佳做法是始终将“图像角色”字段与文本描述对齐，以便屏幕阅读器和其他辅助功能软件可以访问这些内容。

## 图像连接疑难解答

有时，如果您超过了每个字段允许的图像数量，在复杂的可视化项上有大型图像文件，或者在移动设备上查看可视化项，图像将不会显示。本部分帮助您排除这些错误。

### 我的可视化项中没有显示任何图像

可视化项中的图像太多

根据可视化项的复杂程度，您通常可以在每个字段中加载 500 个图像。如果您有一个复杂的可视化项，它可能默认使用服务器端渲染。使用服务器端渲染，每个字段可以加载 100 个图像。

如果收到可视化项中图像太多的错误消息，请筛选掉图像，然后重试。

Tableau 无法访问图像

如果您收到的是损坏的图像图标，而不是您的图像，请首先确认您有足够的权限查看这些图像（或者举例来说，确认它们是否位于防火墙后面）。Tableau 必须能够访问图像，并且图像不能要求单独的身份验证才能查看。

如果您确定您拥有查看图像的权限，并且它们符合大小要求，请检查您的设置页面上是否启用了 Web 图像。

在 Tableau Desktop 中：

1. 从工作簿中，单击工具栏中的“帮助”。
2. 选择“设置和性能”\>“设置仪表板 Web 视图安全性”。
3. 确保选中了“启用网页对象和 Web 图像”。

在 Tableau Cloud 中：

1. 从主页中，单击“设置”。
2. 在“常规”下，向下滚动并找到“网页对象和 Web 图像”。
3. 确保选中了“启用网页对象和 Web 图像”。

### 我的可视化项中未显示某些图像

图像文件太大

每个图像文件必须小于 200 kb 才能渲染。请检查您的图像文件大小，然后重试。

您使用的是早期版本的 Tableau

如果您使用的是 Tableau 23.1 或更低版本，则仅支持 .png、.jpeg 和 .jpg 图像文件。升级您的 Tableau 版本或使用您正在使用的 Tableau 版本支持的文件类型。

图像 URL 必须以 http 或 https 开头

每个图像 URL 必须以 http 或 https 开头。Tableau 目前不支持 FTP/SMTP 调用。请验证您的 URL 格式，然后重试。

图像文件必须为 URL

图像角色只能分配给导航到 .png、.jpeg 或 .jpg、.svg、.webp、.jfif、.ico、.bmp 或 .gif 图像文件的 URL。请验证您的 URL 格式，然后重试。

不支持图像文件类型

图像角色只能分配给导航到 .png、.jpeg 或 .jpg、.svg、.webp、.jfif、.ico、.bmp 或 .gif 图像文件的 URL。请验证您的 URL 格式，然后重试。

如果您使用的是 Tableau 23.1 或更低版本，则仅支持 .png、.jpeg 和 .jpg 图像文件。升级您的 Tableau 版本或使用您正在使用的 Tableau 版本支持的文件类型。  
在 Tableau 23.2 及更高版本中，支持 .gif 文件，但 .gif **动画**将仅在具有客户端渲染的 Tableau Cloud 和 Tableau Server 上显示。在具有服务器端渲染的 Tableau Desktop 和 Tableau Server 中，.gif 文件将显示为静态图像。  

图像文件包含错误字符

不能将图像角色分配给包含以下字符的 URL：

< > & \\ ^ '

或以下字符序列：

..\\\\.\\r \\n \\t

请验证您的 URL 不包含任何这些字符或字符序列，然后重试。

### 图像没有显示在我的工作表之外

图像没有显示在工具提示内部可视化项中

工具提示内部可视化项是通过服务器端渲染处理的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

有关服务器端和客户端渲染的详细信息，请参见[配置客户端渲染](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

有关使用工具提示内部可视化项的详细信息，请参见[在工具提示中创建视图（工具提示内部可视化项）](https://help.tableau.com/current/pro/desktop/zh-cn/viz_in_tooltip.htm)。

图像未以缩略图形式显示在视图中

视图缩略图是通过服务器端渲染处理的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

有关服务器端和客户端渲染的详细信息，请参见[配置客户端渲染](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm)。

当我导出工作簿时，图像不显示

所有导出和与导出相关的功能是通过服务器端渲染处理的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

图像没有显示在移动设备上

与计算机相比，移动设备的复杂性阈值更低，因此处理是通过服务器端渲染完成的，这允许您在每个字段中加载最多 100 个图像。请确认每个字段的图像少于 100 个，然后重试。

您可以更改移动设备上的复杂性设置。有关复杂性阈值的详细信息，请参见[为计算机和移动设备配置复杂程度阈值](https://help.tableau.com/current/server/zh-cn/browser_rendering.htm#configure-the-complexity-threshold-for-computers-and-mobile-devices)。