SetFieldValues

Descripción

Sitúa los valores especificados en los campos denominados. Este método permite establecer varios valores de campo con una llamada. Las dos matrices de serie de entrada son listas paralelas, donde field_names lista los nombres de campo y new_values lista los valores de campo. Por ejemplo, el elemento N de field_names proporciona el nombre de campo y el elemento N de new_values proporciona el valor de dicho campo.

El valor de retorno es una matriz de mensajes de resultado para cada campo. Cada mensaje de resultado es el mismo mensaje que ha devuelto una única llamada al método SetFieldValue. Si no existen errores, el resultado es una matriz de series con el mismo número de elementos que field_names, siendo cada elemento un valor String vacío.

Nota: Este método estuvo disponible en la versión de 2003.06.00.

Sintaxis

VBScript

entity.SetFieldValues field_names, new_values 

Perl

$entity->SetFieldValues (field_names, new_values); 
Identificador
Descripción
entity
Un objeto Entity que representa un registro de datos de usuario. En un enganche, si se omite esta parte de la sintaxis, se presupone el objeto Entity correspondiente al registro de datos actual (sólo VBScript).
field_names
Lista de nombres de campo para los valores que establecer.

Para VBScript, un valor Variant que contiene una matriz de series. Cada serie contiene un nombre de campo válido de este objeto Entity.

Para Perl, una referencia a una matriz de series que contiene los nombres de campo válidos.

new_values
Lista de valores de campo que establecer para los nombres de campo especificados.

Para VBScript, un valor Variant que contiene una matriz de series. Cada serie contiene un valor de campo.

Para Perl, una referencia a una matriz de series que contiene los nuevos valores.

Valor de retorno
Para VBScript, un valor Variant que contiene una matriz de mensajes de resultado para cada campo.

Para Perl, una referencia a una matriz de series que contiene los mensajes de resultado para cada campo.

Si se permiten cambios en el campo, este método devuelve un valor String vacío; de lo contrario, este método devuelve un String que contiene una explicación del error.

Ejemplos

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

Feedback