---
schema_version: "1"
id: 45a46ba0fb6e8f04d4dc214fcf615e7a9df32982934eb632486502eb40688714
title: 迁移计划：工作簿
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/server-linux/cmt-plan_workbooks.md
canonical_url: https://help.tableau.com/current/server-linux/zh-cn/cmt-plan_workbooks.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 32edfff466350baf4b6f0f6b05368e4e12233a7ce3eb38afe5bc1db7e331fbcc
description: Select and map workbooks for migration in a Content Migration Tool plan.
---
[跳转到主要内容](#main-content)

# 迁移计划：工作簿

您已成功登录到源站点和目标站点以及选定的项目。下一步是针对迁移准备工作簿。

**注意：**如果您的工作簿或数据源包括数据提取，请确保阅读并理解[迁移包含数据提取的工作簿和数据源](https://help.tableau.com/current/server-linux/zh-cn/cmt-migration_extracts.htm)中的信息。

## 步骤 1：工作簿选择

源站点和选定项目中的所有工作簿将出现在“Workbook Selection”屏幕中。

![工作簿选择窗口，其中选择了特定的工作簿选项并显示了所选可视化项的六个预览。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-select.png)

如果在此步骤中对源站点中的工作簿进行任何更改，您可以单击“Refresh ”更新工作簿列表。可通过多种不同方式来选择这些工作簿。

### “特定工作簿”选择

“Specific ”部分中有三个按钮。“基本”部分中的任何选项将立即包括迁移计划中特定选择的工作簿。或者，可通过单击每个工作簿来单独选择特定工作簿。

#### 全选

“全选”按钮将选择或取消选择站点中的所有工作簿。如果在保存计划后向站点中添加了将其他工作簿，则在下次使用计划时将不会自动添加这些工作簿。

#### 显示：

##### 缩略图

默认视图将在缩略图预览中显示工作簿，以帮助您区分每个工作簿。在此视图中，将鼠标指针悬停在缩略图上的将显示该工作簿内的其他工作表和仪表板的预览。

##### 列表

列表视图是一个更简洁的列表，它还提供了附加信息，包括工作簿名称、项目、Tableau 版本和最后修改时间。

单击任一列标题将相应地对工作簿进行排序。此外，将鼠标指针悬停在任何工作簿上时，还将提供该工作簿内的工作表和仪表板的浮动预览。如果站点中有大量工作簿，列表视图尤其有用。

### “基于规则”选择

可以使用“Rule Based”选项来基于特定条件选择工作簿。基于规则的选项将创建要在运行迁移计划时使用的工作簿选择条件。请注意，在任何“Rule Based”选项中选择“全部”与“Specific Workbooks”选择不同。基于规则的“全部”选择将始终包括所有工作簿，因此新添加的任何工作簿将包含在将来的迁移中。

![根据项目标签和发布者设置工作簿迁移规则的界面。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-rulebased.png)

“Rule Based”单选按钮允许您使用以下选项选择工作簿：

#### Workbooks in projects

此菜单允许您从特定项目中选择工作簿。

#### Workbooks tagged with

此菜单允许您按标记选择工作簿。

#### Workbooks published by

此菜单允许您按作者选择工作簿。

对于每个选项，您可以通过单击每个条目旁边的选项来进行单选或多选。所有选定工作簿将出现在“Selection Description”框中。

### “所有工作簿”选择

最后一个选项是选择“All Workbooks”单选按钮，它可选择站点内所有项目中的所有工作簿。

使用“All Workbooks”单选按钮与使用“Specific Workbook”方法选择所有工作簿不同，因为它也会在将来每次使用迁移计划时使用源站点中的每个工作簿。

![工作簿选择选项，其中选择了所有项目中的所有工作簿。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-select-all.png)

对工作簿选择感到满意后，单击“Next”。

## 步骤 2：工作簿映射

现在，您可以将所选工作簿从源文件映射到目标文件。映射允许您在迁移源工作簿时对其进行重命名，并选择不同的目标。您也可以添加映射以更改工作簿的项目、前缀或后缀。还可以将项目添加到此部分的“目标”中。

如果在此处未进行更改，则只会使用相同的名称迁移所选工作簿，并迁移到与源工作簿相同的项目中。如果未在目标站点中定义项目，则它们将迁移到“默认”项目中。若要添加工作簿映射，请单击“添加映射”按钮。映射区域中将显示以下选项。

![用于添加新工作簿映射的界面，其中包含重命名和更改项目的选项。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-mapping.png)

### 重命名工作簿

![工作簿映射界面，其中包含源和目标项目以及工作簿名称的字段。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-mapping-rename.png)

此转换允许您按Source 项目筛选，并选择要重命名的所需工作簿。在“Destination ”字段中，选择要将工作簿定向到哪个项目，并输入所需的新名称。

### 更改项目

![用于更改工作簿前缀的界面，并提供移除或替换的选项。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-mapping-chgproj.png)

默认情况下，工作簿将迁移到目标中的相同项目。此映射允许您为源项目中的所有工作簿更改目标项目。

### 添加项目

在重命名工作簿或更改项目时，“Add New”选项允许您创建目标，而不必登录到目标站点并手动创建项目。您可以使用“Add New ”对话框创建项目及嵌套项目。

![用于创建新项目的表单，其中包含位置、项目名称、父项目和描述字段。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-mapping-chgproj-new.png)

### 更改前缀

![用于更改工作簿前缀的界面，并提供移除或替换的选项。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-mapping-chgprefix.png)

此选项允许您为一个或所有源项目中的工作簿移除或替换前缀。

### 更改后缀

与前缀映射一样，您可以为一个或所有源项目中的工作簿移除或替换后缀。

## 步骤 3：工作簿转换

您可以使用“转换”步骤更改和修改工作簿。

![带有下拉箭头的标有“添加转换”的按钮。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-add-transform-button.png)

转换以指定的方式修改工作簿。可以通过插件包含其他转换，将来版本的应用程序中将添加这些转换。单击“添加转换”下拉菜单可查看当前可用的转换选择。

![工作簿转换选项的下拉菜单。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-add-transform-list.png)

选择任何转换将会打开“编辑转换”窗口，该窗口允许您将其自定义为所选工作簿。所有转换将按其列出顺序从上到下完成。

对于所有不同类型的转换，有两个基本步骤。第一步是让您选择转换。在本例中，选择要转换的工作簿。选择区域类似于“规划”阶段的“工作簿选择”部分，具有“基本选择”单选按钮的所有功能：“全选”/“取消全选”、“刷新”、“缩略图”显示，以及“列表”显示。在列表顶部，您可以选择“Select All”工作簿，这是一个用于自动选择所有工作簿以供将来转换的选项。您还可以刷新工作簿显示窗口以反映源站点的所有更改或更新。

![带有编辑转换选项的窗口。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-edit-transform-workbook.png)

第二步是使用选项选项卡为所选的任何转换输入特定选择。

![用于编辑参数值的表单，其中包含参数名称、数据类型和值的字段。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-edit-transform-options.png)

每个工作簿转换都有要在选项选项卡上输入的不同值，并且选项卡将具有不同的名称，具体情况视所编辑的信息而定：

### 替换 URL 动作

使用此转换替换工作簿内的部分或全部 URL 动作。在“选项”选项卡上，输入要匹配的文本及其替换值。替换功能用于 URL 动作，不会检查整个工作簿 XML。

![两个带有标签的文本框，“匹配”和“替换”。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-action-url.png)

#### 示例：

URL：`www.exampledev.com`

匹配：`dev`

替换值：`Prod`

结果：`www.exampleProd.com`

### 设置参数值

定义一个新参数。在选项选项卡上，输入参数的名称、下拉菜单中的数据类型以及值。

![包含参数名称、数据类型和值字段的表单。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-parameter.png)

### 移除图像

通过在选项选项卡上输入文件名，移除所选工作簿中的任何图像（例如水印）。另外还有一个复选框，用于指定在迁移期间找不到图像的情况下接收警告。

![标有“文件名”的文本字段和关于在工作簿中找不到匹配图像的警告消息。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-image-remove.png)

### 移除工具提示命令

从所选工作簿中移除所有工具提示命令。没有要为此转换定义的其他选项。

### 替换图像

替换所选工作簿中嵌入的图像。在“选项”选项卡上，输入当前图像和替换图像的文件名。您可以使用本地文件路径或 URL 替换图像。

![标有“文件名”的文本字段和关于在工作簿中找不到匹配图像的警告消息。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-image-replace.png)

#### 示例：

文件名：`image.png`

替换图像 URL：`https://www.exampledev.com/replacementImage.png`

### 缩放控制可见性

在选项选项卡上通过下拉菜单设置可见性模式：“自动”、“悬停时显示”或“隐藏”。

![选择了“自动”的可见性模式下拉菜单。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-zoom.png)

### 网页 URL 替换

使用此转换替换仪表板上使用的部分或全部网页 URL。在“选项”选项卡上，输入应匹配的文本及其替换值。

![标有“匹配”和“替换”的两个空文本字段](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-web-url-replace.png)

#### 示例：

URL：`www.exampledev.com`

匹配：`dev`

替换值：`Prod`

结果：`www.exampleProd.com`

## 步骤 4：数据源转换

为企业迁移规划工作簿的下一步是数据源转换。它的功能与“工作簿转换”步骤类似。这些转换适用于打包在工作簿内的数据源。已发布的数据源将在流程中的其他步骤中处理。

![带有下拉箭头的标有“添加转换”的按钮。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-transform-add-button.png)

单击“添加转换”下拉菜单，以下选项将会出现：

![数据源转换列表，包括表名替换和 SQL 设置调整。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-transform-datasource-add-list.png)

选择任何数据源转换将会打开“编辑转换”窗口，该窗口允许您将其自定义为所选数据源。所有转换将按其列出顺序从上到下完成。

对于所有不同类型的数据源转换，有两个基本步骤。第一步是输入所需数据源的匹配条件。根据所选的连接类型，将在“匹配条件”选项卡上显示更多字段。

![数据源转换接口，其中包含用于设置新连接值和匹配条件的字段。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-transform-datasource-edit-criteria.png)

单击“预览源连接”查找与所输入条件匹配的任何连接。

![预览数据源转换的表。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-transform-preview.png)

第二步是使用选项选项卡为所选的任何转换输入特定选择。

![用于数据源转换的自定义 SQL 设置界面。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-transform-datasources-edit-options.png)

每个数据源转换都有要在选项选项卡上输入的不同值：

#### 设置计算公式

在“选项”选项卡上，您可以替换列计算。

![包含列名和公式字段的表单。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-transform-calc-set.png)

#### 设置连接信息

在“新建连接值”选项卡上，输入新数据源的身份验证方法和连接详细信息。根据所选的连接类型，将显示更多字段。

**使用 CMT 更改已发布的数据源**

从版本 2022.1 开始，选择“Tableau Server（已发布数据源）”连接类型以更改工作簿的已发布数据源。这可以减少在 Tableau 环境之间迁移工作簿时所需的手动步骤，例如，将内容从开发推广到生产。

若要更改已发布数据源，请从下拉菜单中选择一个数据源，并输入 Tableau 用户名进行身份验证。用户必须存在于目标站点上并具有已发布数据源的“连接”能力。

- 对于基于文件的数据源，用户将访问工作簿并根据指定 Tableau 用户的权限查看数据。
- 对于所有其他数据源，在视图或工作簿加载时会提示用户输入他们自己的数据库凭据。

如果未指定 Tableau 用户名，则只有具有“连接”能力的用户才能查看工作簿中的数据。

![包含已发布数据源和您的 Tableau 用户名的字段的表单。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-transform-set-cx.png)

#### 设置自定义 SQL

在“新建自定义 SQL”选项卡上，输入要为“匹配查询名称”修改的自定义 SQL 查询的名称。查询名称必须与数据源物理层的自定义 SQL 查询名称匹配。如果这些名称不匹配，则转换将失败。有关数据建模和物理层的详细信息，请参见[Tableau 数据模型](https://help.tableau.com/current/server-linux/zh-cn/datasource_datamodel.htm)。

输入查询名称后，在文本字段中输入所需的“自定义 SQL”。请注意，如果使用不当，自定义 SQL 可能会对工作簿的性能产生负面影响。

![一个标有“匹配查询名称”的文本框，和一个标有“自定义 SQL”的更大的文本框。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-transform-set-custom-sql.png)

#### 移除数据提取

此转换没有选项选项卡，只需在“Match Criteria”信息中输入内容，迁移过程中即会移除数据提取。

此外，您还可以在“Edit Transformation”窗口左侧的“Comments ”部分输入有关每个转换的注释。

#### 应用保存的凭据

在版本 2022.3 中已弃用。请改用“设置连接信息”数据源转换。

在选项选项卡上，为数据连接输入 Tableau 用户名和相应的已保存凭据用户名。您只能在 Tableau 站点的“帐户设置”页面上为现有数据连接应用保存的凭据。有关详细信息，请参见[为数据连接管理保存的凭据](https://help.tableau.com/current/server-linux/zh-cn/manage_stored_credentials.htm)。

![两个文本框请求 Tableau 用户名和已保存的凭据用户名。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-datasource-transform-saved-credentials.png)

## 步骤 5：发布选项

“工作簿”阶段的最后一步是选择发布选项并为标记、数据提取刷新计划和权限创建转换。

![工作簿的发布选项包括覆盖控制和权限设置。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-publish-options.png)

#### 重置仪表板选项

此选项会取消选择仪表板上的所有对象。

#### 覆盖较新的工作簿

如果选中此选项，即使工作簿将覆盖已在同一时间创建或者比移动的工作簿更新的工作簿，也会迁移该工作簿。

#### 复制工作簿权限

选中此选项时，迁移工具将尝试尽可能地匹配源工作簿权限。

#### 复制数据提取刷新计划

选中此选项时，迁移工具将尝试将目标工作簿数据提取刷新计划设置为与源的名称相匹配。

**注意：**无法在 Tableau Cloud 中创建数据提取刷新计划。如果目标是 Tableau Cloud 站点，则此选项不可用。有关详细信息，请参见[迁移限制](https://help.tableau.com/current/server-linux/zh-cn/cmt-migration_limitations.htm)。

#### 复制工作簿的嵌入式凭据

复制工作簿中嵌入的数据源的嵌入式凭据。仅在从 Tableau Server 迁移到 Tableau Cloud 站点时可用。有关详细信息，请参见[迁移包含嵌入式凭据的工作簿和数据源](https://help.tableau.com/current/server-linux/zh-cn/cmt-migration_embedded_credentials.htm)。

**注意：**CMT 不支持 OAuth 连接的嵌入式凭证迁移。若要将 OAuth 凭据迁移到目标站点，请使用[“设置连接信息”](#plan_wkbk_data_trans)数据源转换。

#### 复制工作簿所有者

从源位置复制工作簿所有者设置以分配工作簿所有者。如果未选中，Content Migration Tool 用户将获得目标位置中工作簿的所有权。

#### 应用用户映射

应用用户映射来分配内容所有权。如果目标位置的用户名语法存在差异，请选择此选项。有关详细信息，请参见[迁移计划：权限和所有权](https://help.tableau.com/current/server-linux/zh-cn/cmt-plan_users.htm)。

### 添加选项

为您可添加的不同类型的转换单击“Add Option”下拉菜单：

![用于添加工作簿发布选项的界面，包括标记管理和权限设置。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-pub-option-add.png)

对于所有不同类型的转换，有两个基本步骤。第一步是让您选择转换。在本例中，选择要转换的工作簿。选择区域类似于“规划”阶段的“工作簿选择”部分，具有“基本选择”单选按钮的所有功能：“Select/Unselect All”、“Refresh”、“Thumbnail Display”，以及“List Display”。在列表顶部，您可以选择“Select All”工作簿，这是一个用于自动选择所有工作簿以供将来转换的选项。您还可以刷新工作簿显示窗口以反映源站点的所有更改或更新。

![工作簿的标记添加界面，其中包含用于标记选择和应用的字段。](/tableau/current/zh-cn/server-linux/zh-cn/Img/cmt-plan-workbook-pub-option-add-tags.png)

第二步是使用选项选项卡为所选的任何转换输入特定选择。**注意：**选项选项卡将具有不同名称，具体情况视所编辑的转换而定。

#### 添加标记

这允许您向工作簿中添加一个或多个标记。如果将鼠标指针悬停在以前输入的标记上，则会显示一个蓝色“X”以允许删除。

![“编辑选项”对话框，其中包含选择工作簿或添加标记的选项。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-tags-add.png)

#### 移除标记

这允许您向工作簿中添加一个或多个标记。如果将鼠标指针悬停在以前输入的标记上，则会显示一个蓝色“X”以允许删除。您也可以选择从源工作簿或目标工作簿中移除标记。

![用于从工作簿中移除标记的窗口。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-tags-remove.png)

#### 应用数据提取刷新计划

在这里，您可以将目标提取刷新计划应用于迁移的工作簿。生成的计划列表来自目标。

**注意：**无法在 Tableau Cloud 中创建数据提取刷新计划。如果目标是 Tableau Cloud 站点，则此选项不可用。有关详细信息，请参见[迁移限制](https://help.tableau.com/current/server-linux/zh-cn/cmt-migration_limitations.htm)。

![带有用于应用数据提取刷新计划的选项的对话框，包括月底、周六晚上和工作日清晨。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-sched-refresh.png)

#### 设置权限

此转换是编辑所选工作簿的权限。输入组或用户，然后单击“Add”。根据需要调整权限。四种不同选项为：“Allow 权限”、“Deny 权限”、“Inherit”，或“保留Source Value”。

![显示工作簿权限的窗口。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-permissions-set.png)

#### 设置“将缩略图生成为”

这样，您就可以设置迁移后将用于在工作簿缩略图中生成用户特定数据的用户或组。每个选项都有一个下拉列表，用于选择所需的用户或组。

![作为用户或组生成缩略图的对话框。](/tableau/current/zh-cn/server-linux/zh-cn/Img/ptd-plan-workbook-thumbnail-gen.png)

## 步骤 6：继续下一步

选择工作簿和首选项后，单击“Next ”继续进行规划阶段的[迁移计划：已发布数据源](https://help.tableau.com/current/server-linux/zh-cn/cmt-plan_datasources.htm)部分。

## 谁可以执行此操作

具有 Explorer 角色或更高级别角色的 Tableau 站点用户。为了迁移内容，您必须在源站点上具有工作簿的**“查看”**和**“下载”/“保存副本”**能力，并在目标站点上具有目标项目的**“查看”**和**“发布”**能力。有关详细信息，请参见[权限](https://help.tableau.com/current/server-linux/zh-cn/permissions.htm)。