AddFieldValue

설명

이름 지정된 필드의 값 목록에 지정된 값을 추가합니다.

이 메소드는 하나의 값을 제공하는 대신 값 목록에 항목을 추가한다는 점을 제외하면 SetFieldValue와 유사합니다. 이 메소드는 값 목록을 승인할 수 있는 필드에 사용하도록 설계되었습니다. 필드에 이미 값이 포함되어 있지 않으면, 계속해서 이 메소드를 사용하여 단일 값을 취하는 필드의 값을 설정할 수 있습니다. AddFieldValue 메소드를 호출하는 동안 유효성 검증이 발생되지 않습니다.

AddFieldValue 메소드는 목록 필드에서 작동하도록 설계되었습니다. 스칼라 필드(예: 문자열, 다중 행 문자열 및 참조)에서는 작동하지 않도록 설계되었습니다.

AddFieldValue 메소드를 호출하는 동안 유효성 검증이 발생되지 않습니다. 필드가 올바른 값을 포함하는지 판별하려면 해당 필드에 대한 FieldInfo 오브젝트를 확보한 후 FieldInfo 오브젝트의 ValidityChangedThisSetValue를 호출하여 필드의 유효성을 검증하십시오.

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

구문

VBScript

entity.AddFieldValue field_name,new_value 

Perl

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

예제

VBScript

AddFieldValue "field1", "option 1" 
AddFieldValue "field1", "option 2" 
AddFieldValue "field1", "option 3" 

Perl

$entity->AddFieldValue("field1", "option 1");
$entity->AddFieldValue("field1", "option 2");
$entity->AddFieldValue("field1", "option 3");

피드백