SetFieldValues

Description

Inserisce i valori specificati nei campi denominati. Questo metodo consente l'impostazione di più valori di campo con una chiamata. I due vettori delle stringhe di imput sono elenchi paralleli, dove field_names elenca i nomi di campo e new_values i valori di campo. Ad esempio, l'elemento N in field_names fornisce il nome di campo e l'elemento N in new_values il valore per tale campo.

Il valore di ritorno è un vettore di messaggi di risultato per ogni campo. Ciascun messaggio di risultato è lo stesso messaggio restituito da una singola chiamata al metodo SetFieldValue. Se non si verificano errori, il risultato è un vettore del valore String con lo stesso numero di elementi di field_names, ogni elemento diventa un valore String vuoto.

Nota: questo metodo diventa disponibile nella versione 2003.06.00.

Sintassi

VBScript

entity.SetFieldValues field_names, new_values 

Perl

$entity->SetFieldValues (field_names, new_values); 
Identificativo
Description
entity
Un oggetto Entity che rappresenta un record di dati dell'utente. All'interno di un hook, se si omette questa parte della sintassi, viene utilizzato l'oggetto Entity corrispondente al record di dati corrente (solo VBScript).
field_names
L'elenco dei nomi di campo per i valori da impostare.

Per VBScript, un valore Variant contenente un vettore di stringhe. Ogni valore String contiene un nome del campo valido di questo oggetto Entity.

Per Perl, un riferimento ad un vettore di stringhe contenente i nomi del campo validi.

new_values
L'elenco dei valori di campo da impostare per i nomi di campo specificati.

Per VBScript, un valore Variant contenente un vettore di stringhe. Ogni valore String contiene un valore di campo.

Per Perl, un riferimento ad un vettore di stringhe contenente i nuovi valori.

Valore di ritorno
Per VBScript, un valore Variant contenente un vettore di messaggi di risultato per ogni campo.

Per Perl, un riferimento ad un vettore di stringhe contenente i messaggi di risultato per ogni campo.

Se le modifiche al campo sono consentite, questo metodo restituisce un valore String vuoto; in caso contrario, questo metodo restituisce un valore String contenente una spiegazione dell'errore.

Esempi

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