JSON 端口

JSON 端口支持将 XML 数据转换为 JSON，将 JSON 数据转换为 XML。

核心功能

JSON 与 XML 之间的双向转换，支持自动格式检测
仅需极简配置（端口通常可以使用默认配置正常工作）
可配置属性前缀及文本属性处理，确保翻译准确
自定义格式选项，包括压缩（Minification）及根元素命名
类型转换支持，具备 JSON 类型注释功能以实现精确的数据处理

概述

JSON 端口以最少的配置在 JSON 和 XML 之间进行转换。端口会自动检测输入文件是 JSON 还是 XML，然后将文件转换为其他格式。端口支持可配置的语法来区分属性并确保输出是有效的 XML 或 JSON。

端口设置

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

设置选项卡

端口设置

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

设置	说明
端口 ID	端口的静态唯一标识符。
端口类型	显示端口名称及其功能说明。
端口说明	可选字段，用于自由填写端口及其在流中角色的描述。
根元素名称	从 JSON 转换为 XML 时，此值用作生成的 XML 文档中根元素的名称。这确保输出 XML 具有单个根元素，而不管输入 JSON 的结构如何。
属性前缀	用于标识 JSON 中的属性的前缀。从 JSON 转换为 XML 时，端口会将带有此前缀的值解释为结果 XML 中的属性。从 XML 转换为 JSON 时，端口会将此前缀添加到生成的 JSON 中的属性值。请参阅转换示例部分了解更多信息。
文本属性名称	当 JSON 对象具有属性值和非属性值时，此名称标识非属性值。从 JSON 转换为 XML 时，与此名称关联的值将在生成的 XML 元素的文本中设置。从 XML 转换为 JSON 时，元素中的文本将设置为此名称的值。请参阅转换示例部分了解更多信息。
最小化输出	启用后，此选项会指示端口减少生成的 XML 或 JSON 文档中的空格。此选项可节省空间，但可能会使人类更难以阅读输出。

其他设置

设置	说明
无效的 XML 名称前缀	当 JSON 元素的名称不是有效的 XML 名称时，端口会将此前缀添加到 XML 元素名称的开头。例如，如果 JSON 元素名为 `10price`，则必须修改该名称才能转换为 XML。因为 JSON 元素名称可以以数字开头，但 XML 元素名称不能。如果将此字段设置为 `num`，则 `10price` JSON 元素在 XML 输出中将变为 `num10price`。
本地文件命名方案	用于为端口输出的消息分配文件名的方案。您可以在文件名中动态使用宏，以包含标识符和时间戳等信息。有关更多信息，请参阅宏。

高级选项卡

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置	描述
保存到已发送文件夹	选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案	端口根据选定的时间间隔对已发送文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在已发送文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

设置

描述

保存到已发送文件夹

选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。

已发送文件夹方案

端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口，使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置	描述
日志级别	指定要记录在端口日志目录中的信息类型： None - 不创建任何日志。 Error - 仅当端口遇到错误时才创建日志。 Warning - 仅当端口发出警告时才创建日志。 Info - 记录工作流的一般信息，包括任何错误和警告（如果适用）。 Debug - 记录成功和失败工作流的详细调试信息。 Trace - 记录成功和失败工作流的详细跟踪信息。请注意：Debug 和 Trace 级别的日志可能会记录敏感信息，包括消息内容和 SSL 证书。尽管连接属性（例如密码）被屏蔽了，但在与您的组织外部共享它们之前，请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构	指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如，Weekly 选项指示端口每周创建一个新的子文件夹，并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口，使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本	指示端口在日志目录中保存最新消息副本的切换。请注意，端口每个子文件夹只保留一个消息，并且端口在再次运行时会覆盖以前保存的消息。

其他设置

设置	说明
处理延迟	放置在事务选项卡中的文件被延迟处理的时间（以秒为单位）。这是一个旧版设置。最佳做法是使用文件端口来管理本地文件系统，而不是使用此设置。

杂项

特殊设置适用于特定用例。

设置	描述
其他设置	允许在以分号分隔的列表中配置隐藏的端口设置，例如 `setting1=value1;setting2=value2`。正常的端口用例和功能不需要使用这些设置。

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

