본문으로 건너뛰기

Multi-Row Input

Multi-Row Input은(는) 하위 필드로 추가 및 삭제 가능한 객체 배열을 편집합니다. 이 필드는 Form의 상태, 검증 및 제출 범위에 포함됩니다.

1. 사용 시점​

일반적인 용도:

  • 비상 연락처
  • 주문 항목 및 비용 행
  • 개수가 제한된 반복 업무 레코드

2. 추가 및 구성​

  1. Form Section의 Fields 영역에 Multi-Row Input을(를) 추가합니다.
  2. 백엔드 DTO 속성과 일치하는 안정적이고 고유한 Field Key / Name을 설정합니다.
  3. 아래의 컴포넌트 속성을 구성하고 필요에 따라 Required, Help Text, Full row 또는 조건식을 추가합니다.
  4. Design Preview에서 초기값과 레이아웃을 확인한 다음 Form Validate / Submit으로 전체 데이터 경로를 테스트합니다.

3. 주요 속성​

속성역할
Fields바인딩, 제출 또는 응답에 사용하는 데이터 형태를 정의합니다.
Max Rows허용되는 개수, 길이 또는 값 범위를 제한합니다.
Show Label / Show HeaderDesign Preview와 Runtime에서 필드가 표시되는 방식을 제어합니다.
Table LayoutDesign Preview와 Runtime에서 필드가 표시되는 방식을 제어합니다.
Hide New / Hide Delete이 동작을 켜거나 끕니다.
Validator바인딩, 제출 또는 응답에 사용하는 데이터 형태를 정의합니다.

Field Key, Required, Help Text, Full row, Visible When 같은 공통 속성은 Form 필드 계약에서 제공합니다. 표에는 Multi-Row Input에 특히 중요한 설정을 정리했습니다.

4. Form 값과 백엔드 계약​

제출 값: 하위 필드의 Field Key를 속성으로 갖는 객체 배열입니다.

[
  {"name": "Alex", "relationship": "Manager", "phone": "+1 555 0100"}
]

예시는 데이터 형태만 보여 줍니다. API는 업무 DTO에 따라 형식, 범위 및 권한을 계속 검증해야 합니다.

5. 검증, 조건 및 인터랙션​

모든 필드에서 Required, Visible When, Disabled When, Required When, Dependencies, Clear When Hidden을 사용할 수 있습니다. 조건식은 사용성을 높이지만 백엔드 검증이나 권한을 대체하지 않습니다.

컴포넌트 기능: setValue를 지원하여 버튼, Step 또는 다른 작업에서 값을 쓸 수 있습니다.

6. 구성 권장 사항​

권장 사항: 먼저 요청 및 응답 JSON 계약을 고정한 뒤 배열 항목, 파일 메타데이터 및 서버 오류 경로를 종단 간 테스트하세요.

레이아웃, 검증, 제출, 초안 및 백엔드 프로토콜은 Form 개요를 참고하세요.

최종 수정: 에