XML 변환
데이터 변환형변환
XML↔JSON 변환을 수행한다.
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 타입 | ssemworks-microservice-base.xml |
| 표시 이름 | XML 변환 |
| 카테고리 | 데이터 변환 |
| 그룹 | transform |
| 버전 | 1 |
입출력
- 입력: 메인(main)
- 출력: 메인(main)
파라미터
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 모드 | mode | 선택 | xmlToJson | 변환 방향 선택지: XML → JSON( xmlToJson) · JSON → XML(jsonToxml) |
| 필드명 | dataPropertyName | 문자열 | data | xmlToJson: XML 문자열이 담긴 입력 필드명. jsonToxml: 변환 결과(XML 문자열)를 저장할 필드명 |
| 옵션 | options | 컬렉션 | {} | 표시 조건: mode = "xmlToJson" |
| 옵션 | options | 컬렉션 | {} | 표시 조건: mode = "jsonToxml" |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 속성 키 | attrkey | 문자열 | $ | XML 속성을 담을 JSON 키. proto/constructor/prototype은 금지 |
| 문자 키 | charkey | 문자열 | _ | XML 텍스트 노드를 담을 JSON 키. proto/constructor/prototype은 금지 |
| 항상 배열로 | explicitArray | 불리언 | false | 자식 요소를 항상 배열로 감쌀지 여부 |
| 루트 요소 포함 | explicitRoot | 불리언 | true | 결과에 루트 요소를 포함할지 여부 |
| 속성 무시 | ignoreAttrs | 불리언 | false | XML 속성을 결과에서 제외할지 여부 |
| 속성 병합 | mergeAttrs | 불리언 | true | 속성을 별도 키 대신 요소 객체에 병합할지 여부 |
| 공백 정규화 | normalize | 불리언 | false | 텍스트의 연속 공백을 정규화할지 여부 |
| 태그명 소문자화 | normalizeTags | 불리언 | false | 태그명을 소문자로 정규화할지 여부 |
| 텍스트 트림 | trim | 불리언 | false | 텍스트 노드의 앞뒤 공백을 제거할지 여부 |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 속성 키 | attrkey | 문자열 | $ | 속성으로 취급할 JSON 키. proto/constructor/prototype은 금지 |
| 문자 키 | charkey | 문자열 | _ | 텍스트 노드로 취급할 JSON 키. proto/constructor/prototype은 금지 |
| 서로게이트 문자 허용 | allowSurrogateChars | 불리언 | false | 옵션값은 수용되나 이 노드에서는 항상 허용되어 실제 동작에 영향 없음 |
| CDATA 사용 | cdata | 불리언 | false | 텍스트 노드를 CDATA 섹션으로 감쌀지 여부 |
| XML 선언 생략 | headless | 불리언 | false | true면 <?xml ...?> 선언을 생략 |
| 루트 요소명 | rootName | 문자열 | root | 생성할 XML의 루트 요소명 |