验证操作
- Updated: 2026/02/23
JSON 软件包中的验证操作可让您验证 JSON 数据源的内容。 您可以使用此操作来验证任何 JSON 源的语法、结构和架构。
概览
验证操作使您能够在将 JSON 数据源传递给任何下游操作之前，检查其中是否存在潜在错误。 此操作通过防止运行时故障并减少调试时间，提高了自动化的可靠性。 您可以指定 JSON 数据源，设置验证级别，并将验证结果保存到多个变量或单个字典变量中。
验证操作支持文件流式传输功能。 您可以使用任何支持文件流的操作来创建一个文件变量，该变量用于保存文件流，并将该文件变量用作 JSON 数据源。
验证级别
以下验证级别适用于此操作：
- 格式
- 格式选项用于根据格式和语法等语法规则验证 JSON 数据源。 此选项可用于检查 JSON 语法规则的正确使用，包括花括号 {}、方括号 []、冒号 :、逗号 ,、字符串双引号，以及 JSON 字面量，例如 true、false 和 null。
- 节点
- 节点选项会根据结构规则验证 JSON 数据源，例如特定节点的存在及其正确的数据类型。 此选项使您能够通过指定节点键或节点路径来检查节点是否存在。 您还必须在值类型下拉菜单中指定所选节点的预期数据类型。
- 架构
-
架构选项用于验证 JSON 数据源是否符合指定的架构定义。 此选项包含了格式和节点两个选项，因为 JSON 架构定义了 JSON 语法、节点、数据类型、必填/可选字段、枚举值以及最大/最小值。注： 请确保在架构定义文件变量或字符串中指定 JSON 架构草案版本。 如果您未指定版本，验证操作将默认采用
JSON 架构草案 2020-12规范对 JSON 数据源进行验证。
验证结果
验证操作使您能够将验证结果保存为单独的变量或一个字典变量。 只有在出现平台故障（例如 JSON 数据源中存在值 Null）时，自动化执行才会失败。 验证结果存储在以下键中：
- isvalid
-
isvalid 键包含 JSON 源的验证结果。 以下是可能的取值：
- true： 如果验证成功。
- false： 如果验证失败。
- validationlevel
-
validationlevel 键包含您在配置操作时设置的验证级别。 以下是可能的取值：
- syntax： 如果验证级别设置为格式。
- structure： 如果验证级别设置为节点。
- schema： 如果验证级别设置为架构。
- errorpath
- errorpath 键包含 JSON 数据源中出现错误的位置路径。
- error message
- error message 键包含错误消息。 例如，如果 JSON 架构定义为数字，但 JSON 数据源在相同位置提供了字符串，则 error message 键会将此发现字符串，期望为整数错误消息作为其值存储。