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);