SetFieldValue

설명

이름 지정된 필드에 지정된 값을 기록합니다.

필드가 변경될 경우, 값이 올바른지 여부에 관계 없이 이 메소드는 새 값을 설정하고 빈 문자열을 설정합니다. 필드에 올바른 값이 포함되어 있는지 여부를 판별하려면 해당 필드에 대한 FieldInfo 오브젝트를 확보한 다음 FieldInfo 오브젝트의 ValidityChangedThisSetValue 메소드를 호출하여 필드의 유효성을 검증하십시오.

필드를 변경할 수 없는 경우, 리턴된 문자열에 필드를 변경할 수 없는 이유가 표시됩니다. 일반적인 값에는 "변경할 수 있는 필드가 아님", "레코드가 편집 중이지 않음" 및 "필드가 읽기 전용임"이 포함됩니다.

필드가 하나가 아닌 여러 개의 값을 가질 수 있는 경우, AddFieldValue 메소드를 사용하여 새 값을 하나씩 추가하십시오. SetFieldValue를 사용할 수도 있습니다. 그러나 이미 값 목록을 포함하는 필드에서 SetFieldValue를 사용하면 전체 목록이 하나의 새 값으로 바뀝니다.

Entity 오브젝트가 편집 가능한 경우에만 이 메소드를 호출할 수 있습니다. 기존의 Entity 오브젝트를 편집 가능하게 만들려면 Session 오브젝트의 EditEntity 메소드를 호출하십시오.

참고: 후크가 필드 특성 또는 값을 변경한 후 변경된 필드 또는 모든 기타 필드에 해당하는 논리 변수를 새로 고쳐야 합니다. 필드 값을 설정하면 레코드 내 필드의 필요성 또는 값을 변경하는 후크가 시작됩니다. 후크 또는 스크립트는 로컬 변수를 새로 고쳐 레코드 내의 값과 동일한 상태를 유지할 수 있게 해야 합니다. 현재 값이 필요하면 로컬 변수를 새로 고치십시오.

구문

VBScript

entity.SetFieldValue field_name, new_value 

Perl

$entity->SetFieldValue(field_name, new_value); 
ID
설명
entity
사용자 데이터 레코드를 나타내는 Entity 오브젝트. 후크 내에서 구문에 이 부분을 생략할 경우, Entity 오브젝트가 현재 데이터 레코드에 해당한다고 가정합니다(VBScript에만 해당).
field_name
Entity 오브젝트의 올바른 필드 이름을 포함하는 문자열.
new_value
VBScript의 경우, 필드의 새 값을 포함하는 Variant 값. Perl의 경우, 새 값을 포함하는 문자열.
Return value
필드 변경이 허용될 경우 이 메소드는 빈 문자열을 리턴합니다. 허용되지 않으면 오류에 대한 설명이 들어 있는 문자열을 리턴합니다.

예제

VBScript

' Set two field values, but only check errors for 
' the second field. 
entity.SetFieldValue "field1", "new value" 
returnVal = SetFieldValue("field2", "100") 

Perl

# Set two field values for the entity

# Perform error checking on the second field

$entity->SetFieldValue("field1","new value");

$returnval = $entity->SetFieldValue("field2","100"); 

피드백