JSON 패키지의 유효성 검사 작업을 사용하면 JSON 데이터 소스의 내용을 검증할 수 있습니다. 이 작업을 사용하여 모든 JSON 소스의 구문, 구조 및 스키마를 검증할 수 있습니다.

개요

유효성 검사 작업을 사용하면 JSON 데이터 소스를 다운스트림 작업에 전달하기 전에 잠재적인 오류를 확인할 수 있습니다. 이 작업은 런타임 실패를 방지하고 디버깅 시간을 줄여 자동화의 신뢰성을 개선합니다. JSON 데이터 소스를 지정하고, 유효성 검사 수준을 설정하며 검증 결과를 여러 변수나 하나의 사전 변수에 저장할 수 있습니다.

유효성 검사 작업은 파일 스트리밍 기능을 지원합니다. 파일 스트림을 처리할 수 있는 아무 작업이나 사용하여 파일 스트림을 저장하는 파일 변수를 생성한 후 해당 파일 변수를 JSON 데이터 소스로 사용할 수 있습니다.

유효성 검사 수준

이 작업에서 사용할 수 있는 유효성 검사 수준은 다음과 같습니다.

형식
형식 옵션은 형식 및 문법과 같은 구문 규칙에 대해 JSON 데이터 소스를 검증합니다. 이 옵션을 사용하면 중괄호 {}, 대괄호 [], 콜론 :, 쉼표 ,, 문자열 큰따옴표, True, False, Null과 같은 JSON 리터럴 등 JSON 문법 규칙의 올바른 사용을 확인할 수 있습니다.
이 유효성 검사 수준은 사전 변수를 데이터 소스로 선택할 때 사용할 수 없습니다.
노드
노드 옵션은 특정 노드의 존재 및 올바른 데이터 유형과 같은 구조 규칙에 대해 JSON 데이터 소스를 검증합니다. 이 옵션을 사용하면 노드 키 또는 노드 경로를 지정하여 노드의 존재 여부를 확인할 수 있습니다. 지정된 노드의 예상 데이터 유형도 값 유형 드롭다운에서 지정해야 합니다.
스키마
스키마 옵션은 JSON 데이터 소스가 지정된 스키마 정의를 따르는지 검증합니다. 이 옵션은 JSON 스키마가 JSON 문법, 노드, 데이터 유형, 필수/선택 사항 필드, 열거형 값, 최대/최소 값을 정의하므로 형식 및 노드 옵션 모두를 포함합니다.
주: 스키마 정의 파일 변수 또는 문자열에 JSON 스키마 초안 버전을 지정해야 합니다. 버전을 지정하지 않으면 유효성 검사 작업은 JSON 데이터 소스를 검증하기 위한 기본 옵션으로 JSON 스키마 초안 2020-12 사양을 사용합니다.

유효성 검사 결과

유효성 검사 작업을 통해 유효성 검사 결과를 개별 변수 또는 단일 사전 변수로 저장할 수 있습니다. 자동화 실행은 JSON 데이터 소스에 Null 값이 존재하는 것과 같은 플랫폼 오류가 있을 경우에만 실패합니다. 유효성 검사 결과는

isvalid 키에 저장됩니다.
isvalid 키에는 JSON 소스의 유효성 검사 결과가 포함되어 있습니다. 다음은 가능한 값들입니다.
  • true: 유효성 검사가 성공적으로 완료되었습니다.
  • false: 유효성 검사에 실패한 경우.
유효성 검사 수준
validationlevel 키에는 작업을 구성할 때 설정한 유효성 검사 수준이 포함되어 있습니다. 다음은 가능한 값들입니다.
  • 구문: 유효성 검사 수준이 형식으로 설정된 경우.
  • 구조: 유효성 검사 수준이 노드로 설정된 경우.
  • 스키마: 유효성 검사 수준이 스키마로 설정된 경우.
errorpath
errorpath 키에는 오류가 발생한 JSON 데이터 소스의 경로가 포함되어 있습니다.
에러 메시지
오류 메시지 키에는 오류 메시지가 포함되어 있습니다. 예를 들어, JSON 스키마에서 숫자를 정의했지만 JSON 데이터 소스에 동일한 위치에 문자열이 제공된 경우, 오류 메시지 키는 해당 오류 메시지인 문자열 발견됨, 정수 예상됨을 값으로 저장합니다.