데이터 맵과 전문

주제 목차 · 이전: 거래 계약 개념 · 다음: CRUD 거래 연결과 검증

이 문서의 결과: 데이터 맵 네 종류와 요청·응답 전문 구조를 설명한다.

데이터 맵 네 종류

거래에서 주고받는 데이터는 묶음(맵) 단위로 다룹니다.

방향	타입	몇 건	화면에서	예
요청	Row	정확히 1건	검색 조건, 단건 폼	분류·제목
요청	List	0건 이상	그리드 여러 행	편집한 행 여러 개
응답	Form	1건	상세 폼	게시글 1건
응답	Grid	여러 건	목록 그리드	게시글 여러 건

BOD010의 LD01은 조건(Row)을 요청해 목록(Grid)을 받고, BOD012의 GD01은 ID(Row)를 요청해 상세(Form)를 받습니다.

화면과 계약의 출력 연결

[화면 HTML]   syn-datafield="Board"
[화면 JS]     outputs: [{ type: 'Grid', dataFieldID: 'Board' }]
[.json 계약]  Outputs: [{ Type: "Grid", ... }]

HTML과 JS의 Board는 같은 출력 컨트롤을 가리킵니다. JSON 계약은 출력의 형식과 순서를 정의하므로 Board라는 이름을 그대로 적는 규칙은 아닙니다. 연결이 어긋나면 응답에 데이터가 있어도 화면에 표시되지 않을 수 있습니다. 정확한 연결 항목은 거래 호출 레퍼런스를 확인하세요.

요청·응답 전문 구조

클라이언트와 서버가 주고받는 전문은 헤더(설명)와 바디(정보)로 구성됩니다.

구성	담긴 정보
요청 헤더(global/system/interface/transaction)	환경, 인증, 요청 시스템, 통신, 거래 업무 정보
요청 본문(payLoad)	실제 데이터 맵
응답(message)	성공/오류 상태와 코드
응답(result)	실제 응답 데이터 맵

전문 필드 하나하나의 정의는 계약 중심 거래에서 확인합니다. 이 문서에서는 "왜 이런 구조가 필요한가"에 집중합니다. 요청마다 이 구조를 다 채우는 것은 화면 개발자가 아니라 syn.$w.transactionAction이 대신 처리합니다.

CRUD 거래 연결과 검증에서 실제 요청과 응답을 대조합니다.