设置	说明
发送	指示端口在文件准备就绪时自动发送的开关。

性能

与端口资源分配相关的设置。

设置	描述
最大工作线程数	此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置，则会覆盖高级设置页面的性能设置部分的默认设置。
最大文件数	分配给端口的每个线程发送的最大文件数。如果设置，则会覆盖高级设置页面的性能设置部分的默认设置。

警报选项卡

SLA 选项卡

宏

示例

转换示例

下面是使用 JSON 端口在 XML 和 JSON 之间转换的示例。

XML to JSON

XML 输入：

<Fable>
  <Author alive="false">Aesop</Author>
  <Title>Tortoise and the Hare</Title>
  <Characters>
    <Character id="1" slow="true">Tortoise</Character>
    <Character id="2" slow="hardly">Hare</Character>
  </Characters>
  <Moral>Persistence over speed</Moral>
</Fable>

JSON 输出：

{
  "Fable": {
    "Author": {
      "@alive":"false",
      "#text":"Aesop"
    },
    "Title":"Tortoise and the Hare",
    "Characters": {
      "Character": [
        {
          "@id":"1",
          "@slow":"true",
          "#text":"Tortoise"
        },
        {
          "@id":"2",
          "@slow":"hardly",
          "#text":"Hare"
        }
      ]
    },
    "Moral":"Persistence over speed"
    }
}

JSON to XML

JSON 输入：

{ 
  "Catch": [
    {
      "type": "salmon",
      "quantity": "2",
      "weight": "20.2 lbs"
    },
    {
      "type": "pike",
      "quantity": "21",
      "weight": "521 lbs"
    }
  ],
  "Lake": "Boulder",
  "Weather": "Clear",
  "808s": "Loud" 
}

XML 输出：

<Items>
  <Catch>
    <type>salmon</type>
    <quantity>2</quantity>
    <weight>20.2 lbs</weight>
  </Catch>
  <Catch>
    <type>pike</type>
    <quantity>21</quantity>
    <weight>521 lbs</weight>
  </Catch>
  <Lake>Boulder</Lake>
  <Weather>Clear</Weather>
  <_808s>Loud</_808s>
</Items>

JSON 类型转换

从 XML 转换为 JSON 时，端口将所有 XML 元素视为字符串，但以下两种情况除外：

如果端口在 XML 输入的同一 XML 结构中检测到多个元素或值，它会将它们视为一个数组。
如果您应用 XML 属性来指定 JSON 输出格式，则此属性会覆盖默认的 string 行为。这些属性在下表中列出。

属性	说明
json:array=“true”	如果您有一个单元素数组，可以应用此属性以确保端口将其视为数组而非字符串。
json:type=“number”	指示端口将 XML 元素视为数字。
json:type=“boolean”	指示端口将 XML 元素视为布尔值。
json:type=“object”	指示端口将 XML 元素视为对象。
json:type=“null”	端口将空的 XML 元素视为长度为零的字符串。此命令强制输出为 `null` 而不是空字符串。
xsi:nil=“true”	与 json:type=“null” 功能相同。

入门指南

工作流

EDI 交易伙伴管理控制台

端口

映射

系统 API

操作指南

脚本编写

软件许可和第三方版权

核心功能

概述

端口设置

设置选项卡

端口设置

其他设置

高级选项卡

消息

日志

其他设置

杂项

自动化选项卡

自动化设置

性能

警报选项卡

SLA 选项卡

宏

示例

转换示例

XML to JSON

JSON to XML

JSON 类型转换

​核心功能

​概述

​端口设置

​设置选项卡

​端口设置

​其他设置

​高级选项卡

​消息

​日志

​其他设置

​杂项

​自动化选项卡

​自动化设置

​性能

​警报选项卡

​SLA 选项卡

​宏

​示例

​转换示例

​XML to JSON

​JSON to XML

​JSON 类型转换

核心功能

概述

端口设置

设置选项卡

端口设置

其他设置

高级选项卡

消息

日志

其他设置

杂项

自动化选项卡

自动化设置

性能

警报选项卡

SLA 选项卡

宏

示例

转换示例

XML to JSON

JSON to XML

JSON 类型转换