AddFieldValue

Description

Añade el valor especificado a la lista de valores del campo denominado.

Este método es similar a SetFieldValue, excepto que añade un elemento a una lista de valores, en lugar de proporcionar un valor exclusivo. Este método está previsto para campos que pueden aceptar una lista de valores. Si un campo no contiene un valor, puede utilizar este método para establecer el valor de un campo que toma un único valor. No tiene lugar ninguna validación durante la llamada al método AddFieldValue.

El método AddFieldValue se ha diseñado para trabajar con campos de lista. No se ha diseñado para trabajar con campos escalonados (por ejemplo, una serie, una serie de varias líneas y referencia).

No tiene lugar ninguna validación durante una llamada al método AddFieldValue. Para determinar si un campo contiene un valor válido, obtenga el Objeto FieldInfo para el campo y llame a ValidityChangedThisSetValue del objeto FieldInfo para validar el campo.

Sólo se puede llamar a este método si el objeto Entity se puede editar. Para convertir un objeto Entity existente en editable, llame a EditEntity del objeto Session.

Sintaxis

VBScript

entity.AddFieldValue field_name,new_value 

Perl

$entity->AddFieldValue(field_name, new_value); 
Identificador
Description
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.
field_name
Un valor String que contiene un nombre de campo válido de este objeto Entity.
new_value
Para Visual Basic, un valor Variant que contiene el nuevo valor que se va a añadir al campo. Para Perl, un valor String que contiene el nuevo valor.
Valor de retorno
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

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

Perl

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

Comentarios