跳转到主要内容
CSV 端口可以将逗号分隔值 (CSV) 文件转换为 XML,也可以从 XML 生成 CSV 文件。

核心功能

  • 支持 CSV/XML 双向转换,具有可配置的分隔符和编码
  • 具有标头检测和自定义列映射能力
  • 支持各种字符编码和特殊字符处理

概览

端口配置

本节包含所有可配置的端口属性。

设置

配置

与端口 Id 和描述相关的设置。

端口设置

与端口核心操作相关的设置。

其他设置

未包含在先前类别中的设置。

示例文件选项卡

高级页面 (Advanced Tab)

消息

日志

其他设置

自动化页面 (Automation Tab)

自动化设置

性能

通知选项卡

SLA 选项卡

将 CSV 转换为 XML

文件转换为 XML,得到的 XML 将包含以下结构:
原始文件中的每一行(记录)都成为根元素 Items 的子元素。所有记录元素的名称由端口设置中设置的 记录名称 选项确定。每个记录元素都有与输入文件每行中的值相对应的子元素。 某些 文件包含一行消息头信息,为文件中的值提供上下文。当启用 存在列标题 设置时,将解析此标题行,并将解析后的标题用作值元素(记录元素的子元素)的元素名称。否则,值元素将被赋予通用名称,例如 field_0field_1 等。

将 XML 转换为 CSV

要将 XML 转换为 文件,输入 XML 必须具有“平面”结构。这意味着,忽略 Items 根元素,XML 结构的深度为 2。例如:
XML 解释如下:
  • 根元素的子元素在结果文件中被视为记录(行)
  • 每个记录元素的子元素被视为每行中的值
如果启用 存在列标题 选项,则会将标题行插入到生成的 文件中,其中包含每个值元素的名称,以提供值的上下文。在上面的示例中,此标题行将由 titleyearruntime 组成。

打印视图

CSV 转换:使用 XML Map 端口

CSV 运算器

除了知行之桥提供的操作之外,端口还可以提供将功能扩展到 ArcScript 中的操作。 这些端口操作可以像任何其他 ArcScript 操作一样调用,但有两个细节除外:
  1. 它们必须通过 connector.rsc 端点调用。
  2. 它们必须包含认证令牌。
例如,使用这两条规则调用端口操作可能如下所示:
下面列出了 CSV 端口功能特定的操作。

csvListRecords

循环遍历指定 CSV 文件或字符串中的每条记录。有关更多详细信息,请参阅函数

必需参数

  • file: CSV 文件的路径。

可选参数

  • data: 如果 CSV 数据以字符串形式存在,而不是存储在 CSV 文件中,请使用此参数代替 file
  • columns: 输出中要包含的列的逗号分隔列表(如果未指定,将包含所有列)。
  • requireheader: 默认情况下,数据的第一行会被解释为列标题;向此参数传入 false 时,将使用通用列名(例如 c1、c2、c3)。

输出

csvListRecords 操作中的任何脚本都会执行多次:对输入 CSV 文件/数据中的每条记录/行执行一次。在操作中,可以使用 csv 格式化器访问各个 CSV 值。此格式化器将列名作为参数,并输出当前记录中该列的值。 例如,假设 CSV 输入数据包含订单中购买的一组商品,商品名称保存在 ItemName 列中。以下脚本生成 XML,在 Item 元素中包含每个 ItemName 值:

示例