SetFieldValues

설명

이름 지정된 필드에 지정된 값을 기록합니다. 이 메소드를 사용하면 한 번의 호출로 여러 개의 필드 값을 설정할 수 있습니다. 두 개의 입력 문자열 배열은 병렬 목록입니다. 여기서 field_names는 필드 이름을 나열하고 new_values는 필드 값을 나열합니다. 예를 들어, field_names의 항목 N은 필드 이름을 제공하고 new_values의 항목 N은 해당 필드의 값을 제공합니다.

리턴값은 각 필드에 대한 결과 메시지 배열입니다. 각 결과 메시지는 SetFieldValue 메소드에 대한 단일 호출로부터 리턴되는 메시지와 동일합니다. 오류가 없으면, 결과는 field_names와 동일한 수의 요소를 가진 문자열 배열이며 각 요소의 문자열은 비어 있습니다.

참고: 이 메소드는 버전 2003.06.00부터 사용 가능해졌습니다.

구문

VBScript

entity.SetFieldValues field_names, new_values 

Perl

$entity->SetFieldValues (field_names, new_values); 
ID
설명
entity
사용자 데이터 레코드를 나타내는 Entity 오브젝트. 후크 내에서 구문에 이 부분을 생략할 경우, Entity 오브젝트가 현재 데이터 레코드에 해당한다고 가정합니다(VBScript에만 해당).
field_names
설정할 값에 대한 필드 이름 목록.

VBScript의 경우, 문자열 배열을 포함하는 Variant 값. 각 문자열에는 이 Entity 오브젝트에 대해 올바른 필드 이름이 포함되어 있습니다.

Perl의 경우, 올바른 필드 이름을 포함하는 문자열 배열에 대한 참조가 리턴됩니다.

new_values
지정된 필드 이름에 대해 설정할 필드 값 목록.

VBScript의 경우, 문자열 배열을 포함하는 Variant 값. 각 문자열은 필드 값을 포함합니다.

Perl의 경우, 새 값을 포함하는 문자열 배열에 대한 참조가 리턴됩니다.

Return value
VBScript의 경우, 각 필드에 대한 결과 메시지 배열을 포함하는 Variant 값입니다.

Perl의 경우, 각 필드의 결과 메시지를 포함하는 문자열 배열에 대한 참조입니다.

필드 변경이 허용될 경우 이 메소드는 빈 문자열을 리턴합니다. 허용되지 않으면 오류에 대한 설명이 들어 있는 문자열을 리턴합니다.

예제

VBScript

Dim FieldList
ReDim FieldList(2)	' This sets up an array of three elements
Dim ValList
ReDim ValList(2)
FieldList(0)="new_field"
FieldList(1)="new_field2"
FieldList(2)="new_field3"
ValList(0)="f1"
ValList(1)="f2"
ValList(2)="f3"
entity.SetFieldValues FieldList, ValList 

Perl

my @fieldnames = ("submitter", "owner");
my @fieldvalues = ("userA", "userB");

$entity->SetFieldValues(\@fieldnames, \@fieldvalues);

피드백