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