GetFieldStringValues

Description

This Entity object method allows multiple field values to be retrieved with one call. The field_names parameter is a string array of field names, and the result is a string array of field values, in the same order as the input array. If there is an error retrieving any one of the named fields (for example, if you specify an incorrect name of a field), an exception is thrown.

Note: This method became available in version 2003.06.00.

Syntax

VBScript


entity.GetFieldStringValues field_names 

Perl


$entity->GetFieldStringValues (field_names); 
Identifier
Description
entity
An Entity object representing a user data record. Inside a hook, if you omit this part of the syntax, the Entity object corresponding to the current data record is assumed (VBScript only).
field_names
For VBScript, a Variant containing an array of Strings. Each String contains a valid field name of this Entity object.

For Perl, a reference to an array of strings containing the valid field names.

Return value
For VBScript, a Variant containing an array of strings. Each string contains the value or values stored for each of the specified field names.

For Perl, a reference to an array of strings containing the value or values stored for each of the specified field names.

Example

Perl

my @fieldnames = ("submitter", "owner");
my $fieldvalues = $entity->GetFieldStringValues (\@fieldnames);