JSON 빌더 단계
다른 단계에서 사용할 JSON 페이로드를 생성합니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다. 이 단계에서는 중첩 구조에 대한 개체 및 배열을 포함하여 여러 데이터 형식을 지원합니다.
역할 및 가용성
이 단계를 수행하려면 통합 허브 구독이 필요합니다. 자세한 내용은 법무 일정 - 통합 허브 개요를 참조하십시오. 필요한 플러그인이 활성화되면 통합 아래에 단계가 표시됩니다.
작업 단계로 워크플로우 스튜디오 사용할 수 있습니다. action_designer 역할을 가진 사용자는 하나 이상의 작업 단계로 사용자 지정 작업을 생성할 수 있습니다.
입력
작업에 필요한 각 입력에 대한 값을 제공합니다. 동적 값을 추가하려면 데이터 패널에서 정제를 끌어서 놓거나 정제 선택기에서 선택할 수도 있습니다.
- 이름
- 데이터 유형: String
이름-값 쌍의 이름 부분입니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다.
- 값
- 데이터 유형: String
이름-값 쌍의 값 부분입니다. 값을 입력하거나 데이터 알약을 사용하여 동적 페이로드를 생성합니다. 복합 개체 정제를 사용하여 개체 데이터 형식으로 행을 채울 수 있지만 이렇게 하면 복합 개체 알약에 이미 있는 자식이 삭제됩니다.
- 유형
- 데이터 유형: Choice이름-값 쌍의 데이터 유형입니다. 이름 또는 값에 데이터 정제를 사용하는 경우 알약의 데이터 유형이 여기에서 선택한 데이터 유형과 일치하는지 확인합니다. 옵션은 다음과 같습니다.
- 문자열
- 개체
- 번호
- 부울
- 배열
배열과 객체의 경우, 더하기 아이콘(
)을 사용하여 배열 또는 객체에 이름-값 쌍을 추가합니다. - 빈 값인 경우
- 데이터 유형: Choice이름-값 쌍에 비어 있거나 null 값이 있는 경우 수행할 작업을 지정하는 옵션입니다.
- 그대로 두기: 비어 있거나 null 값을 빈 문자열로 유지합니다.
- 속성 생략: 값이 비어 있거나 null인 경우 이름-값 쌍을 제외합니다.
- Set as null: 비어 있거나 null 값을 null 데이터 형식으로 반환합니다.
- Throw 오류: 이름-값 쌍에 비어 있거나 null 값이 있는 경우 오류를 반환합니다.
- 외부 구조 포함
- 데이터 유형: True/False
최상위 JSON 컨테이너에 중괄호를 포함하는 옵션입니다.
- 빈 구조 생략
- 데이터 유형: True/False
빈 페이로드를 생략하는 옵션입니다. 빈 페이로드는 모든 이름-값 쌍에 대해 In case of empty value 입력에 대해 속성 생략을 선택하면 발생할 수 있으며 페이로드의 모든 이름-값 쌍은 빈 값을 생성합니다.
- 구조
- 데이터 유형: Structure
단계에서 생성하는 읽기 전용 페이로드입니다.
- 이 단계가 실패할 경우
- 데이터 유형: Choice
다음 단계를 계속 실행하거나 오류 평가로 이동하는 옵션입니다. 사용자 지정 작업 오류 조건에 대한 단계 상태 코드 또는 메시지를 사용하려면 문서를 참조하십시오 Action error evaluation.
출력
이러한 출력은 데이터 패널에 표시됩니다. 이러한 항목을 작업의 다른 곳에서 입력으로 사용할 수 있습니다.
- 출력
- 데이터 유형: String
문자열로 된 JSON 페이로드입니다. 페이로드를 객체로 사용하려면 JSON 파서 단계를 사용하여 문자열을 구문 분석할 수 있습니다.
- 단계 상태
- 데이터 유형: Object
단계에 대한 런타임 상세 정보를 포함하는 객체 데이터 정제입니다. 작업의 각 단계는 단계 상태를 반환합니다.
- 단계 상태 > 코드
- 데이터 유형: Integer
단계에서 오류가 발생했는지 여부를 나타내는 정수 데이터 정제입니다. 기본적으로 값 1은 단계에서 오류가 발생했음을 나타냅니다. 값이 0이면 단계가 성공적으로 실행되었음을 나타냅니다. 이러한 코드는 사용자 지정할 수 없습니다.
- 단계 상태 > 메시지
- 데이터 유형: String
단계 또는 시스템 운영에서 생성된 오류 메시지가 포함된 문자열 데이터 알약입니다. 이 메시지는 사용자 지정할 수 없습니다.
JSON 페이로드 작성
페이로드용 JSON 추가 버튼을 사용하여 JSON 페이로드를 자동으로 생성합니다. 이 버튼을 클릭하면 JSON 페이로드를 입력하여 구조화된 입력으로 자동 역직렬화할 수 있는 페이로드 추가 스크립트 편집기가 열립니다.
- JSON에 빈 키가 있어도 페이로드가 계속 생성됩니다.
- 스크립트 편집기에 중복 키가 있는 경우 객체의 마지막 키 항목은 동일한 이름의 이전 키 값을 재정의합니다.
- 루트 객체가 배열인 경우 루트 배열은 루트 객체로 래핑됩니다.
- 배열에 여러 개체가 포함된 경우 개체의 모든 키가 하나의 부모 개체로 병합됩니다.
- 빈 페이로드
- 복잡하지 않은 객체 유형
- 잘못된 JSON
- 빈 배열과 같은 빈 루트 객체
- 65,000바이트보다 큰 페이로드