양식 화면 (Form)
양식 화면은 데이터를 입력하고 수정하는 화면입니다. 컬럼 타입에 따라 텍스트 입력, 드롭다운 선택, 달력, 토글 스위치 등 적절한 입력 도구가 자동으로 배치됩니다.
소개
양식(Form) 화면은 새로운 데이터를 등록하거나 기존 데이터를 수정할 때 사용합니다. 테이블의 각 컬럼이 양식의 입력 필드로 변환되며, 컬럼 타입에 따라 가장 적합한 UI가 자동 제공됩니다.
이렇게 보입니다
전체 화면
양식 화면의 전체 모습입니다. 각 필드가 컬럼 타입에 맞는 입력 도구로 표시됩니다.
컬럼 타입별 필드 렌더링
각 컬럼 타입이 양식에서 어떤 입력 도구로 나타나는지 정리합니다:
| 컬럼 타입 | 양식 UI | 특징 |
|---|---|---|
| VARCHAR | 한 줄 텍스트 입력 | 최대 길이 제한 |
| TEXT | 여러 줄 텍스트 영역 | 높이 조절 가능 |
| INT / BIGINT | 숫자 입력 (위아래 화살표) | 정수만 허용 |
| DECIMAL | 소수점 숫자 입력 | 소수점 자릿수 제한 |
| BOOLEAN | 토글 스위치 | ON/OFF 전환 |
| DATE | 달력 선택기 | 클릭하면 달력 팝업 |
| TIMESTAMP | 날짜+시간 선택기 | 날짜와 시간 모두 선택 |
| ENUM | 드롭다운 선택 | 미리 정의된 항목 중 선택 |
| JSON | JSON 편집기 | 구조화 데이터 입력 |
| FILE | 파일 업로드 영역 | 드래그앤드롭 또는 클릭 |
| FK (외래키) | 드롭다운 + 검색 | 참조 테이블에서 선택 |
주요 기능
FK 검색 모달
FK 필드에서 돋보기 아이콘을 클릭하면 참조 테이블을 검색할 수 있는 모달(팝업)이 열립니다.
FK(외래키) 필드에서 데이터를 선택할 때:
| 거래처코드 | 거래처명 | 사업자번호 |
|---|---|---|
| V001 | (주)A사 | 123-45-67890 |
| V002 | (주)B사 | 234-56-78901 |
| V003 | (주)C사 | 345-67-89012 |
- 검색창에 키워드를 입력하면 실시간으로 필터링됩니다
- 원하는 항목을 클릭하고 "선택" 버튼을 누릅니다
- 선택된 값이 양식 필드에 자동으로 채워집니다
유효성 검사
필수 항목을 입력하지 않거나 형식이 맞지 않으면 오류 메시지가 표시됩니다.
양식에서 "저장" 버튼을 클릭하면 자동으로 유효성 검사가 수행됩니다:
| 검사 항목 | 오류 메시지 예시 |
|---|---|
| NOT NULL 위반 | "품목코드는 필수 항목입니다" |
| UNIQUE 위반 | "이미 존재하는 품목코드입니다" |
| 타입 불일치 | "숫자만 입력할 수 있습니다" |
| 범위 초과 | "최대 255자까지 입력할 수 있습니다" |
오류가 있는 필드는 빨간색 테두리로 강조되고, 필드 아래에 오류 메시지가 표시됩니다.
임시저장
양식을 작성하다가 실수로 페이지를 떠나도, 임시저장 기능으로 작성 중이던 내용을 복구할 수 있습니다.
| 기능 | 설명 |
|---|---|
| 자동 임시저장 | 일정 시간 간격으로 자동 저장 |
| 수동 임시저장 | "임시저장" 버튼 클릭 |
| 복구 | 다시 양식을 열면 "임시저장된 내용이 있습니다. 복구하시겠습니까?" 알림 |
긴 양식을 작성할 때는 중간중간 임시저장을 활용하세요. 브라우저가 갑자기 닫히더라도 내용을 복구할 수 있습니다.
레이아웃 설정
양식의 필드 배치를 설정할 수 있습니다:
| 설정 | 옵션 |
|---|---|
| 1단 배치 | 필드를 세로로 한 줄씩 (기본) |
| 2단 배치 | 필드를 2열로 나란히 배치 |
| 3단 배치 | 필드를 3열로 배치 |
| 필드 순서 | 드래그로 필드 순서 변경 |
| 필드 숨기기 | 특정 필드를 양식에서 숨김 |
| 읽기 전용 | 특정 필드를 수정 불가로 설정 |
| 구분선 | 필드 그룹 사이에 구분선 추가 |
실무 예시
상황: 구매팀에서 발주서를 작성합니다.
발주서 양식 필드 구성:
| 필드 | 타입 | 설명 |
|---|---|---|
| 발주번호 | VARCHAR (자동채번) | 읽기 전용, 자동 생성 |
| 거래처 | FK (거래처 마스터) | 드롭다운 + 검색 모달 |
| 발주일자 | DATE | 달력 선택, 기본값: 오늘 |
| 납품요청일 | DATE | 달력 선택 |
| 담당자 | SYSTEM_REF (사용자) | 현재 로그인 사용자 자동 입력 |
| 비고 | TEXT | 여러 줄 텍스트 |
자주 묻는 질문
Q: 양식에서 특정 필드를 숨기고 싶어요. A: 속성 패널의 필드 설정에서 "숨김" 옵션을 활성화하면 해당 필드가 양식에 표시되지 않습니다.
Q: 양식을 열 때 특정 필드에 기본값을 넣고 싶어요. A: 테이블의 컬럼 설정에서 DEFAULT 값을 지정하거나, 양식 설정에서 초기값을 설정할 수 있습니다.
Q: 저장 후 어떤 화면으로 이동하나요? A: 기본적으로 목록 화면으로 돌아갑니다. 설정에서 "저장 후 상세 화면으로 이동" 등으로 변경할 수 있습니다.
Q: 양식에서 파일을 여러 개 첨부할 수 있나요? A: FILE 컬럼 설정에서 "다중 파일" 옵션이 활성화되어 있으면 여러 파일을 첨부할 수 있습니다.