다음을 통해 공유


setValue(클라이언트 API 참조)

열의 데이터 값을 설정합니다.

지원되는 열 형식

All

Syntax

formContext.getAttribute(arg).setValue(value)

매개 변수

열 유형에 따라 달라집니다.

열 형식 매개 변수 형식
불리언 Boolean
datetime 날짜

통합 인터페이스에서 날짜 값은 UTC로 간주됩니다.
레거시 웹 클라이언트에서 날짜 값은 사용자의 표준 시간대에 있는 것으로 간주됩니다.
십진수 숫자
더블 숫자
정수 숫자
lookup 배열 조회 개체의 배열입니다.

'파티리스트' 조회라고 하는 특정 조회를 사용하면 전자 메일 테이블 레코드의 To: 열과 같은 여러 레코드를 조회에 연결할 수 있습니다. 따라서 조회 열이 추가할 레코드 참조를 둘 이상 지원하지 않는 경우에도 모든 조회 데이터 값은 조회 개체 배열을 사용합니다.

각 조회에는 다음과 같은 속성이 있습니다.
- entityType: String. 조회에 표시되는 테이블의 이름입니다.
- id: String: 조회에 표시된 레코드에 대한 GUID 값의 문자열 표현입니다. 값은 {XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX} 형식과 일치해야 합니다.
- name: String: 조회에 표시할 레코드를 나타내는 텍스트입니다.
메모 String
숫자
choice 숫자
문자열 String
메모 String
숫자
선택, 선택 숫자

getOptions 메서드는 옵션 값을 문자열로 반환합니다. 이러한 값을 사용하여 선택 열의 값을 설정하려면 먼저 parseInt 를 사용하여 숫자로 변환해야 합니다. 유효한 상태 코드(상태 이유) 옵션은 레코드의 현재 상태 코드에 따라 달라집니다. 상태 코드(상태) 열은 양식 스크립트에서 설정할 수 없습니다. 유효한 상태 코드 값을 이해하려면 열 정의를 참조하세요. 사용자 지정 테이블의 경우 테이블 정의 브라우저를 사용합니다. 마지막으로 열에 적용된 사용자 지정 상태 전환도 고려합니다. 추가 정보: 사례 또는 사용자 지정 테이블에 대한 상태 이유 전환을 정의합니다.
String String

전자 메일 형식의 문자열 열을 사용하려면 문자열이 유효한 전자 메일 주소를 나타내야 합니다.

비고

setValue를 사용하여 열을 업데이트해도 OnChange 이벤트 처리기가 실행되지 않습니다. OnChange 이벤트 처리기를 실행하려면 setValue 외에도 fireOnChange를 사용해야 합니다.

관련 문서

getValue(클라이언트 API 참조)