열에는 모델 기반 앱 폼 또는 그리드의 데이터가 포함됩니다.
formContext.data.entity.attributes 컬렉션 또는 바로 가기 메서드를 formContext.getAttribute 사용하여 열 컬렉션에 액세스합니다. 컬렉션에 대한 자세한 내용은 컬렉션(클라이언트 API 참조)을 참조하세요.
컬렉션 내의 열에 액세스하려면 열의 이름(문자열) 또는 인덱스 값(숫자)을 메서드에 인수로 전달합니다. 예: formContext.getAttribute(arg). 인수를 지정하지 않으면 메서드는 폼에 있는 모든 특성의 컬렉션을 반환합니다.
열은 형식별로 분류됩니다. getAttributeType 메서드를 사용하여 열 형식을 확인합니다. 특정 열 메서드는 특정 유형의 열에만 사용할 수 있습니다.
이 문서에서는 각 열 형식에 사용할 수 있는 메서드에 대한 정보를 제공합니다.
모든 열 형식
컨트롤 속성은 열과 연결된 컨트롤 컬렉션을 제공합니다.
다음 메서드는 모든 열 형식에 사용할 수 있습니다.
| Method | Description |
|---|---|
| addOnChange | 열의 OnChange 이벤트가 발생할 때 실행할 함수를 추가합니다. |
| fireOnChange | 열의 OnChange 이벤트를 트리거합니다. |
| getAttributeType | 열의 형식을 반환합니다. |
| getFormat | 열의 형식을 반환합니다. |
| getIsDirty | 열에 저장되지 않은 변경 내용이 있는지 여부를 반환합니다. |
| getName | 열의 논리적 이름을 반환합니다. |
| getParent | 부모 formContext.data.entity 객체를 반환합니다. |
| getRequiredLevel | 열 값이 필요한지 아니면 권장되는지를 반환합니다. |
| getSubmitMode | 저장 시 열의 데이터가 제출될 때를 반환합니다. |
| getUserPrivilege | 열 값을 만들거나 읽거나 업데이트할 수 있는 사용자의 권한을 반환합니다. |
| getValue | 열의 데이터 값을 반환합니다. |
| isValid | 열의 값이 유효한지 여부를 반환합니다. |
| removeOnChange | 열의 OnChange 이벤트 처리기에서 함수를 제거합니다. |
| setIsValid | 열의 유효성 및 오류 메시지를 설정합니다. |
| setRequiredLevel | 저장하기 전에 열 값이 필요한지 또는 권장되는지를 설정합니다. |
| setSubmitMode | 열의 데이터가 저장 시 제출되는지 여부를 설정합니다. |
| setValue | 열의 데이터 값을 설정합니다. |
부울 열 형식
부울 열 형식은 모든 열 형식에 사용할 수 있는 메서드 외에도 다음 메서드를 제공합니다.
| Method | Description |
|---|---|
| getInitialValue | 폼이 열릴 때 열의 값을 반환합니다. |
조회 열 형식
조회 열 형식은 모든 열 형식에 사용할 수 있는 메서드 외에도 다음 메서드를 제공합니다.
| Method | Description |
|---|---|
| getIsPartyList | 조회에서 여러 레코드를 파티 목록 조회로 허용하는지 여부를 반환합니다. |
선택 항목 및 선택 열 형식
모든 열 형식에 사용할 수 있는 메서드 외에도 선택 항목 및 선택 열 형식은 다음 메서드를 제공합니다.
| Method | Description |
|---|---|
| getInitialValue | 폼이 열릴 때 열의 값을 반환합니다. |
| getOption | 지정된 레이블 또는 값과 일치하는 옵션을 반환합니다. |
| getOptions | 열의 유효한 옵션을 반환합니다. |
| getSelectedOption | 선택한 옵션 또는 옵션을 반환합니다. |
| getText | 선택한 옵션 또는 옵션의 텍스트를 반환합니다. |
숫자 열 형식(10진수, double, 정수, money)
다음 메서드는 10진수, double 및 정수 열에 만 사용할 수 있습니다.
| Method | Description |
|---|---|
| getMax | 열의 최대 허용 값을 반환합니다. |
| getMin | 열의 허용되는 최소값을 반환합니다. |
| getPrecision | 소수점 이후 허용되는 자릿수를 반환합니다. |
| setPrecision | 소수점 이후 허용되는 자릿수를 설정합니다. |
문자열 열 형식
앞에서 설명한 대로 모든 열 형식에 사용할 수 있는 메서드 외에도 다음 메서드는 문자열 열에만 사용할 수 있습니다.
| Method | Description |
|---|---|
| getMaxLength | 열의 최대 문자열 길이를 반환합니다. |