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