AddFieldValue

Description

Aggiunge il valore specificato all'elenco di valori nel campo denominato.

Questo metodo è simile a SetFieldValue, tranne per il fatto che aggiunge un elemento ad un elenco di valori, anziché fornire l'unico valore. Questo metodo è previsto per campi che possono accettare un elenco di valori. Se un campo non contiene già un valore, è possibile utilizzare ancora questo metodo per impostare il valore di un campo che utilizza un singolo valore.

Nota: il metodo AddFieldValue è stato progettato per essere utilizzato con i campi elenco. Non è stato progettato per essere utilizzato con i campi scalari (ad esempio, stringa, stringa multiriga e riferimento).

Per determinare se un campo contiene un valore valido, acquisire l'Oggetto FieldInfo per tale campo e richiamare ValidityChangedThisSetValue dell'oggetto FieldInfo per convalidare il campo.

È possibile richiamare questo metodo solo se l'oggetto Entity è modificabile. Per rendere un oggetto Entity esistente modificabile, richiamare EditEntity dell'oggetto Session.

Sintassi

VBScript

entity.AddFieldValue field_name, new_value 

Perl

$entity->AddFieldValue(field_name, new_value); 
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.
field_name
Un valore String contenente un nome del campo valido di questo oggetto Entity.
new_value
Per Visual Basic, un valore Variant contenente il nuovo valore da aggiungere al campo. Per Perl, un valore String contenente il nuovo valore.
Valore di ritorno
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

AddFieldValue "field1", "option 1" 
AddFieldValue "field1", "option 2" 
AddFieldValue "field1", "option 3" 

Perl $entity->AddFieldValue("field1", "option 1"); $entity->AddFieldValue("field1", "option 2"); $entity->AddFieldValue("field1", "option 3");



Feedback