SetFieldValues

Descrizione

Inserisce i valori specificati nei campi denominati. Questo metodo consente l'impostazione di più valori di campo con una chiamata. I due array delle stringhe di input 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 array 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 array di stringhe con lo stesso numero di elementi di field_names, dove ogni elemento è una stringa vuota.

Nota: questo metodo è stato reso disponibile nella versione 2003.06.00.

Sintassi

VBScript

entity.SetFieldValues field_names, new_values 

Perl

$entity->SetFieldValues (field_names, new_values); 
Identificativo
Descrizione
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 array di stringhe. Ogni stringa contiene un nome del campo valido di questo oggetto Entity.

Per Perl, un riferimento ad un array 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 array di stringhe. Ogni stringa contiene un valore di campo.

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

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

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

Se le modifiche al campo sono consentite, questo metodo restituisce una stringa vuota; in caso contrario, questo metodo restituisce una stringa 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