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