# 映射字段处理器

查找映射表中的值并替换或添加字段

该映射字段处理器允许您通过将其值与查找表进行匹配来标准化或丰富字段，而无需编写脚本。这相当于无代码地加载一个映射表，并在Qlik脚本中使用[ApplyMap](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/MappingFunctions/ApplyMap.htm)函数来应用它。

## 使用

映射字段 处理器需要两个输入流：

* 源表（上游）：一个包含您想要将数据映射到映射表中值的表。

* 映射表（下层流）：一个包含要在源表中查找和替换的值的表。

映射字段 生成一个单一的输出流。

信息注释当您想要直接在数据流中创建一个小的映射表，而不是从数据集或连接加载它时，您可以使用 手动输入 源。请参阅[通过手动输入添加数据](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataFlow/Creating-data-flow.htm#Adding_manual_entry)。

## 属性

需要配置的属性，以便使用 映射字段 映射您的字段。

配置

| 属性 | 配置 |
| --- | --- |
| 要应用映射的字段 | 选择源表中的一个或多个字段，您希望在映射表中查找这些字段的值。 |
| 从字段映射 | 在映射表中选择包含要与在要应用映射的字段中选择的字段进行匹配的值的字段。这是映射表的关键字段，或者说是第一个字段。 |
| 映射到字段 | 选择映射表中包含要在输出中替换的值的字段。这是映射表的值字段，或者说是第二个字段。 |
| 创建新字段 | 启用此开关以将匹配值写入新的自定义命名字段，而不是替换所选要应用映射的字段中的值。当在 要映射的字段 中选择了多个字段时，此选项将隐藏。 |
| 默认值 | 当来自 要应用映射的字段 的值在映射表的 映射源字段 中未找到时，输出中替换的值。 |

要重命名处理器或编辑其描述，请将鼠标指向属性面板中要更改的名称或描述，然后单击 the 编辑 icon图标。

## 示例

此示例中用作源的数据包含客户订单，其中有一个两位字母的CountryCode字段，您希望将其替换为完整的国家/地区名称。

源表格

| OrderID | Customer | CountryCode |
| --- | --- | --- |
| 1001 | A. Smith | US |
| 1002 | M. Dupont | FR |
| 1003 | T. Nakamura | JP |
| 1004 | R. Costa | BR |

映射表

| Code | CountryName |
| --- | --- |
| US | United States |
| FR | France |
| JP | Japan |

连接两个表到 映射字段 处理器，并按如下方式配置属性：

* 要应用映射的字段: CountryCode

* 字段映射: 代码

* 映射到字段: 国家名称

* 创建新字段：已启用，命名为国家

输出流保留了所有来自源表的原始字段，并添加了一个新的国家字段。具有在映射表中找到的CountryCode的记录，例如US、FR或JP，将获得相应的完整国家名称。带有 CountryCode BR 的记录不在映射表中，将获取 未知 默认值。

输出自 映射字段映射字段 处理器

| OrderID | Customer | CountryCode | Country |
| --- | --- | --- | --- |
| 1001 | A. Smith | US | United States |
| 1002 | M. Dupont | FR | France |
| 1003 | T. Nakamura | JP | Japan |
| 1004 | R. Costa | BR | Britain |

![数据流，包含一个映射字段处理器、相应的输入以及一个输出到数据文件](https://help.qlik.com/zh-CN/cloud-services/Subsystems/Hub/Content/Resources/Images/Dataflow/map_fields_example.png)